[HUB] Интеграции Hermes: Uptime Kuma (69 мониторов, перевод формата), Proxmox CT (ct-state), Home Assistant (ha-state); секретарь получил действие jobs — отвечает, какие задания падают. Заданий теперь 24

This commit is contained in:
root committed 2026-11-10 10:30:54 +03:00
1 parent 63516dc840
commit 157bf5b868
1 file changed
+83
+83
View File
@@ -0,0 +1,83 @@
# Интеграции Hermes (10.11.2026)
## Что подключено
```
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Uptime Kuma │ │ Proxmox │ │ Home │ │ Hermes- │
│ 69 мониторов │ │ 33 CT │ │ Assistant │ │ задания │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ webhook │ job │ job │ job
└──────────────────┴────────┬────────┴─────────────────┘
▼
HERMES (порт 9130)
│
┌──────────────┼──────────────┐
▼ ▼ ▼
секретарь Matrix hub-core
(tool hermes) (critical) /notify
```
## 1. Uptime Kuma → Hermes
Kuma шлёт свой формат `{heartbeat, monitor, msg}`. Hermes теперь его понимает:
`/event` распознаёт полезную нагрузку и превращает в событие:
* `heartbeat.status == 1` → **low** «Монитор поднялся: <имя>»
* иначе → **high** «МОНИТОР УПАЛ: <имя>» + url и текст ошибки
Создано уведомление **«Hermes (шина)»** (id=3), привязано ко **всем 69 мониторам**.
Проверка: тестовый payload → `{"translated":"uptime-kuma"}`, событие
«МОНИТОР УПАЛ: Тест монитор» (high) в журнале.
## 2. Proxmox → Hermes (`ct-state`)
Задание каждые 5 минут: `pct list` → сравнение со снимком
`/var/lib/hermes/ct_snapshot.json`.
* CT остановился (был running) → **high**
* CT запустился → **low**
Игнорируется CT 999 (тестовый).
## 3. Home Assistant → Hermes (`ha-state`)
Задание каждые 10 минут: считает сущности в `unavailable`/`unknown`.
* прирост ≥ 5 → **medium** «HA: недоступно N сущностей (+K)» со списком
* первый запуск только сохраняет снимок (без шума)
## 4. Секретарь научился спрашивать Hermes
Инструмент `hermes` получил действие **`jobs`**:
```
Q: «Какие задания падают?»
A: «Падает одно задание: audit-targets — 1 провал. Остальные 23 в порядке.»
Q: «Что слышно по системе?»
A: «🔴 high — монитор упал; 🟠 medium — HA: недоступно 72 сущности;
🟢 Hermes перезапускался, поднялся.»
```
Полный набор: `health`, `events` (с фильтром severity), `jobs`, `run`.
## Состав шины после расширения
| Источник | Тип | Важность |
|---|---|---|
| Uptime Kuma (69 мониторов) | monitor down/up | high / low |
| Proxmox CT (33) | ct stopped/started | high / low |
| Home Assistant | ha unavailable | medium |
| Alertmanager | тревоги | critical → владельцу |
| Hermes-задания | провал/успех | medium / low |
| Боты | ошибки, пожелания | medium / low |
| hub-core `/alert` | алерты | по важности |
Заданий в Hermes: **24** (`state-diff`, `auto-repair`, `ct-state`, `ha-state` — новые).
## Ловушка
Первый запуск `ha-state` посчитал все 72 недоступные сущности «новыми» и выдал
одно шумное событие. Исправлено: при отсутствии снимка — только сохраняем базу,
без события.