Intégration Supervision hôte pour Gladys Assistant
Remonte l'usage CPU, la mémoire, l'espace disque et la température CPU de la machine hôte.
Publiée par prohand
- Appareils
- Version 1.0.2
- Nécessite Gladys >=4.86.0
- ★ 0
Cette intégration crée un appareil dans Gladys, qui représente la machine sur laquelle Gladys tourne, avec cinq capteurs :
| Capteur | Unité | Source |
|---|---|---|
| Utilisation CPU | % | /proc/stat |
| Utilisation mémoire | % | /proc/meminfo (MemAvailable) |
| Utilisation disque | % | statfs() sur le chemin surveillé |
| Espace disque libre | Gio | statfs() sur le chemin surveillé |
| Température CPU | °C | /sys/class/thermal ou hwmon |
Tout est lu localement, sur la machine : aucun agent à installer, aucun service cloud, aucune donnée qui sort de chez vous.
Installation
Nécessite Gladys 4.86 ou plus récent. Sur une version antérieure, l'intégration n'apparaît tout simplement pas dans le catalogue : mettez d'abord Gladys à jour.
- Installez l'intégration depuis le catalogue Gladys (catégorie Services).
- Ouvrez l'onglet Configuration et enregistrez (les valeurs par défaut conviennent dans la grande majorité des cas).
- Allez dans l'onglet Découverte : l'appareil « Machine hôte » apparaît, cliquez sur Ajouter.
Les premières valeurs sont publiées dans les secondes qui suivent, puis toutes les 5 minutes.
Fréquence de rafraîchissement et taille de la base
C'est le point important de cette intégration. Gladys écrit une ligne d'historique pour chaque valeur publiée : il n'y a pas de déduplication côté serveur. Un moniteur système qui publie 5 métriques toutes les 30 secondes écrit environ 5 millions de lignes par an, dont l'immense majorité répète la valeur précédente. Sur un Raspberry Pi avec une carte SD, cela se paie en place disque et en usure.
Trois garde-fous, réglables dans l'écran de configuration :
- Intervalle de rafraîchissement (300 s par défaut, minimum 60 s) — à quelle fréquence les métriques sont lues. L'intégration gère son propre minuteur : elle n'utilise pas le planificateur de Gladys, qui ne descend pas en dessous d'une lecture par minute.
- Variation minimale (2 points de % / 1 °C par défaut) — une valeur n'est publiée que si elle a bougé d'au moins ce seuil depuis la dernière valeur publiée. Une dérive lente finit donc toujours par franchir le seuil, mais le bruit de fond ne remplit plus la base. Mettez 0 pour tout publier.
- Intervalle maximum sans point (60 min par défaut) — même si rien ne bouge, chaque capteur est publié au moins une fois par heure, pour que les courbes restent continues.
Avec les réglages par défaut, une machine calme écrit typiquement quelques dizaines de lignes par jour au lieu de plusieurs dizaines de milliers.
L'option Conserver l'historique permet d'aller plus loin : décochée, les capteurs affichent toujours leur valeur en direct mais n'écrivent plus aucune ligne d'historique. Attention, ce réglage est appliqué à la création de l'appareil ; si l'appareil existe déjà, changez l'option directement sur la fiche de l'appareil dans Gladys (chaque capteur y a sa case « conserver l'historique »).
Espace disque : quel disque est mesuré ?
Un conteneur ne voit pas le système de fichiers de l'hôte, il voit le sien. Le
chemin par défaut /data est le volume monté par Gladys depuis l'hôte :
c'est le système de fichiers qui héberge vos données Gladys, donc celui dont
l'espace libre vous intéresse en pratique.
Pour surveiller un autre point de montage, renseignez son chemin dans Chemin du disque à surveiller — à condition qu'il soit visible depuis le conteneur.
Le pourcentage est calculé comme celui de la commande df : les blocs réservés
à root sont exclus, un disque ext4 fraîchement formaté affiche donc bien 0 % et
non 5 %.
Température du CPU
La sonde est détectée automatiquement parmi celles exposées par le noyau
dans /sys/class/thermal (Raspberry Pi et cartes ARM) et /sys/class/hwmon
(coretemp sur Intel, k10temp sur AMD…). Les sondes dont le nom désigne
clairement le CPU sont préférées.
Si votre machine n'expose aucune sonde (machine virtuelle, conteneur LXC, hôte non Linux), le capteur de température n'est simplement pas créé : les quatre autres fonctionnent normalement.
Si la sonde choisie n'est pas la bonne, utilisez le bouton Lister les sondes
de température : il affiche toutes les sondes visibles avec leur valeur
actuelle, et marque d'un > celle utilisée. Copiez le chemin qui vous convient
dans Sonde de température CPU.
Actions disponibles
- Lire les métriques maintenant — lit tout immédiatement et affiche le résultat sous le bouton, sans attendre le prochain rafraîchissement. C'est le test à faire en premier si une valeur vous semble fausse.
- Lister les sondes de température — voir ci-dessus.
Dépannage
Aucune valeur ne remonte. Vérifiez que l'appareil a bien été ajouté depuis l'onglet Découverte : tant qu'il n'est pas créé, Gladys ignore silencieusement les états publiés. Dès que vous l'ajoutez, l'intégration republie un instantané complet — les cinq métriques apparaissent donc en quelques secondes, sans attendre le prochain rafraîchissement ni le prochain point garanti.
L'appareil affiche « Pas de valeur récente ». Ce badge apparaît quand aucun état n'a été enregistré depuis 48 heures — donc, en pratique, jamais. Utilisez l'action Lire les métriques maintenant : elle termine par « N état(s) publié(s) ». Si N vaut au moins 1, l'intégration publie bien, et le problème est l'appariement des fonctionnalités décrit juste en dessous.
L'appareil a été créé par une version plus ancienne. Gladys ne met jamais à
jour les fonctionnalités d'un appareil déjà créé : republier l'appareil ne
rafraîchit que la fiche de l'écran Découverte. Un appareil créé avec d'anciens
identifiants garde donc ces identifiants, et les états publiés pour les nouveaux
sont jetés sans erreur visible (le serveur Gladys journalise DeviceFeature "..." not found (or not added to Gladys), skipping state update.).
L'intégration détecte ce cas au démarrage et l'affiche dans l'écran de
configuration. Le seul remède est de supprimer l'appareil dans Gladys puis de
le rajouter depuis l'écran Découverte. C'est également la marche à suivre pour
appliquer un changement de l'option Conserver l'historique, ou pour faire
apparaître la température sur un appareil créé avant la détection de la sonde.
La température est absente. C'est normal sur une VM. Utilisez l'action Lister les sondes de température pour confirmer que le noyau n'en expose aucune.
Les courbes sont en escalier. C'est le comportement attendu : entre deux points publiés, la valeur n'a pas bougé de plus que le seuil. Baissez la variation minimale si vous voulez plus de détail — au prix d'une base plus grosse.
Les valeurs semblent lissées. L'utilisation CPU publiée est la moyenne sur l'intervalle de rafraîchissement, pas un instantané : un pic de 2 secondes dans une fenêtre de 5 minutes reste peu visible. Réduisez l'intervalle si vous chassez des pics courts.
L'intégration journalise chaque lecture. Consultez les logs depuis l'interface
Gladys, avec LOG_LEVEL=debug pour le détail complet.
Paramètres de configuration
Voici les paramètres demandés par Supervision hôte dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Supervision de l'hôte | section | Non | Un appareil qui expose la santé de la machine qui fait tourner Gladys : usage CPU, usage mémoire, usage disque, espace disque libre et température du CPU. Tout est lu localement dans /proc et /sys, sans agent ni service cloud. |
| Nom de l'appareil | string | Non | Nom de l'appareil créé dans Gladys. Utile si vous supervisez plusieurs machines. |
| Chemin du disque à surveiller | string | Non | Chemin dont le système de fichiers est mesuré. La valeur /data par défaut est le volume de l'intégration, situé sur le même système de fichiers que vos données Gladys. |
| Sonde de température CPU (optionnel) | string | Non | Laissez vide pour une détection automatique. Sinon, le fichier sysfs à lire, par exemple /sys/class/thermal/thermal_zone0/temp. |
| Fréquence et historique | section | Non | Gladys écrit une ligne d'historique par valeur publiée : un moniteur laissé sans garde-fou remplit vite la base. L'intégration lit les métriques à son propre rythme et ne publie une valeur que si elle a bougé de plus que les seuils ci-dessous — avec un point garanti au moins une fois par intervalle maximum pour que les courbes restent continues. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture des métriques, en secondes. 300 s (5 minutes) suffit largement pour superviser un hôte. |
| Variation minimale (%) | number | Non | Une mesure en pourcentage n'est publiée que si elle a bougé d'au moins autant de points depuis la dernière valeur publiée. 0 publie chaque mesure. |
| Variation minimale (°C) | number | Non | Même seuil, appliqué à la température du CPU. |
| Intervalle maximum sans point (min) | number | Non | Même si rien ne bouge, chaque métrique est publiée au moins une fois par intervalle pour que les courbes gardent une ligne continue. |
| Conserver l'historique | boolean | Non | Appliqué à la création de l'appareil. Désactivez-le pour ne garder que les valeurs instantanées, sans aucune ligne d'historique. |
Comment installer Supervision hôte dans Gladys
- Dans Gladys, ouvrez Intégrations : Supervision hôte apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-host-monitoring:1.0.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-host-monitoring.
Supervision hôte nécessite Gladys >=4.86.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Supervision hôte est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation