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

/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 ) :donne la liste de tout les paramètres et options de la sonde.

[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  Print usage information
  -h, --help
    Print 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)

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, 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 On trouve un argument qui décrit ce que l'aide de la commande on cherche :

[root@machine ~]# /var/lib/shinken/libexec/check_nwc_health --help

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

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

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.