From 2221c8ca4fbde3023ba4880e0724877c8ca93000 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Mon, 9 Nov 2026 23:53:28 +0300 Subject: [PATCH] =?UTF-8?q?[HUB]=20=D0=A8=D0=B8=D0=BD=D0=B0=20=D1=81=D0=BE?= =?UTF-8?q?=D0=B1=D1=8B=D1=82=D0=B8=D0=B9=20=D0=B7=D0=B0=D0=BC=D0=BA=D0=BD?= =?UTF-8?q?=D1=83=D1=82=D0=B0:=20=D1=81=D0=B5=D0=BA=D1=80=D0=B5=D1=82?= =?UTF-8?q?=D0=B0=D1=80=D1=8C=20=D0=BF=D0=BE=D0=BB=D1=83=D1=87=D0=B8=D0=BB?= =?UTF-8?q?=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BC=D0=B5=D0=BD=D1=82?= =?UTF-8?q?=20hermes=20(health/events/run)=20=D0=B8=20=D0=BE=D1=82=D0=B2?= =?UTF-8?q?=D0=B5=D1=87=D0=B0=D0=B5=D1=82=20=D0=BF=D0=BE=20=D0=B6=D1=83?= =?UTF-8?q?=D1=80=D0=BD=D0=B0=D0=BB=D1=83=20(=C2=AB=D1=87=D1=82=D0=BE=20?= =?UTF-8?q?=D0=BD=D0=BE=D1=87=D1=8C=D1=8E=20=D1=81=D0=BB=D0=BE=D0=BC=D0=B0?= =?UTF-8?q?=D0=BB=D0=BE=D1=81=D1=8C=C2=BB),=20=D0=B1=D0=BE=D1=82=D1=8B=20?= =?UTF-8?q?=D0=BF=D1=83=D0=B1=D0=BB=D0=B8=D0=BA=D1=83=D1=8E=D1=82=20=D0=BE?= =?UTF-8?q?=D1=88=D0=B8=D0=B1=D0=BA=D0=B8=20=D0=B8=20=D0=BF=D0=BE=D0=B6?= =?UTF-8?q?=D0=B5=D0=BB=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=B2=20Hermes.=20?= =?UTF-8?q?=D0=9F=D0=BE=D0=BF=D1=83=D1=82=D0=BD=D0=BE:=20cmd=5Fservices=20?= =?UTF-8?q?=D1=85=D0=BE=D0=B4=D0=B8=D0=BB=20=D0=BD=D0=B0=20HTML=20/status?= =?UTF-8?q?=20=D0=B2=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20/status.json=20?= =?UTF-8?q?=E2=80=94=20=D0=B8=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D0=BE=20=D0=B2=D0=BE=20=D0=B2=D1=81=D0=B5=D1=85=20=D0=B2?= =?UTF-8?q?=D1=8B=D0=B7=D0=BE=D0=B2=D0=B0=D1=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/hub/EVENT-BUS.md | 80 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 ops/hub/EVENT-BUS.md diff --git a/ops/hub/EVENT-BUS.md b/ops/hub/EVENT-BUS.md new file mode 100644 index 0000000..bf60071 --- /dev/null +++ b/ops/hub/EVENT-BUS.md @@ -0,0 +1,80 @@ +# Шина событий Buryan Hub (09.11.2026) + +## Что было + +Hermes существовал с 20 заданиями и журналом событий, но **никто его не читал и +почти никто не писал**. Боты опрашивали Synapse, секретарь отвечал «всё в порядке» +по `/status.json`, а провалы заданий копились тысячами без реакции. + +## Что стало + +``` + ┌──────────────────────────────┐ + боты ────────▶│ │ + Hermes-jobs ─▶│ HERMES (порт 9130) │──▶ /notify (hub-core) + Alertmanager ▶│ журнал + дедуп + тишина │ │ + hub-core ────▶│ │ ▼ + └──────────────┬───────────────┘ Matrix (только critical) + │ + ▼ + секретарь: tool «hermes» + health / events / run +``` + +### Кто пишет в шину + +| Источник | Что | Severity | +|---|---|---| +| Hermes-jobs | провал задания | medium | +| Hermes-jobs | запуск Hermes | low | +| **боты (новое)** | ошибка обработки сообщения | medium | +| **боты (новое)** | пожелание от пользователя | low | +| Alertmanager | тревоги | critical / warning | +| hub-core `/alert` | алерты | по важности | + +### Кто читает + +| Потребитель | Как | +|---|---| +| владелец | Matrix, только **critical** (настройка `alertmanager.yml`) | +| **секретарь** | tool `hermes` → `health`, `events`, `run` | +| hub-core | `/notify` — маршрутизация доставки | + +## Проверено + +``` +Q: «Что ночью сломалось?» +A: «Ночью (по журналу Hermes): + • Падало задание check-services — несколько раз с 21:55 до 23:24 + • home-heartbeat не достучался до 193.233.210.184 — таймаут + • Hermes перезапускался (22:38–23:46)» + +Q: «Какие были ошибки за сутки?» +A: «check-services падал 4 раза, home-heartbeat — таймауты, Hermes перезапуски» + +Публикация из бота: publish_event(...) → True +Журнал: «Проверка шины событий [low] quiet-hours» — событие записано +``` + +## Правила + +1. **Не падать при недоступной шине.** `publish_event` возвращает False и молчит — + событие не должно ломать обработку сообщения. +2. **Дедуп обязателен** для повторяющихся событий (`dedup_key`). +3. **Severity честно:** critical — только то, что требует владельца; medium — то, + что система может починить сама; low — информационное. +4. **Тихие часы** 23:30–07:30 в `hermes.yaml` — события ниже critical не будят. + +## Что осталось + +| # | Задача | +|---|---| +| 1 | hub-core публикует изменения состояния служб (сейчас только `/alert`) | +| 2 | Hermes-задание «увидел medium → попробовал починить → отчитался» | +| 3 | Секретарь сам создаёт события о своих действиях (сейчас только ошибки и пожелания) | + +## Ловушка + +`cmd_services` в ботах ходил на `/status` — это **HTML-страница**, а не JSON, +поэтому отвечал «0 из 0 сервисов». Правильный путь — `/status.json`. +Проверять тип ответа, а не только код 200.