[HUB] Единый шлюз уведомлений: hub /notify понимает формат Uptime Kuma (раньше отвечал empty и молча выбрасывал), Hermes стал журналом (Matrix только critical и провалы заданий), auto-repair эскалирует critical, swarm-watchdog переведён на notify.py, добавлена утренняя сводка очереди notify-digest в 09:00
This commit is contained in:
1 parent
e2803ebb00
commit
93440b8b7e
1 file changed
+92
@@ -0,0 +1,92 @@
|
||||
# Единый шлюз уведомлений (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`.
|
||||
Reference in new issue
Block a user