From 10e4c16c7e00aa84f286065bc628ca0704de2a20 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Fri, 23 Oct 2026 21:20:10 +0300 Subject: [PATCH] =?UTF-8?q?[MONITORING]=20Kuma-=D1=8D=D0=BA=D1=81=D0=BF?= =?UTF-8?q?=D0=BE=D1=80=D1=82=D1=91=D1=80,=20=D0=BF=D0=B0=D0=BD=D0=B5?= =?UTF-8?q?=D0=BB=D0=B8=20Grafana,=20=D0=BF=D0=B8=D0=BD=D0=B3=D0=B8=20?= =?UTF-8?q?=D0=B1=D1=8D=D0=BA=D0=B0=D0=BF=D0=BE=D0=B2;=200=20=D0=BD=D0=B5?= =?UTF-8?q?=D0=B4=D0=BE=D1=81=D1=82=D1=83=D0=BF=D0=BD=D1=8B=D1=85=20=D0=BC?= =?UTF-8?q?=D0=BE=D0=BD=D0=B8=D1=82=D0=BE=D1=80=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/ops/KUMA-PROMETHEUS.md | 64 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 ops/ops/KUMA-PROMETHEUS.md 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-хеш + можно вписать напрямую, что и сделано для будущих нужд).