Поддерживаемые пользовательские макросы по расположению
Обзор
В этом разделе представлен список мест, где поддерживаются определяемые пользователем макросы.
Для Действий, Сетевого обнаружения, Прокси и всех мест, перечисленных в разделе Другие места этой страницы, поддерживаются только пользовательские макросы, определённые на глобальном уровне. В упомянутых местах макросы, определённые на уровне узла сети и на уровне шаблона, раскрываться не будут.
Чтобы настроить значения макросов (например, сократить или извлечь определённые подстроки), можно использовать функции макросов.
Действия
При настройке действий пользовательские макросы могут быть использованы в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Оповещения и команды на события триггеров | да | |
| Внутренние оповещения на события триггеров | да | |
| Оповещения об обновлении проблем | да | |
| Оповещения и команды на события услуг | да | |
| Оповещения об обновлении услуг | да | |
| Условие периода времени | нет | |
| Операции | ||
| Длительность шага операции по умолчанию | нет | |
| Длительность шага | нет | |
Узлы сети / прототипы узлов сети
При настройке узла сети и прототипа узла сети пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| IP адрес / DNS имя интерфейса | только DNS | |
| Порт интерфейса | нет | |
| SNMP v1, v2 | ||
| SNMP community | да | |
| SNMP v3 | ||
| Имя контекста | да | |
| Имя безопасности | да | |
| Пароль аутентификации | да | |
| Ключевая фраза безопасности | да | |
| IPMI | ||
| Имя пользователя | да | |
| Пароль | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Элементы данных / прототипы элементов данных
В конфигурации элемента данных или прототипа элемента данных пользовательские макросы можно использовать в следующих полях:
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Item name | yes | |
| Item key parameters | yes4 | |
| Update interval | no | |
| Custom intervals | no | |
| Timeout (available for supported item types) | no | |
| Store up to (for history and trends) | no | |
| Description | yes | |
| Calculated/aggregate item | ||
| Formula (expression constants and function parameters; item key parameters; (aggregate item only) filter conditions (host group name and tag name)) | yes | |
| Database monitor | ||
| Username | yes | |
| Password | yes | |
| SQL query | yes | |
| HTTP agent | ||
| URL3 | yes | |
| Query fields | yes | |
| 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 | |
| Browser 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 | |
| Tags2 | ||
| Tag names | yes | |
| Tag values | yes | |
| Preprocessing steps | ||
| Parameters (including custom scripts) | yes | |
| Custom error-handling parameters (Set value to and Set error to fields) | yes | |
Низкоуровневое обнаружение
При настройке правил низкоуровневого обнаружения пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Параметры ключа | да | |
| Интервал обновления | нет | |
| Пользовательские интервалы | нет | |
| Время ожидания (доступно для поддерживаемых типов элементов данных) | нет | |
| Удаление потерянных ресурсов | нет | |
| Деактивация потерянных ресурсов | нет | |
| Описание | да | |
| SNMP агент | ||
| SNMP OID | да | |
| SSH агент | ||
| Имя пользователя | да | |
| Файл публичного ключа | да | |
| Файл приватного ключа | да | |
| Пароль | да | |
| Выполняемый скрипт | да | |
| TELNET агент | ||
| Имя пользователя | да | |
| Пароль | да | |
| Выполняемый скрипт | да | |
| Zabbix траппер | ||
| Разрешённые хосты | да | |
| Монитор баз данных | ||
| Имя пользователя | да | |
| Пароль | да | |
| SQL запрос | да | |
| JMX агент | ||
| JMX endpoint | да | |
| HTTP агент | ||
| URL3 | да | |
| Поля запроса | да | |
| Тело запроса | да | |
| Заголовки (имена и значения) | да | |
| Требуемые коды состояния | да | |
| Имя пользователя для HTTP аутентификации | да | |
| Пароль для HTTP аутентификации | да | |
| Фильтры | ||
| Регулярное выражение | да | |
| Замещения | ||
| Фильтры: регулярное выражение | да | |
| Операции: интервал обновления (для прототипов элементов данных) | нет | |
| Операции: период хранения истории (для прототипов элементов данных) | нет | |
| Операции: период хранения динамики изменений (для прототипов элементов данных) | нет | |
Сетевое обнаружение
При настройке правил сетевого обнаружения пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Интервал обновления | нет | |
| SNMP v1, v2 | ||
| SNMP community | да | |
| SNMP OID | да | |
| SNMP v3 | ||
| Имя контекста | да | |
| Имя безопасности | да | |
| Пароль аутентификации | да | |
| Ключевая фраза безопасности | да | |
| SNMP OID | да | |
Прокси
В конфигурации прокси пользовательские макросы можно использовать в следующих полях:
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Address for active agents > Port (if the proxy belongs to a group) | no | |
| Interface address and port (for passive proxy) | no | |
| Timeouts for item types | no | |
Группы прокси
В конфигурации группы прокси пользовательские макросы можно использовать в следующих полях:
| Местоположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Период переключения на резервный прокси | нет | |
| Минимальное количество прокси | нет | |
Шаблоны
При настройке шаблонов пользовательские макросы могут использоваться в следующих полях:
Триггеры
При настройке триггеров пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Имя | да | |
| Оперативные данные | да | |
| Выражение (только в константах и параметрах функций; секретные макросы не поддерживаются) | да | |
| Теги для совпадения | да | |
| Имя записи в меню | да | |
| URL записи в меню3 | да | |
| Описание | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Веб-сценарии
При настройке веб-сценариев пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Имя | да | |
| Интервал обновления | нет | |
| Агент | да | |
| HTTP прокси | да | |
| Переменные (только значения) | да | |
| Заголовки (имена и значения) | да | |
| Шаги | ||
| Имя | да | |
| URL3 | да | |
| Переменные (только значения) | да | |
| Заголовки (имена и значения) | да | |
| Время ожидания | нет | |
| Требуемая строка | да | |
| Требуемые коды состояния | нет | |
| Аутентификация | ||
| Пользователь | да | |
| Пароль | да | |
| Файл SSL сертификата | да | |
| Файл SSL ключа | да | |
| Пароль к SSL ключу | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Другие расположения
Помимо расположений, перечисленных здесь, пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Глобальные скрипты (URL, script, SSH, Telnet, IPMI), включая текст подтверждения | yes | |
| Вебхуки | ||
| Скрипт JavaScript | no | |
| Имя параметра скрипта JavaScript | no | |
| Значение параметра скрипта JavaScript | yes | |
| Панели | ||
| Столбец типа данных Text в виджете панели Top hosts | yes | |
| Параметр Description в виджете панели Item value и Gauge | yes | |
| Параметр Text для основной/вторичной метки в виджете панели Honeycomb | yes | |
| Параметр URL3 в виджете панели URL | yes | |
| Мониторинг > Проблемы, Узлы сети, Последние данные | ||
| Столбец Custom text | yes | |
| Сбор данных > Шаблоны, Узлы сети | ||
| Столбец Custom text | yes | |
| Оповещения > Типы медиа > Шаблоны сообщений | ||
| Тема | yes | |
| Сообщение | yes | |
| Оповещения > Типы медиа > Скрипт | ||
| Параметры скрипта | yes | |
| Оповещения > Типы медиа > Тип медиа | ||
| Поля Username и Password для типа медиа Email (когда для Authentication установлено значение "Username and password"; рекомендуется использовать секретные макросы) | yes | |
| Пользователи > Пользователи > Медиа | ||
| Когда активно | yes | |
| Администрирование > Общие > GUI | ||
| Рабочее время | no | |
| Администрирование > Общие > Тайм-ауты | ||
| Тайм-ауты для типов элементов данных | no | |
| Администрирование > Общие > Коннекторы | ||
| URL | yes | |
| Имя пользователя | yes | |
| Пароль | yes | |
| Bearer token | yes | |
| Тайм-аут | no | |
| HTTP proxy | yes | |
| Файл SSL-сертификата | yes | |
| Файл SSL-ключа | yes | |
| Пароль SSL-ключа | yes | |
Полный список всех макросов, поддерживаемых в Zabbix, см. в разделе поддерживаемые макросы.
Сноски
1 Если для поля не поддерживаются несколько макросов или макросы, смешанные с текстом, для указанного места, одно значение макроса должно заполнять все поле.
2 Макросы, используемые в именах и значениях тегов, разрешаются только в процессе генерации события.
3 URL, содержащие секретный макрос, не будут работать, так как макрос в них будет разрешен как "******".
4 Макросы не поддерживаются в ключе элемента данных Zabbix trapper.