Chapitre 27. Macros standards dans Nagios

Les macros standards disponibles dans Nagios sont listées ci-dessous. Les macros on-demand et les macros de variables personnalisées sont décrites ici.

Validité des macros

Bien que toutes les macros puissent être utilisées dans toutes les commandes que vous définissez, elles ne sont pas toutes valables pour une commande en particulier. Par exemple, certaines macros ne sont valables que dans les commandes de notification de service, alors que d'autres ne sont valables que dans les commandes de contrôle d'hôte. Il y a dix types de commandes que Nagios identifie et traite différemment. Ce sont les suivantes :

  1. Les contrôles de service

  2. Les notifications de service

  3. Les contrôles d'hôte

  4. Les notifications d'hôte

  5. Les gestionnaires d'événements de service et/ou le gestionnaire global d'événements de service

  6. Les gestionnaires d'événements d'hôte et/ou le gestionnaire global d'événements d'hôte

  7. La commande OCSP

  8. La commande OCHP

  9. Les commandes de données de performance de service

  10. Les commandes de données de performance d'hôte

La tableau ci-dessous liste toutes les macros actuellement disponibles dans Nagios, accompagnées d'une brève description et des types de commandes pour lesquels elles sont valables. Si une macro est utilisée dans une commande où elle n'est pas valable, elle est remplacée par une chaîne vide. Notez que les macros sont entièrement en majuscules et sont comprises entre des caractères $.

Tableau de disponibilité des macros

Légende :

Non

la macro n'est pas disponible

Oui

la macro est disponible

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros d'hôte : 3

$HOSTNAME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTDISPLAYNAME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTALIAS$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTADDRESS$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTSTATE$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$HOSTSTATEID$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$LASTHOSTSTATE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTSTATEID$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTSTATETYPE$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$HOSTATTEMPT$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$MAXHOSTATTEMPST$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTEVENTID$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTEVENTID$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTPROBLEMID$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTPROBLEMID$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTLATENCY$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTEXECUTIONTIME$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$HOSTDURATION$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTDURATIONSEC$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTDOWNTIME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTPERCENTCHANGE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTGROUPNAME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTGROUPNAMES$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTCHECK$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTSTATECHANGE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTUP$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTDOWN$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LASTHOSTUNREACHABLE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTOUTPUT$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$LONGHOSTOUTPUT$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$HOSTPERFDATA$

Oui

Oui

Oui 1

Oui

Oui

Oui

Oui

Oui

$HOSTCHECKCOMMAND$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTACKAUTHOR$ 8

Non

Non

Non

Oui

Non

Non

Non

Non

$HOSTACKAUTHORNAME$ 8

Non

Non

Non

Oui

Non

Non

Non

Non

$HOSTACKAUTHORALIAS$ 8

Non

Non

Non

Oui

Non

Non

Non

Non

$HOSTACKCOMMENT$ 8

Non

Non

Non

Oui

Non

Non

Non

Non

$HOSTACTIONURL$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTNOTESURL$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTNOTES$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TOTALHOSTSERVICES$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TOTALHOSTSERVICESOK$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TOTALHOSTSERVICESWARNING$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TOTALHOSTSERVICESUNKNOWN$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TOTALHOSTSERVICESCRITICAL$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de groupes d'hôtes :

$HOSTGROUPALIAS$> 5

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTGROUPMEMBERS$ 5

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTGROUPNOTES$ 5

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTGROUPNOTESURL$> 5

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTGROUPACTIONURL$ 5

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de service :

$SERVICEDESC$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEDISPLAYNAME$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICESTATE$

Oui 2

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICESTATEID$

Oui 2

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICESTATE$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICESTATEID$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICESTATETYPE$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEATTEMPT$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$MAXSERVICEATTEMPTS$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEISVOLATILE$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEEVENTID$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICEEVENTID$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEPROBLEMID$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICEPROBLEMID$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICELATENCY$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEEXECUTIONTIME$

Oui 2

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEDURATION$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEDURATIONSEC$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEDOWNTIME$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEPERCENTCHANGE$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEGROUPNAME$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEGROUPNAMES$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICECHECK$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICESTATECHANGE$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICEOK$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICEWARNING$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICEUNKNOWN$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$LASTSERVICECRITICAL$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEOUTPUT$

Oui 2

Oui

Non

Non

Oui

Non

Oui

Non

$LONGSERVICEOUTPUT$

Oui 2

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEPERFDATA$

Oui 2

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICECHECKCOMMAND$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICEACKAUTHOR$ 8

Non

Oui

Non

Non

Non

Non

Non

Non

$SERVICEACKAUTHORNAME$ 8

Non

Oui

Non

Non

Non

Non

Non

Non

$SERVICEACKAUTHORALIAS$ 8

Non

Oui

Non

Non

Non

Non

Non

Non

$SERVICEACKCOMMENT$ 8

Non

Oui

Non

Non

Non

Non

Non

Non

$SERVICEACTIONURL$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICENOTESURL$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

$SERVICENOTES$

Oui

Oui

Non

Non

Oui

Non

Oui

Non

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de groupes de services :

$SERVICEGROUPALIAS$ 6

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$SERVICEGROUPMEMBERS$ 6

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$SERVICEGROUPNOTES$ 6

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$SERVICEGROUPNOTESURL$ 6

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$SERVICEGROUPACTIONURL$ 6

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de contact :

$CONTACTNAME$

Non

Oui

Non

Oui

Non

Non

Non

Non

$CONTACTALIAS$

Non

Oui

Non

Oui

Non

Non

Non

Non

$CONTACTEMAIL$

Non

Oui

Non

Oui

Non

Non

Non

Non

$CONTACTPAGER$

Non

Oui

Non

Oui

Non

Non

Non

Non

$CONTACTADDRESSn$

Non

Oui

Non

Oui

Non

Non

Non

Non

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de groupes de contacts :

$CONTACTGROUPALIAS$ 7

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$CONTACTGROUPMEMBERS$ 7

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros récapitulatives :

$TOTALHOSTSUP$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALHOSTSDOWN$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALHOSTSUNREACHABLE$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALHOSTSDOWNUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALHOSTSUNREACHABLEUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALHOSTPROBLEMS$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALHOSTPROBLEMSUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESOK$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESWARNING$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESCRITICAL$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESUNKNOWN$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESWARNINGUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESCRITICALUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICESUNKNOWNUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICEPROBLEMS$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

$TOTALSERVICEPROBLEMSUNHANDLED$ 10

Oui

Oui 4

Oui

Oui 4

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de notification :

$NOTIFICATIONTYPE$

Non

Oui

Non

Oui

Non

Non

Non

Non

$NOTIFICATIONRECIPIENTS$

Non

Oui

Non

Oui

Non

Non

Non

Non

$NOTIFICATIONISESCALATED$

Non

Oui

Non

Oui

Non

Non

Non

Non

$NOTIFICATIONAUTHOR$

Non

Oui

Non

Oui

Non

Non

Non

Non

$NOTIFICATIONAUTHORNAME$

Non

Oui

Non

Oui

Non

Non

Non

Non

$NOTIFICATIONAUTHORALIAS$

Non

Oui

Non

Oui

Non

Non

Non

Non

$NOTIFICATIONCOMMENT$

Non

Oui

Non

Oui

Non

Non

Non

Non

$HOSTNOTIFICATIONNUMBER$

Non

Oui

Non

Oui

Non

Non

Non

Non

$HOSTNOTIFICATIONID$

Non

Oui

Non

Oui

Non

Non

Non

Non

$SERVICENOTIFICATIONNUMBER$

Non

Oui

Non

Oui

Non

Non

Non

Non

$SERVICENOTIFICATIONID$

Non

Oui

Non

Oui

Non

Non

Non

Non

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de date/heure :

$LONGDATETIME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$SHORTDATETIME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$DATE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TIME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TIMET$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$ISVALIDTIME:$ 9

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$NEXTVALIDTIME:$ 9

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros de fichier :

$MAINCONFIGFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$STATUSDATAFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$COMMENTDATAFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui5

$DOWNTIMEDATAFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$RETENTIONDATAFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$OBJECTCACHEFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TEMPFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$TEMPPATH$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$LOGFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$RESOURCEFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$COMMANDFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$HOSTPERFDATAFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$SERVICEPERFDATAFILE$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Macro Name

Service Checks

Service Notifications

Host Checks

Host Notifications

Gestionnaire d'événements de service et OCSP

Gestionnaire d'événements d'hôte et OCHP

Données de performance de service

Données de performance d'hôte

Macros diverses :

$PROCESSSTARTTIME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$EVENTSTARTTIME$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$ADMINEMAIL$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$ADMINPAGER$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$ARGn$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

$USERn$

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Description des macros

Macros d'hôte : 3

$HOSTNAME$

Nom court de l'hôte (par exemple biglinuxbox). Cette valeur provient du paramètre host_name de la définition de l'hôte.

$HOSTDISPLAYNAME$

Nom d'hôte utilisé pour l'affichage. Cette valeur provient du paramètre display_name de la définition de l'hôte

$HOSTALIAS$

Nom long/description de l'hôte. Cette valeur provient du paramètre alias de la définition de l'hôte.

$HOSTADDRESS$

Adresse de l'hôte. Cette valeur provient du paramètre address de la définition de l'hôte.

$HOSTSTATE$

Une chaîne représentant l'état actuel de l'hôte (UP, DOWN, ou UNREACHABLE).

$HOSTSTATEID$

Un nombre correspondant à l'état actuel de l'hôte : 0=UP, 1=DOWN, 2=UNREACHABLE.

$LASTHOSTSTATE$

Une chaîne représentant le dernier état de l'hôte (UP, DOWN, ou UNREACHABLE).

$LASTHOSTSTATEID$

Un nombre correspondant au dernier état de l'hôte : 0=UP, 1=DOWN, 2=UNREACHABLE.

$HOSTSTATETYPE$

Une chaîne indiquant le type d'état actuel du contrôle d'hôte (HARD ou SOFT). L'état est SOFT lorsque le contrôle a renvoyé un état non-OK (non-UP) et va être réessayé. L'état est HARD lorsque le contrôle d'hôte a été tenté le nombre de fois maximum défini.

$HOSTATTEMPT$

Le nombre d'essais de contrôle d'hôte actuel. Par exemple, si c'est la seconde fois que l'hôte est contrôlé, ce sera le nombre 2. Le nombre actuel d'essais n'est réellement utile que pour l'écriture de gestionnaires d'événements d'hôte pour des états SOFT, qui agiraient de manière spécifique selon le nombre de tentatives.

$MAXHOSTATTEMPST$

Le nombre maximum d'essais de contrôles défini pour l'hôte actuel. Utile lors de l'écriture de gestionnaire d'événements d'hôte pour les états SOFT qui ont besoin de prendre une action basée sur le numéro de l'essai.

$HOSTEVENTID$

Un numéro unique associé à l'état actuel de l'hôte. À chaque fois qu'un hôte (ou un service) change d'état, un numéro global d'événement est incrémenté de un (1). Si un hôte n'a pas changé d'état, cette macro égale zéro (0).

$LASTHOSTEVENTID$

Le numéro unique d'événement précédent qui a été donné à un hôte.

$HOSTPROBLEMID$

Un numéro unique associé à l'état problématique actuel de l'hôte. À chaque fois qu'un hôte (ou un service) change d'état de UP ou OK à un état problématique, un numéro global d'événement est incrémenté de un (1). Cette macro est différente de zéro si l'hôte est actuellement dans un état différent de UP. Les changements d'états entre états différents de OK (par exemple DOWN ou UNREACHABLE) n'incrémente pas ce numéro unique. Si un hôte est dans l'état UP, cette macro est égale à zéro (0). Combiné avec les gestionnaires d'événements, cette macro peut être utilisée pour créer automatiquement des tickets de support au moment où les hôtes basculent pour la première fois dans un état problématique.

$LASTHOSTPROBLEMID$

Le numéro unique de problème précédent qui a été donné à un hôte. Combiné avec les gestionnaires d'événements, cette macro peut être utilisée pour clore automatiquement des tickets de support au moment où les hôtes reviennent dans un état UP.

$HOSTLATENCY$

Un nombre (réel) indiquant le retard en secondes par rapport au moment où un contrôle d'hôte ordonnancé devait être exécuté. Par exemple, si un contrôle était ordonnancé à 03:14:15 et qu'il n'a été exécuté qu'à 03:14:17, la latence de ce contrôle est de 2.0 secondes. Les contrôles d'hôtes à la demande ont une latence de zéro secondes.

$HOSTEXECUTIONTIME$

un nombre (réel) indiquant le nombre de secondes qu'a pris l'exécution du contrôle d'hôte (c.-à-d. le temps pendant lequel le contrôle s'est exécuté).

$HOSTDURATION$

Une chaîne indiquant le temps qu'a passé l'hôte dans sont état actuel. Le format est XXh YYm ZZs, pour les heures, les minutes et les secondes.

$HOSTDURATIONSEC$

Un nombre indiquant le nombre de secondes qu'a passé l'hôte dans sont état actuel.

$HOSTDOWNTIME$

Un nombre indiquant la profondeur d'arrêt planifié pour l'hôte. Si cet hôte est actuellement dans une période d'arrêt planifié, la valeur sera supérieure à zéro. Si l'hôte n'est pas en cours d'arrêt planifié, la valeur sera zéro.

$HOSTPERCENTCHANGE$

Un nombre (réel) indiquant le pourcentage de changement d'état subit par l'hôte. Le pourcentage de changement d'état est utilisé par l'algorithme de détection d'oscillation.

$HOSTGROUPNAME$

le nom court du groupe d'hôtes auquel appartient cet hôte. Cette valeur provient du paramètre hostgroup_name de la définition de groupe d'hôtes. Si l'hôte fait partie de plus d'un groupe d'hôte cette macro contiendra le nom d'un seul de ceux-ci.

$HOSTGROUPNAMES$

Une liste séparée par des virgules du nom court de tous les groupes d'hôtes auxquels appartient cet hôte.

$LASTHOSTCHECK$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où le dernier contrôle d'hôte a eu lieu.

$LASTHOSTSTATECHANGE$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où l'état de l'hôte a changé pour la dernière fois.

$LASTHOSTUP$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où l'hôte a été vu dans l'état UP pour la dernière fois.

$LASTHOSTDOWN$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où l'hôte a été vu dans l'état DOWN pour la dernière fois.

$LASTHOSTUNREACHABLE$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où l'hôte a été vu dans l'état UNREACHABLE pour la dernière fois.

$HOSTOUTPUT$

La première ligne du texte en sortie du dernier contrôle d'hôte (p. ex. Ping OK).

$LONGHOSTOUTPUT$

Le texte complet (en plus de la première ligne) qui a été renvoyé par le dernier contrôle d'hôte.

$HOSTPERFDATA$

Cette macro contient les données de performance qui ont éventuellement été renvoyées par le dernier contrôle d'hôte.

$HOSTCHECKCOMMAND$

Cette macro contient le nom de la commande (ainsi que les paramètres qui ont pu lui être passés) utilisée lors du contrôle d'hôte.

$HOSTACKAUTHOR$ 8

Une chaîne contenant le nom de l'utilisateur qui a acquitté le problème de l'hôte. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$HOSTACKAUTHORNAME$ 8

Une chaîne contenant le nom court du contact (si applicable) qui a acquitté le problème de l'hôte. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$HOSTACKAUTHORALIAS$ 8

Une chaîne contenant l'alias du contact (si applicable) qui a acquitté le problème de l'hôte. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$HOSTACKCOMMENT$ 8

Une chaîne contenant le commentaire associé à l'acquittement saisi par l'utilisateur qui a acquitté le problème de l'hôte. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$HOSTACTIONURL$

URL d'action associée à l'hôte. Cette macro peut contenir d'autres macros (par exemple $HOSTNAME$), ce qui peut s'avérer pratique quand vous souhaitez passer le nom d'hôte à une page web.

$HOSTNOTESURL$

URL de notes associée à l'hôte. Cette macro peut contenir d'autres macros (par exemple $HOSTNAME$), ce qui peut s'avérer pratique quand vous souhaitez passer le nom d'hôte à une page web.

$HOSTNOTES$

URL de notes associée à l'hôte. Cette macro peut contenir d'autres macros (par exemple $HOSTNAME$), ce qui peut s'avérer pratique quand vous souhaitez avoir l'état d'un hôte spécifique dans la description.

$TOTALHOSTSERVICES$

Le nombre total de services associés à l'hôte.

$TOTALHOSTSERVICESOK$

Le nombre total de services associés à l'hôte qui sont dans un état OK.

$TOTALHOSTSERVICESWARNING$

Le nombre total de services associés à l'hôte qui sont dans un état WARNING.

$TOTALHOSTSERVICESUNKNOWN$

Le nombre total de services associés à l'hôte qui sont dans un état UNKNOWN.

$TOTALHOSTSERVICESCRITICAL$

Le nombre total de services associés à l'hôte qui sont dans un état CRITICAL.

Macros de groupes d'hôtes: 5

$HOSTGROUPALIAS$ 5

Le nom long/alias soit de 1) du groupe d'hôtes passé en argument de la macro à la demande ou soit 2) du groupe d'hôte principal associé à l'hôte actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur est donnée par le paramètre alias de la définition du groupe d'hôtes .

$HOSTGROUPMEMBERS$ 5

Une liste séparée par des virgules des hôtes appartenant soit 1) au groupe d'hôtes passé en argument de la macro à la demande ou soit 2) au groupe d'hôte principal associé à l'hôte actuel (si non utilisé dans le contexte d'une macro à la demande).

$HOSTGROUPNOTES$ 5

Les notes associées avec soit 1) le groupe d'hôtes passé en argument de la macro à la demande ou soit 2) le groupe d'hôte principal associé à l'hôte actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur est donnée par le paramètre notes de la définition du groupe d'hôtes.

$HOSTGROUPNOTESURL$ 5

L' URL de notes associée avec soit 1) le groupe d'hôtes passé en argument de la macro à la demande ou soit 2) le groupe d'hôte principal associé à l'hôte actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur est donnée par le paramètre notes_url de la définition du groupe d'hôtes.

$HOSTGROUPACTIONURL$ 5

L' URL d'action associée avec soit 1) le groupe d'hôtes passé en argument de la macro à la demande ou soit 2) le groupe d'hôte principal associé à l'hôte actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur est donnée par le paramètre action_url de la définition du groupe d'hôtes.

Macros de service :

$SERVICEDESC$

Le nom long/description du service (p. ex. Main Website ). Cette valeur provient du paramètre description de la définition du service.

$SERVICEDISPLAYNAME$

Un nom utilisé pour l'affichage du service. Cette valeur provient du paramètre display_name de la définition du service.

$SERVICESTATE$

Une chaîne indiquant l'état actuel du service (OK, WARNING, UNKNOWN, ou CRITICAL).

$SERVICESTATEID$

Un nombre qui correspond à l'état actuel du service : 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN.

$LASTSERVICESTATE$

Une chaîne indiquant l'état précédent du service (OK, WARNING, UNKNOWN, ou CRITICAL).

$LASTSERVICESTATEID$

Un nombre qui correspond à l'état précédent du service : 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN.

$SERVICESTATETYPE$

Une chaîne indiquant le type d'état actuel du contrôle de service (HARD ou SOFT). L'état est SOFT quand le contrôle de service renvoie un état non-OK state et va être réessayé. L'état est HARD quand le contrôle de service a été tenté le nombre de fois maximum défini.

$SERVICEATTEMPT$

Le nombre actuel d'essais de contrôle du service. Par exemple, si c'est la seconde fois que le service est contrôlé, ce sera le nombre deux. Le nombre actuel d'essais n'est réellement utile que pour l'écriture de gestionnaires d'événements d'hôte pour des états SOFT, qui agiraient de manière spécifique selon le nombre de tentatives.

$MAXSERVICEATTEMPTS$

Le nombre maximum d'essais de contrôle du service actuel. Utile pour l'écriture de gestionnaires d'événements d'hôte pour des états SOFT, qui agiraient de manière spécifique selon le nombre de tentatives de contrôle de service.

$SERVICEISVOLATILE$

Indique si le service est volatile ou pas : 0 = non volatile, 1 = volatile.

$SERVICEEVENTID$

Un numéro unique associé à l'état actuel du service. À chaque fois qu'un service (ou un hôte) change d'état, un numéro global d'événement est incrémenté de un (1). Si un service n'a pas changé d'état, cette macro égale zéro (0).

$LASTSERVICEEVENTID$

Le numéro unique d'événement précédent qui a été donné à un service.

$SERVICEPROBLEMID$

Un numéro unique associé à l'état problématique actuel du service. À chaque fois qu'un service (ou un hôte) change d'état de OK ou UP à un état problématique, un numéro global d'événement est incrémenté de un (1). Cette macro est différente de zéro si le service est actuellement dans un état différent de OK. Les changements d'états entre états différents de OK (par exemple WARNING ou CRITICAL) n'incrémente pas ce numéro unique. Si un service est dans l'état OK, cette macro est égale à zéro (0). Combiné avec les gestionnaires d'événements, cette macro peut être utilisée pour créer automatiquement des tickets de support au moment où les services basculent pour la première fois dans un état problématique.

$LASTSERVICEPROBLEMID$

Le numéro unique de problème précédent qui a été donné à un service. Combiné avec les gestionnaires d'événements, cette macro peut être utilisée pour clore automatiquement des tickets de support au moment où les services reviennent dans un état OK.

$SERVICELATENCY$

Un nombre (réel) indiquant le retard en secondes par rapport au moment où un contrôle de service ordonnancé devait être exécuté. Par exemple, si un contrôle était ordonnancé à 03:14:15 et qu'il n'a été exécuté qu'à 03:14:17, la latence de ce contrôle est de 2.0 secondes.

$SERVICEEXECUTIONTIME$

un nombre (réel) indiquant le nombre de secondes qu'a pris l'exécution du contrôle de service (c.-à-d. le temps pendant lequel le contrôle s'est exécuté).

$SERVICEDURATION$

Une chaîne indiquant le temps qu'a passé le service dans son état actuel. Le format est XXh YYm ZZs, pour les heures, les minutes et les secondes.

$SERVICEDURATIONSEC$

Un nombre indiquant le nombre de secondes qu'a passé le service dans son état actuel.

$SERVICEDOWNTIME$

Un nombre indiquant la profondeur d'arrêt planifié pour le service. Si ce service est actuellement dans une période d' arrêt planifié, la valeur sera supérieure à zéro. Si le service n'est pas en cours d'arrêt planifié, la valeur sera zéro.

$SERVICEPERCENTCHANGE$

Un nombre (réel) indiquant le pourcentage de changement d'état subit par le service. Le pourcentage de changement d'état est utilisé par l'algorithme de détection d'oscillation.

$SERVICEGROUPNAME$

le nom court du groupe de services auquel appartient ce service. Cette valeur provient du paramètre servicegroup_name de la définition de groupe de services. Si le service fait partie de plus d'un groupe de services cette macro contiendra le nom d'un seul de ceux-ci.

$SERVICEGROUPNAMES$

Une liste séparée par des virgules du nom court de tous les groupes de services auxquels appartient ce service.

$LASTSERVICECHECK$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où le dernier contrôle de service a eu lieu.

$LASTSERVICESTATECHANGE$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où l'état du service a changé pour la dernière fois.

$LASTSERVICEOK$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où le service a été vu dans l'état OK pour la dernière fois.

$LASTSERVICEWARNING$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où le service a été vu dans l'état WARNING pour la dernière fois.

$LASTSERVICEUNKNOWN$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où le service a été vu dans l'état UNKNOWN pour la dernière fois.

$LASTSERVICECRITICAL$

C'est le moment au format time_t (secondes écoulées depuis l'époque UNIX) où le service a été vu dans l'état CRITICAL pour la dernière fois.

$SERVICEOUTPUT$

La première ligne du texte en sortie du dernier contrôle de service (p. ex. Ping OK).

$LONGSERVICEOUTPUT$

Le texte complet (en plus de la première ligne) en sortie du dernier contrôle de service (p. ex. Ping OK).

$SERVICEPERFDATA$

Cette macro contient les données de performance qui ont pu être renvoyées par le dernier contrôle de service.

$SERVICECHECKCOMMAND$

Cette macro contient le nom de la commande (ainsi que les paramètres qui ont pu lui être passés) utilisée lors du contrôle de service.

$SERVICEACKAUTHOR$ 8

Une chaîne contenant le nom de l'utilisateur qui a acquitté le problème du service. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$SERVICEACKAUTHORNAME$ 8

Une chaîne contenant le nom court de l'utilisateur (si applicable) qui a acquitté le problème du service. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$SERVICEACKAUTHORALIAS$ 8

Une chaîne contenant l'alias de l'utilisateur (si applicable) qui a acquitté le problème du service. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$SERVICEACKCOMMENT$ 8

Une chaîne contenant le commentaire associé à l'acquittement saisi par l'utilisateur qui a acquitté le problème du service. Cette macro n'est valable que dans les notifications dont la macro $NOTIFICATIONTYPE$ vaut ACKNOWLEDGEMENT.

$SERVICEACTIONURL$

URL d'action associée au service. Cette valeur provient du paramètre action_url de la définition d'informations complémentaires du service.

$SERVICENOTESURL$

URL d'action associée au service. Cette macro peut contenir d'autres macros (par exemple $HOSTNAME$ ou $SERVICEDESC$), ce qui peut s'avérer pratique quand vous souhaitez passer le nom d'hôte à une page web.

$SERVICENOTES$

URL de notes associée au service. Cette macro peut contenir d'autres macros (par exemple $HOSTNAME$ ou $SERVICEDESC$), ce qui peut s'avérer pratique quand vous souhaitez avoir l'état d'un service spécifique dans la description.

Macros de groupes de services : 6

$SERVICEGROUPALIAS$ 6

Le nom long/alias soit de 1) du groupe de services passé en argument de la macro à la demande ou soit 2) du groupe de services principal associé au service actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur est donnée par le paramètre alias de la définition du groupe de services.

$SERVICEGROUPMEMBERS$ 6

Une liste séparée par des virgules des services appartenant soit 1) au groupe de services passé en argument de la macro à la demande ou soit 2) au groupe de services principal associé au service actuel (si non utilisé dans le contexte d'une macro à la demande).

$SERVICEGROUPNOTES$ 6

Les notes associées soit 1) au groupe de services passé en argument de la macro à la demande ou soit 2) au groupe de services principal associé au service actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur provient du paramètre notes de la définition du groupe de services.

$SERVICEGROUPNOTESURL$ 6

L'URL de notes associée soit 1) au groupe de services passé en argument de la macro à la demande ou soit 2) au groupe de services principal associé au service actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur provient du paramètre notes_url de la définition du groupe de services.

$SERVICEGROUPNOTES$ 6

L'URL d'action associée soit 1) au groupe de services passé en argument de la macro à la demande ou soit 2) au groupe de services principal associé au service actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur provient du paramètre action_url de la définition du groupe de services.

Macros de contact :

$CONTACTNAME$

Nom court du contact (p. ex. jdoe) qui est notifié pour un problème d'hôte ou de service. Cette valeur provient du paramètre contact_name de la définition de contact.

$CONTACTALIAS$

Nom long/description du contact (p. ex. John Doe) qui est notifié. Cette valeur provient du paramètre alias de la définition de contact.

$CONTACTEMAIL$

Adresse email du contact qui est notifié. Cette valeur provient du paramètre email de la définition de contact.

$CONTACTPAGER$

Numéro/adresse du Pager du contact qui est notifié. Cette valeur provient du paramètre pager de la définition de contact.

$CONTACTADDRESSn$

Adresse du contact qui est notifié. Chaque contact peut avoir six adresses différentes (en plus de son adresse email et de son numéro de pager). Les macros correspondant à ces adresses sont $CONTACTADDRESS1$ - $CONTACTADDRESS6$. Cette valeur provient du paramètre addressx de la définition de contact.

$CONTACTGROUPNAME$

Le nom court du groupe de contact auquel est rattaché ce contact. Cette valeur provient du paramètre contactgroup_name de la définition de groupes de contacts.

$CONTACTGROUPNAMES$

Une liste séparée par des virgules des groupes de contacts auxquels appartient ce contact.

Macros de groupes de contacts: 5

$CONTACTGROUPALIAS$ 7

Le nom long/alias soit 1) du groupe de contacts passé en argument de la macro à la demande ou soit 2) du groupe de contacts principal associé au contact actuel (si non utilisé dans le contexte d'une macro à la demande). Cette valeur est donnée par le paramètre alias de la définition du groupe de contacts.

$CONTACTGROUPMEMBERS$ 7

Une liste séparée par des virgules de tous les contacts soit 1) du groupe de contacts passé en argument de la macro à la demande ou soit 2) du groupe de contacts principal associé au contact actuel (si non utilisé dans le contexte d'une macro à la demande).

Macros récapitulatives :

$TOTALHOSTSUP$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état UP.

$TOTALHOSTSDOWN$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état DOWN.

$TOTALHOSTSUNREACHABLE$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état UNREACHABLE.

$TOTALHOSTSDOWNUNHANDLED$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état DOWN et qui ne sont pas en cours de traitement. Un problème d'hôte est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

$TOTALHOSTSUNREACHABLEUNHANDLED$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état UNREACHABLE et qui ne sont pas en cours de traitement. Un problème d'hôte est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

$TOTALHOSTPROBLEMS$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état DOWN ou UNREACHABLE.

$TOTALHOSTPROBLEMSUNHANDLED$

Cette macro donne le nombre total d'hôtes qui sont actuellement dans l'état DOWN ou UNREACHABLE et qui ne sont pas en cours de traitement. Un problème d'hôte est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

$TOTALSERVICESOK$

Cette macro donne le nombre total de services qui sont actuellement dans l'état OK.

$TOTALSERVICESWARNING$

Cette macro donne le nombre total de services qui sont actuellement dans l'état WARNING.

$TOTALSERVICESCRITICAL$

Cette macro donne le nombre total de services qui sont actuellement dans l'état CRITICAL.

$TOTALSERVICESUNKNOWN$

Cette macro donne le nombre total de services qui sont actuellement dans l'état UNKNOWN.

$TOTALSERVICESWARNINGUNHANDLED$

Cette macro donne le nombre total de services qui sont actuellement dans l'état WARNING et qui ne sont pas en cours de traitement. Un problème de service est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

$TOTALSERVICESCRITICALUNHANDLED$

Cette macro donne le nombre total de services qui sont actuellement dans l'état CRITICAL et qui ne sont pas en cours de traitement. Un problème de service est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

$TOTALSERVICESUNKNOWNUNHANDLED$

Cette macro donne le nombre total de services qui sont actuellement dans l'état UNKNOWN et qui ne sont pas en cours de traitement. Un problème de service est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

$TOTALSERVICEPROBLEMS$

Cette macro donne le nombre total de services qui sont actuellement dans l'état WARNING, CRITICAL, ou UNKNOWN.

$TOTALSERVICEPROBLEMSUNHANDLED$

Cette macro donne le nombre total de services qui sont actuellement dans l'état WARNING, CRITICAL, ou UNKNOWN et qui ne sont pas en cours de traitement. Un problème de service est dit non traité s'il n'est pas acquitté, ni en cours d'arrêt planifié, et dont les contrôles sont activés.

Macros de notification :

$NOTIFICATIONTYPE$

Une chaîne représentant le type de notification envoyée (PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPINGSTART, FLAPPINGSTOP FLAPPINGDISABLED, DOWNTIMESTART, DOWNTIMEEND ou DOWNTIMECANCELLED).

$NOTIFICATIONRECIPIENTS$

Une liste séparée par des virgules de tous les noms courts des contacts qui sont notifiés pour un hôte ou un service.

$NOTIFICATIONISESCALATED$

Un entier indiquant si la notification a été envoyé à des contacts normaux pour l'hôte ou le service ou si elle a été escaladé. 0 = Notification normale (non-escaladée) , 1 = Notification escaladée.

$NOTIFICATIONAUTHOR$

Une chaîne contenant le nom de l'utilisateur qui a écrit la notification. Si la macro $NOTIFICATIONTYPE$ est égale à DOWNTIMESTART ou DOWNTIMEEND, ce sera le nom de l'utilisateur qui a programmé la maintenance de l'hôte ou du service. Si la macro $NOTIFICATIONTYPE$ est égale à ACKNOWLEDGEMENT, ce sera le nom de l'utilisateur qui a acquitté le problème de'hôte ou de service. Si la macro $NOTIFICATIONTYPE$ est égale à CUSTOM, ce sera le nom de l'utilisateur qui a initié la notification personnalisée de l'hôte ou du service.

$NOTIFICATIONAUTHORNAME$

Une chaîne contenant le nom court du contact (si applicable) tel qu'indiqué dans la macro $NOTIFICATIONAUTHOR$.

$NOTIFICATIONAUTHORALIAS$

Une chaîne contenant l'alias du contact (si applicable) tel qu'indiqué dans la macro $NOTIFICATIONAUTHOR$.

$NOTIFICATIONCOMMENT$

Une chaîne contenant le commentaire entré par l'auteur de la notification. Si la macro $NOTIFICATIONTYPE$ est égale à DOWNTIMESTART ou DOWNTIMEEND, ce sera le commentaire de l'utilisateur qui a programmé la maintenance de l'hôte ou du service. Si la macro $NOTIFICATIONTYPE$ est égale à ACKNOWLEDGEMENT, ce sera le commentaire de l'utilisateur qui a acquitté le problème de'hôte ou de service. Si la macro $NOTIFICATIONTYPE$ est égale à CUSTOM, ce sera le commentaire de l'utilisateur qui a initié la notification personnalisée de l'hôte ou du service.

$HOSTNOTIFICATIONNUMBER$

Le numéro courant de la notification de l'hôte. Le numéro de notification augmente par incrément de un (1) à chaque fois qu'une nouvelle notification est envoyée pour l'hôte (excepté pour les acquittements). Le numéro de notification est remis à zéro quand l'hôte revient à l'état ok (après que la notification de retour à la normale soit envoyée). Les acquittements n'incrémentent pas le numéro de notification, pas plus que les notifications qui ont à voir avec les oscillations et la maintenance planifiée.

$HOSTNOTIFICATIONID$

Un numéro unique qui identifie une notification d'hôte. Les numéros identifiants de notifications sont uniques à travers tout le système de notifications pour les hôtes et services. Vous pouvez donc utiliser ce numéro comme clé primaire dans une base de données de notifications. Ces numéros devraient rester uniques même après redémarrage de Nagios tant que vous activez l'option de rétention d'états. Le numéro identifiant de notification est incrémenté par pas de un (1) à chaque fois qu'une nouvelle notification pour l'hôte est envoyée, sans tenir compte du nombre de contacts notifiés.

$SERVICENOTIFICATIONNUMBER$

Le numéro courant de la notification de service. Le numéro de notification augmente par incrément de un (1) à chaque fois qu'une nouvelle notification est envoyée pour le service (excepté pour les acquittements). Le numéro de notification est remis à zéro quand le service revient à l'état ok (après que la notification de retour à la normale soit envoyée). Les acquittements n'incrémentent pas le numéro de notification, pas plus que les notifications qui ont à voir avec les oscillations et la maintenance planifiée.

$SERVICENOTIFICATIONID$

Un numéro unique qui identifie une notification des service. Les numéros identifiants de notifications sont uniques à travers tout le système de notifications pour les hôtes et services. Vous pouvez donc utiliser ce numéro comme clé primaire dans une base de données de notifications. Ces numéros devraient rester uniques même après redémarrage de Nagios tant que vous activez l'option de rétention d'états. Le numéro identifiant de notification est incrémenté par pas de un (1) à chaque fois qu'une nouvelle notification pour l'hôte est envoyée, sans tenir compte du nombre de contacts notifiés.

Macros de date/heure :

$LONGDATETIME$

Date et heure actuelles (p. ex. Fri Oct 13 00:30:28 CDT 2000). Le format de la date est défini par le paramètre date_format .

$SHORTDATETIME$

Date et heure actuelles (p. ex. 10-13-2000 00:30:28). Le format de la date est défini par le paramètre date_format .

$DATE$

Date du jour (p. ex. 10-13-2000). Le format de la date est défini par le paramètre date_format .

$TIME$

Heure actuelle (p. ex. 00:30:28).

$TIMET$

Moment actuel au format time_t (secondes écoulées depuis l'époque UNIX).

$ISVALIDTIME:$ 9

C'est une macro à la demande spéciale qui renvoie 1 ou 0 en fonction du fait qu'une heure donnée fait partie ou non d'une période de temps précisé. Il y a deux façons d'utiliser cette macro :

  1. $ISVALIDTIME:24x7$ est égale à 1si l'heure courante est valide dans la période de temps 24x7. Égale à 0 dans le cas contraire.

  2. $ISVALIDTIME:24x7:timestamp$ est égale à 1si l'heure donnée par l'argument timestamp (qui doit être au format time_t) est valide dans la période de temps 24x7. Égale à 0 dans le cas contraire.

$NEXTVALIDTIME:$ 9

C'est une macro à la demande spéciale qui renvoie l'heure valide suivante (dans le format time_t) pour une période temps spécifique. Il y a deux façons d'utiliser cette macro :

  1. $NEXTVALIDTIME:24x7$ renvoie la prochaine heure valide - depuis et en incluant l'heure courante - dans la période de temps 24x7.

  2. $NEXTVALIDTIME:24x7:timestamp$ renvoie la prochaine heure valide - depuis et en incluant l'heure précisée par l'argument timestamp (qui doit être précisé dans le format time_t - dans la période de temps 24x7.

Si une prochaine période de temps valide ne peut être trouvée dans la période de temps précisée, la valeur d ela macro est égale à 0.

Macros de fichier :

$MAINCONFIGFILE$

Emplacement du fichier de configuration principal .

$STATUSDATAFILE$

Emplacement du journal des états.

$COMMENTDATAFILE$

Emplacement du fichier de commentaires.

$DOWNTIMEDATAFILE$

Emplacement du fichier des arrêts planifiés.

$RETENTIONDATAFILE$

Emplacement du fichier de mémorisation des états .

$OBJECTCACHEFILE$

Emplacement du fichier de cache des objets.

$TEMPFILE$

Emplacement du fichier temporaire.

$TEMPPATH$

Le dossier précisé dans la variable chemin temporaire.

$LOGFILE$

Emplacement du fichier journal .

$RESOURCEFILE$

Emplacement du fichier de ressources.

$COMMANDFILE$

Emplacement du fichier de commandes externes.

$HOSTPERFDATAFILE$

Emplacement du fichier de performance des hôtes (s'il est défini).

$SERVICEPERFDATAFILE$

Emplacement du fichier de performance des services (s'il est défini).

Macros diverses :

$PROCESSSTARTTIME$

Moment au format time_t (secondes écoulées depuis l'époque UNIX) où le processus Nagios a été (re)démarré pour la dernière fois. Vous pouvez en déduire le nombre de secondes écoulées depuis le démarrage (ou redémarrage) de Nagios, en soustrayant $PROCESSSTARTTIME$ de $TIMET$.

$EVENTSTARTTIME$

Moment au format time_t (secondes écoulées depuis l'époque UNIX) où Nagios a commencé à traiter les événements (contrôles, etc.). Vous pouvez déduire le nombre de secondes qui ont été nécessaires au démarrage de Nagios en soustrayant $PROCESSSTARTTIME$ de $EVENTSTARTTIME$.

$ADMINEMAIL$

Adresse email globale de l'administrateur. Cette valeur provient du paramètre admin_email .

$ADMINPAGER$

Numéro/adresse global du pager de l'administrateur. Cette valeur provient du paramètre admin_pager .

$ARGn$

Le n-ième paramètre passé à la commande (notification, gestionnaire d'événement, contrôle de service, etc.). Nagios gère jusqu'à 32 macros de paramètre (de $ARG1$ à $ARG32$).

$USERn$

La nième macro définie par l'utilisateur. Les macros utilisateur peuvent être définies dans un ou plusieurs fichiers de ressources . Nagios gère jusqu'à 32 macros utilisateur (de $USER1$ à $USER32$).

Notes

1 Ces macros ne sont pas valables pour l'hôte auquel elles sont associées lorsque cet hôte est en cours de contrôle (c.-à-d. qu'elles n'ont pas de sens, car elles ne sont pas encore déterminées).

2 Ces macros ne sont pas valables pour le service auquel elles sont associées lorsque ce service est en cours de contrôle (c.-à-d. qu'elles n'ont pas de sens, car elles ne sont pas encore déterminées).

3 Quand des macros d'hôte sont utilisées dans des commandes relatives à un service (c.-à-d. les notifications de service, les gestionnaires d'événements, etc.) elles font référence à l'hôte auquel est associé le service.

4 Quand les macros récapitulatives d'hôte et de service sont utilisées dans des commandes de notification, les totaux sont filtrés pour ne prendre en compte que les hôtes et les services autorisés à ce contact (c.-à-d. les hôtes et les services configurés pour lui envoyer des notifications).

5 Ces macros sont habituellement associées avec le groupe primaire d'hôtes auquel appartient l'hôte actuel. Elles peuvent donc être considérées comme des macros d'hôtes dans la plupart des cas. Cependant, ces macros ne sont pas valables dans le cas de macros d'hôte à la demande. À la place, elles peuvent être utilisées comme macros de groupe d'hôtes à la demande quand vous passez le nom du groupe d'hôte à la macro. Par exemple: $HOSTGROUPMEMBERS:hg1$ renvoie une liste séparée par des virgules des tous les membres (hôtes) du groupe d'hôtes hg1.

6 Ces macros sont habituellement associées avec le groupe primaire de services auquel appartient le service actuel. Elles peuvent donc être considérées comme des macros de services dans la plupart des cas. Cependant, ces macros ne sont pas valables dans le cas de macros de service à la demande. À la place, elles peuvent être utilisées comme macros de groupe de services à la demande quand vous passez le nom du groupe de services à la macro. Par exemple: $SERVICEGROUPMEMBERS:sg1$ renvoie une liste séparée par des virgules des tous les membres (service) du groupe de services sg1.

7 Ces macros sont habituellement associées avec le groupe primaire de contacts auquel appartient le contact actuel. Elles peuvent donc être considérées comme des macros de contacts dans la plupart des cas. Cependant, ces macros ne sont pas valables dans le cas de macros de contact à la demande. À la place, elles peuvent être utilisées comme macros de groupe de contacts à la demande quand vous passez le nom du groupe de contacts à la macro. Par exemple: $CONTACTGROUPMEMBERS:cg1$ renvoie une liste séparée par des virgules des tous les membres (contact) du groupe de contacts cg1.

8 Ces macros d'acquittement sont abandonnées. Utilisez désormais les macros plus génériques $NOTIFICATIONAUTHOR$, $NOTIFICATIONAUTHORNAME$, $NOTIFICATIONAUTHORALIAS$ ou $NOTIFICATIONCOMMENT$.

9 Ces macros sont seulement valables dans le cas de macros à la demande. Vous devez fournir un argument supplémentaire pour les utiliser. Ces macros ne sont pas disponibles comme variables d'environnement.

10 Les macros de statistiques ne sont pas disponibles comme variables d'environnement si l'option use_large_installation_tweaks est activée, car elles sont plutôt grosses consommatrices de CPU lors de leurs calculs.