From 157bf5b8681118732d1f6fcb6bf8bfd704fd4d85 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Tue, 10 Nov 2026 10:30:54 +0300 Subject: [PATCH] =?UTF-8?q?[HUB]=20=D0=98=D0=BD=D1=82=D0=B5=D0=B3=D1=80?= =?UTF-8?q?=D0=B0=D1=86=D0=B8=D0=B8=20Hermes:=20Uptime=20Kuma=20(69=20?= =?UTF-8?q?=D0=BC=D0=BE=D0=BD=D0=B8=D1=82=D0=BE=D1=80=D0=BE=D0=B2,=20?= =?UTF-8?q?=D0=BF=D0=B5=D1=80=D0=B5=D0=B2=D0=BE=D0=B4=20=D1=84=D0=BE=D1=80?= =?UTF-8?q?=D0=BC=D0=B0=D1=82=D0=B0),=20Proxmox=20CT=20(ct-state),=20Home?= =?UTF-8?q?=20Assistant=20(ha-state);=20=D1=81=D0=B5=D0=BA=D1=80=D0=B5?= =?UTF-8?q?=D1=82=D0=B0=D1=80=D1=8C=20=D0=BF=D0=BE=D0=BB=D1=83=D1=87=D0=B8?= =?UTF-8?q?=D0=BB=20=D0=B4=D0=B5=D0=B9=D1=81=D1=82=D0=B2=D0=B8=D0=B5=20job?= =?UTF-8?q?s=20=E2=80=94=20=D0=BE=D1=82=D0=B2=D0=B5=D1=87=D0=B0=D0=B5?= =?UTF-8?q?=D1=82,=20=D0=BA=D0=B0=D0=BA=D0=B8=D0=B5=20=D0=B7=D0=B0=D0=B4?= =?UTF-8?q?=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=BF=D0=B0=D0=B4=D0=B0=D1=8E=D1=82?= =?UTF-8?q?.=20=D0=97=D0=B0=D0=B4=D0=B0=D0=BD=D0=B8=D0=B9=20=D1=82=D0=B5?= =?UTF-8?q?=D0=BF=D0=B5=D1=80=D1=8C=2024?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/hub/HERMES-INTEGRATIONS.md | 83 ++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 ops/hub/HERMES-INTEGRATIONS.md 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 недоступные сущности «новыми» и выдал +одно шумное событие. Исправлено: при отсутствии снимка — только сохраняем базу, +без события.