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 commande
/var/lib/shinken/libexec/check_nwc_health --help |
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 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) |
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
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)
...
... |
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.
|
