Contexte
Le check Node Disks Health by API permet de vérifier l'état des disques utilisés par le nœud Proxmox.
Sur un nœud Proxmox, les disques sont généralement utilisés en permanence. Cette permanence crée de l'usure qui à terme, impacte les performances des disques.
Le changement de statut repose sur une seule règle :
Si le taux d'usure d'un des disques dépasse les seuils définis ( warning ou critical ), alors le statut du check change automatiquement.
Ce check permet donc :
d'anticiper les problèmes matériels,
de comprendre les activités anormales,
de prévenir une coupure de service.
Pour résumer, ce check est un indicateur vital pour s'assurer du bon fonctionnement des disques utilisés par un nœud Proxmox.
Paramétrage
Le check utilise la ligne de commande suivante :
$GLOBAL_PROXMOX-VE-BY-API_PLUGINSDIR$/check_proxmox_ve.py
--host $HOSTADDRESS$
--node-name $_HOSTPROXMOX-VE-BY-API__NODE-NAME$
--user $_HOSTPROXMOX-VE-BY-API__USER$
--token $_HOSTPROXMOX-VE-BY-API__TOKEN$
--mode "node_disks"
--warn $_HOSTPROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-WARN$
--crit $_HOSTPROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-CRIT$
--ssl-verify $_HOSTPROXMOX-VE-BY-API__SSL__USE-SSL$
--exclude $_HOSTPROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-EXCLUDE$
Données utilisées provenant du modèle
Données communes pour les checks du modèle
l'Hôte ( Onglet Données ) $HOSTNAME$ Le nom du nœud Proxmox supervisé. Il faut utiliser le nom du nœud correspondant à l'adresse IP de l'hôte :
Si l'adresse IP de l'hôte Shinken est 172.17.0.14, alors PROXMOX-VE-BY-API__NODE-NAME doit être exemple-shinken-proxmox-cluster01. l'Hôte ( Onglet Données ) 8006 Le port utilisé pour accéder à l'API. Par défaut, il s'agit du même port que celui de l'interface de configuration et de gestion Proxmox. l'Hôte ( Onglet Données ) True Le mode de gestion SSL : l'Hôte ( Onglet Données ) shinken:secret Combinaison du nom de la clé API et de la clé API. l'Hôte ( Onglet Données ) shinken@pve Nom de l'utilisateur Proxmox à utiliser pour la connexion.Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation du pack Description PROXMOX-VE-BY-API__NODE-NAME
-- $HOSTNAME$ PROXMOX-VE-BY-API__PORT
-- 8006 PROXMOX-VE-BY-API__SSL__USE-SSL
-- True PROXMOX-VE-BY-API__TOKEN
-- shinken:secret PROXMOX-VE-BY-API__USER
-- shinken@pve
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-CRIT | l'Hôte ( Onglet Données ) | % | 90 | 90 | Définit le pourcentage d'usure à partir duquel le check passe en CRITIQUE.
|
PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-WARN | l'Hôte ( Onglet Données ) | % | 80 | 80 | Définit le pourcentage d'usure à partir duquel le check passe en ATTENTION .
|
PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-EXCLUDE | l'Hôte ( Onglet Données ) | % | None | None | La liste des disques à exclure des vérifications. Cette donnée n'est utilisée que pour le check "Node Disks Health by API". |
Données DFE ( Duplicate Foreach )
Pas de données DFE pour ce check
Données utilisées provenant du check
Pas de données provenant du check pour ce modèle
Non modifiable ( Sauf Admin Shinken ) Chemin absolu contenant les sondes installées par Shinken. Non modifiable ( Sauf Admin Shinken ) Dossier fourni par Shinken. Non modifiable ( Sauf Admin Shinken ) Dossier contenant les sondes. Non modifiable ( Sauf Admin Shinken ) Chemin absolu du dossier contenant les sondes du pack proxmox-ve-by-API__shinken ( non modifiable ). l'Hôte ( Onglet Général ) -- Adresse de l'hôteDonnées globales
Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation Description USERPLUGINSDIR
-- /var/lib/shinken-user/libexec /var/lib/shinken-user/libexec GLOBAL_PROXMOX-VE-BY-API_VENDOR
-- shinken-additional-packs shinken-additional-packs GLOBAL_PROXMOX-VE-BY-API_PACKNAME
proxmox-ve-by-API__shinken proxmox-ve-by-API__shinken GLOBAL_PROXMOX-VE-BY-API_PLUGINSDIR
-- $USERPLUGINSDIR$/$GLOBAL_PROXMOX-VE-BY-API_PACKNAME$/$GLOBAL_PROXMOX-VE-BY-API_PACKNAME$
/var/lib/shinken-user/libexec/shinken-additional-packs/proxmox-ve-by-API__shinken Propriétés de l'hôte
Nom Modifiable sur Unité Défaut Valeur par défaut Description HOSTADDRESS
Nom de l'hôte Nom de l'hôte
Résultat
Exemple
Interprétation des données
Statut
Il peut prendre 3 états OK / CRITIQUE / ATTENTION .
Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
- PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-WARN
- PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-CRIT
Ci-dessous, un tableau récapitulatif des différents retours possibles :
Le texte de la colonne "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.
| Situation | Statut | Exemple |
|---|---|---|
| ATTENTION |
|
| CRITIQUE |
Résultat
Le résultat court affiche, en une ligne, un résumé de l'état des disques détectés. Ce retour compact permet de pouvoir visualiser l'information même avec la taille des lignes réduite dans l'interface de visualisation.
Résultat Long
Le résultat long affiche un tableau regroupant des informations complémentaires sur l'état d'usure des disques détectés.
Métriques
Interprétation des métriques
| Nom de la métrique | Unité | Description | Seuil d'avertissement | Seuil critique |
|---|---|---|---|---|
| (disk-name)_wearout | % | Pourcentage d'usure du disque. | PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-WARN | PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-WEAROUT-CRIT |
Exemple
Erreurs et pré-requis
Le nœud Proxmox n'a pas pu être contacté.
Résolution : Possibles raisons : Le nom du nœud indiqué dans la donnée "PROXMOX-VE-BY-API__NODE-NAME" n'a pas été trouvé.
L'authentification au nœud Proxmox a échoué.
Résolution : Possibles raisons :Erreurs de connexion ( communes à tous les checks )
UNKNOWN – No route to host.
UNKNOWN – 500 Internal Server Error : RRD error: rrdcached@unix:/var/run/rrdcached.sock: rrd_fetch_r failed: opening '/var/lib/rrdcached/db/pve-node-9.0/alpachouette-prox0': No such file or directory
UNKNOWN – 401 Unauthorized: Authentication failed! - {'errors': b''}









