diff --git a/ops/ops/KUMA-PROMETHEUS.md b/ops/ops/KUMA-PROMETHEUS.md new file mode 100644 index 0000000..fdc85f0 --- /dev/null +++ b/ops/ops/KUMA-PROMETHEUS.md @@ -0,0 +1,64 @@ +# Uptime Kuma → Prometheus (23.10) + +## Задача + +Kuma показывает статусы в своём интерфейсе, но данных нет в Prometheus и +Grafana. Встроенный `/metrics` требует API-ключа, а ключи в Kuma хранятся +**bcrypt-хешами** — восстановить нельзя. + +## Что сделали + +### 1. Свой экспортёр вместо /metrics + +`/opt/kuma_exporter.py` на CT107 (порт 3010), systemd-юнит `kuma-exporter`: + +* читает базу Kuma **только на чтение** (`mode=ro`); +* отдаёт метрики: + +``` +kuma_monitor_up{id,name} 1/0 +kuma_monitor_ping_ms{...} время отклика +kuma_monitors_total 62 +kuma_monitors_down 0 +``` + +### 2. Prometheus + +Добавлена задача `kuma` → `192.168.1.107:3010`. + +### 3. Grafana + +В дашборд `infra-v3` добавлены три панели: + +* **Kuma: недоступно** (stat, пороги 1 → оранжевый, 5 → красный); +* **Kuma: мониторов всего**; +* **Kuma: что недоступно** (таблица `kuma_monitor_up == 0`). + +## Разбор «лежащих» мониторов: было 7 → стало 0 + +| Монитор | Причина | Решение | +|---|---|---| +| Matrix Local/Offsite, Restore Test, Buryan Hub Backup | **push**-мониторы, их никто не пинговал | пинги из наших задач | +| Nextcloud | редирект на https с самоподписанным сертификатом | `maxredirects=0`, коды 200–399 | +| Mosquitto MQTT | в мониторе был хост `192.168.1.106` | исправлен на `192.168.1.107` | +| Zigbee2MQTT | UI не опубликован (контейнер в host-сети, порт занят) | приостановлен с пояснением | + +### Пинги в задачи + +`/opt/hub-core/kuma_ping.py` вызывается в: + +* `backup_configs.py` — конфиги; +* `db_dumps.py` — дампы баз; +* `drill.py` — тест восстановления; +* `/root/matrix-backups/backup-matrix.sh` — бэкап Matrix. + +Итог: **62 монитора, 0 недоступных**, всё видно в Prometheus и Grafana. + +## Ловушки + +1. **Копирование kuma.db без WAL** даёт устаревшие данные — свежие + heartbeat лежат в `-wal`. Экспортёр читает живую базу, поэтому корректен. +2. **DB-правки** требуют остановки контейнера: `docker stop uptime_kuma`, + правка, `pct push`, `chown 1000:1000`, `docker start`. +3. **API-ключи** Kuma не восстановить — только создать новый (bcrypt-хеш + можно вписать напрямую, что и сделано для будущих нужд).