monitoring/openspec/changes/archive/2026-09-13-vesti-alerts/proposal.md

Proposal: vesti-alerts

Why

Проект /opt/vesti (веб :8400 + publisher-контейнер :8410 + SOCKS5-туннель :1080 + SQLite БД) получил дашборд VESTI в Grafana (2026-09-13), но алертов на падение компонентов нет: при недоступности web/publisher/туннеля/БД никто не узнает в реальном времени (только постфактум на дашборде). Нужны алерты в существующем механизме мониторинга (Prometheus rule_files → alerts.yml) на все компоненты vesti, с уведомлением (webhook/настроенный канал).

What Changes

• В /opt/monitoring/alerts.yml добавляется группа vesti с алертами:
  • VestiWebDown — vesti_web_up{component="vesti"} == 0, for 2m, severity: critical
  • VestiPublisherDown — vesti_publisher_health{component="vesti"} == 0, for 2m, severity: critical
  • VestiPublisherContainerDown — vesti_publisher_docker{component="vesti"} == 0, for 2m, severity: critical
  • VestiTunnelDown — vesti_telegram_tunnel{component="vesti"} == 0, for 2m, severity: critical
  • VestiDbDown — vesti_db_ok{component="vesti"} == 0, for 2m, severity: critical
  • VestiDbStale — time() - vesti_db_last_run_ts{component="vesti"} > 1800, for 5m, severity: warning (краулер не работал >30 мин)
• Все алерты аннотируются summary с именем компонента.
• Верификация: promtool check config + запрос фактических значений в Prometheus API.

Capabilities

New Capabilities

• vesti-alerts: алерты на компоненты VESTI (web, publisher, docker, tunnel, db, краулер staleness).

Modified Capabilities

• monitoring-stack (alerts.yml) — добавлена группа vesti.