2 User macros supported by location

Overview

User-definable macros are supported in the following locations:

• Hosts
  • Interface IP/DNS
  • Interface port

<!-- -->

• Passive proxy
  • Interface port

<!-- -->

• Items and item prototypes
  • Name
  • Key parameters
  • Update interval
  • Custom intervals
  • History storage period
  • Trend storage period
  • SNMPv3 context name
  • SNMPv3 security name
  • SNMPv3 auth pass
  • SNMPv3 priv pass
  • SNMPv1/v2 community
  • SNMP OID
  • SNMP port
  • SSH username
  • SSH public key
  • SSH private key
  • SSH password
  • SSH script
  • Telnet username
  • Telnet password
  • Telnet script
  • Calculated item formula
  • Trapper item "Allowed hosts" field
  • Database monitoring additional parameters
  • JMX item endpoint field
  • since Zabbix 4.0 also in:
    • item value preprocessing steps
    • HTTP agent URL field
    • HTTP agent HTTP query fields field
    • HTTP agent request body field
    • HTTP agent required status codes field
    • HTTP agent headers field key and value
    • HTTP agent HTTP authentication username field
    • HTTP agent HTTP authentication password field
    • HTTP agent HTTP proxy field
    • HTTP agent SSL certificate file field
    • HTTP agent SSL key file field
    • HTTP agent SSL key password field
    • HTTP agent HTTP timeout field
    • HTTP agent HTTP allowed hosts field

<!-- -->

• Discovery

<!-- -->

    * Update interval
    * SNMPv3 context name
    * SNMPv3 security name
    * SNMPv3 auth pass
    * SNMPv3 priv pass
    * SNMPv1/v2 community
    * SNMP OID

• Low-level discovery rule
  • Name
  • Key parameters
  • Update interval
  • Custom intervals
  • SNMPv3 context name
  • SNMPv3 security name
  • SNMPv3 auth pass
  • SNMPv3 priv pass
  • SNMPv1/v2 community
  • SNMP OID
  • SNMP port
  • SSH username
  • SSH public key
  • SSH private key
  • SSH password
  • SSH script
  • Telnet username
  • Telnet password
  • Telnet script
  • Trapper item "Allowed hosts" field
  • Database monitoring additional parameters
  • JMX item endpoint field
  • Keep lost resources period
  • Filter regular expressions
  • since Zabbix 4.0 also in:
    • HTTP agent URL field
    • HTTP agent HTTP query fields field
    • HTTP agent request body field
    • HTTP agent required status codes field
    • HTTP agent headers field key and value
    • HTTP agent HTTP authentication username field
    • HTTP agent HTTP authentication password field
    • HTTP agent HTTP timeout field

<!-- -->

• Web scenario

<!-- -->

    * Name
    * Update interval
    * Agent
    * HTTP proxy
    * Variables
    * Headers
    * Step name
    * Step URL
    * Step post variables
    * Step headers
    * Step timeout
    * Required string
    * Required status codes
    * Authentication (user and password)
    * SSL certificate file
    * SSL key file
    * SSL key password

• Triggers

<!-- -->

    * Name
    * Expression (only in constants and function parameters)
    * Description
    * URLs

• Trigger-based notifications
• Trigger-based internal notifications

<!-- -->

• Event tags

<!-- -->

    * Tag name 
    * Tag value 
    * Tag for matching 

• Action operations

<!-- -->

    * Default operation step duration
    * Step duration

• Action conditions

<!-- -->

    * Time period condition

• Global scripts (including confirmation text)

<!-- -->

• URL field of dynamic URL screen element

<!-- -->

• Administration → Users → Media: 'When active' field
• Administration → General → Working time: 'Working time' field

For a complete list of all macros supported Zabbix, see macros supported by location.

Actions

In actions, user macros can be used in the following fields:

Hosts/host prototypes

In a host and host prototype configuration, user macros can be used in the following fields:

Items / item prototypes

In an item or an item prototype configuration, user macros can be used in the following fields:

Low-level discovery

In a low-level discovery rule, user macros can be used in the following fields:

Network discovery

In a network discovery rule, user macros can be used in the following fields:

Proxies

In a proxy configuration, user macros can be used in the following field:

Templates

In a template configuration, user macros can be used in the following fields:

Triggers

In a trigger configuration, user macros can be used in the following fields:

Web scenario

In a web scenario configuration, user macros can be used in the following fields:

Other locations

In addition to the locations listed here, user macros can be used in the following fields:

For a complete list of all macros supported in Zabbix, see supported macros.

Footnotes

¹ If multiple macros in a field or macros mixed with text are not supported for the location, a single macro has to fill the whole field.

² URLs that contain a secret macro will not work, as the macro in them will be resolved as "******".