Zabbix Documentation 2.4

3.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.22.43.23.4

User Tools

Site Tools


Sidebar

manual:appendix:macros:supported_by_location

This is an old revision of the document!


1 Macros supported by location

Overview

The table contains a complete list of macros supported by Zabbix.

  • X means “supported” in that location
  • The numbered macro syntax of {MACRO<1-9>} is used to reference hosts in the order in which they appear in a trigger expression. Thus, macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will expand to the IP of the first, second and third host in the trigger expression, providing the expression contains those hosts.
URL field of dynamic URL screen element ▼DESCRIPTION▼
Low-level discovery rule filter regular expressions
Graph names
Web monitoring6
DB monitoring additional parameters, SSH and Telnet scripts
Host interface IP/DNS
Item names
Trigger names and descriptions
Trigger expressions
Map URLs
Map labels1
Item key parameters
Global scripts including confirmation text
Low-level discovery rule based internal notifications
Item based internal notifications
Trigger based internal notifications
Auto registration notifications
Discovery notifications
Trigger-based notifications and commands
▼MACRO▼ 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{ACTION.ID} X X X X X X Numeric ID of the triggered action.
Supported since 2.2.0.
{ACTION.NAME} X X X X X X Name of the triggered action.
Supported since 2.2.0.
{DATE} X X X X X X Current date in yyyy.mm.dd. format.
{DISCOVERY.DEVICE.IPADDRESS} X IP address of the discovered device.
Available always, does not depend on host being added.
{DISCOVERY.DEVICE.DNS} X DNS name of the discovered device.
Available always, does not depend on host being added.
{DISCOVERY.DEVICE.STATUS} X Status of the discovered device: can be either UP or DOWN.
{DISCOVERY.DEVICE.UPTIME} X Time since the last change of discovery status for a particular device.
For example: 1h 29m.
For devices with status DOWN, this is the period of their downtime.
{DISCOVERY.RULE.NAME} X Name of the discovery rule that discovered the presence or absence of the device or service.
{DISCOVERY.SERVICE.NAME} X Name of the service that was discovered.
For example: HTTP.
{DISCOVERY.SERVICE.PORT} X Port of the service that was discovered.
For example: 80.
{DISCOVERY.SERVICE.STATUS} X Status of the discovered service: can be either UP or DOWN.
{DISCOVERY.SERVICE.UPTIME} X Time since the last change of discovery status for a particular service.
For example: 1h 29m.
For services with status DOWN, this is the period of their downtime.
{ESC.HISTORY} X X X X Escalation history. Log of previously sent messages.
Shows previously sent notifications, on which escalation step they were sent and their status (sent, in progress or failed).
{EVENT.ACK.HISTORY} X Log of acknowledgements on the problem.
{EVENT.ACK.STATUS} X Acknowledgement status of the event (Yes/No).
{EVENT.AGE} X X X X X X Age of the event that triggered an action.
Useful in escalated messages.
{EVENT.DATE} X X X X X X Date of the event that triggered an action.
{EVENT.ID} X X X X X X Numeric ID of the event that triggered an action.
{EVENT.RECOVERY.DATE} X X X X Date of the recovery event.
Can be used in recovery messages only.
Supported since 2.2.0.
{EVENT.RECOVERY.ID} X X X X Numeric ID of the recovery event.
Can be used in recovery messages only. Supported since 2.2.0.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{EVENT.RECOVERY.STATUS} X X X X Verbal value of the recovery event.
Can be used in recovery messages only. Supported since 2.2.0.
{EVENT.RECOVERY.TIME} X X X X Time of the recovery event.
Can be used in recovery messages only.
Supported since 2.2.0.
{EVENT.RECOVERY.VALUE} X X X X Numeric value of the recovery event.
Can be used in recovery messages only.
Supported since 2.2.0.
{EVENT.STATUS} X X X X X X Verbal value of the event that triggered an action.
Supported since 2.2.0.
{EVENT.TIME} X X X X X X Time of the event that triggered an action.
{EVENT.VALUE} X X X X X X Numeric value of the event that triggered an action.
Supported since 2.2.0.
{HOST.CONN<1-9>} X X X X X X2 X X X X5 X X8 X8 IP or host DNS name, depending on host settings 3.
Supported in trigger names since 2.0.0.
{HOST.DESCRIPTION<1-9>} X X X X X Host description.
Supported since 2.4.0.
{HOST.DNS<1-9>} X X X X X X2 X X X X5 X X8 X8 Host DNS name 3.
Supported in trigger names since 2.0.0.
{HOST.HOST<1-9>} X X X X X X X X X X X5 X X8 X8 Host name.
{HOSTNAME<1-9>} is deprecated.
{HOST.ID} X X8 Host ID.
{HOST.IP<1-9>} X X X X X X X2 X X X X5 X X8 X8 Host IP address 3. Supported since 2.0.0.
{IPADDRESS<1-9>} is deprecated.
{HOST.METADATA} X Host metadata.
Used only for active agent auto-registration. Supported since 2.2.0.
{HOST.NAME<1-9>} X X X X X X X X X X X5 X X8 X8 Visible host name.
Supported since 2.0.0.
{HOST.PORT<1-9>} X X X X X X Host (agent) port 3.
Supported in auto-registration since 2.0.0.
Supported in trigger names, trigger descriptions, internal and trigger-based notifications since 2.2.2.
{HOSTGROUP.ID} X Host group ID.
{INVENTORY.ALIAS<1-9>} X X X X Alias field in host inventory.
{INVENTORY.ASSET.TAG<1-9>} X X X X Asset tag field in host inventory.
{INVENTORY.CHASSIS<1-9>} X X X X Chassis field in host inventory.
{INVENTORY.CONTACT<1-9>} X X X X Contact field in host inventory.
{PROFILE.CONTACT<1-9>} is deprecated.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{INVENTORY.CONTRACT.NUMBER<1-9>} X X X X Contract number field in host inventory.
{INVENTORY.DEPLOYMENT.STATUS<1-9>} X X X X Deployment status field in host inventory.
{INVENTORY.HARDWARE<1-9>} X X X X Hardware field in host inventory.
{PROFILE.HARDWARE<1-9>} is deprecated.
{INVENTORY.HARDWARE.FULL<1-9>} X X X X Hardware (Full details) field in host inventory.
{INVENTORY.HOST.NETMASK<1-9>} X X X X Host subnet mask field in host inventory.
{INVENTORY.HOST.NETWORKS<1-9>} X X X X Host networks field in host inventory.
{INVENTORY.HOST.ROUTER<1-9>} X X X X Host router field in host inventory.
{INVENTORY.HW.ARCH<1-9>} X X X X Hardware architecture field in host inventory.
{INVENTORY.HW.DATE.DECOMM<1-9>} X X X X Date hardware decommissioned field in host inventory.
{INVENTORY.HW.DATE.EXPIRY<1-9>} X X X X Date hardware maintenance expires field in host inventory.
{INVENTORY.HW.DATE.INSTALL<1-9>} X X X X Date hardware installed field in host inventory.
{INVENTORY.HW.DATE.PURCHASE<1-9>} X X X X Date hardware purchased field in host inventory.
{INVENTORY.INSTALLER.NAME<1-9>} X X X X Installer name field in host inventory.
{INVENTORY.LOCATION<1-9>} X X X X Location field in host inventory.
{PROFILE.LOCATION<1-9>} is deprecated.
{INVENTORY.LOCATION.LAT<1-9>} X X X X Location latitude field in host inventory.
{INVENTORY.LOCATION.LON<1-9>} X X X X Location longitude field in host inventory.
{INVENTORY.MACADDRESS.A<1-9>} X X X X MAC address A field in host inventory.
{PROFILE.MACADDRESS<1-9>} is deprecated.
{INVENTORY.MACADDRESS.B<1-9>} X X X X MAC address B field in host inventory.
{INVENTORY.MODEL<1-9>} X X X X Model field in host inventory.
{INVENTORY.NAME<1-9>} X X X X Name field in host inventory. {PROFILE.NAME<1-9>} is deprecated.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{INVENTORY.NOTES<1-9>} X X X X Notes field in host inventory. {PROFILE.NOTES<1-9>} is deprecated.
{INVENTORY.OOB.IP<1-9>} X X X X OOB IP address field in host inventory.
{INVENTORY.OOB.NETMASK<1-9>} X X X X OOB subnet mask field in host inventory.
{INVENTORY.OOB.ROUTER<1-9>} X X X X OOB router field in host inventory.
{INVENTORY.OS<1-9>} X X X X OS field in host inventory.
{PROFILE.OS<1-9>} is deprecated.
{INVENTORY.OS.FULL<1-9>} X X X X OS (Full details) field in host inventory.
{INVENTORY.OS.SHORT<1-9>} X X X X OS (Short) field in host inventory.
{INVENTORY.POC.PRIMARY.CELL<1-9>} X X X X Primary POC cell field in host inventory.
{INVENTORY.POC.PRIMARY.EMAIL<1-9>} X X X X Primary POC email field in host inventory.
{INVENTORY.POC.PRIMARY.NAME<1-9>} X X X X Primary POC name field in host inventory.
{INVENTORY.POC.PRIMARY.NOTES<1-9>} X X X X Primary POC notes field in host inventory.
{INVENTORY.POC.PRIMARY.PHONE.A<1-9>} X X X X Primary POC phone A field in host inventory.
{INVENTORY.POC.PRIMARY.PHONE.B<1-9>} X X X X Primary POC phone B field in host inventory.
{INVENTORY.POC.PRIMARY.SCREEN<1-9>} X X X X Primary POC screen name field in host inventory.
{INVENTORY.POC.SECONDARY.CELL<1-9>} X X X X Secondary POC cell field in host inventory.
{INVENTORY.POC.SECONDARY.EMAIL<1-9>} X X X X Secondary POC email field in host inventory.
{INVENTORY.POC.SECONDARY.NAME<1-9>} X X X X Secondary POC name field in host inventory.
{INVENTORY.POC.SECONDARY.NOTES<1-9>} X X X X Secondary POC notes field in host inventory.
{INVENTORY.POC.SECONDARY.PHONE.A<1-9>} X X X X Secondary POC phone A field in host inventory.
{INVENTORY.POC.SECONDARY.PHONE.B<1-9>} X X X X Secondary POC phone B field in host inventory.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{INVENTORY.POC.SECONDARY.SCREEN<1-9>} X X X X Secondary POC screen name field in host inventory.
{INVENTORY.SERIALNO.A<1-9>} X X X X Serial number A field in host inventory.
{PROFILE.SERIALNO<1-9>} is deprecated.
{INVENTORY.SERIALNO.B<1-9>} X X X X Serial number B field in host inventory.
{INVENTORY.SITE.ADDRESS.A<1-9>} X X X X Site address A field in host inventory.
{INVENTORY.SITE.ADDRESS.B<1-9>} X X X X Site address B field in host inventory.
{INVENTORY.SITE.ADDRESS.C<1-9>} X X X X Site address C field in host inventory.
{INVENTORY.SITE.CITY<1-9>} X X X X Site city field in host inventory.
{INVENTORY.SITE.COUNTRY<1-9>} X X X X Site country field in host inventory.
{INVENTORY.SITE.NOTES<1-9>} X X X X Site notes field in host inventory.
{INVENTORY.SITE.RACK<1-9>} X X X X Site rack location field in host inventory.
{INVENTORY.SITE.STATE<1-9>} X X X X Site state/province field in host inventory.
{INVENTORY.SITE.ZIP<1-9>} X X X X Site ZIP/postal field in host inventory.
{INVENTORY.SOFTWARE<1-9>} X X X X Software field in host inventory. {PROFILE.SOFTWARE<1-9>} is deprecated.
{INVENTORY.SOFTWARE.APP.A<1-9>} X X X X Software application A field in host inventory.
{INVENTORY.SOFTWARE.APP.B<1-9>} X X X X Software application B field in host inventory.
{INVENTORY.SOFTWARE.APP.C<1-9>} X X X X Software application C field in host inventory.
{INVENTORY.SOFTWARE.APP.D<1-9>} X X X X Software application D field in host inventory.
{INVENTORY.SOFTWARE.APP.E<1-9>} X X X X Software application E field in host inventory.
{INVENTORY.SOFTWARE.FULL<1-9>} X X X X Software (Full details) field in host inventory.
{INVENTORY.TAG<1-9>} X X X X Tag field in host inventory. {PROFILE.TAG<1-9>} is deprecated.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{INVENTORY.TYPE<1-9>} X X X X Type field in host inventory. {PROFILE.DEVICETYPE<1-9>} is deprecated.
{INVENTORY.TYPE.FULL<1-9>} X X X X Type (Full details) field in host inventory.
{INVENTORY.URL.A<1-9>} X X X X URL A field in host inventory.
{INVENTORY.URL.B<1-9>} X X X X URL B field in host inventory.
{INVENTORY.URL.C<1-9>} X X X X URL C field in host inventory.
{INVENTORY.VENDOR<1-9>} X X X X Vendor field in host inventory.
{ITEM.DESCRIPTION<1-9>} X X X X Description of the Nth item in the trigger expression that caused a notification. Supported since 2.0.0.
{ITEM.ID<1-9>} X X X X Numeric ID of the Nth item in the trigger expression that caused a notification. Supported since 1.8.12.
{ITEM.KEY<1-9>} X X X X Key of the Nth item in the trigger expression that caused a notification. Supported since 2.0.0.
{TRIGGER.KEY} is deprecated.
{ITEM.KEY.ORIG<1-9>} X X X X Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification. Supported since 2.0.6.
{ITEM.LASTVALUE<1-9>} X X