diff --git a/ops/hub/HERMES-INTEGRATIONS.md b/ops/hub/HERMES-INTEGRATIONS.md new file mode 100644 index 0000000..4325b47 --- /dev/null +++ b/ops/hub/HERMES-INTEGRATIONS.md @@ -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 недоступные сущности «новыми» и выдал +одно шумное событие. Исправлено: при отсутствии снимка — только сохраняем базу, +без события.