2 User macros supported by location

2 User macros supported by location

Overview

This section contains a list of locations, where user-definable macros are supported.

Only global-level user macros are supported for Actions, Network discovery, Proxies and all locations listed under Other locations section of this page. In the mentioned locations, host-level and template-level macros will not be resolved.

Actions

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

Location		Multiple macros/mix with text¹
Trigger-based notifications and commands		yes
Trigger-based internal notifications		yes
Problem update notifications		yes
Service-based notifications and commands		yes
Service update notifications		yes
Time period condition		no
Operations
	Default operation step duration	no
	Step duration	no

Hosts/host prototypes

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

Location		Multiple macros/mix with text¹
Interface IP/DNS		DNS only
Interface port		no
SNMP v1, v2
	SNMP community	yes
SNMP v3
	Context name	yes
	Security name	yes
	Authentication passphrase	yes
	Privacy passphrase	yes
IPMI
	Username	yes
	Password	yes
Tags²
	Tag names	yes
	Tag values	yes

Items / item prototypes

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

Location		Multiple macros/mix with text¹
Item key parameters		yes
Update interval		no
Custom intervals		no
History storage period		no
Trend storage period		no
Description		yes
Calculated item
	Formula	yes
Database monitor
	Username	yes
	Password	yes
	SQL query	yes
HTTP agent
	URL³	yes
	Query fields	yes
	Timeout	no
	Request body	yes
	Headers (names and values)	yes
	Required status codes	yes
	HTTP proxy	yes
	HTTP authentication username	yes
	HTTP authentication password	yes
	SSl certificate file	yes
	SSl key file	yes
	SSl key password	yes
	Allowed hosts	yes
JMX agent
	JMX endpoint	yes
Script item
	Parameter names and values	yes
SNMP agent
	SNMP OID	yes
SSH agent
	Username	yes
	Public key file	yes
	Private key file	yes
	Password	yes
	Script	yes
TELNET agent
	Username	yes
	Password	yes
	Script	yes
Zabbix trapper
	Allowed hosts	yes
Tags²
	Tag names	yes
	Tag values	yes
Preprocessing
	Step parameters (including custom scripts)	yes

Low-level discovery

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

Location		Multiple macros/mix with text¹
Key parameters		yes
Update interval		no
Custom interval		no
Keep lost resources period		no
Description		yes
SNMP agent
	SNMP OID	yes
SSH agent
	Username	yes
	Public key file	yes
	Private key file	yes
	Password	yes
	Script	yes
TELNET agent
	Username	yes
	Password	yes
	Script	yes
Zabbix trapper
	Allowed hosts	yes
Database monitor
	Username	yes
	Password	yes
	SQL query	yes
JMX agent
	JMX endpoint	yes
HTTP agent
	URL³	yes
	Query fields	yes
	Timeout	no
	Request body	yes
	Headers (names and values)	yes
	Required status codes	yes
	HTTP authentication username	yes
	HTTP authentication password	yes
Filters
	Regular expression	yes
Overrides
	Filters: regular expression	yes
	Operations: update interval (for item prototypes)	no
	Operations: history storage period (for item prototypes)	no
	Operations: trend storage period (for item prototypes)	no

Network discovery

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

Location		Multiple macros/mix with text¹
Update interval		no
SNMP v1, v2
	SNMP community	yes
	SNMP OID	yes
SNMP v3
	Context name	yes
	Security name	yes
	Authentication passphrase	yes
	Privacy passphrase	yes
	SNMP OID	yes

Proxies

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

Location		Multiple macros/mix with text¹
Interface port (for passive proxy)		no

Templates

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

Location		Multiple macros/mix with text¹
Tags²
	Tag names	yes
	Tag values	yes

Triggers

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

Location		Multiple macros/mix with text¹
Name		yes
Operational data		yes
Expression (only in constants and function parameters; secret macros are not supported)		yes
Tag for matching		yes
Menu entry name		yes
Menu entry URL³		yes
Description		yes
Tags²
	Tag names	yes
	Tag values	yes

Web scenario

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

Location		Multiple macros/mix with text¹
Name		yes
Update interval		no
Agent		yes
HTTP proxy		yes
Variables (values only)		yes
Headers (names and values)		yes
Steps
	Name	yes
	URL³	yes
	Variables (values only)	yes
	Headers (names and values)	yes
	Timeout	no
	Required string	yes
	Required status codes	no
Authentication
	User	yes
	Password	yes
	SSL certificate	yes
	SSL key file	yes
	SSL key password	yes
Tags²
	Tag names	yes
	Tag values	yes

Other locations

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

Location		Multiple macros/mix with text¹
Global scripts (URL, script, SSH, Telnet, IPMI), including confirmation text		yes
Webhooks
	JavaScript script	no
	JavaScript script parameter name	no
	JavaScript script parameter value	yes
Dashboards
	Description field of Item value dashboard widget	yes
	URL³ field of dynamic URL dashboard widget	yes
Users → Users → Media
	When active	no
Administration → General → GUI
	Working time	no
Administration → General → Connectors
	URL	yes
	Username	yes
	Password	yes
	Bearer token	yes
	Timeout	no
	HTTP proxy	yes
	SSL certificate file	yes
	SSL key file	yes
	SSL key password	yes
Alerts → Media types → Message templates
	Subject	yes
	Message	yes
Alerts → Media types → Script
	Script parameters	yes

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

Footnotes

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

2 Macros used in tag names and values are resolved only during event generation process.

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