[HUB] Шина событий замкнута: секретарь получил инструмент hermes (health/events/run) и отвечает по журналу («что ночью сломалось»), боты публикуют ошибки и пожелания в Hermes. Попутно: cmd_services ходил на HTML /status вместо /status.json — исправлено во всех вызовах

This commit is contained in:
root committed 2026-11-09 23:53:28 +03:00
1 parent ae447b12f7
commit 2221c8ca4f
1 file changed
+80
+80
View File
@@ -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.