2 User macros supported by location
Overview
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:
Hosts/host prototypes
In a host and configuration, user macros can be used in the following fields:
Location | Multiple macros/mix with text1 | |
---|---|---|
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 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 | ||
URL3 | 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
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 configuration, user macros can be used in the following field:
Location | Multiple macros/mix with text1 | |
---|---|---|
Interface port (for passive proxy) | no |
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:
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 URL3 | yes | |
Description | yes | |
Tags | ||
Tag names | yes | |
Tag values | yes |
Web scenario
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 | |
URL3 | 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:
For a complete list of all macros supported in Zabbix, see .
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.