Configuration des objets basée sur des modèles

Notes

Lorsque vous créerez /éditerez les fichiers de configuration, gardez à l’esprit que :

  1. Les lignes commençant par un ’#’ sont des commentaires et ne sont pas traitées.
  2. Les directives sont sensibles à la casse.

Introduction

Un des bénéfices de l’utilisation de fichiers dont le format utilise des modèles est le suivant: vous pouvez créer des définitions d’objets qui vont hériter de quelques propriétés d’autres définitions d’objets. Cette notion d’héritage, ainsi que la documentation expliquant comment la mettre en place, se trouve ici. Je ne saurais trop vous recommander de vous familiariser avec l’héritage entre objets, une fois que vous aurez lu la documentation ci-dessous. En effet, l’héritage va vous rendre le travail de création et de maintenance des définitions d’objets bien plus facile.

Trucs et astuces "gain de temps"

Il y a quelques trucs que vous devez connaitre, dans la définition d’objet, et qui vous permettront de créer un grand nombre d’objets avec juste un petit nombre de définitions dans vos fichiers de configuration. Un de ces "trucs", c’est la possibilité de définir un seul objet pour un service, qui crée un service pour de nombreux hôtes ou groupes d’hôtes. Ces astuces sont décrites .

Notes sur la mémorisation

Il est important de comprendre que plusieurs directives dans les hôtes et services peuvent ne pas être pris en compte par Nagios® quand vous les modifiez. Les directives d’hôtes et de services affectées par ce type de comportement sont marquées (*). La raison de ce comportement réside dans le fait que Nagios® choisit d’honorer les valeurs stockées dans le fichier de mémorisation des états plutôt que celles présentes dans les fichiers de configuration, à supposer que vous avez activé la mémorisation des états pour l’ensemble de Nagios®.

Une des manières de se débarrasser de ce problème consiste à désactiver la mémorisation des informations n’ayant pas trait avec le statut, avec la directive retain_nonstatus_information dans la définition des hôtes et services. La désactivation de cette directive va obliger Nagios® à prendre les valeurs initiales pour ces directives dans vos fichiers de configurations, plutôt que dans le fichier de mémorisation des états, quand Nagios® (re)démarre. L’utilisation de cette directive n’est cependant pas recommandée, car elle peut avoir (de votre point de vue) des effets inattendus.

Une autre manière consiste à exécuter une commande externe appropriée qui va changer la valeur affectée à l’hôte ou au service, via l’interface web, de telle sorte que cette valeur sera en phase avec ce qui se trouve dans le fichier de configuration. Ceci est habituellement fait à travers le CGI d’informations complémentaires. Cette option requiert un peu plus de travail, mais elle est de loin préférable à l’option de désactivation de la mémorisation mentionnée juste au-dessus.

Exemple de Configuration

Quelques fichiers de configuration d’objets sont créés lorsque vous exécutez le script de configuration - vous pouvez les trouver dans le sous répertoire sample-config/template-object/ de la distribution de Nagios®.

Types d’objets

Définition d’hôte
Définition de groupe d’hôtes
Définition de service
Définition de groupe de service
Définition de contact
Définition de groupe de contacts
Définition de période
Définition de commande
Définition des dépendances de service
Définition d’escalade de service
Définition des dépendances d’hôte
Définition d’escalade d’hôte
Définition des informations étendues d’hôte
Définition des informations étendues de service

Définition d’hôte
Description:

Une définition d’hôte s’applique à un serveur "physique", une station de travail, un périphérique, un équipement, qui se trouve sur votre réseau.

Définition du format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define host{
host_name host_name
alias alias
address address
parents host_names
hostgroups hostgroup_names
check_command command_name
max_check_attempts #
check_interval #
active_checks_enabled [0/1]
passive_checks_enabled [0/1]
check_period timeperiod_name
obsess_over_host [0/1]
check_freshness [0/1]
freshness_threshold #
event_handler command_name
event_handler_enabled [0/1]
low_flap_threshold #
high_flap_threshold #
flap_detection_enabled [0/1]
process_perf_data [0/1]
retain_status_information [0/1]
retain_nonstatus_information [0/1]
contact_groups contact_groups
notification_interval #
notification_period timeperiod_name
notification_options [d,u,r,f]
notifications_enabled [0/1]
stalking_options [o,d,u]
    }
Exemple de définition:

define host{
        host_name                       bogus-router
        alias                           Bogus Router #1
        address                         192.168.1.254
        parents                         server-backbone
        check_command                   check-host-alive
        max_check_attempts              5
        check_period                    24x7
        process_perf_data               0
        retain_nonstatus_information    0
        contact_groups                  router-admins
        notification_interval           30
        notification_period             24x7
        notification_options            d,u,r
        }
Descriptions des directives:
host_name: C’est le nom court qui permet d’identifier l’hôte. Il est utilisé dans les groupes d’hôtes et les définitions de service pour faire référence à cet hôte particulier. Les hôtes peuvent être associés à de multiples services (qui sont supervisés). Si elle est utilisée dans le bon contexte, la macro $HOSTNAME$ contient ce nom court.
alias: C’est un nom long ou une description de l’hôte permettant de l’identifier plus facilement. Si elle est utilisée dans le bon contexte, la macro $HOSTALIAS$ contient cet alias/description.
address: Cette directive définit l’adresse de l’hôte. C’est normalement une adresse IP, bien que ce puisse être en réalité ce que vous voulez (du moment que cela peut être utilisé pour tester l’hôte). Vous pouvez utiliser un FQDN [Fully Qualified Domain Name, nom de domaine complet] pour identifier l’hôte, mais si le service DNS n’est pas actif, cela peut poser des problèmes. Si elle est utilisée dans le bon contexte, la macro $HOSTADDRESS$ contient cette adresse. Note: si vous ne spécifiez pas une directive d’adresse dans la définition d’un hôte, le nom sera employé comme adresse. Un avertissement à ce sujet : si le DNS tombe, tous les contrôles de service échoueront puisque les plugin seront incapables de résoudre les noms.
parents: Cette directive définit une liste de noms courts d’hôtes "parents" de cet hôte, séparés par des virgules. Les hôtes parents sont généralement des routeurs, des commutateurs, des firewalls, etc. se trouvant entre l’hôte de supervision et les hôtes distants. Le routeur, le commutateur, etc. le plus proche de l’hôte distant est considéré comme le parent de cette hôte. Pour plus d’informations, référez-vous au chapitre "Déterminer l’état et l’accessibilité des hôtes du réseau" dans ce document ici. Si cet hôte est sur le même segment que l’hôte de supervision (sans routeur intermédiaire, etc.), il est considéré comme étant sur le réseau local et n’aura pas d’hôte parent. Laissez cette valeur vide si l’hôte n’a pas d’hôte parent (c.a.d s’il est sur le même segment que l’hôte de Nagios®). L’ordre dans lequel vous déclarez les parents n’a pas d’influence sur la façon dont la supervision se déroule.
hostgroups:

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.

check_command: Cette directive définit le nom court de la commande à utiliser pour déterminer si l’hôte est hors service ou non. Typiquement, cette commande lance un "ping" vers l’hôte pour voir s’il est "vivant". La commande doit retourner un état OK (0) sinon Nagios® supposera que cet hôte est hors service. Si vous laissez cet argument vide, l’hôte ne sera pas contrôlé - Nagios® supposera que l’hôte est toujours en fonctionnement. Ceci est utile pour superviser des imprimantes ou autres périphériques qui sont éteints fréquemment. Le temps d’exécution maximal de cette commande est déterminé par la variable host_check_timeout.
max_check_attempts: Cette directive définit le nombre de fois ou Nagios® relancera la commande de contrôle de l’hôte si celle-ci retourne un état différent de OK. Positionner cette valeur à 1 entraînera Nagios® à générer une alerte sans re-contrôler l’hôte. Note : si vous ne voulez pas contrôler l’état de l’hôte, vous devez quand même mettre une valeur supérieure ou égale à 1. Pour ne pas effectuer le contrôle de l’hôte, laissez simplement vide l’option <check_command>.
check_interval: NOTE: N’activez pas cette directive sans en avoir réellement besoin ! Les vérifications sont réalisées à la demande lorsque c’est nécessaire. Les vérifications programmées des hôtes peuvent impacter les performances - lire les astuces de tuning des performances pour plus d’informations. Cette directive est utilisée pour définir le nombre "d’unité de temps" entre chaque check de l’hôte. Sans changer la directive interval_length la valeur par défaut est de 60, ce nombre correspond à des minutes. Plus d’informations sur cette valeur peuvent être trouvées sur la documentation des vérifications programmées.
active_checks_enabled *: Cette directive définit si les contrôles actifs (les contrôles planifiés ou ceux à la demande) sont activés pour cet hôte. Valeurs: 0 = contrôles actifs désactivés, 1 = contrôles actifs activés.
passive_checks_enabled *: Cette directive définit si les contrôles passifs sont activés pour cet hôte. Valeurs: 0 = contrôles passifs désactivés, 1 = contrôles passifs activés.
check_period: Cette directive est utilisée pour définir le nom court d’une période durant laquelle les contrôles actifs de cet hôte peuvent être réalisés.
obsess_over_host *: Cette directive définit si les contrôles pour cet hôte seront "obsessed" en utilisant la directive ochp_command.
check_freshness *: Cette directive est utilisée pour définir si les contrôles de fraîcheur sont activés pour cet hôte. Valeurs : 0 = contrôle de fraîcheur désactivé, 1 = contrôle de fraîcheur activé.
freshness_threshold: Cette directive est utilisée pour spécifier le seuil de fraîcheur (en secondes) pour cet hôte. Si vous mettez cette valeur à 0, Nagios® déterminera automatiquement le seuil de fraîcheur à utiliser.
event_handler:

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.

event_handler_enabled *:

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é.

low_flap_threshold: Cette directive définit le seuil bas de la détection d’oscillation pour cet hôte. Vous trouverez plus d’informations sur l’oscillation . Si vous fixez cette directive à 1, la valeur fixée par la directive globale ( au niveau de Nagios®) low_host_flap_threshold sera utilisé à la place.
high_flap_threshold: Cette directive définit le seuil haut de la détection d’oscillation pour cet hôte. Vous trouverez plus d’informations sur l’oscillation . Si vous fixez cette directive à 1, la valeur fixée par la directive globale ( au niveau de Nagios®) high_host_flap_threshold sera utilisé à la place.
flap_detection_enabled *: Cette directive définit si la détection d ’oscillation est activée pour cet hôte. Valeurs: 0 = détection d’oscillation désactivée, 1 = détection d’oscillation activée. Vous trouverez plus d’informations sur l’oscillation .
process_perf_data *: Cette directive définit si le traitement des données liées à la performance du contrôle est activé pour cet hôte. Valeurs: 0 = traitement désactivé, 1 = traitement activé.
retain_status_information: Cette directive définit si les informations liées au statut de l’hôte sont mémorisées, entre les (re)démarrages de Nagios®, pour cet hôte. Valeurs: 0 = mémorisation désactivée, 1 = mémorisation activée. Ceci n’est utile que si vous avez activé la directive retain_state_information. Value: 0 = mémorisation des états désactivée, 1 = mémorisation des états activée.
retain_nonstatus_information: Cette directive définit si les informations non liées au statut de l’hôte sont mémorisées, entre les (re)démarrages de Nagios®, pour cet hôte. Valeurs: 0 = mémorisation désactivée, 1 = mémorisation activée. Ceci n’est utile que si vous avez activé la directive retain_state_information.
contact_groups: Ceci est une liste de noms courts de groupes de contacts qui devront être notifiés lorsqu’il y aura des problèmes (ou des recouvrements) avec cet hôte. Les multiples groupes de contacts devront être séparés par des virgules.
notification_interval:

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.

notification_period:

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.

notifications_options: Cette directive définit quand les notifications pour cet hôte 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. . Exemple: avec les valeurs d,r dans ce champ, les notifications seront envoyées quand l’hôte sera DOWN et quand il sortira de cet état pour un état OK.
notifications_enabled *: Cette directive définit si les notifications sont activées pour cet hôte. valeurs: 0 = notifications désactivées, 1 = notifications activées.
stalking_options: Cette directive définit pour quel état de l’hôte le "suivi précis" est activé. Les options valides sont une combinaison d’une ou plusieurs des valeurs suivantes: o = suivi sur les états UP, d = suivi sur les états DOWN , et u = suivi sur les états UNREACHABLE. Vous trouverez plus d’informations sur le suivi précis là.

Définition d’un groupe d’hôtes
Description:

Une définition de groupe d’hôtes est utilisée pour regrouper un ou plusieurs groupes ensemble pour les afficher CGIs.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define hostgroup{
hostgroup_name hostgroup_name
alias alias
members members
    }
Exemple de définition

define hostgroup{
        hostgroup_name          novell-servers
        alias                   Novell Servers
        members                 netware1,netware2,netware3,netware4
        }
Descriptions des directives
hostgroup_name: Cette directive définit le nom court qui identifie le groupe d’hôtes
alias: Cette directive définit un nom long ou une description permettant d’identifier plus facilement le groupe d’hôtes. Elle sert à permettre une identification plus facile d’un groupe d’hôtes.
members: C’est une liste de noms courts d’hôtes à inclure dans ce groupe. Les noms doivent être séparés par des virgules. Cette directive peut être utilisée comme une alternative (ou en complément) de la directive hostgroups dans les définitions d’hôte.

Définition d’un service
Description:

la définition d’un service identifie un service tournant sur un hôte. Le terme "service" est très générique. Il peut s’appliquer à un service ( tel que POP, SMTP, HTTP, etc.) ou bien tout autre type de mesures associé à l’hôte (temps de réponse à un ping, nombre d’utilisateurs connectés, usage des disques). Les différents arguments sont expliqués ci-dessous.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define service{
host_name host_name
service_description service_description
servicegroups servicegroup_names
is_volatile [0/1]
check_command command_name
max_check_attempts #
normal_check_interval #
retry_check_interval #
active_checks_enabled [0/1]
passive_checks_enabled [0/1]
check_period timeperiod_name
parallelize_check [0/1]
obsess_over_service [0/1]
check_freshness [0/1]
freshness_threshold #
event_handler command_name
event_handler_enabled [0/1]
low_flap_threshold #
high_flap_threshold #
flap_detection_enabled [0/1]
process_perf_data [0/1]
retain_status_information [0/1]
retain_nonstatus_information [0/1]
notification_interval #
notification_period timeperiod_name
notification_options [w,u,c,r,f]
notifications_enabled [0/1]
contact_groups contact_groups
stalking_options [o,w,u,c]
    }
Exemple de Définition:

define service{
        host_name               linux-server
        service_description     check-disk-sda1
        check_command           check-disk!/dev/sda1
        max_check_attempts      5
        normal_check_interval   5
        retry_check_interval    3
        check_period            24x7
        notification_interval   30
        notification_period     24x7
        notification_options    w,c,r
        contact_groups          linux-admins
        }
Descriptions des directives:
host_name: Cette directive définit le nom court de l’hôte sur lequel "tourne" le service ou avec lequel il est associé.
service_description;:

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.

servicegroups: Cette directive est utilisée pour identifié le(s) nom(s) court(s) du (ou des) services groupes auquel le service appartient. Les multiples groupes de services doivent être séparés par des virgules. Cette directive peut être utilisée à la place de la directive members de la définition du groupe de service.
is_volatile: Cette directive définit si le service est "volatil". Un service ne l’est normalement pas. Plus d’informations sur ce type de service et en quoi ils diffèrent des services normaux, se trouve ici. Valeur: 0 = service non volatil, 1 = service volatil.
check_command: Cette directive est utilisée pour spécifier the nom court de la commande que Nagios® exécutera pour déterminer l’état du service. Le temps d’exécution maximal de cette commande est déterminé par la variable service_check_timeout
max_check_attempts:

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.

normal_check_interval:

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.

retry_check_interval:

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.

active_checks_enabled *: Cette directive définit si les contrôles actifs sont activés pour ce service. Valeurs: 0 = contrôle actif désactivé, 1 = contrôle actif activé.
passive_checks_enabled *: Cette directive définit si les contrôles passifs sont activés pour ce service. Valeurs: 0 = contrôle passif désactivé, 1 = contrôle passif activé.
check_period: Cette directive définit le nom court de la période de temps durant laquelle un contrôle actif peut être effectué.
parallelize_check: cette directive définit si le contrôle de service peut être effectué en parallèle. Par défaut, tous les contrôles de service sont parallélisés. Le désactiver peut causer de graves problèmes de performance. Vous trouverez plus d’informations à ce sujet . Valeurs: 0 = le contrôle de service ne peut pas être parallélisés (utilisation à vos risques et périls! ), 1 = le contrôle de service peut être parallélisé.
obsess_over_service *: Cette directive définit si les contrôles pour ce service seront "obsessed" en utilisant la ocsp_command.
check_freshness *: Cette directive définit si le contrôle de validité des données est activé pour ce service. Valeurs: 0 = contrôle désactivé, 1 = contrôle activé.
freshness_threshold:

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.

event_handler_enabled: Cette directive définit si le gestionnaire d’événements est activé pour ce service. Valeurs: 0 = gestionnaire d’événements désactivé, 1 = gestionnaire d’événements activé.
low_flap_threshold: Cette directive définit le seuil bas de la détection d’oscillation pour ce service. Vous trouverez plus d’informations sur l’oscillation . si vous fixez cette directive à 1, la valeur fixée par la directive globale (au niveau de Nagios®) low_service_flap_threshold sera utilisé à la place.
high_flap_threshold: Cette directive définit le seuil haut de la détection d’oscillation pour ce service. Vous trouverez plus d’informations sur l’oscillation . si vous fixez cette directive à 1, la valeur fixée par la directive globale ( au niveau de Nagios®) high_service_flap_threshold sera utilisé à la place.
flap_detection_enabled *: Cette directive définit si la détection d’oscillation est activée pour ce service. Valeurs: 0 = détection d’oscillation désactivée, 1 = détection d’oscillation activée. Vous trouverez plus d’informations sur l’oscillation .
process_perf_data *: Cette directive définit si le traitement des données liées à la performance du contrôle est activé pour ce service. Valeurs: 0 = traitement désactivé, 1 = traitement activé.
retain_status_information: Cette directive définit si les informations liées au statut du service sont mémorisées, entre les (re)démarrages de Nagios®, pour cet hôte. Valeurs: 0 = mémorisation désactivée, 1 = mémorisation activée. Ceci n’est utile que si vous avez activé la mémorisation des états, avec la directive adéquate. Valeur : 0 = mémorisation des états désactivée, 1 = mémorisation des états activée.
retain_nonstatus_information: Cette directive définit si les informations non liées au statut du service sont mémorisées, entre les (re)démarrages de Nagios®, pour cet hôte. Valeurs: 0 = mémorisation désactivée, 1 = mémorisation activée. Ceci n’est utile que si vous avez activé la mémorisation des états, avec la directive adéquate.
notification_interval: Cette directive définit le nombre d’"unités de temps" à patienter avant de notifier à nouveau un contact que le service 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 re-notifiera pas les contacts à propos des problèmes de ce service - une seule notification sera émise.
notification_period: Cette directive définit le nom court de la période durant laquelle les notifications d’événements concernant ce service peuvent être émises vers les contacts. Si un service est tombé, inaccessible, ou se rétablit en dehors de la période de notification, aucune notification ne sera envoyée.
notification_options:

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.

notifications_enabled *: Cette directive définit si les notifications sont activées pour ce service. Valeurs: 0 = notifications désactivées, 1: notifications activées.
contact_groups: C’est une liste de noms courts de groupes de contacts, séparés par des virgules, qui doivent être notifiés des problèmes ou rétablissements de ce service.
stalking_options:

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à.

Définition des groupes de services
Description:

Une définition de groupe de services est utilisée pour regrouper un ou plusieurs services ensemble pour les afficher CGIs.

Définition du Format :

Note: Les directives en rouge sont requises alors que celles en noir sont optionnelles.

define servicegroup{
servicegroup_name servicegroup_name
alias alias
members members
    }
Exemple Definition:

define servicegroup{
        servicegroup_name       dbservices
        alias                   Database Services
        members                 ms1,SQL Server,ms1,SQL Server Agent,ms1,SQL DTC
        }
Descriptions des Directives :
servicegroup_name: Cette directive définit le nom court qui identifie le groupe de services.
alias: Cette directive définit un nom long ou une description permettant d’identifier plus facilement le groupe de services. Elle sert à permettre une identification plus facile d’un groupe de services.
members:

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>

Définition d’un contact
Description:

Une définition de contact s’applique à la personne physique qui doit être contactée en cas de problèmes sur le réseau. Les différents arguments possibles sont expliqués ci-dessous.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define contact{
contact_name contact_name
alias alias
contactgroups contactgroup_names
host_notification_period timeperiod_name
service_notification_period timeperiod_name
host_notification_options [d,u,r,f,n]
service_notification_options [w,u,c,r,f,n]
host_notification_commands command_name
service_notification_commands command_name
email email_address
pager pager_number or pager_email_gateway
addressx additional_contact_address
    }
Exemple de Définition:

define contact{
        contact_name                    jdoe
        alias                           John Doe
        service_notification_period     24x7
        host_notification_period        24x7
        service_notification_options    w,u,c,r
        host_notification_options       d,u,r
        service_notification_commands   notify-by-email
        host_notification_commands      host-notify-by-email
        email                           jdoe@localhost.localdomain
        pager                           555-5555@pagergateway.localhost.localdomain
        address1                        xxxxx.xyyy@icq.com
        address2                        555-555-5555
        }
Descriptions des directives
contact_name:

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$

alias: Cette directive définit un nom long ou une description du contact. Si elle est utilisée dans le bon contexte, la macro $CONTACTALIAS$ contient cette valeur.
contactgroups: Cette directive est utilisée pour identifier le(s) nom(s) court(s) de groupe(s) de contacts auquel le contact appartient. Les multiples groupes de contacts doivent être séparés par des virgules. Cette directive peut être utilisée comme une alternative (ou en complément) de la directive members de la définition d’un groupe de contacts.
host_notification_period: Cette directive définit le nom court de la période durant laquelle le contact peut être notifié de problèmes ou de rétablissement d’hôtes. Considérez ceci comme "la période d’astreinte du contact" durant laquelle les notifications peuvent lui parvenir. Pour plus d’informations, vous pouvez lire le chapitre sur les "Périodes de temps", qui décrit comment elles fonctionnent et quels sont les problèmes qui peuvent découler d’une utilisation incorrecte.
service_notification_period: Cette directive définit le nom court de la période durant laquelle le contact peut être notifié de problèmes ou de rétablissement de services. Considérez ceci comme "la période d’astreinte du contact" durant laquelle les notifications peuvent lui parvenir. Pour plus d’informations, vous pouvez lire le chapitre sur les "Périodes de temps", qui décrit comment elles fonctionnent et quels sont les problèmes qui peuvent découler d’une utilisation incorrecte.
host_notification_commands: Cette directive définit une liste de noms courts de commandes à utiliser pour notifier un contact d’un problème sur un hôte ou de son rétablissement. Les commandes multiples seront séparées par des virgules. Toutes les commandes de notification sont exécutées quand le contact doit être notifié. Le temps maximal durant lequel cette commande de notification peut s’exécuter est contrôlé par l’option notification_timeout.
host_notification_options:

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.

service_notification_options:

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. .

service_notification_commands: Cette directive définit une liste de noms courts de commandes à utiliser pour notifier un contact d’un problème sur un service ou de son rétablissement. Les commandes multiples seront séparées par des virgules. Toutes les commandes de notification sont exécutées quand le contact doit être notifié. Le temps maximal durant lequel cette commande de notification peut s’exécuter est contrôlé par l’option notification_timeout.
email:

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.

pager: Cette directive définit le numéro de pager du contact. Cela peut aussi être l’adresse email d’une passerelle vers un pager (c.a.d pagejoe@pagenet.com). Selon la manière dont vous aurez configuré la commande de notification, Il pourra être utilisé pour émettre un message vers un pager. Dans des circonstances adéquates, la macro $CONTACTPAGER$ contient cette valeur.
addressx: Les directives adresses sont utilisées pour définir les adresses d’un contact. Ces adresses peuvent être n’importe quoi - numéros de téléphone portable, adresses de messageries instantanées, etc. Cela dépend de comment vous avez configuré vos commandes de notifications, elles peuvent être utilisées pour envoyer des alertes aux contacts. Jusqu’à six adresses peuvent être définies en utilisant cette directive address1 à address6). La macro $CONTACTADDRESSx$ contiendra cette valeur.

Définition d’un contact de groupe
Description:

Une définition de groupe de contacts permet de regrouper un ou plusieurs contacts pour émettre des notifications. Quand un hôte ou un service a un problème ou se rétablit, Nagios® recherche les groupes de contacts à qui envoyer des notifications, et notifie tous les contacts de ces groupes. Ceci peut sembler complexe, mais dans la plupart des cas, ce ne le sera pas. On obtient ainsi une meilleure flexibilité dans la définition de qui est notifié de quel problème. Les différents arguments d’une définition de groupe de contacts sont détaillés ci-dessous.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define contactgroup{
contactgroup_name contactgroup_name
alias alias
members members
    }
Exemple de définition

define contactgroup{
        contactgroup_name               novell-admins
        alias                   Novell Administrators
        members                 jdoe,rtobert,tzach
        }
Descriptions des directives
contactgroup_name: Cette directive définit le nom court utilisé pour identifier le groupe de contacts.
alias: Cette directive définit le nom long ou la description de ce groupe de contacts.
members: C’est une liste de noms courts de contacts faisant partie de ce groupe. Les noms doivent être séparés par des virgules. Cette directive peut être utilisée comme une alternative - ou en supplément - de la directive contactgroups de la définition d’un contact.

Définition de période
Description:

Une période est une liste de tranches horaires pour les différents jours de la semaine, qui sont "valides" pour l’envoi des notifications et les contrôles de service. Ces tranches sont elles-mêmes composées d’autres tranches de temps pour chaque jour de la semaine, qui "tournent" une fois que la semaine est terminée. On ne peut pas définir d’exception à la définition hebdomadaire.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define timeperiod{
timeperiod_name timeperiod_name
alias alias
sunday timeranges
monday timeranges
tuesday timeranges
wednesday timeranges
thursday timeranges
friday timeranges
saturday timeranges
    }
Exemple de définition

define timeperiod{
        timeperiod_name         nonworkhours
        alias                   Non-Work Hours
        sunday                  00:00-24:00
        monday                  00:00-09:00,17:00-24:00
        tuesday                 00:00-09:00,17:00-24:00
        wednesday               00:00-09:00,17:00-24:00
        thursday                00:00-09:00,17:00-24:00
        friday                  00:00-09:00,17:00-24:00
        saturday                00:00-24:00
        }
Descriptions des directives
timeperiod_name: Cette directive définit le nom court identifiant la période.
alias: Cette directive définit un nom long ou une description de la période.
someday:

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.

Définition de commande
Description:

Une définition de commande, comme son nom l’indique, définit une commande :-). Les commandes qu’on peut définir sont les contrôles de service, les notifications de service, les gestionnaires d’événements de service, les contrôles d’hôte, les notifications d’hôte, et les gestionnaires d’événement d’hôte. Les définitions de commande peuvent contenir des macros, mais vous devez vous assurer de n’utiliser que des macros "valides" dans le contexte de la commande. Vous trouverez plus d’informations sur les macros disponibles et leur domaine de validité ici. Les différents arguments d’une définition de commande sont détaillés ci-dessous.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define command{
command_name command_name
command_line command_line
    }
Exemple de définition

define command{
        command_name    check_pop
        command_line    /usr/local/nagios/libexec/check_pop -H $HOSTADDRESS$    
        }
Descriptions des directives
command_name:

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.

command_line:

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.

Définition de dépendance de service
Description:

Les définitions de dépendances du service sont une fonctionnalité avancée de Nagios® qui permet de supprimer des notifications et des contrôles actifs, à partir de l’état d’un ou plusieurs services. Elles sont optionnelles et sont principalement destinées aux utilisateurs avertis qui ont des configurations de supervision complexes. Pour plus d’informations sur le fonctionnement des dépendances de service (Il est important de le lire !) lisez ceci.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir. Cependant, pour celles-ci, vous devez fournir au minimum un type de critères à utiliser.

define servicedependency{
dependent_host_name host_name
dependent_service_description service_description
host_name host_name
service_description service_description
execution_failure_criteria [o,w,u,c,n]
notification_failure_criteria [o,w,u,c,n]
    }
Exemple de définition

define servicedependency{
        host_name                       WWW1
        service_description             Apache Web Server
        dependent_host_name             WWW1
        dependent_service_description   Main Web Site
        execution_failure_criteria      n
        notification_failure_criteria   w,u,c
        }
Descriptions des directives
dependent_host: Cette directive définit le nom court de l’hôte sur lequel le service dépendant tourne ou qui lui est associé.
dependent_service_description: Cette directive définit la description du service dépendant.
host_name:

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é.

service_description: cette directive définit la description du service dont nous dépendons.
execution_failure_criteria:

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.

notification_failure_criteria:

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.

Définition d’escalade de service
Description:

Une définition d’escalade pour un service est complètement optionnelle et est utilisée pour escalader les notifications liées à un service particulier. Vous trouverez plus d’informations sur le fonctionnement de l’escalade ici.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define serviceescalation{
host_name host_name
service_description service_description
contact_groups contactgroup_name
first_notification #
last_notification #
notification_interval #
escalation_period timeperiod_name
escalation_options [w,u,c,r]
    }
Exemple de définition

define serviceescalation{
        host_name               nt-3
        service_description     Processor Load
        first_notification      4
        last_notification       0
        notification_interval   30
        contact_groups          all-nt-admins,themanagers
        }
Descriptions des directives
host_name:

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

 

service_description:

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

first_notification: Cette directive définit un nombre qui désigne la première notification à partir de laquelle cette escalade est effective. Par exemple, si vous mettez cette valeur à 3, cette escalade ne sera lancée que lorsque le service sera dans un état différent de OK depuis trois notifications.
last_notification:

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).

contact_groups:

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.

notification_interval:

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.

escalation_period:

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.

escalation_options:

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.

Définition de dépendance d’hôte
Description:

Les définitions de dépendances d’hôte sont une fonctionnalité avancée de Nagios® qui permet de supprimer des notifications et des contrôles actifs, à partir de l’état d’un ou plusieurs hôtes. Elles sont optionnelles et sont principalement destinées aux utilisateurs avertis qui ont des configurations de supervision complexes. Pour plus d’informations sur le fonctionnement des dépendances de service (lisez le !) lisez ceci.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define hostdependency{
dependent_host_name host_name
host_name host_name
inherits_parent [0/1]
execution_failure_criteria [o,d,u,p,n]
notification_failure_criteria [o,d,u,p,n]
    }
Exemple de définition

define hostdependency{
        host_name                       WWW1
        dependent_host_name             DBASE1
        notification_failure_criteria   d,u
        }
Descriptions des directives
dependent_host:

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

host_name:

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

inherits_parent:

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.

execution_failure_criteria:

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.

notification_failure_criteria:

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.

Définition d’escalade d’hôte
Description:

Une définition d’escalade pour un hôte est complètement optionnelle et est utilisée pour escalader les notifications liées à un hôte particulier. Vous trouverez plus d’informations sur le fonctionnement de l’escalade ici.

Définition du Format:

Note: les directives requises sont en rouge, et les optionnelles en noir.

define hostescalation{
host_name host_name
hostgroup_name hostgroup_name
contact_groups contactgroup_name
first_notification #
last_notification #
notification_interval #
escalation_period timeperiod_name
escalation_options [d,u,r]
    }
Exemple de définition

define hostescalation{
        host_name               router-34
        first_notification      5
        last_notification       8
        notification_interval   60
        contact_groups          all-router-admins
        }
Descriptions des directives
host_name: Cette directive définit le nom court de l’hôte auquel l’escalade s’appliquera.
hostgroup_name: Cette directive est utilisée pour identifier le nom court du/des groupe(s) d’hôtes sur lequel l’escalade sera appliquée. Les multiples groupes d’hôtes sont séparés par des virgules. Si cette directive est utilisée, l’escalade sera appliquée à tous les hôtes membres des groupes d’hôtes spécifiés.
first_notification: C’est un nombre qui désigne la première notification à partir de laquelle cette escalade est effective. Par exemple, si vous mettez cette valeur à 3, cette escalade ne sera lancée que lorsque l’hôte sera dans un état différent de UP depuis trois notifications.
last_notification: Cette directive définit 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).
contact_groups: Cette directive définit une liste de noms courts de groupes de contacts à notifier quand une escalade a lieu pour cet hôte. Les groupes de contacts doivent être séparés par des virgules.
notification_interval: Cette directive définit l’Intervalle auquel les notifications doivent être faites quand cette escalade s’applique. 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 l’hôte se rétablisse. Ceci est utile si vous ne voulez plus de notifications après un certain temps. Note : si pour un même hôte, 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.
escalation_period: 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 est tout le temps considérée comme valide.
escalation_options: Cette directive est utilisée pour définir le critère qui détermine quand l’escalade est utilisée. L’escalade est utilisée uniquement lorsque l’hôte se trouve dans un des états spécifiés dans la directive. Si la directive n’est pas spécifiée, l’escalade sera considérée valide pour tous les états. Les options valides sont une combinaison d’un ou plusieurs critères suivants : r = escalade pour un état UP, d = escalade pour un état DOWN et u = escalade pour un état UNREACHABLE. Exemple : si vous spécifiez d dans ce champ, l’escalade sera uniquement utilisée si l’hôte est dans l’état DOWN.

Définition des informations complémentaires d’hôtes
Description:

Les informations complémentaires d’hôtes sont utilisées principalement pour que l’image générée par les CGI’s d’état, de cartographie d’états, de monde des états, et d’informations complémentaires soit jolie. Elles n’ont aucun effet sur la surveillance et sont totalement optionnelles.

Définition du Format:

Note: les variables requises sont en rouge, les variables optionnelles sont en noir. Cependant, vous devez fournir au moins une variable optionnelle dans chaque définition pour que celle-ci soit d’une utilité quelconque.

define hostextinfo{
host_name host_name
notes note_string
notes_url url
action_url url
icon_image image_file
icon_image_alt alt_string
vrml_image image_file
statusmap_image image_file
2d_coords x_coord,y_coord
3d_coords x_coord,y_coord,z_coord
    }
Exemple de Definition:

define hostextinfo{
        host_name       netware1
        notes           This is the primary Netware file server
        notes_url       http://webserver.localhost.localdomain/hostinfo.pl?host=netware1
        icon_image      novell40.png 
        icon_image_alt  IntranetWare 4.11
        vrml_image      novell40.png
        statusmap_image novell40.gd2
        2d_coords       100,250
        3d_coords       100.0,50.0,75.0
        }
Descriptions des Variables:
host_name: Cette variable est utilisée pour identifier le nom court de l’hôte associé aux informations étendues.
notes: Cette directive est utilisée pour définir une note appartenant à l’hôte. Si vous spécifiez une note ici, vous pourrez la voir dans le CGI d’informations complémentaires (lorsque vous regardez les informations de l’hôte concerné).
notes_url: Cette variable définit une URL optionnelle qui peut être utilisée pour fournir plus d’informations sur l’hôte. Si vous spécifiez une URL, vous verrez un lien "Notes About This Host" dans les CGI d’informations complémentaires (quand vous regarderez les informations à propose de cet hôte). N’importe quel URL valide put être employée. Si vous désirez utiliser des chemins relatifs, la racine sera la même que celle utilisée pour les CGIs (c.a.d /cgi-bin/nagios/). Ceci peut être très utile si vous voulez donner des informations détaillées sur l’hôte, telles que les contacts en cas d’urgence, etc.. aux autres membres des équipes de support.
action_url: Cette directive est utilisée pour définir une URL optionnelle qui peut être utilisée pour fournir plus d’actions à exécuter sur l’hôte. Si vous spécifiée une URL, vous verrez un lien dans les CGI d’informations complémentaires (quand vous regarderez les informations à propose de cet hôte). Si vous désirez utiliser des chemins relatifs, la racine sera la même que celle utilisée pour les CGIs (c.a.d /cgi-bin/nagios/).
icon_image: Cette variable définit le nom d’une image GIF, PNG, ou JPG qui sera associée avec cet hôte. Elle sera affichée dans les CGIs d’état et d’informations complémentaires. Pour un aspect correct, choisissez une taille de 40x40 pixels. les images des hôtes sont supposées être dans le sous-répertoire logos/ de votre répertoire images HTML (c.a.d /usr/local/nagios/share/images/logos).
icon_image_alt: Cette variable définit une chaine optionnelle qui est utilisée par l’étiquette ALT de l’image spécifiée par l’argument <icon_image> . L’étiquette ALT est utilisée à la fois dans le CGI d’état et celui de la cartographie des états.
vrml_image: Cette variable définit le nom d’une image GIF, PNG, ou JPG qui sera associée à cet hôte. Cette image sera utilisée comme texture pour l’hôte spécifié, dans le CGI du monde des états. Contrairement à l’image utilisée pour la variable <icon_image>, celle-ci ne doit pas être transparente, sinon, l’objet représenté sera un peu étrange/bizarre. Les images pour ces hôtes sont supposées être dans le sous-répertoire logos/ du répertoire des images HTML (c.a.d /usr/local/nagios/share/images/logos).
statusmap_image: Cette variable définit le nom d’une image au format GD2 qui sera associée à cet hôte. Elle sera affichée dans l’image crée par le CGI de cartographie des états. Vous pouvez spécifier une image JPEG, PNG, ou GIF cependant I suggère fortement d’utiliser une image au format GD2 qui gâchera moins de temps CPU lors de la génération de la cartographie des états. Les images GD2 peuvent être crées en utilisant le programme pngtogd2 fournie via la librairie gd de Thomas Boutell’s . Elles doivent être crées en format non compressé pour minimiser la charge CPU, quand le CGI génère l’image de la carte du réseau. Pour un aspect correct, choisissez une taille de 40x40 pixels. Vous pouvez laisser cette option vide si vous n’utilisez pas le CGI d’état. Les images sont supposées être dans le sous-répertoire logos/ du répertoire des images HTML (c.a.d /usr/local/nagios/share/images/logos).
2d_coords: Cette variable définit les coordonnées à utiliser pour le dessin de l’hôte dans le CGI de cartographie des états. Elles doivent être des entiers positifs et correspondre aux pixels physiques de l’image générée. L’origine du dessin (0,0) est dans le coin supérieur gauche de l’écran et s’étend sur des coordonnées en x positives vers la droite en haut de l’image et sur des coordonnées en y positives le long du coté gauche vers le bas de l’image. Pour référence, notez que les icônes dessinées ont une taille d’environ 40x40 pixels (le texte prend un peu d’espace). Les coordonnées choisies désignent le coin supérieur gauche de l’icône de l’hôte. Note : ne vous inquiétez pas des coordonnées maximum en x et y que vous pouvez utiliser. Le CGI va calculer automatiquement les dimensions de l’image, à partir des plus grandes valeurs de x et y que vous aurez spécifiées.
3d_coords: Cette variable définit les coordonnées à utiliser pour le dessin d’un hôte dans le CGI du monde des états. L’origine du dessin est (0.0,0.0,0.0). Pour référence, la taille des cubes représentant les hôtes est d’environ 0,5 unités par coté (le texte prend un peu de place). Les coordonnées que vous avez spécifiées pointent sur le centre du cube.

Définition des informations complémentaires des services
Description:

Les informations complémentaires d’hôtes sont utilisées principalement pour que l’image générée par les CGI d’état et d’ informations complémentaires soit jolie. Elles n’ont aucun effet sur la surveillance et sont totalement optionnelles.

Format de Définition:

Note: les variables requises sont en rouge, les variables optionnelles sont en noir. Cependant, vous devez fournir au moins une variable optionnelle dans chaque définition pour que celle-ci soit d’une utilité quelconque.

define serviceextinfo{
host_name host_name
service_description service_description
notes note_string
notes_url url
action_url url
icon_image image_file
icon_image_alt alt_string
    }
Exemple Definition:

define serviceextinfo{
        host_name               linux2
        service_description     Log Anomalies
        notes                   Security-related log anomalies on secondary Linux server
        notes_url               http://webserver.localhost.localdomain/serviceinfo.pl?host=linux2&service=Log+Anomalies
        icon_image              security.png 
        icon_image_alt          Security-Related Alerts
        }
Descriptions des Variables:
host_name: Cette variable définit le nom court de l’hôte associé avec le service.
service_description: Cette directive est la description du service associé aux informations étendues.
notes: Cette directive est utilisée pour définir une note appartenant au service. Si vous spécifiez une note ici, vous pourrez la voir dans le CGI d’informations complémentaires (lorsque vous regardez les informations du service concerné).
notes_url: Cette variable définit une URL optionnelle qui peut être utilisée pour fournir plus d’informations sur ce service. Si vous spécifiez une URL, vous verrez un lien "Notes About This Service" dans le CGI des informations complémentaires. (quand vous regarderez les informations de ce service). N’importe quelle URL valide peut être employée. si vous utilisez des chemins relatifs, la racine sera la même que celle utilisée pour accéder les CGIs (c.a.d /cgi-bin/nagios/). Ceci peut être très utile pour mettre à disposition des informations détaillées sur le service, sur les contacts en cas d’urgence, etc. à disposition des autres membres de l’équipe.
action_url: Cette directive est utilisée pour définir une URL optionnelle qui peut être utilisée pour fournir plus d’actions à exécuter sur le service. Si vous spécifiée une URL, vous verrez un lien dans les CGI d’informations complémentaires (quand vous regarderez les informations à propose de cet hôte). Si vous désirez utiliser des chemins relatifs, la racine sera la même que celle utilisée pour les CGIs (c.a.d /cgi-bin/nagios/).
icon_image: Cette variable définit le nom d’une image GIF, PNG, ou JPG associée à ce service. Elle sera utilisée par les CGI d’état et d’informations complémentaires. Pour un aspect correct, choisissez une image de taille 40x40 pixels. Les images des hôtes sont supposées être dans le sous-répertoire logos/ du répertoire des images HTML (c.a.d /usr/local/nagios/share/images/logos).
icon_image_alt: Une chaîne optionnelle utilisée par l’étiquette ALT de l’image définie par l’argument <icon_image>. Cette étiquette est utilisée par les CGIs d’état, d’informations complémentaires et de cartographie des états.