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