Page History

Contexte

Les checks que nous fournissons supervise qu'une partie des éléments d'un switch.

La sonde fournie avec le pack met à disposition plus d'une centaine informations/options ( interface-health, interface-uptime, svn-status ... ).

Pour des besoins plus précis, il vous sera nécessaire de créer de nouveaux checks qui permettront de superviser plus d'éléments.

Lister toutes les informations et options de la sonde 

La sonde mise à disposition par Shinken propose une liste exhaustive d'informations et d'options, disponible avec la commande suivante :

/var/lib/shinken/libexec/check_nwc_health --help

Vous obtiendrez un résultat comme celui-ci ( ceci n'est qu'un extrait de tout le résultat ) :

[root@localhost ~]# /var/lib/shinken/libexec/check_nwc_health --help
check_nwc_health $Revision: 10.12.1 $ [http://labs.consol.de/nagios/check_nwc_health]

This monitoring plugin is free software, and comes with ABSOLUTELY NO WARRANTY.
It may be used, redistributed and/or modified under the terms of the GNU
General Public Licence (see http://www.fsf.org/licensing/licenses/gpl.txt).

This plugin checks various parameters of network components

Usage: check_nwc_health [ -v|--verbose ] [ -t <timeout> ] --mode <what-to-do> --hostname <network-component> --community <snmp-community>  ...]
 -?, --usage
   Print usage information
 -h, --help
   Print detailed help screen

Faire un nouveau check 

Pour pouvoir superviser de nouveaux éléments de votre switch, il vous sera nécessaire de créer des nouveaux checks.

Dans un premier temps, nous vous conseillons de lire les bonnes pratiques quand on veut compléter un pack livré par Shinken.

Ensuite, nous vous pouvez suivre l'exemple concret ci-dessous

Exemple : création d'une commande qui liste les interfaces réseaux 

Rechercher un paramètre dans la commande qui répond à notre besoin

A l'aide de la commande :

/var/lib/shinken/libexec/check_nwc_health --help

On trouve un argument qui décrit ce que l'on cherche :

 list-interfaces                  (Show the interfaces of the device and update the name cache)

On modifiera donc le paramètre mode de la commande par list-interfaces.

Le clone d'une commande et sa modification

Cloner la commande check_switch_hardware_health.

Éditer la nouvelle commande en changeant au minimum le nom et la ligne de commande.

Création du nouveau modèle d'hôte

On vous conseille de créer un nouveau modèle et de ne pas modifier ceux fournis dans le pack par Shinken.

Dans notre exemple, nous utilisons que le modèle switch-base, mais dans d'autres cas, il pourrait être utile d'utiliser les autres modèles fournis par le pack ( Switch-SNMPv1v2, Switch-SNMPv1v2-detailed).

Création du check appliqué à notre nouveau modèle d'hôte

Cloner le check Hardware Health Switch SNMPv1v2.

Éditer le nouveau check en changeant au minimum le nom, attaché sur le modèle d'hôte et la commande de vérification.

Nous vous conseillons de faire un essai de check sur l'hôte dans lequel vous avez attaché le modèle avant de pousser vos nouveautés en production.