Init

spec/tasks/008_add_signoz_telegram_alerting.md

@@ -0,0 +1,41 @@
+---
+id: 008
+title: Add SigNoz to Telegram alerting configuration
+status: TODO
+created: 2026-03-07
+---
+
+## Context
+`spec/overview.md` требует anomaly alerting через цепочку `SigNoz Alert Rules -> Webhook -> Telegram Bot API` с вынесением token в configuration.
+
+## Goal
+Добавить configuration и infrastructure artifacts, необходимые для маршрутизации anomaly alerts из SigNoz в Telegram и для соответствия alert thresholds требованиям проекта.
+
+## Constraints
+- Alert transport/configuration должны быть отделены от business logic.
+- Telegram credentials должны приходить из configuration и не быть hardcoded.
+- Thresholds должны соответствовать alert conditions из `spec/overview.md`.
+- Не изменять файлы в `spec/`.
+
+## Acceptance criteria
+- Configuration содержит отдельную секцию Alerts с Telegram settings.
+- Infrastructure artifact(s) описывают routing от SigNoz alert webhook к Telegram Bot API.
+- Представлены alert conditions для:
+  - provider 5xx: 5 ошибок за 5 минут
+  - provider p99 latency > 5000ms в течение 10 минут
+  - provider unavailable более 5 минут
+- Setup instructions содержат обязательные environment variables и шаги верификации.
+
+## Definition of Done
+- [ ] Реализована schema конфигурации Alerts.
+- [ ] Добавлены artifact(s) для маршрутизации SigNoz-to-Telegram.
+- [ ] Определены все три обязательных anomaly conditions.
+- [ ] Инструкции валидации исполнимы в local environment.
+
+## Tests
+- Добавить config tests для проверки загрузки alert settings и обязательных полей.
+- Добавить tests для alert payload transformation/transport logic, если он реализован в коде.
+
+## Commands
+- `poetry run pytest tests/config/test_alerts_config.py -q`
+- `docker compose config`