Sommaire

Contexte

Le check $KEY$ : Usage Switch SNMPv3 va récupérer les informations concernant le volume d'utilisation d'une interface réseau de votre switch en utilisant la version 3 du protocole SNMP.


Paramétrage

Le check utilise une des lignes de commandes suivantes selon le modèle d'hôte utilisé :


  • Connexion de type noAuthNoPriv :
$PLUGINSDIR$/check_nwc_health --hostname "$HOSTADDRESS$" --protocol 3 --timeout "$_HOSTSWITCH_TIMEOUT$" --username "$_HOSTSNMP_LOGIN$" --contextname
"$_HOSTSNMP_CONTEXT$" --mode interface-usage --name "$ARG1$" --port "$_HOSTSWITCH_PORT$" --statefilesdir "$_HOSTSWITCH_WORKING_FOLDER$"
$_SERVICECUSTOM_THRESHOLD$
  • Connexion de type authNoPriv :
$PLUGINSDIR$/check_nwc_health --hostname "$HOSTADDRESS$" --protocol 3 --timeout "$_HOSTSWITCH_TIMEOUT$" --username "$_HOSTSNMP_LOGIN$" --contextname
"$_HOSTSNMP_CONTEXT$" --authpassword "$_HOSTSWITCH_PASSPHRASE_AUTH$" --authprotocol "$_HOSTSWITCH_PROTOCOL_AUTH$" --mode interface-usage --name "$ARG1$"
--port "$_HOSTSWITCH_PORT$" --statefilesdir "$_HOSTSWITCH_WORKING_FOLDER$" $_SERVICECUSTOM_THRESHOLD$
  • Connexion de type authPriv : 
$PLUGINSDIR$/check_nwc_health --hostname "$HOSTADDRESS$" --protocol 3 --timeout "$_HOSTSWITCH_TIMEOUT$" --username "$_HOSTSNMP_LOGIN$" --contextname
"$_HOSTSNMP_CONTEXT$" --authpassword "$_HOSTSWITCH_PASSPHRASE_AUTH$" --authprotocol "$_HOSTSWITCH_PROTOCOL_AUTH$" --privpassword
"$_HOSTSWITCH_PASSPHRASE_PRIV$" --privprotocol "$_HOSTSWITCH_PROTOCOL_PRIV$" --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
SNMP_LOGIN

l'Hôte

( Onglet Données )

--shinkenshinken

Un nom d'utilisateur SNMP v3 défini sur votre switch :

  • Un nom unique qui identifie l'utilisateur SNMPv3
SNMP_CONTEXT

l'Hôte

( Onglet Données )

--publicpublic

Le contexte SNMPv3 permet d'identifier et d'isoler un espace de gestion spécifique sur un agent réseau SNMPv3. Il est utilisé pour définir un domaine de gestion distinct au sein d'un même appareil réseau, permettant ainsi de segmenter et d'organiser les données SNMPv3.

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. ( par défaut 161 )

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 

Mode de connexion noAuthNoPriv

Pas de données communes supplémentaires pour ce type de connexion SNMPv3


Mode de connexion authNoPriv
NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
SWITCH_PROTOCOL_AUTH

l'Hôte

( Onglet Données )

--MD5MD5Protocole utilisé pour vérifier l'authenticité des messages SNMPv3
SWITCH_PASSPHRASE_AUTH

l'Hôte

( Onglet Données )

--shinkenpasswordshinkenpassword Chaîne secrète utilisée pour vérifier l'authenticité des messages SNMPv3
Mode de connexion authPriv
NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription


SWITCH_PROTOCOL_AUTH

l'Hôte

( Onglet Données )

--MD5MD5Protocole utilisé pour vérifier l'authenticité des messages SNMPv3


SWITCH_PASSPHRASE_AUTH

l'Hôte

( Onglet Données )

--shinkenpasswordshinkenpassword Chaîne secrète utilisée pour vérifier l'authenticité des messages SNMPv3.


SWITCH_PROTOCOL_PRIV

l'Hôte

( Onglet Données )

--DESDES

Protocole utilisé pour chiffrer les données SNMPv3


SWITCH_PASSPHRASE_PRIV

l'Hôte

( Onglet Données )

--shinkencryptionkeyshinkencryptionkey

Chaîne secrète utilisée pour chiffrer et déchiffrer les données SNMPv3.


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.