81 lines
4.1 KiB
Markdown
81 lines
4.1 KiB
Markdown
# Шина событий 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.
|