Contexte

Les checks que nous fournissons supervisent 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 ( voir la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken ).

Lister toutes les informations et options de la sonde 

La commande "/var/lib/shinken/libexec/check_nwc_health --help" donne la liste de tous les paramètres et options de la sonde.

[root@machine ~]# /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
 -V, --version
   Print version information
 -t, --timeout=INTEGER
   Seconds before plugin times out (default: 15)
 -v, --verbose
   Show details for command-line debugging (can repeat up to 3 times)
 --hostname
   Hostname or IP-address of the switch or router
 --port
   The SNMP port to use (default: 161)
 ...

( plus de détails sur le site du créateur de la sonde https://labs.consol.de/nagios/check_nwc_health/index.html )

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.

Voici un exemple concret pour créer une nouvelle commande qui permet de lister vos interfaces supervisables.

Le procédé est le même pour chaque version de SNMP.

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

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

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

[root@machine ~]# /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
 -V, --version
   Print version information
 ...
 --mode
   A keyword which tells the plugin what to do
       hardware-health                  (Check the status of environmental equipment (fans, temperatures, power))
       cpu-load                         (Check the CPU load of the device)
       memory-usage                     (Check the memory usage of the device)
       ...
       list-interfaces                  (Show the interfaces of the device and update the name cache)
       ...
 ...

Dans la recherche ci-dessus, on voit dans le paramètre "--mode", l'option "list-interfaces" correspondant au besoin et sera utilisée dans la nouvelle commande. 

Le clone d'une commande et sa modification

Cloner la commande check_switch_hardware_health.

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

( Voir la page Personnaliser une commande livrée par un pack Shinken )

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

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

Dans notre exemple, nous n'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 ).

( voir la page Créer un modèle d'hôte hérité d'un modèle livré dans un pack Shinken )

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 le nom, attaché sur le modèle d'hôte et la commande de vérification.

( Voir la page Créer un check attaché à un modèle d'hôte hérité d'un modèle livré dans un pack Shinken )

Confirmer le fonctionnement du nouveau check 

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.