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

4.3 KiB
Raw Blame History

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