Sommaire

Contexte

Le check $KEY$ : Usage Switch SNMPv1v2 va récupérer les informations concernant le volume d'utilisation d'une interface réseau de votre switch 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-usage
--name "$ARG1$" --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

Les données DFE ( Duplicate Foreach )

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
SWITCH_INTERFACES

l'Hôte

( Onglet Données )

---port1,port2port1,port2

Nom de ou des interfaces ( séparés par une virgule ), exemple "Vlan01,Vlan02,Vlan03".

Check(s) impacté(s) :

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

Ci-dessous, vous avez le check correspondant à l'interface "Vlan201".

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 volume d'utilisation de toutes les interfaces réseaux :

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

CRITIQUE

En fonction du volume d'utilisation de toutes les interfaces réseaux :

  • 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éseaux sous la forme "nom d'interface réseau" usage is in:A% (Xbits/s) out:B% (Ybits/s) avec :

  • "nom d'interface réseau" : le nom de l'interface réseau,
  • A : le pourcentage d'utilisation de l'interface en entrée
  • B : le pourcentage d'utilisation de l'interface en sortie
  • X/Y : la valeur du trafic de l'interface ( en bits par seconde )

Résultat Long

Pas de résultat long pour ce check.

Métriques

NomUnitésDescription
"nom_d'interface_réseau"_usage_in
%Pourcentage utilisé entrant suivant la capacité maximale de l'interface utilisée ( 100Mb/s, 1Gb/s... ), cela dépend de votre interface et sa configuration.
"nom_d'interface_réseau"_usage_out
%Pourcentage utilisé sortant suivant la capacité maximale de l'interface utilisée ( 100Mb/s, 1Gb/s... ), cela dépend de votre interface et sa configuration.
"nom_d'interface_réseau"_traffic_in
bits par seconde

Vitesse du débit entrant.

"nom_d'interface_réseau"_traffic_out
bits par seconde

Vitesse du débit sortant.