[MONITORING] Kuma-экспортёр, панели Grafana, пинги бэкапов; 0 недоступных мониторов
This commit is contained in:
1 parent
a1a719b514
commit
10e4c16c7e
1 file changed
+64
@@ -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-хеш
|
||||
можно вписать напрямую, что и сделано для будущих нужд).
|
||||
Reference in new issue
Block a user