Page History

Contexte

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

Or, la La sonde fournie avec le pack met à disposition bien plus de possibilités ( --units, --blacklist, --verbose 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 nouvelles commandes qui prendront en compte d'autres informations non traitées par Shinken.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 sonde mise à disposition par Shinken propose une liste exhaustive d'arguments supplémentaires.

Pour la trouver, il vous faudra utiliser la commande suivante :

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

Comment créer des commandes et checks

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 switchDans un premier temps, il vous sera nécessaire de créer une nouvelle commande ( voir la page Les commandes ) avec les arguments supplémentaires que vous aurez choisis.

Il vous faudra ensuite créer un check contenant cette commande ( voir la page Les Checks ).

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 SNMPPour finir, vous devrez créer ou modifier votre hôte pour qu'il prenne en compte ce nouveau check ( voir la page Les Hôtes).

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

Création de la nouvelle commande 

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.

Après avoir sélectionné la commande que l'on veut modifier, nous allons cloner la commande  :

Une fois dans le menu de la commande, il faut lui donner un nom, une ligne de commande et le pack associé a la commande. Dans notre exemple, nous aurons les paramètres suivants :

• Nom de la Commande :
  • check_switch_list_interfaces
• Ligne de commande :

  • Code Block
    $PLUGINSDIR$/check_nwc_health --hostname "$HOSTADDRESS$" --timeout "$_HOSTSWITCH_TIMEOUT$" --community "$_HOSTSNMPCOMMUNITY$" --port "$_HOSTSWITCH_PORT$" --statefilesdir "$_HOSTSWITCH_WORKING_FOLDER$" --mode list-interfaces

• Pack :
  • switch-snmp

Ce qui nous donne une interface comme celle-ci :