2. Пользовательские макросы, поддерживаемые по местоположению
Обзор
В этом разделе представлен список мест, где поддерживаются определяемые пользователем макросы.
Для Действий, Сетевого обнаружения, Прокси и всех мест, перечисленных в разделе Другие места этой страницы, поддерживаются только пользовательские макросы, определённые на глобальном уровне. В упомянутых местах макросы, определённые на уровне узла сети и на уровне шаблона, раскрываться не будут.
Чтобы настроить значения макросов (например, сократить или извлечь определённые подстроки), можно использовать функции макросов.
Действия
При настройке действий пользовательские макросы могут быть использованы в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Оповещения и команды на события триггеров | да | |
| Внутренние оповещения на события триггеров | да | |
| Оповещения об обновлении проблем | да | |
| Оповещения и команды на события услуг | да | |
| Оповещения об обновлении услуг | да | |
| Условие периода времени | нет | |
| Операции | ||
| Длительность шага операции по умолчанию | нет | |
| Длительность шага | нет | |
Узлы сети / прототипы узлов сети
При настройке узла сети и прототипа узла сети пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| IP адрес / DNS имя интерфейса | только DNS | |
| Порт интерфейса | нет | |
| SNMP v1, v2 | ||
| SNMP community | да | |
| SNMP v3 | ||
| Имя контекста | да | |
| Имя безопасности | да | |
| Пароль аутентификации | да | |
| Ключевая фраза безопасности | да | |
| IPMI | ||
| Имя пользователя | да | |
| Пароль | да | |
| Теги2 | ||
| Имена тегов | да | |
| Значения тегов | да | |
Элементы данных / прототипы элементов данных
В конфигурации элемента данных или прототипа элемента данных пользовательские макросы можно использовать в следующих полях:
| Расположение | Несколько макросов/смешивание с текстом1 | |
|---|---|---|
| Имя элемента данных | yes | |
| Параметры ключа элемента данных | yes4 | |
| Интервал обновления | no | |
| Пользовательские интервалы | no | |
| Тайм-аут (доступно для поддерживаемых типов элементов данных) | no | |
| Хранить до (для истории и трендов) | no | |
| Описание | yes | |
| Вычисляемый/агрегированный элемент данных | ||
| Формула (константы выражения и параметры функций; параметры ключа элемента данных; (только для агрегированного элемента данных) условия фильтрации (имя группы узлов сети и имя тега)) | yes | |
| Монитор базы данных | ||
| Имя пользователя | yes | |
| Пароль | yes | |
| SQL-запрос | yes | |
| HTTP agent | ||
| URL3 | yes | |
| Поля запроса | yes | |
| Тело запроса | yes | |
| Заголовки (имена и значения) | yes | |
| Требуемые коды состояния | yes | |
| HTTP proxy | yes | |
| Имя пользователя для HTTP-аутентификации | yes | |
| Пароль для HTTP-аутентификации | yes | |
| Файл сертификата SSL | yes | |
| Файл ключа SSL | yes | |
| Пароль ключа SSL | yes | |
| Разрешенные узлы сети | yes | |
| JMX agent | ||
| JMX endpoint | yes | |
| Элемент данных скрипта | ||
| Имена и значения параметров | yes | |
| Элемент данных браузера | ||
| Имена и значения параметров | yes | |
| SNMP agent | ||
| SNMP OID | yes | |
| SSH agent | ||
| Имя пользователя | yes | |
| Файл открытого ключа | yes | |
| Файл закрытого ключа | yes | |
| Пароль | yes | |
| Скрипт | yes | |
| TELNET agent | ||
| Имя пользователя | yes | |
| Пароль | yes | |
| Скрипт | yes | |
| Zabbix trapper | ||
| Разрешенные узлы сети | yes | |
| Теги2 | ||
| Имена тегов | yes | |
| Значения тегов | yes | |
| Шаги предварительной обработки | ||
| Параметры (включая пользовательские скрипты) | yes | |
| Параметры обработки пользовательских ошибок (Set value to и Set error to) | 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 | да | |
Прокси серверы
При настройке прокси серверов пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Адрес для активных агентов > Порт (если прокси принадлежит группе) | нет | |
| Адрес интерфейса и порт (для пассивных прокси) | нет | |
| Время ожидания по типам элементов данных | нет | |
Группы прокси
При настройке групп прокси пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом1 | |
|---|---|---|
| Период аварийного переключения (Failover period) | нет | |
| Минимальное количество прокси (Minimum number of proxies) | нет | |
Шаблоны
При настройке шаблонов пользовательские макросы могут использоваться в следующих полях:
Триггеры
При настройке триггеров пользовательские макросы могут использоваться в следующих полях:
| Место | Несколько макросов/вперемешку с текстом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 | |
| Оповещения → Типы медиа → Шаблоны сообщений | ||
| Тема | yes | |
| Сообщение | yes | |
| Оповещения → Типы медиа → Скрипт | ||
| Параметры скрипта | yes | |
| Оповещения → Типы медиа → Тип медиа | ||
| Поля Username и Password для типа медиа Email (когда для Authentication установлено значение "Username and password"; рекомендуется использовать секретные макросы) | yes | |
| Пользователи → Пользователи → Медиа | ||
| Когда активно | no | |
| Администрирование → Общее → 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.