From 93440b8b7e382bfaf6d5e2edb7ce1e4edc58a246 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Tue, 10 Nov 2026 11:46:13 +0300 Subject: [PATCH] =?UTF-8?q?[HUB]=20=D0=95=D0=B4=D0=B8=D0=BD=D1=8B=D0=B9=20?= =?UTF-8?q?=D1=88=D0=BB=D1=8E=D0=B7=20=D1=83=D0=B2=D0=B5=D0=B4=D0=BE=D0=BC?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D0=B8=D0=B9:=20hub=20/notify=20=D0=BF=D0=BE?= =?UTF-8?q?=D0=BD=D0=B8=D0=BC=D0=B0=D0=B5=D1=82=20=D1=84=D0=BE=D1=80=D0=BC?= =?UTF-8?q?=D0=B0=D1=82=20Uptime=20Kuma=20(=D1=80=D0=B0=D0=BD=D1=8C=D1=88?= =?UTF-8?q?=D0=B5=20=D0=BE=D1=82=D0=B2=D0=B5=D1=87=D0=B0=D0=BB=20empty=20?= =?UTF-8?q?=D0=B8=20=D0=BC=D0=BE=D0=BB=D1=87=D0=B0=20=D0=B2=D1=8B=D0=B1?= =?UTF-8?q?=D1=80=D0=B0=D1=81=D1=8B=D0=B2=D0=B0=D0=BB),=20Hermes=20=D1=81?= =?UTF-8?q?=D1=82=D0=B0=D0=BB=20=D0=B6=D1=83=D1=80=D0=BD=D0=B0=D0=BB=D0=BE?= =?UTF-8?q?=D0=BC=20(Matrix=20=D1=82=D0=BE=D0=BB=D1=8C=D0=BA=D0=BE=20criti?= =?UTF-8?q?cal=20=D0=B8=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B0=D0=BB=D1=8B=20?= =?UTF-8?q?=D0=B7=D0=B0=D0=B4=D0=B0=D0=BD=D0=B8=D0=B9),=20auto-repair=20?= =?UTF-8?q?=D1=8D=D1=81=D0=BA=D0=B0=D0=BB=D0=B8=D1=80=D1=83=D0=B5=D1=82=20?= =?UTF-8?q?critical,=20swarm-watchdog=20=D0=BF=D0=B5=D1=80=D0=B5=D0=B2?= =?UTF-8?q?=D0=B5=D0=B4=D1=91=D0=BD=20=D0=BD=D0=B0=20notify.py,=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B0=20=D1=83=D1=82?= =?UTF-8?q?=D1=80=D0=B5=D0=BD=D0=BD=D1=8F=D1=8F=20=D1=81=D0=B2=D0=BE=D0=B4?= =?UTF-8?q?=D0=BA=D0=B0=20=D0=BE=D1=87=D0=B5=D1=80=D0=B5=D0=B4=D0=B8=20not?= =?UTF-8?q?ify-digest=20=D0=B2=2009:00?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/hub/NOTIFY-GATEWAY.md | 92 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 ops/hub/NOTIFY-GATEWAY.md diff --git a/ops/hub/NOTIFY-GATEWAY.md b/ops/hub/NOTIFY-GATEWAY.md new file mode 100644 index 0000000..4a1b42c --- /dev/null +++ b/ops/hub/NOTIFY-GATEWAY.md @@ -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`.