Files
buryan-infra/ops/hub/NOTIFY-GATEWAY.md
T

4.5 KiB
Raw Blame History

Единый шлюз уведомлений (10.11.2026)

Зачем

Путей уведомлений было пять, каждый со своими правилами. Отсюда спам и невозможность предсказать, что и когда придёт.

ДО                                    ПОСЛЕ
check-services ──► Matrix             check-services ─┐
notify.py      ──► Matrix             notify.py      ─┤
Hermes         ──► Matrix             Hermes         ─┤
Kuma           ──► hub (ломался)      Kuma           ─┼──► HUB /notify ──► Matrix
swarm-watchdog ──► Matrix             swarm-watchdog ─┤      (политика)
                                      матрица-бриджи ─┘
                                              Hermes: журнал + только critical

Что сделано

1. hub /notify — единственная точка доставки

Политика внутри:

Правило Как работает
Дедуп одинаковые title+message в окне 10 минут не повторяются
Тихие часы 23:00–08:00 normal откладывается в очередь
Суточный лимит не больше 3 normal-сообщений в день
Приоритеты critical/high проходят всегда, low — в очередь

2. /notify понимает формат Uptime Kuma

Раньше Kuma присылала {monitor, heartbeat, msg}, хаб отвечал empty и молча выбрасывал. Теперь разбирает и превращает в:

  • heartbeat.status != 1 → «Монитор: X упал», priority high
  • иначе → «Монитор: X поднялся», priority low

3. Hermes стал журналом, а не вторым каналом

Было: любое событие с severity high/critical → уведомление. Это дублировало доставку (Kuma → hub и Kuma → Hermes → hub).

Стало:

Событие Доставка
severity=critical ✅ в Matrix
провал задания (etype=job, high/critical) ✅ в Matrix
всё остальное 📓 только журнал (journal-only)

4. Авто-починка эскалирует через critical

auto_repair.py: «не смог починить» теперь critical, а не high — такие события доходят до владельца, обычные успехи остаются в журнале.

5. Утренняя сводка очереди

notify_digest.py — задание Hermes notify-digest в 09:00. Разбирает очередь, отправляет одну сводку и очищает. Раньше очередь росла до 100 записей / 24 КБ и никто её не читал.

6. swarm-watchdog переведён на шлюз

alert_matrix() больше не шлёт curl'ом напрямую в Matrix, а зовёт notify.py — значит подчиняется дедупу, тихим часам и лимиту.

Проверка

Kuma-формат → /notify:  {"ok": true, "action": "sent"}
  запись: "title": "Монитор: Тестовый монитор", "priority": "high"

low-событие Hermes:     delivered=1 (journal-only)   ← в Matrix не ушло
critical-событие:       delivered=1 (http:200)       ← доставлено
swarm-watchdog прогон:  ок, сообщений нет
очередь:                0

Что осталось

# Что
1 Матричные бриджи (webhook-to-matrix, smtp-to-matrix, matrix-vpn-bot) — они пересылают контент, а не статус; их можно оставить напрямую
2 Дайджесты (media_digest, events_digest, weekly, resume) — контент, не алерты
3 Убрать дубль-подписку Kuma (id=2), если решим оставить только путь через Hermes

Итог

Теперь любое состояние системы идёт через один шлюз с одной политикой. Добавить новый источник — значит просто вызвать POST /notify.