Sommaire

Contexte

Le check InterfaceErrors Switch SNMPv1v2 va récupérer le taux moyen d'erreurs en entrée et en sortie des interfaces en utilisant les versions v1 ou v2 du protocole SNMP.


Paramétrage

Le check utilise la ligne de commande suivante :

$PLUGINSDIR$/check_nwc_health --hostname "$HOSTADDRESS$" --timeout "$_HOSTSWITCH_TIMEOUT$" --community 
"$_HOSTSNMPCOMMUNITY$" --mode interface-errors --port "$_HOSTSWITCH_PORT$" --statefilesdir 
"$_HOSTSWITCH_WORKING_FOLDER$" $_SERVICECUSTOM_THRESHOLD$

Données utilisées provenant du modèle

Données communes pour les checks du modèle

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
SNMPCOMMUNITY

l'Hôte

( Onglet Données )

--$SNMPCOMMUNITYREAD$ public

La Communauté SNMP v1/v2 défini sur votre switch :

  • En SNMP v1/v2, la communauté est un équivalent à un ID ou à un mot de passe pour se connecter aux équipements.
SWITCH_TIMEOUT

l'Hôte

( Onglet Données )

secondes60 60

Donnée permettant au check de s'arrêter après un certain temps si une tâche ne s'est pas terminée.

  • Permet d'éviter que le programme ne s'exécute indéfiniment et de prévenir des problèmes de performances.

( La valeur doit être supérieure à 3 )

SWITCH_PORT

l'Hôte

( Onglet Données )

--161161

Donnée correspondant au port SNMP sur lequel le démon SNMP de votre équipement écoute.

SWITCH_WORKING_FOLDER

l'Hôte

( Onglet Données )


/var/tmp/check_nwc_health/var/tmp/check_nwc_health

Dossier dans lequel la sonde stockera ses fichiers de travail 

Remarque

Par défaut, la donnée SNMPCOMMUNITY prend le contenu de la donnée globale $SNMPCOMMUNITYREAD$ dont la valeur est modifiable dans le fichier /etc/shinken/resource.d/snmp.cfg,

La modification des valeurs par défaut présentes dans le fichier du serveur ( /etc/shinken/resource.d/snmp.cfg ) nécessite un redémarrage des démons suivants :

  • Synchronizer pour le voir dans l'interface,
  • Arbiter pour que la modification soit prise en compte en supervision.


Donc, pour changer la valeur de SNMPCOMMUNITY, vous pouvez :

  • changer sa valeur dans un hôte,
  • changer sa valeur dans le modèle Switch-SNMPv1v2 ( mais cela impactera tous les hôtes utilisant ce modèle ).
  • modifier le contenu de la donnée globale $SNMPCOMMUNITYREAD$ ( en prenant en compte que tous les hôtes utilisant cette donnée seront impactés ).

Données spécifiques pour ce check

Pas de données spécifiques pour ce check

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check

Données utilisées provenant du check

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
CUSTOM_THRESHOLD

le check

( Onglet Données )

--__

Cette donnée permet de modifier les seuils ( CRITIQUE/ ATTENTION ) intégrés par défaut par la sonde 

( voir la page Modifier vos seuils des checks interfaceErrors et interfaceUsage )

Données globales

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--/var/lib/shinken/libexec/var/lib/shinken/libexec

Chemin absolu du dossier contenant la sonde ( non modifiable )

Propriétés de l'hôte

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
HOSTADDRESS

l'Hôte

( Onglet Général )

--

Nom de l'hôteNom de l'hôte

Adresse de l'hôte

Résultat

Exemple

Interprétation

Statut

Il peut prendre quatre valeurs OK/ CRITIQUE/ ATTENTION / INCONNU.

  • Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
    • CUSTOM_THRESHOLD, 
    • SWITCH_TIMEOUT

  • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

SituationStatut

En fonction du taux moyen d'erreurs :

  • Si c'est supérieur à la valeur --critical de CUSTOM_THRESHOLD 

CRITIQUE

En fonction du taux moyen d'erreurs :

  • Si c'est supérieur à la valeur --warning de CUSTOM_THRESHOLD

ATTENTION

Si la sonde n'a pas eu de réponse avant le temps maximum

  • Si supérieur à SWITCH_TIMEOUT( par défaut: 60 s )
INCONNU

Résultat

Renvoi la liste des interfaces réseau sous la forme "nom d'interface réseau" errors in:A% out:B% avec :

  • "nom d'interface réseau" : le nom de l'interface réseau
  • A : le taux d'erreurs moyen rentrant dans l'interface réseau depuis le dernier check
    ( le nombre de paquets comportant des erreurs reçus par l'interface entre deux checks )
  • B : le taux d'erreurs moyen sortant de l'interface réseau depuis le dernier check
    ( le nombre de paquets comportant des erreurs envoyés par l'interface entre deux checks )

Résultat Long

Pas de résultat long pour ce check.

Métriques

NomUnitésDescription
"nom d'interface réseau"_errors_in
%

Retourne le taux d'erreurs rentrant dans l'interface réseau depuis le dernier check.
( se répète pour chaque interface )

"nom d'interface réseau"_errors_out
%

Retourne le taux d'erreurs sortant de l'interface réseau depuis le dernier check.
( se répète pour chaque interface )