Files
buryan-infra/ops/hermes/README.md

63 lines
4.1 KiB
Markdown
Raw Permalink 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 — шина событий, планировщик и агентский слой
Запущен 28.10.2026, порт **9130**, systemd-юнит `hermes.service`,
код `/opt/hermes/`, состояние в SQLite `hermes.db`.
## Что уже забрал на себя
| Функция | Было | Стало |
|---|---|---|
| Приём алертов Prometheus | Alertmanager слал сразу в Matrix и вебхук | **Alertmanager → Hermes → хаб → Matrix**: дедуп 15 мин, тихие часы 23:30–07:30, приоритеты |
| Свежесть бэкапов | cron `buryan-backup-heartbeat` | задание Hermes `backup-heartbeat`, каждые 30 мин |
| Проверка обновлений | сломанный скрипт (только CT110, «проверено: 0») | задание `updates-check`, все LXC + хост: **132 образа, 87 обновлений** |
| Журнал событий | нигде | таблица `events`: источник, тип, важность, доставка, дедуп-ключ |
| Статус сервисов | ручной опрос | задание `verify-services` раз в час |
## API
```
POST /event {"source","type","severity","title","body","dedup_key"}
POST /alertmanager вебхук Alertmanager
GET /events?limit=50 журнал
GET /approvals ожидающие решения
GET /health живость + счётчики
GET /metrics Prometheus (hermes_events_total, hermes_job_fails…)
POST /jobs/<name>/run ручной запуск задания
```
## Задания (jobs.yaml)
| Имя | Расписание | Что делает |
|---|---|---|
| `backup-heartbeat` | 30 мин | пингует Kuma по свежести бэкапов |
| `updates-check` | 6 ч | ищет обновления образов, публикует событие |
| `disk-trend` | 1 ч | срез занятого места |
| `verify-services` | 1 ч | проверяет статус хаба |
| `update-plan` | 08:45 | строит план обновлений в `/var/lib/hub-agents/update-plan.md` |
| `home-heartbeat` | 5 мин | dead-man switch: отметка на VPS |
| `export-service-metrics` | 2 мин | метрики служб → textfile CT134 *(было `cron.d/buryan-service-metrics`)* |
| `direct-health-check` | 5 мин | записи в `health_checks` Postgres *(было в crontab)* |
| `check-services` | 5 мин | проверки служб по смыслу *(было в crontab)* |
| `swarm-watchdog` | 1 мин | сторож роя *(было в crontab)* |
Миграция четырёх последних выполнена 28.10.2026: строки в crontab и
`/etc/cron.d` закомментированы с пометкой `# -> Hermes 2026-10-28`
(файл `buryan-service-metrics` переименован в `.disabled`), двойного запуска нет.
Попутно исправлено в `check-services.sh`:
* убраны проверки Plex и Tautulli — службы выведены из эксплуатации (был вечный «провал»);
* Zigbee проверяется через `check_docker "Zigbee" "zigbee2mqtt"`: у Zigbee2MQTT нет HTTP-фронтенда
(конфиг без блока `frontend`, сеть `host`), а прежний адрес `192.168.1.106:8080` не отвечал никогда.
## Куда развивать
1. **Ротация расписаний** — перенести `hub-*` cron в jobs.yaml, чтобы был один список.
2. **Обновления по подтверждению** — заявка `approvals` → применение с снапшотом и откатом.
3. **Агенты** — задачи «проверь X и предложи Y» с журналом решений.
4. **Голос** — после локальной LLM: событие → короткий ответ в Matrix/колонку.
## Метрики
`hermes_events_total`, `hermes_events_1h`, `hermes_events_undelivered`,
`hermes_quiet_active`, `hermes_job_runs{job,status}`, `hermes_job_fails{job}`.