docs(docs): обновлён план генератора по интеграции Prometheus
- Зачем: - зафиксировать решение об observability генератора на уровне MVP-плана - Что: - добавлены требования по /metrics, scrape_config и target generator:9109 - добавлен env-параметр GEN_METRICS_PORT - обновлены шаг внедрения и критерии успеха - Проверка: - проверен diff только для plans/generator_demo_stream_plan.md
This commit is contained in:
@@ -23,6 +23,7 @@
|
||||
- один автономный сервис (контейнер);
|
||||
- простая конфигурация через env;
|
||||
- базовые метрики и логи;
|
||||
- экспорт метрик в Prometheus;
|
||||
- минимальная история запусков.
|
||||
|
||||
### Не делаем в MVP
|
||||
@@ -116,6 +117,7 @@
|
||||
- `GEN_LAMBDA_BASE_PER_MIN` (базовый `lambda` для Poisson)
|
||||
- `GEN_MIN_EVENTS_PER_TICK` (нижняя граница)
|
||||
- `GEN_MAX_EVENTS_PER_TICK` (верхняя граница)
|
||||
- `GEN_METRICS_PORT` (порт HTTP-эндпоинта `/metrics`, по умолчанию `9109`)
|
||||
|
||||
Опционально:
|
||||
|
||||
@@ -141,6 +143,13 @@
|
||||
- `generator_tick_duration_seconds`
|
||||
- `generator_last_success_timestamp`
|
||||
|
||||
### Интеграция с Prometheus (MVP)
|
||||
|
||||
- генератор поднимает HTTP-эндпоинт `/metrics` (например, на `:9109`);
|
||||
- в `configs/prometheus.yml` добавляется `scrape_config` для job `generator`;
|
||||
- target внутри docker-сети: `generator:9109`;
|
||||
- в runbook добавляется проверка, что метрики генератора видны в Prometheus.
|
||||
|
||||
### Минимальная история
|
||||
|
||||
Таблица `meta.generator_batches` (или файл/лог на первом шаге):
|
||||
@@ -178,6 +187,7 @@
|
||||
### Шаг 3. Логи/метрики/история batch
|
||||
|
||||
- добавить базовые метрики;
|
||||
- подключить экспорт метрик в Prometheus (`/metrics` + `scrape_config`);
|
||||
- писать историю batch;
|
||||
- оформить runbook запуска/проверки.
|
||||
|
||||
@@ -195,6 +205,7 @@ MVP успешен, если:
|
||||
3. Данные остаются совместимыми с текущим пайплайном.
|
||||
4. Поток публикуется равномерно малыми порциями (без искусственного минутного burst).
|
||||
5. Есть история batch-ов для учебного разбора.
|
||||
6. Метрики генератора стабильно собираются Prometheus.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user