Uptime Kuma¶

Outil de monitoring auto-hébergé pour surveiller la disponibilité des services et hôtes de l'infrastructure. Remplace les checks manuels et envoie des alertes en cas de panne.

Informations¶

Token API Proxmox¶

Token en lecture seule utilisé par les moniteurs JSON Query pour consulter l'API Proxmox.

Ignorer erreur TLS sur les endpoints Proxmox (certificat auto-signé).

⚠️ Après migration/réinstallation PVE : l'utilisateur monitoring@pve et son token sont dans /etc/pve/ (rootfs host), non sauvegardés par PBS. Les recréer via restore-host-artefacts.sh (voir ci-dessous).

Restauration après migration PVE¶

En cas de réinstallation du host Proxmox (migration disque, disaster recovery), les artefacts suivants sont perdus car ils sont dans rpool/ROOT (non couvert par PBS) :

Restauration en une commande :

bash /mnt/lxc-data/101-admin/uptime-kuma/restore-host-artefacts.sh

Ce script (idempotent) recrée le user/token PVE, installe Glances, régénère les scripts cron depuis les tokens stockés dans kuma.db, et patche la DB Kuma avec le nouveau token.

Glances (Host PVE)¶

Glances est installé directement sur le host Proxmox (apt install glances) et exposé comme service systemd sur le port 61208.

Rôle dans Uptime Kuma¶

Glances est utilisé uniquement pour le monitor HTTP "Glances (PVE Host)" (groupe Proxmox Host) — il vérifie que le service tourne et répond.

Il n'est plus utilisé pour lire les températures ou les vitesses ventilateurs. Depuis la session 3 (2026-04-02), le script monitor-thermals.sh utilise directement sensors (lm-sensors) pour lire coretemp-isa-0000 (CPU) et it8628-isa-0a40 (carte mère + ventilateurs).

Prérequis module it87¶

Le capteur it8628-isa-0a40 (puce IT8628E) nécessite que le module kernel it87 soit chargé :

# Chargement immédiat
modprobe it87

# Persistance (survit au reboot)
# /etc/modules-load.d/it87.conf contient : it87

Sans ce module, sensors ne liste pas les capteurs MB/fans — ni les températures carte mère, ni les vitesses ventilateurs.

Indépendance des monitors¶

Le service Glances est indépendant du monitoring thermique :

• Si Glances s'arrête → seul le monitor "Glances (PVE Host)" passe DOWN
• Les monitors Températures & Ventilateurs continuent de fonctionner (ils n'utilisent plus Glances)
• La perte du module it87 (ex. après réinstallation kernel) est la vraie cause de panne des capteurs MB/fans

# Vérifier l'état des capteurs après reboot
sensors coretemp-isa-0000
sensors it8628-isa-0a40
# Si erreur « No sensors found » : modprobe it87

Configuration des Moniteurs¶

Groupe : Réseau¶

Groupe : Proxmox Host¶

Groupe : LXC – Statuts (via API Proxmox)¶

Pour chaque LXC, vérifie que chaque conteneur est running du point de vue de Proxmox.

• Type : HTTP(s) – JSON Query
• URL : `https://192.168.1.21:8006/api2/json/nodes/pve/lxc/{ID}/status/current |
• Json Path : $.data.status |
• Valeur attendue : running |

LXC couverts : 100 (Media), 101 (Management), 102 (PBS), 103 (Gateway), 104 (Services), 105 (Web).

Groupe : LXC 100 – Média¶

Chaque service exposé en HTTP à http://192.168.1.100.

Voir LXC 100

Groupe : LXC 101 – Management¶

Groupe : LXC 102 – PBS¶

Groupe : LXC 103 – Network Gateway¶

Groupe : LXC 104 – Services¶

Groupe : LXC 105 – Web¶

Monitors de type HTTP(s) vers les URLs directes des services WordPress.

⚠️ Investigation en cours (2026-04-02) : les ports 801x ne sont pas joignables depuis le réseau local — monitors en état DOWN, cause non résolue. Anciennement en type Port TCP (idem symptôme).

Groupe : Domaines HTTPS publics (SSL)¶

Vérifie la disponibilité et la validité du certificat SSL (alerte à J-14 avant expiry).

Groupe : Espaces Disques¶

Moniteurs de type Push — le host Proxmox envoie les métriques via cron toutes les 3 min.

Script : /usr/local/bin/monitor-disk-space.sh
Cron : /etc/cron.d/monitor-disk-space (*/3 * * * *)

Architecture post-migration NVMe/ZFS (2026-04-02) — LVM thin pool remplacé par ZFS avec quotas.

ping = % utilisé (graphe historique) ; msg = détail espace libre.

Groupe : Températures & Ventilateurs¶

Moniteurs de type Push — le host Proxmox envoie les métriques via cron toutes les 3 min.

Sources : sensors coretemp-isa-0000 (CPU) + sensors it8628-isa-0a40 (carte mère + fans) via lm-sensors + smartctl
Script : /usr/local/bin/monitor-thermals.sh
Cron : /etc/cron.d/monitor-thermals (*/3 * * * *)

Prérequis : module it87 chargé (puce IT8628E) — persisté dans /etc/modules-load.d/it87.conf. Sans ce module, lm-sensors ne voit pas les capteurs MB/fans.

Pas de ventilateur CPU dédié — fan2 et fan3 sont les deux ventilateurs boîtier. Capteurs bogus exclus (tensions mal étiquetées comme températures).
ping = valeur brute (°C ou RPM) pour le graphe historique.