g2s-aggregator/spec/tasks/008_add_signoz_telegram_alerting.md

id, title, status, created

id	title	status	created
008	Add SigNoz to Telegram alerting configuration	DONE	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 требованиям проекта через секцию alerts в .yaml конфиге.

Constraints

• Alert transport/configuration должны быть отделены от business logic.
• Telegram credentials должны приходить из секции alerts YAML-конфига и не быть hardcoded.
• Thresholds должны соответствовать alert conditions из spec/overview.md.
• Не изменять файлы в spec/.

Acceptance criteria

• Configuration содержит отдельную секцию alerts в .yaml конфиге с 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 содержат пример секции alerts YAML-конфига и шаги верификации.

Definition of Done

• Реализована schema конфигурации Alerts.
• Добавлены artifact(s) для маршрутизации SigNoz-to-Telegram.
• Определены все три обязательных anomaly conditions.
• Инструкции валидации исполнимы в local environment.

Tests

• Добавить config tests для проверки загрузки alert settings из секции alerts YAML-конфига и обязательных полей.
• Добавить tests для alert payload transformation/transport logic, если он реализован в коде.

Commands

• poetry run pytest tests/config/test_alerts_config.py -q
• docker compose config