2 Пользовательские макросы, поддерживаемые в зависимости от расположения
Обзор
В этом разделе содержится список мест, где поддерживаются пользовательские макросы.
Для действий, обнаружения сети, прокси и всех мест, перечисленных в разделе Другие места на этой странице, поддерживаются только пользовательские макросы глобального уровня. В указанных местах макросы уровня узла сети и уровня шаблона не будут разрешены.
Чтобы настраивать значения макросов (например, сокращать их или извлекать определенные подстроки), вы можете использовать функции макросов.
Действия
В действиях пользовательские макросы могут использоваться в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Уведомления и команды на основе триггеров | да | |
| Внутренние уведомления на основе триггеров | да | |
| Уведомления об обновлении проблем | да | |
| Уведомления и команды на основе сервисов | да | |
| Уведомления об обновлении сервисов | да | |
| Условие периода времени | нет | |
| Операции | ||
| Длительность шага операции по умолчанию | нет | |
| Длительность шага | нет | |
Узлы сети/прототипы узлов сети
В конфигурации узла сети и прототипа узла сети пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| IP/DNS интерфейса | только DNS | |
| Порт интерфейса | нет | |
| SNMP v1, v2 | ||
| SNMP community | да | |
| SNMP v3 | ||
| Имя контекста | да | |
| Имя безопасности | да | |
| Парольная фраза аутентификации | да | |
| Парольная фраза приватности | да | |
| IPMI | ||
| Имя пользователя | да | |
| Пароль | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Элементы данных / прототипы элементов данных
В конфигурации элемента данных или прототипа элемента данных пользовательские макросы могут использоваться в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Имя элемента данных | да | |
| Параметры ключа элемента данных | да | |
| Интервал обновления | нет | |
| Пользовательские интервалы | нет | |
| Таймаут (доступно для поддерживаемых типов элементов данных) | нет | |
| Хранить до (для истории и трендов) | нет | |
| Описание | да | |
| Вычисляемый/агрегированный элемент данных | ||
| Формула (константы выражения и параметры функций; параметры ключа элемента данных; (только для агрегированного элемента данных) условия фильтрации (имя группы узлов сети и имя тега)) | да | |
| Монитор базы данных | ||
| Имя пользователя | да | |
| Пароль | да | |
| SQL-запрос | да | |
| HTTP агент | ||
| URL3 | да | |
| Поля запроса | да | |
| Тело запроса | да | |
| Заголовки (имена и значения) | да | |
| Требуемые коды состояния | да | |
| HTTP прокси | да | |
| Имя пользователя для HTTP-аутентификации | да | |
| Пароль для HTTP-аутентификации | да | |
| Файл SSL-сертификата | да | |
| Файл SSL-ключа | да | |
| Пароль SSL-ключа | да | |
| Разрешенные узлы сети | да | |
| JMX агент | ||
| Конечная точка JMX | да | |
| Элемент данных-скрипт | ||
| Имена и значения параметров | да | |
| Элемент данных браузера | ||
| Имена и значения параметров | да | |
| SNMP агент | ||
| SNMP OID | да | |
| SSH агент | ||
| Имя пользователя | да | |
| Файл открытого ключа | да | |
| Файл закрытого ключа | да | |
| Пароль | да | |
| Скрипт | да | |
| TELNET агент | ||
| Имя пользователя | да | |
| Пароль | да | |
| Скрипт | да | |
| Zabbix trapper | ||
| Разрешенные узлы сети | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
| Шаги предобработки | ||
| Параметры (включая пользовательские скрипты) | да | |
| Параметры пользовательской обработки ошибок (поля Установить значение в и Установить ошибку в) | да | |
Обнаружение низкого уровня
В правиле обнаружения низкого уровня пользовательские макросы могут использоваться в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Параметры ключа | да | |
| Интервал обновления | нет | |
| Пользовательский интервал | нет | |
| Таймаут (доступно для поддерживаемых типов элементов данных) | нет | |
| Удаление потерянных ресурсов | нет | |
| Отключение потерянных ресурсов | нет | |
| Описание | да | |
| SNMP агент | ||
| SNMP OID | да | |
| SSH агент | ||
| Имя пользователя | да | |
| Файл открытого ключа | да | |
| Файл закрытого ключа | да | |
| Пароль | да | |
| Скрипт | да | |
| TELNET агент | ||
| Имя пользователя | да | |
| Пароль | да | |
| Скрипт | да | |
| Zabbix trapper | ||
| Разрешённые узлы сети | да | |
| Монитор базы данных | ||
| Имя пользователя | да | |
| Пароль | да | |
| SQL-запрос | да | |
| JMX агент | ||
| Конечная точка JMX | да | |
| HTTP агент | ||
| URL3 | да | |
| Поля запроса | да | |
| Тело запроса | да | |
| Заголовки (имена и значения) | да | |
| Требуемые коды состояния | да | |
| Имя пользователя для HTTP-аутентификации | да | |
| Пароль для HTTP-аутентификации | да | |
| Фильтры | ||
| Регулярное выражение | да | |
| Переопределения | ||
| Фильтры: регулярное выражение | да | |
| Операции: интервал обновления (для прототипов элементов данных) | нет | |
| Операции: период хранения истории (для прототипов элементов данных) | нет | |
| Операции: период хранения трендов (для прототипов элементов данных) | нет | |
Обнаружение сети
В правиле обнаружения сети пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Интервал обновления | нет | |
| SNMP v1, v2 | ||
| SNMP community | да | |
| SNMP OID | да | |
| SNMP v3 | ||
| Context name | да | |
| Security name | да | |
| Authentication passphrase | да | |
| Privacy passphrase | да | |
| SNMP OID | да | |
Прокси
В конфигурации прокси пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Адрес для активных агентов > Порт (если прокси принадлежит группе) | нет | |
| Адрес и порт интерфейса (для пассивного прокси) | нет | |
| Тайм-ауты для типов элементов данных | нет | |
Группы прокси
В конфигурации группы прокси пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Период переключения при отказе | нет | |
| Минимальное количество прокси | нет | |
Шаблоны
В конфигурации шаблона пользовательские макросы можно использовать в следующих полях:
Триггеры
В настройке триггера пользовательские макросы могут использоваться в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Имя | да | |
| Рабочие данные | да | |
| Выражение (только в константах и параметрах функций; секретные макросы не поддерживаются) | да | |
| Тег для сопоставления | да | |
| Имя пункта меню | да | |
| URL пункта меню3 | да | |
| Описание | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Веб-сценарий
В конфигурации веб-сценария пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Имя | да | |
| Интервал обновления | нет | |
| Агент | да | |
| HTTP-прокси | да | |
| Переменные (только значения) | да | |
| Заголовки (имена и значения) | да | |
| Шаги | ||
| Имя | да | |
| URL3 | да | |
| Переменные (только значения) | да | |
| Заголовки (имена и значения) | да | |
| Таймаут | нет | |
| Требуемая строка | да | |
| Требуемые коды состояния | нет | |
| Аутентификация | ||
| Пользователь | да | |
| Пароль | да | |
| SSL-сертификат | да | |
| Файл SSL-ключа | да | |
| Пароль SSL-ключа | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Другие расположения
Помимо расположений, перечисленных здесь, пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Глобальные скрипты (URL, script, SSH, Telnet, IPMI), включая текст подтверждения | да | |
| Вебхуки | ||
| JavaScript script | нет | |
| Имя параметра JavaScript script | нет | |
| Значение параметра JavaScript script | да | |
| Панели | ||
| Столбец типа данных Text в виджете панели Top hosts | да | |
| Параметр Description в виджетах панели Item value и Gauge | да | |
| Параметр Text основной/вторичной метки в виджете панели Honeycomb | да | |
| Параметр URL3 в виджете панели URL | да | |
| Пользователи → Пользователи → Способы оповещения | ||
| Когда активно | да | |
| Администрирование → Общие → GUI | ||
| Рабочее время | нет | |
| Администрирование → Общие → Тайм-ауты | ||
| Тайм-ауты для типов элементов данных | нет | |
| Администрирование → Общие → Коннекторы | ||
| URL | да | |
| Имя пользователя | да | |
| Пароль | да | |
| Bearer token | да | |
| Тайм-аут | нет | |
| HTTP proxy | да | |
| Файл SSL-сертификата | да | |
| Файл SSL-ключа | да | |
| Пароль SSL-ключа | да | |
| Оповещения → Способы оповещения → Шаблоны сообщений | ||
| Тема | да | |
| Сообщение | да | |
| Оповещения → Способы оповещения → Скрипт | ||
| Параметры скрипта | да | |
| Оповещения → Способы оповещения → Способ оповещения | ||
| Поля Username и Password для способа оповещения Email (когда Authentication установлено в "Username and password"; рекомендуется использовать секретные макросы) | да | |
Полный список всех макросов, поддерживаемых в Zabbix, см. в разделе поддерживаемые макросы.
Сноски
1 Если несколько макросов в поле или макросы, смешанные с текстом, не поддерживаются для данного расположения, одно значение макроса должно заполнять всё поле целиком.
2 Макросы, используемые в именах и значениях тегов, разрешаются только в процессе генерации события.
3 URL-адреса, содержащие секретный макрос, не будут работать, так как макрос в них будет разрешён как "******".