Sommaire

Contexte

Le modèle Switch-SNMPv1v2-detailed permet d'avoir un point de vue plus détaillé sur chaque interface du switch, et donner des informations plus précises comme la mémoire RAM disponible et l'état du CPU.

Si le besoin de modifier certains éléments ( commandes, checks ou modèles d'hôtes ) se présente, il faut lire la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken ).

Sommaire des checks

NomDescription
Hardware Health Switch SNMPv1v2

Il vérifie le bon fonctionnement physique du matériel de l'appareil ( alimentation, ventilateurs, températures, disques… ).

( voir la page Hardware Health Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed )

Cpu Switch SNMPv1v2

Il récupère et affiche les informations concernant l'utilisation du/des processeur(s) du switch.

( voir la page Cpu Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed )

Memory Switch SNMPv1v2

Il récupère et affiche les informations sur l'utilisation mémoire du switch.

( voir la page Memory Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed )

$KEY$ : Errors Switch SNMPv1v2

( exemple : $KEY$ = Vlan201, Vlan202
       => Vlan201: Errors Switch SNMPv1v2
       => Vlan202: Errors Switch SNMPv1v2 )


Il récupère et affiche le taux moyen d'erreurs en entrée et en sortie des interfaces.

( voir la page $KEY$ : Errors Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed )


Utilise le mécanisme de DuplicateForEach ( Données SWITCH_INTERFACES )

$KEY$ : Status Switch SNMPv1v2

( exemple : $KEY$ = Vlan201, Vlan202
       => Vlan201: Status Switch SNMPv1v2
       => Vlan202: Status Switch SNMPv1v2 )


Il récupère et affiche les informations concernant le statut des interfaces réseaux de votre switch.

( voir la page $KEY$ : Status Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed )


Utilise le mécanisme de DuplicateForEach ( Données SWITCH_INTERFACES )

$KEY$ : Usage Switch SNMPv1v2

( exemple : $KEY$ = Vlan201, Vlan202
       => Vlan201: Usage Switch SNMPv1v2
       => Vlan202: Usage Switch SNMPv1v2 )


Il récupère et affiche les informations sur le volume d'utilisation de toutes les interfaces réseaux de votre switch.

( voir la page $KEY$ : Usage Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed )


Utilise le mécanisme de DuplicateForEach ( Données SWITCH_INTERFACES )

Les données

Les données communes

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

Les données spécifiques

Pour le check "Cpu Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed"

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
SWITCH_CPU_LOAD_CRIT

l'Hôte

( Onglet Données )

Pourcentage9090Valeur de charge à partir de laquelle le check passe en CRITIQUE.
SWITCH_CPU_LOAD_WARN

l'Hôte

( Onglet Données )

Pourcentage8080Valeur de charge à partir de laquelle le check passe en AVERTISSEMENT.


Pour le check "Memory Switch SNMPv1v2 - Modèle Switch-SNMPv1v2-detailed"



NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
SWITCH_MEMORY_USAGE_CRIT

l'Hôte

( Onglet Données )

Pourcentage9090Valeur de charge à partir de laquelle le check passe en CRITIQUE.
SWITCH_MEMORY_USAGE_WARN

l'Hôte

( Onglet Données )

Pourcentage8080Valeur de charge à partir de laquelle le check passe en AVERTISSEMENT.

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) :

Utilisation

Il vous faudra saisir les noms des interfaces à surveiller :

  • Dans l'exemple ci-dessous, le modèle liste par défaut les interfaces appelées port1 et port2.



  • Changer cette liste avec les noms qui concernent votre équipement :
    • Par exemple Eth1, Eth2, Eth3, pour avoir les checks surveillant ces interfaces.


Pour cette donnée, 

  • La virgule sert de séparateur.
  • Vous pouvez mettre n'importe quelle chaîne de caractères.

    • Si vous voulez surveiller les interfaces réseaux non continues, comme les Eth1, Eth2, Eth3 et Eth9, Eth10, il vous suffit d'en faire la liste :

      Eth1,Eth2,Eth3,Eth9,Eth10

Astuce

Si vous voulez générer une liste de 256 ports de la forme Eth0,Eth1, Eth2, ... Eth255, le faire à la main serait très fastidieux !


Nous avons donné la possibilité de générer AUTOMATIQUEMENT les nombres :

  • La syntaxe [nombre1-nombre2] permet de générer plusieurs valeurs
  • donc pour avoir notre liste, saisissez Eth[0-255] 


SyntaxeRésultatsCommentaire
Eth[5-9]Eth5,Eth6,Eth7,Eth8,Eth9Pour une liste d'interfaces continues
Eth[5-9], Eth[60-65]Eth5,Eth6,Eth7,Eth8,Eth9,Eth60,Eth61,Eth62,Eth63,Eth64,Eth65Pour faire des sauts entre plusieurs listes d'interfaces continues
Eth[2-3][0-5]Eth20,Eth21,Eth22,Eth23,Eth24,Eth25,Eth30,Eth31,Eth32,Eth33,Eth34,Eth35Pour faire un saut régulier entre des listes d'interfaces

La génération de la liste des valeurs souhaitées se fera par l'Arbiter après la mise en production, elle sera visible uniquement dans l'interface de visualisation, du coté de l'interface de production la syntaxe du DFE ne seras pas interprétée.

Comment appliquer un modèle d'hôte à un hôte

Application du modèle via l'interface de Configuration

Dans l'interface de Configuration :

  • créer ou éditer un hôte ( voir la page Editer un Hôte ),
  • ajouter le modèle "My_template" dans la propriété "Modèles d'hôte hérités" à l'aide du menu déroulant.



Application du modèle via un collecteur d'import de fichiers au format .cfg

Dans votre fichier de définition de vos éléments à importer via votre collecteur :

define host {
    host_name   My_host
    use         My_template
}