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$"

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

Variable 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

Variable 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

Pas de données provenant du check pour ce modèle

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 des données

  • Statut : Le statut peut prendre 4 valeurs différentes ( OK / WARNING / CRITICAL /  UNKNOWN ).
    • Le seuil du statut WARNING est 800 000 000 bit/s ( 100 Mo/s )
    • Le seuil du statut CRITICAL est 900 000 000 bit/s ( 112 Mo/s )
  • Résultat :
    La mention est sous la forme "nom d'interface réseau" is in:A% (Xbit/s) out:B% (Ybit/s) :
    • "nom d'interface réseau" le nom de l'interface réseau pour laquelle vous obtiendrez les informations suivantes : 
    • A : le taux moyen d'informations rentrant dans l'interface réseau,
    • B : taux moyen d'informations sortant de l'interface réseau,
    • X/Y : la vitesse du débit entrant dans l'interface réseau ( 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.