[MONITORING] Kuma-экспортёр, панели Grafana, пинги бэкапов; 0 недоступных мониторов

This commit is contained in:
buryan-agent committed 2026-10-23 21:20:10 +03:00
1 parent a1a719b514
commit 10e4c16c7e
1 file changed
+64
+64
View File
@@ -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-хеш
можно вписать напрямую, что и сделано для будущих нужд).