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

93 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Единый шлюз уведомлений (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`.