Contexte
Le check Node Network by API permet de vérifier l'état des interfaces réseau du nœud Proxmox supervisé.
Le changement de statut repose sur une seule règle :
Si l'une des interfaces détectées n'est pas dans un état de fonctionnement correct, alors le statut du check change automatiquement.
Ce check permet donc :
de repérer rapidement les problèmes réseaux,
de détecter une activité anormale.
Pour résumer, ce check est un indicateur utile pour assurer que les éléments de communication fonctionnent normalement sur 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_network"
--exclude $_HOSTPROXMOX-VE-BY-API__NETWORK__NETWORK-EXCLUDE$
--ssl-verify $_HOSTPROXMOX-VE-BY-API__SSL__USE-SSL$
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__NETWORK__NETWORK-EXCLUDE | l'Hôte ( Onglet Données ) | % | None | None | La liste des interfaces réseau à exclure des vérifications. Cette donnée n'est utilisée que pour le check " Node Network 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 2 états OK / CRITIQUE .
Le statut va dépendre du retour de sonde.
Ci-dessous, un tableau récapitulatif des différents retours possibles :
| Situation | Statut | Exemple |
|---|---|---|
| CRITIQUE | |
Résultat
Le résultat court affiche, en une ligne, un résumé de l'état des interfaces réseau détectées sur le nœud Proxmox. 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 détaillées sur l'état des interfaces.
Métriques
Pas de métriques pour ce check
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''}
