84 lines
4.3 KiB
Markdown
84 lines
4.3 KiB
Markdown
# Интеграции 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 недоступные сущности «новыми» и выдал
|
||
одно шумное событие. Исправлено: при отсутствии снимка — только сохраняем базу,
|
||
без события.
|