4.5 KiB
Единый шлюз уведомлений (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.