[HUB] Шина событий замкнута: секретарь получил инструмент hermes (health/events/run) и отвечает по журналу («что ночью сломалось»), боты публикуют ошибки и пожелания в Hermes. Попутно: cmd_services ходил на HTML /status вместо /status.json — исправлено во всех вызовах
This commit is contained in:
1 parent
ae447b12f7
commit
2221c8ca4f
1 file changed
+80
@@ -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.
|
||||
Reference in new issue
Block a user