2 Macros

Zabbix supporte plusieurs macros qui peuvent être utilisées dans des situations variées. Une utilisation efficace de macros permet de gagner du temps et de rendre la configuration de Zabbix plus transparente.

Liste des macros supportées

La table contient la liste complète des macros supportées par Zabbix.

MACRO	Notifications et commandes	Notifications de découverte	Notifications d'enregistrement automatique	Scripts GUI	Paramètre clé des items	Labels des cartes	Expressions des Déclencheurs	Nom des Déclencheurs	DESCRIPTION
{DATE}	X	X	X						Date actuelle au format yyyy.mm.dd.
{DISCOVERY.DEVICE.IPADDRESS}		X
{DISCOVERY.DEVICE.STATUS}		X
{DISCOVERY.DEVICE.UPTIME}		X
{DISCOVERY.RULE.NAME}		X
{DISCOVERY.SERVICE.NAME}		X
{DISCOVERY.SERVICE.PORT}		X
{DISCOVERY.SERVICE.STATUS}		X
{DISCOVERY.SERVICE.UPTIME}		X
{ESC.HISTORY}	X								Historique des escalades. Log des messages envoyés précédemment.
{EVENT.ACK.HISTORY}	X
{EVENT.ACK.STATUS}	X
{EVENT.AGE}	X	X	X						Age de l'événement. Utile dans l'escalade des messages.
{EVENT.DATE}	X	X	X						Date de l'événement.
{EVENT.ID}	X	X	X						ID numérique de l'événement qui a déclenché cette action.
{EVENT.TIME}	X	X	X						Heure de l'événement.
{HOSTNAME<1-9>}	X				X	X		X	Nom machine du premier item du déclencheur qui a causé une notification.
{HOST.CONN<1-9>}	X			X	X	X			IP et nom DNS de l'hôte en fonction des paramètres de l'hôte.
{HOST.DNS<1-9>}	X			X	X	X			Nom DNS de l'hôte.
{IPADDRESS<1-9>}	X			X	X	X			Adresse IP du premier item du déclencheur qui a causé une notification.
{ITEM.LASTVALUE<1-9>}	X							X	La dernière valeur du premier item de l'expression du déclencheur qui a causé une notification.. Supporté depuis Zabbix 1.4.3. C'est un alias de {{HOSTNAME}:{TRIGGER.KEY}.last(0)}
{ITEM.LOG.AGE<1-9>}	X
{ITEM.LOG.DATE<1-9>}	X
{ITEM.LOG.EVENTID<1-9>}	X
{ITEM.LOG.NSEVERITY<1-9>}	X
{ITEM.LOG.SEVERITY<1-9>}	X
{ITEM.LOG.SOURCE<1-9>}	X
{ITEM.LOG.TIME<1-9>}	X
{ITEM.NAME<1-9>}	X								nom du premier item du déclencheur qui a causé une notification.
{ITEM.VALUE<1-9>}	X							X	La dernière valeur du Nième item de l'expression du déclencheur si utilisée pour afficher les triggers. Valeur historique (lorsque l'événement s'est déroulé) du Nième item de l'expression du déclencheur of the trigger expression if used for displaying events. Supported from Zabbix 1.4.3.
{NODE.ID<1-9>}	X	X	X
{NODE.NAME<1-9>}	X	X	X
{PROFILE.CONTACT<1-9>}	X								Contact du profil.
{PROFILE.DEVICETYPE<1-9>}	X								Type périphérique du profil.
{PROFILE.HARDWARE<1-9>}	X								Matériel du profil.
{PROFILE.LOCATION<1-9>}	X								Situation du profil.
{PROFILE.MACADDRESS<1-9>}	X								Adresse MAC du profil.
{PROFILE.NAME<1-9>}	X								Nom du profil.
{PROFILE.NOTES<1-9>}	X								Notes du profil.
{PROFILE.OS<1-9>}	X								OS du profil.
{PROFILE.SERIALNO<1-9>}	X								Numéro de série du profil.
{PROFILE.SOFTWARE<1-9>}	X								Logiciel du profil.
{PROFILE.TAG<1-9>}	X								Marque du profil.
{STATUS}	X								Alias pour {TRIGGER.STATUS}.
{TIME}	X	X	X						heure actuelle in hh:mm.ss.
{TRIGGER.COMMENT}	X								Commentaire du déclencheur.
{TRIGGER.EVENTS.UNACK}	X								Number of unacknowledged PROBLEM events for a trigger which generated event
{TRIGGER.ID}	X								ID numérique du déclencheur qui a déclenché cette action.
{TRIGGER.KEY<1-9>}	X								Key of first item of the trigger which caused a notification.
{TRIGGER.NAME}	X								Nom (description) du déclencheur.
{TRIGGER.NSEVERITY}	X								Valeur numérique de la sévérité du déclencheur. Valeurs possibles: 0 - Non classée, 1 - Information, 2 - Avertissement, 3 - Moyen, 4 - Élevée, 5 - Désastre, Supporté depuis Zabbix 1.6.2.
{TRIGGER.SEVERITY}	X								Sévérité du déclencheur. Valeurs possibles: Non classée, Information, Avertissement, Moyen, Élevée, Désastre, Inconnu
{TRIGGER.STATUS}, {STATUS}	X								État du déclencheur. ON - Si le déclencheur est en l'état VRAI, OFF - Si le déclencheur est dans l'état FAUX. {STATUS} est obsolète.
{TRIGGER.URL}	X								URL du déclencheur.
{TRIGGER.VALUE}	X							X	Valeur actuelle du déclencheur: 0 - Le déclencheur est dans l'état OFF, 1 – Le déclencheur est dans l'état ON, 2 – Déclencheur UNKNOWN. Cette macro peut aussi être utilisée dans les expressions de déclencheur.
{TRIGGERS.UNACK}						X			Number of unacknowledged PROBLEM triggers for a map element.
{host:key.func(param)}	X					X	X		Simple macros as used in trigger expressions.
{$MACRO}					X		X		Global and host level macros. See next chapter for details.

Macros for host labels are supported starting from 1.8.

Global and host level macros

Pour une meilleure flexibilté, Zabbix supporte global and host-level macros as well as template-level macros. Ces macros ont une syntaxe spéciale: {$MACRO}. Les macros peuvent être utilisées dans les clés des items et les expressions des déclencheurs.

Les caractères suivants sont autorisés dans les noms des macros: A-Z , 0-9 , _ , .

Zabbix substitue les macros en fonction des priorités suivantes:

host macros (checked first)
macros defined for templates of the host. Zabbix will check templates of deeper level taking into account template inheritance.
global macros (checked last)

Plus clairement,si une macro n'existe pas pour un hôte, Zabbix va essayer de la trouver un des modèles d'hôte. Si il ne la trouve toujours pas, un modèle global sera utilisé s'il existe.

Dans le cas ou Zabbix est incapable de trouver une macro, la macro ne sera pas substituées.

Le niveau global et hôte des macros est un excellent moyen de rendre la maintenance de Zabbix plus aisée.

Utilisation commune dans le cas des macros globale et hôte:

taking advantage of templates with host specific attributes: passwords, port numbers, file names, regular expressions, etc
global macros for global one-click configuration changes and fine tuning

Example 1

Use of host macro in item "Status of SSH daemon" key:

ssh,{$SSH_PORT}

Example 2

Use of host macro in trigger "CPU load is too high":

{ca_001:system.cpu.load[,avg1].last(0)}>{$MAX_CPULOAD}

Example 3

Use of two macros in trigger "CPU load is too high":

{ca_001:system.cpu.load[,avg1].min({$CPULOAD_PERIOD})}>{$MAX_CPULOAD}

Note that a macro can be used as a parameter of trigger function, in this example function min().

Documentation