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 . Il vaut mieux mettre le fichier de commandes externes dans son propre répertoire (i.e. /usr/local/nagios/var/rw).
• 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. Certaines des commandes disponibles sont décrites dans le tableau ci-dessous, ainsi que leur command_id et une description de leurs command_arguments.

Commandes implémentées

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/