Configuration des objets basée sur des modèles

Cette directive est utilisée pour identifier le nom court du/des groupe(s) d’hôtes auquel(s) l’hôte appartient. Cette directive peut être utilisée à la place de (en en complément) la directive members dans les définitions des hostgroup.

Cette directive définit le nom court de la commande à lancer à chaque fois qu’un changement d’état de l’hôte est détecté (c.a.d chaque fois qu’il est hors service ou qu’il se rétablit). Lisez la documentation sur les gestionnaires d’événement pour des explications détaillées sur la façon d’écrire des scripts de gestion d’événements. Le temps d’exécution maximal de cette commande est déterminé par la variable event_handler_timeout.

Cette directive définit si le gestionnaire d’événements est activé pour cet hôte. Valeurs: 0 = gestionnaire d’événements désactivé, 1 = gestionnaire d’événements activé.

Cette directive définit le nombre d’"unités de temps" à patienter avant de re-notifier un contact que l’hôte est toujours hors service ou inaccessible. Si vous n’avez pas modifié la valeur par défaut de la directive interval_length , qui est de 60 par défaut, ce nombre exprime des minutes. Si vous mettez cette valeur à 0, Nagios® ne notifiera pas à régulièrement les contacts à propos des problèmes de cet hôte - une seule notification sera émise.

Cette directive définit le nom court de la période durant laquelle les notifications d’événements concernant cet hôte peuvent être émises vers les contacts. Si un hôte est hors service, inaccessible, ou se rétablit en dehors de la période de notification, aucune notification ne sera envoyée.

Cette directive définit la description du service qui peut contenir des espaces, tirets, et deux-points (points-virgules, apostrophes, et guillemets sont à éviter). Deux services associés au même hôte ne peuvent pas avoir la même description. Les services sont identifiés uniquement avec les directives host_name et service_description.

Cette directive définit le nombre de fois que Nagios® réessayera de contrôler le service si celui-ci retourne un état différent de OK. Si vous donnez une valeur de 1 à cette variable, Nagios® générera une alerte (si le contrôle de service a détecté un problème) sans nouvel essai.

Cette directive définit le nombre d’"unités de temps" à attendre avant d’ordonnancer le prochain contrôle "régulier" du service. Les contrôles "réguliers" sont ceux qui se font lorsque le service est en état OK ou lorsque le service n’est pas en état OK, mais que le nombre d’essais défini par la variable max_check_attempts est atteint. Si vous n’avez pas changé la valeur de interval_length, qui est par défaut de 60, ce nombre exprime des minutes. Pour plus d’informations sur cette valeur, voyez la documentation sur l’ordonnancement du contrôle des services.

Cette directive définit le nombre d’"unités de temps" à attendre avant d’ordonnancer le prochain contrôle du service. Les services sont réordonnancés à cet intervalle quand ils sont passés dans un état différent de OK. Une fois que le contrôle de service a été tenté max_check_attempts fois sans changement d’état, il est réordonnancé à nouveau à sa fréquence "normale" définie par la valeur de check_interval. Si vous n’avez pas changé la valeur de interval_length, qui est par défaut de 60, ce nombre exprime des minutes. Pour plus d’informations sur cette valeur, voyez la documentation sur l’ordonnancement du contrôle des services.

Cette directive définit le seuil (en secondes) à partir duquel le contrôle de validité est activé pour ce service. Si vous le mettez à 0, Nagios® déterminera seul un seuil.

Cette directive définit quand les notifications pour ce service doivent être envoyées. Les options valides sont une combinaison d’une ou plusieurs des valeurs suivantes : w = envoi de la notification pour un état WARNING, u = envoi de la notification pour un état UNKNOWN ,r = envoi de la notification pour le retour à la normale (état OK) et f = envoi d’une notification lorsque le service commence ou arrête d’osciller. Si vous spécifiez la valeur n (none), aucune notification ne sera envoyée. . Exemple: avec les valeurs w,r dans ce champ, les notifications seront envoyées quand l’hôte sera WARNING et quand il sortira de cet état pour un état OK.

Cette directive définit pour quel état du service le "suivi précis" est activé. Les options valides sont une combinaison d’une ou plusieurs des valeurs suivantes: w = suivi sur les états WARNING , o = suivi sur les états OK , et u = suivi sur les états UNKNOWN et c = suivi sur les états CRITICAL. Vous trouverez plus d’informations sur le suivi précis là.

Ceci est une liste de descriptions de services (et le nom de leur hôtes associés) qui doivent être inclus dans ce groupe. Les noms des hôtes et des services doivent être séparés par des virgules. Cette directive peut être utilisée comme une alternative à la directive servicegroups de la définition d’un service. Le format de cette directive est le suivant (notez qu’un nom d’hôte doit être précédé d’un nom de service) :

members=<host1>,<service1>,<host2>,<service2>,…,<hostn>,<servicen>

Cette directive définit le nom court identifiant le contact. Il est utilisé dans les définitions de groupes de contacts. Si elle est utilisée dans le bon contexte, la macro $CONTACTNAME$

Cette directive définit pour quel état de l’hôte les notifications doivent être envoyées. Les options valides sont une combinaison d’une ou plusieurs des valeurs suivantes : : d = envoi de la notification pour un état DOWN, u = envoi de la notification pour un état UNREACHABLE , r = envoi de la notification pour le retour à la normale (état OK) et f = envoi d’une notification lorsque l’hôte commence ou arrête d’osciller. Si vous spécifiez la valeur n (none), aucune notification ne sera envoyée.

Cette directive définit pour quel état du service les notifications doivent être envoyées. Les options valides sont une combinaison d’une ou plusieurs des valeurs suivantes : w = envoi de la notification pour un état WARNING, u = envoi de la notification pour un état UNKNOWN , c= envoi de la notification pour un état CRITIQUE et r = envoi de la notification pour le retour à la normale (état OK) et f = envoi d’une notification lorsque le service commence ou arrête d’osciller. Si vous spécifiez la valeur n (none), aucune notification ne sera envoyée. .

Cette directive définit l’adresse email du contact. Selon la manière dont vous aurez défini la commande de notification, elle peut être utilisée pour émettre un email. Dans des circonstances adéquates, la macro $CONTACTEMAIL$ contient cette valeur.

Cette directive définit une liste de tranches horaires ( sunday, friday, saturday ..) séparées par des points-virgules, qui sont "valides" pour un jour donné de la semaine. Notez que vous devez définir des tranches horaires pour les sept jours de la semaine (de Sunday à Saturday - dimanche à samedi). Les tranches horaires sont au format HH:MM-HH:MM, où les heures sont indiquées entre 0 et 24. Par exemple, 00:15-24:00 veut dire de zéro heure quinze ce jour jusqu’à minuit (une tranche de 23 heures et 45 minutes). Si vous désirez exclure une journée entière des périodes de temps, ne la mettez pas dans les définitions, simplement.

Cette directive définit le nom court identifiant la commande. Il est utilisé dans les définitions de contact, d’hôte, et de service, entre autres.

Cette directive définit ce qu’exécute Nagios® lorsque la commande est utilisée pour un contrôle de service ou d’hôte, pour une notification, ou pour un gestionnaire d’événement. Avant que la ligne de commande ne soit exécutée, toutes les macros valides sont remplacées par leur valeur. Référez-vous à la documentation sur les macros pour savoir quand elles sont valides. Notez que la ligne de commande n’est pas entourée de guillemets. De plus, si vous désirez passer le signe ($) sur la ligne de commande, il faudra "l’échapper" avec un autre $.

Si vous souhaitez passer des arguments à la commande à la volée, vous pouvez utiliser la macro $ARGn$ dans la directive command_line de la définition de la commande et séparer les éléments individuels du nom de la commande (et de chaque autre élément) en utilisant le caractère ! dans les directives faisant référence à des commandes (host check command, service event handler command, etc). Plus d’informations sur comment passer des arguments à des commandes à la volée peuvent être trouvées dans la documentation à la page des macros.

Cette directive définit le nom court de l’hôte sur lequel le service dont nous dépendons tourne ou qui lui est associé.

Ces directives définissent les situations dans lesquelles le service dépendant ne doit pas être exécuter. Si le service dont nous dépendons est dans un des états d’erreur spécifié, le service dépendant ne sera pas exécuté. Les valeurs valides sont les combinaisons de un ou plusieurs de ces états (les options multiples sont séparées par des virgules): o = non exécuté si état OK, w = non exécuté si état WARNING , u = non exécuté si état UNKNOWN, et c = non exécuté si état CRITICAL. Si vous spécifiez n (aucun) comme option, la dépendance d’exécution n’échouera jamais et le contrôle du service dépendant aura toujours lieu. Par exemple, si vous spécifiez o,c,u dans cette variable, la dépendance est en erreur si le service dont nous dépendons est dans un des états OK, CRITICAL, ou UNKNOWN et que le service dépendant n’est pas en exécution.

Ces directives définissent les situations dans lesquelles les notifications pour le service dépendant ne doivent pas être envoyées. Si le service dont nous dépendons est dans l’un des états d’erreur spécifiés, les notifications pour le service dépendant ne seront pas envoyées aux contacts. Les valeurs valides sont les combinaisons de un ou plusieurs de ces états : o = non exécuté si état OK, w = non exécuté si état WARNING , u = non exécuté si état UNKNOWN, et c = non exécuté si état CRITICAL. Si vous spécifiez n (aucun) comme option, la dépendance de notification n’échoue jamais et les notifications pour le service dépendant seront toujours envoyées. Par exemple, si vous spécifiez w dans ce champ, la dépendance est en erreur si le service dont nous dépendons est dans l’état WARNING et les notifications pour le service dépendant ne seront pas envoyées.

Cette directive définit le nom court de l’hôte sur lequel le service auquel l’escalade doit s’appliquer est associé.

Cette directive définit une description du service auquel l’escalade doit s’appliquer.

C’est le nombre qui désigne la dernière notification avant que cette escalade ne soit plus effective. Par exemple, si vous mettez une valeur de 5, cette escalade ne sera pas utilisée si plus de cinq notifications ont été envoyées pour le service spécifié. Donner une valeur de 0 revient à utiliser éternellement cette escalade (sans tenir compte du nombre de notifications émises).

Cette directive définit une liste de noms courts de groupes de contacts à notifier quand une escalade a lieu pour ce service. Les groupes de contacts doivent être séparés par des virgules.

Cette directive définit l’intervalle auquel les notifications doivent être faites tant que cette escalade est valide. Si vous donnez une valeur de 0 à cet intervalle, Nagios® enverra la première notification lorsque cette définition d’escalade est valide, mais arrêtera ensuite toute émission de notifications pour l’hôte. Les notifications ne sont plus envoyées jusqu’à ce que le service se rétablisse. Ceci est utile si vous ne voulez plus de notifications après un certain temps. Note : si, pour un même service, plusieurs définitions d’escalade ont des plages de notifications qui se chevauchent, c’est l’intervalle de notification le plus petit qui est retenu.

Cette directive est utilisée pour spécifier le nom court de la période durant laquelle l’escalade est valide. Si cette directive n’est pas spécifiée, l’escalade sera considérée tout le temps comme valide.

Cette directive est utilisée pour définir le critère qui détermine quand l’escalade de service est utilisée. L’escalade est utilisée uniquement si le service est dans un des états spécifiés par cette directive. Si cette directive n’est pas spécifiée, l’escalade sera considérée comme valide pour n’importe quel état. Les options valides sont une combinaison d’une ou de plusieurs options qui suivent : r = escalade pour un état UP, w = escalade pour un état WARNING, u = escalade pour un état UNKNOWN, et c = escalade pour un état CRITICAL. Exemple : Si vous spécifiez w dans ce champ, l’escalade sera uniquement utilisée lorsque le service se trouvera dans un état WARNING.

Cette directive définit le nom court de l’hôte dépendant.

Cette directive définit le nom court de l’hôte dont il y a dépendance (Appelé également hôte maître).

Cette directive indique si la dépendance hérite des dépendances de l’hôte dont il dépend lui même (aussi appelé l’hôte maître). En d’autres mots si l’hôte maître est dépendant d’un autre hôte et que cette dépendance échoue alors cette dépendance aussi échouera.

Ces directives définissent les situations dans lesquelles le service dépendant ne doit pas être exécuté. Si l’hôte maître est dans un des états d’erreur spécifié, l’hôte dépendant ne sera pas contrôlé activement. Les valeurs valides sont les combinaisons de un ou plusieurs de ces états (les options multiples sont séparées par des virgules): o = pas de contrôle si l’état est UP, d = pas de contrôle si l’état est DOWN, u = pas de contrôle si l’état est UNREACHABLE, p = pas de contrôle si l’état n’est pas déterminé (typiquement lorsque l’hôte n’a pas encore été contrôlé). Si vous spécifiez n (none) comme option, les dépendances d’hôtes seront toujours contrôlées activement (si les autres options le permettent). Par exemple : si vous spécifier u,d dans ce champs, les hôtes dépendants ne seront contrôlés activement uniquement si l’hôte maître est dans un état UNREACHABLE ou DOWN. n (aucun) comme option, la dépendance d’exécution n’échouera jamais et le contrôle du service dépendant aura toujours lieu. Par exemple, si vous spécifiez o,c,u dans cette variable, la dépendance est en erreur si le service dont nous dépendons est dans un des états OK, CRITICAL, ou UNKNOWN et que le service dépendant n’est pas en exécution.

Cette directive définit les conditions pour lesquelles les notifications pour l’hôte dépendant ne seront pas envoyées. Les options valides sont une combinaison d’un ou plusieurs des critères suivants: o = n’est pas envoyée sur un état UP, d = n’est pas envoyé sur un état DOWN, et u = n’est pas envoyée sur un état UNREACHABLE. Si vous spécifiez n (aucun) comme option, la dépendance de notification n’échouera jamais et les notifications seront toujours envoyées. Exemple, si vous spécifiez d dans ce champ, les notifications pour cet hôte ne seront pas envoyées si l’hôte dont nous dépendons est dans un état DOWN.