From 7c6cfd7d187fb7358fd355366ee1dfba5106675d Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sat, 14 Feb 2026 12:45:52 +0300 Subject: [PATCH] =?UTF-8?q?docs(docs):=20=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2?= =?UTF-8?q?=D0=BB=D1=91=D0=BD=20=D0=BF=D0=BB=D0=B0=D0=BD=20=D0=B3=D0=B5?= =?UTF-8?q?=D0=BD=D0=B5=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=B0=20=D0=BF=D0=BE?= =?UTF-8?q?=20=D0=B8=D0=BD=D1=82=D0=B5=D0=B3=D1=80=D0=B0=D1=86=D0=B8=D0=B8?= =?UTF-8?q?=20Prometheus?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - зафиксировать решение об observability генератора на уровне MVP-плана - Что: - добавлены требования по /metrics, scrape_config и target generator:9109 - добавлен env-параметр GEN_METRICS_PORT - обновлены шаг внедрения и критерии успеха - Проверка: - проверен diff только для plans/generator_demo_stream_plan.md --- plans/generator_demo_stream_plan.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/plans/generator_demo_stream_plan.md b/plans/generator_demo_stream_plan.md index 4f5f32e..212fead 100644 --- a/plans/generator_demo_stream_plan.md +++ b/plans/generator_demo_stream_plan.md @@ -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. ---