Documentation
Table of Contents
2 Пользовательские макросы поддерживаемые по назначению
Обзор
Определяемые пользователями макросы поддерживаются в следующих местах:
- Узлы сети
- IP/DNS интерфейса
- Порт интерфейса
- Пассивные прокси
- Порт интерфейса
- Элементы данных и прототипы элементов данных
- Имя (устарело)
- Параметры ключей
- Интервал обновления
- Пользовательские интервалы
- Период хранения истории
- Период хранения динамики изменений
- Имя контекста SNMPv3
- Имя безопасности SNMPv3
- Пароль аутентификации SNMPv3
- Ключевая фраза безопасности SNMPv3
- SNMPv1/v2 community
- SNMP OID
- SNMP порт
- Имя пользователя SSH
- Публичный ключ SSH
- Приватный ключ SSH
- Пароль к SSH
- SSH скрипт
- Имя пользователя к Telnet
- Пароль к Telnet
- Telnet скрипт
- Формула вычисляемого элемента данных
- Поле "Разрешенные узлы сети" траппер элемента данных
- Дополнительные параметры мониторинга баз данных
- Поле элемента данных JMX endpoint
- начиная с Zabbix 4.0 также в:
- шагах предобработки значений элементов данных
- поле URL HTTP агента
- HTTP полях запросов HTTP агента
- поле тела запроса HTTP агента
- поле кодов состояний HTTP агента
- поле заголовков ключа и значения HTTP агента
- поле имени пользователя HTTP аутентификации HTTP агента
- поле пароля HTTP аутентификации HTTP агента
- поле HTTP прокси HTTP агента
- поле файла SSL сертификата HTTP агента
- поле файла SSL ключа HTTP агента
- поле пароля к SSL ключу HTTP агента
- поле HTTP времени ожидания HTTP агента
- поле HTTP разрешенных хостов HTTP агента
- Обнаружения
* Интервал обновления
* Имя контекста SNMPv3
* Имя безопасности SNMPv3
* Пароль аутентификации SNMPv3
* Ключевая фраза безопасности SNMPv3
* SNMPv1/v2 community
* SNMP OID- Правило низкоуровневого обнаружения
* Имя
* Параметры ключей
* Интервал обновления
* Пользовательские интервалы
* Имя контекста SNMPv3
* Имя безопасности SNMPv3
* Пароль аутентификации SNMPv3
* Ключевая фраза безопасности SNMPv3
* SNMPv1/v2 community
* SNMP OID
* SNMP порт
* Имя пользователя SSH
* Публичный ключ SSH
* Приватный ключ SSH
* Пароль к SSH
* SSH скрипт
* Имя пользователя к Telnet
* Пароль к Telnet
* Telnet скрипт
* Поле %%"%%Разрешенные узлы сети%%"%% траппер элемента данных
* Дополнительные параметры мониторинга баз данных
* Поле элемента данных JMX endpoint
* Период хранения потерянных ресурсов
* Регулярные выражения в фильтре
* начиная с Zabbix 4.0 также в:
* поле URL HTTP агента
* HTTP полях запросов HTTP агента
* поле запроса тела HTTP агента
* поле требуемых кодов состояний HTTP агента
* поле заголовков ключа и значения HTTP агента
* поле имени пользователя HTTP аутентификации HTTP агента
* поле пароля HTTP аутентификации HTTP агента
* поле HTTP времени ожидания HTTP агента
* Веб-сценарий
* Имя
* Интервал обновления
* Агент
* HTTP прокси
* Переменные
* Заголовки
* Имя шага
* URL шага
* Post переменные шага
* Заголовки шага
* Время ожидания шага
* Требуемая строка
* Требуемые коды состояний
* Аутентификация
* Файл сертификата SSL
* Файл ключа SSL
* Пароль к ключу SSL
* Триггеры
* Имя
* Выражение (только в константах и в параметрах функций)
* Описание
* URL- Оповещения и команды, основанные на триггерах
- Оповещения о внутренних событиях, основанные на триггерах
- Оповещения обновления проблем
- Теги событий
- Операции действий
- Длительность шага операции по умолчанию
- Длительность шага
- Условия действий
- Условие периода времени
- Глобальные скрипты (включая текст подтверждения)
- Поле URL динамического элемента комплексного экрана URL
- Администрирование → Пользователи → Оповещения: поле 'Когда активно'
- Администрирование → Общие → Рабочее время: поле 'Рабочее время'
Полный список всех поддерживаемых макросов в Zabbix смотрите поддерживаемые макросы.
Actions
In actions, user macros can be used in the following fields:
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Trigger-based notifications and commands | yes | |
| Trigger-based internal notifications | yes | |
| Problem update notifications | yes | |
| Time period condition | no | |
| Operations | ||
| Default operation step duration | no | |
| Step duration | no | |
Hosts
In a host 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 | ||
| Interface community | yes | |
| SNMP v3 | ||
| Interface 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 text1 | |
|---|---|---|
| Name (deprecated) | yes | |
| Item key parameters | yes | |
| Update interval | no | |
| Custom intervals | no | |
| History storage period | no | |
| Trend storage period | no | |
| //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 | |
| //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 | |
| Preprocessing | ||
| Step parameters | yes | |
Low-level discovery
In a low-level discovery rule, user macros can be used in the following fields:
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Name | yes | |
| Key parameters | yes | |
| Update interval | no | |
| Custom interval | no | |
| Keep lost resources period | no | |
| 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 | ||
| Additional parameters | 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 | |
Network discovery
In a network discovery rule, user macros can be used in the following fields:
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| 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 text1 | |
|---|---|---|
| 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 text1 | |
|---|---|---|
| //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 text1 | |
|---|---|---|
| Name | yes | |
| Operational data | yes | |
| Expression (only in constants and function parameters; secret macros are not supported). | yes | |
| Description | yes | |
| URL | yes | |
| Tag for matching | 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 text1 | |
|---|---|---|
| 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 | |
Other locations
In addition to the locations listed here, user macros can be used in the following fields:
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Global scripts (including confirmation text) | yes | |
| Monitoring → Screens | ||
| URL field of dynamic URL screen element | yes | |
| Administration → Users → Media | ||
| When active | no | |
| Administration → General → Working time | ||
| Working time | no | |
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.