Chapitre 31. Les contrôles passifs

Comment les contrôles passifs fonctionnent-ils ?

Passive Checks

Ci-dessous, le fonctionnement des contrôles passifs en plus détaillé :

  1. Une application externe contrôle l'état d'un hôte ou un service.

  2. L'application externe écrit le résultat du contrôle dans le fichier des commandes externes.

  3. Ensuite, Nagios lit ce fichier et place les résultats dans une queue pour les traiter plus tard. Cette même queue est utilisée pour aussi bien stocker les résultats des contrôles actifs que passifs.

  4. Nagios va exécuter périodiquement un événement collecteur de résultat et scanner la queue. Chaque résultat de services trouvé est traité de la même manière qu'il soit actif ou passif. Nagios enverra les notifications, alertes de log, etc. en fonction du résultat des contrôles.

Le principe des contrôles actifs et passifs est similairement le même. Cela tient en compte de l'intégration de l'information des états à partir d'applications externes avec Nagios.

Autoriser les contrôles passifs

Dans l'odre, pour autoriser le contrôle passifs dans Nagios, Il faut procéder de la manière suivante:

Si vous voulez désactiver globalement le contrôle passifs, passer le paramètre accept_passive_service_checks à 0.

Si vous voulez désactiver les contrôles passifs pour quelques services ou hôtes, utilisez le paramètre passive_checks_enabled dans votre définition d'hôte et/ou service.

Soumission d'un résultat de contrôle passif

Les applications externes peuvent soumettre à Nagios des résultats de contrôles passifs en écrivant une commande externe PROCESS_SERVICE_CHECK_RESULT dans le fichier de commande externe.

Le format de la commande ressemble à ce qui suit:


[<timestamp>] PROCESS_SERVICE_CHECK_RESULT;<host_name>;<svc_description>;<return_code>;<plugin_output>
        

où :

  • timestamp est le temps au format time_t (secondes écoulée depuis le commencement UNIX) que le contrôle de service génère (ou soumet). Notez bien le simple espace juste après la parenthèse.

  • host_name est l'alias de l'hôte associé avec le service dans la définition de service

  • svc_description est la description de service spécifiée dans la définition de service

  • return_code est le code de retour d'un contrôle (0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN)

  • plugin_output est le texte de sortie d'un contrôle de service

Soumission d'un résultat de contrôle passif d'un hôte

Les applications externes peuvent soumettre à Nagios des résultats de contrôles passifs en écrivant une commande externe PROCESS_HOST_CHECK_RESULT dans le fichier de commande externe.

Le format de la commande ressemble à ce qui suit:


[<timestamp>]PROCESS_HOST_CHECK_RESULT;<host_name>;<host_status>;<plugin_output>
    

où :

  • timestamp est le temps au format time_t (secondes écoulée depuis le commencement UNIX) que le contrôle de service génère (ou soumet). Notez bien le simple espace juste après la parenthèse.

  • host_name est l'alias correspondant à l'hôte (défini dans la définition de l'hôte)

  • host_status est l'état de l'hôte (0=UP, 1=DOWN, 2=UNREACHABLE)

  • plugin_output est le texte de sortie du contrôle de l'hôte