63 lines
4.1 KiB
Markdown
63 lines
4.1 KiB
Markdown
# 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}`.
|