Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

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 .

La récupération utilise le protocole SNMP ( V1 ou V2 ).

Paramétrage

Données du modèle utilisé

NomUnitésDéfautValeur par défaut à l'installation de ShinkenDescription
Code Block
SNMPCOMMUNITY
--$SNMPCOMMUNITYREAD$ public

Doit correspondre à la Communauté SNMP v1/v2 défini sur votre switch :

  • En SNMP v1/v2, la communauté est un équivalent du mot de passe pour se connecter sur les équipements.
Code Block
SWITCH_TIMEOUT
secondes60 60

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

  • Cela permet d'éviter que le programme ne s'exécute indéfiniment et de prévenir des problèmes de performances.
Code Block
SWITCH_PORT
--161 161

Cette variable correspond au port snmp sur lequel le démon snmp de votre équipement écoute

Code Block
SWITCH_WORKING_FOLDER
--/var/tmp/check_nwc_health/var/tmp/check_nwc_health

Permet de partager les données en cas de shinken avec plusieurs Pollers

en utilisant les versions v1 ou v2 du protocole SNMP.


Panel

Image Added



Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagetext
themeEmacs
$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

Excerpt Include
Modèle Switch-base ( uniquement pour les admins Shinken )
Modèle Switch-base ( uniquement pour les admins Shinken )
nopaneltrue

Données spécifiques pour ce check

Pas de données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )

Excerpt Include
Modèle Switch-SNMPv1v2-detailed
Modèle Switch-SNMPv1v2-detailed
nopaneltrue

Données utilisées provenant du check

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
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 )

Excerpt Include
$KEY$ Errors Switch SNMPv1v2
$KEY$ Errors Switch SNMPv1v2
nopaneltrue

Excerpt Include
InterfaceErrors Switch SNMPv1v2
InterfaceErrors Switch SNMPv1v2
nopaneltrue

Données du check

Pas de données spécifique disponible pour ce check.

Résultat

Exemple

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

Panel

Image RemovedImage Added

Interprétation

des données

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 "nomd'interface réseau" usage is in:A% (Xbits/s) out:B% (Ybits/s) avec :

Le résultat se forme de la façon suivante : 

  • Le statut du check ( OK / WARNING / CRITICAL / UNKNOWN ).
  • La mention : "nom d'interface réseau" is in : X.XX% (Xbits/s) out : X.XX% (Ybits/s)

    • "nom d'interface réseau"  : le nom de l'interface réseau pour laquelle vous obtiendrez les informations suivantes : 
    • in : X.XX% étant le taux moyen d'informations rentrant dans l'interface réseau
    • (Xbits/s) : la vitesse du débit entrant dans l'interface réseau (en bits par seconde )
    • out X.XX% étant le taux moyen d'informations sortant de l'interface réseau
    • (Ybits/s) : la vitesse du débit sortant de l'interface réseau ( en bits par seconde

    Métriques

    • ,
    • 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
    No Format
    Nom de la métriqueDescriptionUnités
    "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.
    %
    No Format
    "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.
    %
    No Format
    "nom_d'interface_réseau"_traffic_in
    bits par seconde

    Vitesse du débit entrant.

    bits par seconde
    No Format
    "nom_d'interface_réseau"_traffic_out
    bits par seconde

    Vitesse du débit sortant

    bits par seconde

    .