Files
buryan-infra/ops/hub/HERMES-INTEGRATIONS.md
T

84 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Интеграции 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 недоступные сущности «новыми» и выдал
одно шумное событие. Исправлено: при отсутствии снимка — только сохраняем базу,
без события.