Chapitre 37. Commandes externes

Introduction

Nagios peut traiter des commandes d'applications externes (y compris les CGIs, voir CGI de commande à titre d'exemple) et modifier de nombreux aspects de ses fonctions de supervision suivant les commandes qu'il reçoit.

Autoriser les commandes externes

Par défaut, Nagios ne contrôle, ni ne traite les commandes externes. Si vous voulez autoriser le traitement des commandes externes, il faut effectuer les actions suivantes…

Activer le contrôle des commandes externes à l'aide de l'option check_external_commands
Régler la fréquence des contrôles de commande à l'aide de l'option command_check_interval
Préciser l'emplacement du fichier de commandes à l'aide de l'option command_file .
Configurer les bonnes autorisations pour le répertoire contenant les fichiers de commandes. Des détails sur la manière de faire cela se trouvent ici.

Quand Nagios contrôle-t-il les commandes externes ?

A intervalles réguliers précisés par l'option command_check_interval du fichier de configuration principal.
Immédiatement après que les gestionnaires d'événements soient exécutés. Cela s'effectue en plus du cycle régulier des contrôles de commandes externes et sert à fournir une action immédiate si un gestionnaire d'événement soumet des commandes à Nagios.

L'utilisation des commandes externes

Les commandes externes peuvent être utilisées pour mener à bien un certain nombre de choses pendant que Nagios fonctionne. A titre d'exemple, ce qui peut être effectué comprend : la désactivation temporaire des notifications pour les services et les hôtes, la désactivation temporaire des tests de service, l'obligation de contrôler immédiatement un service, l'ajout de commentaires aux hôtes et services, etc.

Format des commandes

Les commandes externes écrites pour le fichier de commande suivent le format suivant :

[time] command_id;command_arguments

…où time est l'heure (au format time_t à laquelle l'application externe ou le CGI a envoyé la commande externe au fichier de commande. Les valeurs pour les arguments command_id et command_arguments dépendent de la commande qui sera soumise à Nagios.

Un listing complet des commandes externes qui peuvent être utilisées (ainsi que des exemples d'utilisation) sont en ligne à l'adresse suivante:

http://www.nagios.org/developerinfo/externalcommands/