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;
|
- простая конфигурация через 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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user