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

48 lines
2.8 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 ч | проверяет статус хаба |
## Куда развивать
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}`.