Versions Compared

Old Version 50

changes.mady.by.user Quentin Soubeyrol

Saved on

compared with

New Version Current

changes.mady.by.user Soubrié Grégoire

Saved on

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 InterfaceUsage Switch SNMPv1v2 va récupérer les informations concernant le volume d'utilisation de toutes les interfaces réseaux de votre switch en utilisant les versions v1 ou v2 du protocole SNMP.

Panel

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 --port "$_HOSTSWITCH_PORT$" --statefilesdir "$_HOSTSWITCH_WORKING_FOLDER$"

Données

du modèle utilisé

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

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check

Données utilisées provenant du check

NomModifiable surUnité
NomUnités
DéfautValeur par défaut à l'installation de ShinkenDescription
Code BlockSNMPCOMMUNITY
No Format
CUSTOM_THRESHOLD

le check

( Onglet Données )

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

Info

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,
  • 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 ).

Résultat

Exemple

Panel

Image Removed

Interprétation des 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

Résultat

Exemple

Panel

Image Added

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

  • Statut : Le statut peut prendre les 4 valeurs différentes ( OK / WARNING / CRITICAL /  UNKNOWN ).
    • Résultat :
    Liste des interfaces réseau

    sous la forme "nomd'interface réseau" usage is in:

    X.XX%

    A% (X

    .XXbits

    bits/s) out:

    X.XX% (X.XXbits

    B% (Ybits/s) avec :

    • "nom d'interface réseau" : le nom de l'interface réseau,
    • in A : le pourcentage d'utilisation de l'interface en entréeet entre parenthèse la valeur en bit par seconde du trafic entrant de l'interface,
    • B out : le pourcentage d'utilisation de l'interface en sortieet entre parenthèse
    • X/Y : la valeur en bit par seconde du trafic sortant de l'interface. ( en bits par seconde )

    Résultat Long

    Pas

    :  pas

    de résultat long pour ce check.

    Métriques

    NomUnitésDescription
    Code Blocknoformat
    "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.
    Code Blocknoformat
    "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.
    Code Blocknoformat
    "nom d'interface réseau"_traffic_in
    		bits par seconde

    Valeur en bits par seconde du trafic entrant sur l'interface.

    Code Blocknoformat
    "nom d'interface réseau"_traffic_out
    		bits par seconde

    Valeur en bits par seconde du trafic sortant sur l'interface.

    ...