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

Données spécifiques pour ce check

Pas de données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )

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 )

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.