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:
2026-06-09 17:26:31 +03:00
committed by Dmitry Dementiev
parent cbc2f72871
commit 7c6cfd7d18
+11
View File
@@ -23,6 +23,7 @@
- один автономный сервис (контейнер); - один автономный сервис (контейнер);
- простая конфигурация через env; - простая конфигурация через env;
- базовые метрики и логи; - базовые метрики и логи;
- экспорт метрик в Prometheus;
- минимальная история запусков. - минимальная история запусков.
### Не делаем в MVP ### Не делаем в MVP
@@ -116,6 +117,7 @@
- `GEN_LAMBDA_BASE_PER_MIN` (базовый `lambda` для Poisson) - `GEN_LAMBDA_BASE_PER_MIN` (базовый `lambda` для Poisson)
- `GEN_MIN_EVENTS_PER_TICK` (нижняя граница) - `GEN_MIN_EVENTS_PER_TICK` (нижняя граница)
- `GEN_MAX_EVENTS_PER_TICK` (верхняя граница) - `GEN_MAX_EVENTS_PER_TICK` (верхняя граница)
- `GEN_METRICS_PORT` (порт HTTP-эндпоинта `/metrics`, по умолчанию `9109`)
Опционально: Опционально:
@@ -141,6 +143,13 @@
- `generator_tick_duration_seconds` - `generator_tick_duration_seconds`
- `generator_last_success_timestamp` - `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` (или файл/лог на первом шаге): Таблица `meta.generator_batches` (или файл/лог на первом шаге):
@@ -178,6 +187,7 @@
### Шаг 3. Логи/метрики/история batch ### Шаг 3. Логи/метрики/история batch
- добавить базовые метрики; - добавить базовые метрики;
- подключить экспорт метрик в Prometheus (`/metrics` + `scrape_config`);
- писать историю batch; - писать историю batch;
- оформить runbook запуска/проверки. - оформить runbook запуска/проверки.
@@ -195,6 +205,7 @@ MVP успешен, если:
3. Данные остаются совместимыми с текущим пайплайном. 3. Данные остаются совместимыми с текущим пайплайном.
4. Поток публикуется равномерно малыми порциями (без искусственного минутного burst). 4. Поток публикуется равномерно малыми порциями (без искусственного минутного burst).
5. Есть история batch-ов для учебного разбора. 5. Есть история batch-ов для учебного разбора.
6. Метрики генератора стабильно собираются Prometheus.
--- ---