[comment]: # ({d428738a-d428738a})
# 2 Пользовательские макросы, поддерживаемые в зависимости от расположения

[comment]: # ({/d428738a-d428738a})

[comment]: # ({0586ac4e-f0afb8e0})
#### Обзор

В этом разделе содержится список мест, где поддерживаются [пользовательские](/manual/config/macros/user_macros) макросы.

::: noteclassic
Для *действий*, *обнаружения сети*, *прокси* и всех мест, перечисленных в разделе *Другие места* на этой странице, поддерживаются только пользовательские макросы глобального уровня.
В указанных местах макросы уровня узла сети и уровня шаблона не будут разрешены.
:::

::: noteclassic
Чтобы настраивать значения макросов (например, сокращать их или извлекать определенные подстроки), вы можете использовать [функции макросов](/manual/config/macros/macro_functions).
:::

[comment]: # ({/0586ac4e-f0afb8e0})

[comment]: # ({bb611c5d-7cb4c86b})
#### Действия

В [действиях](/manual/config/notifications/action) пользовательские макросы могут
использоваться в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Уведомления и команды на основе триггеров|<|да|
|Внутренние уведомления на основе триггеров|<|да|
|Уведомления об обновлении проблем|<|да|
|Уведомления и команды на основе сервисов|<|да|
|Уведомления об обновлении сервисов|<|да|
|Условие периода времени|<|нет|
|*Операции*|<|<|
| |Длительность шага операции по умолчанию|нет|
|^|Длительность шага|нет|

[comment]: # ({/bb611c5d-7cb4c86b})

[comment]: # ({9d1364cf-f30645e0})
#### Узлы сети/прототипы узлов сети

В конфигурации [узла сети](/manual/config/hosts/host) и [прототипа
узла сети](/manual/vm_monitoring/example#create-a-host-prototype) пользовательские
макросы можно использовать в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|IP/DNS интерфейса|<|только DNS|
|Порт интерфейса|<|нет|
|*SNMP v1, v2*|<|<|
| |SNMP community|да|
|*SNMP v3*|<|<|
| |Имя контекста|да|
|^|Имя безопасности|да|
|^|Парольная фраза аутентификации|да|
|^|Парольная фраза приватности|да|
|*IPMI*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|*Теги*^[2](supported_by_location_user#footnotes)^|<|<|
| |Имена тегов|да|
|^|Значения тегов|да|

[comment]: # ({/9d1364cf-f30645e0})

[comment]: # ({7be6d794-d51563d6})
#### Элементы данных / прототипы элементов данных

В конфигурации [элемента данных](/manual/config/items/item) или [прототипа
элемента данных](/manual/discovery/low_level_discovery/item_prototypes)
пользовательские макросы могут использоваться в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Имя элемента данных|<|да|
|Параметры ключа элемента данных|<|да|
|Интервал обновления|<|нет|
|Пользовательские интервалы|<|нет|
|Таймаут (доступно для [поддерживаемых](/manual/web_interface/frontend_sections/administration/general#timeouts) типов элементов данных)|<|нет|
|Хранить до (для истории и трендов)|<|нет|
|Описание|<|да|
|*Вычисляемый/агрегированный элемент данных*|<|<|
| |Формула (константы выражения и параметры функций; параметры ключа элемента данных; (*только для агрегированного элемента данных*) условия фильтрации (имя группы узлов сети и имя тега))|да|
|*Монитор базы данных*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|^|SQL-запрос|да|
|*HTTP агент*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|да|
|^|Поля запроса|да|
|^|Тело запроса|да|
|^|Заголовки (имена и значения)|да|
|^|Требуемые коды состояния|да|
|^|HTTP прокси|да|
|^|Имя пользователя для HTTP-аутентификации|да|
|^|Пароль для HTTP-аутентификации|да|
|^|Файл SSL-сертификата|да|
|^|Файл SSL-ключа|да|
|^|Пароль SSL-ключа|да|
|^|Разрешенные узлы сети|да|
|*JMX агент*|<|<|
| |Конечная точка JMX|да|
|*Элемент данных-скрипт*|<|<|
| |Имена и значения параметров|да|
|*Элемент данных браузера*|<|<|
| |Имена и значения параметров|да|
|*SNMP агент*|<|<|
| |SNMP OID|да|
|*SSH агент*|<|<|
| |Имя пользователя|да|
|^|Файл открытого ключа|да|
|^|Файл закрытого ключа|да|
|^|Пароль|да|
|^|Скрипт|да|
|*TELNET агент*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|^|Скрипт|да|
|*Zabbix trapper*|<|<|
| |Разрешенные узлы сети|да|
|*Теги*^[2](supported_by_location_user#footnotes)^|<|<|
| |Имена тегов|да|
|^|Значения тегов|да|
|*Шаги предобработки*|<|<|
| |Параметры (включая пользовательские скрипты)|да|
| |Параметры пользовательской обработки ошибок (поля *Установить значение в* и *Установить ошибку в*)|да|

[comment]: # ({/7be6d794-d51563d6})

[comment]: # ({04aa381c-747bd0ca})
#### Обнаружение низкого уровня

В [правиле
обнаружения низкого уровня](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery)
пользовательские макросы могут использоваться в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Параметры ключа|<|да|
|Интервал обновления|<|нет|
|Пользовательский интервал|<|нет|
|Тайм-аут (доступно для [поддерживаемых](/manual/web_interface/frontend_sections/administration/general#timeouts) типов элементов данных)|<|нет|
|Удаление потерянных ресурсов|<|нет|
|Отключение потерянных ресурсов|<|нет|
|Описание|<|да|
|*SNMP агент*|<|<|
| |SNMP OID|да|
|*SSH агент*|<|<|
| |Имя пользователя|да|
|^|Файл открытого ключа|да|
|^|Файл закрытого ключа|да|
|^|Пароль|да|
|^|Скрипт|да|
|*TELNET агент*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|^|Скрипт|да|
|*Zabbix trapper*|<|<|
| |Разрешенные узлы сети|да|
|*Монитор базы данных*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|^|SQL-запрос|да|
|*JMX агент*|<|<|
| |Конечная точка JMX|да|
|*HTTP агент*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|да|
|^|Поля запроса|да|
|^|Тело запроса|да|
|^|Заголовки (имена и значения)|да|
|^|Требуемые коды состояния|да|
|^|Имя пользователя для HTTP-аутентификации|да|
|^|Пароль для HTTP-аутентификации|да|
|*Фильтры*|<|<|
| |Регулярное выражение|да|
|*Переопределения*|<|<|
| |Фильтры: регулярное выражение|да|
|^|Операции: интервал обновления (для прототипов элементов данных)|нет|
|^|Операции: период хранения истории (для прототипов элементов данных)|нет|
|^|Операции: период хранения трендов (для прототипов элементов данных)|нет|

[comment]: # ({/04aa381c-747bd0ca})

[comment]: # ({7c6ab06a-95f2f372})
#### Обнаружение сети

В [правиле обнаружения сети](/manual/discovery/network_discovery/rule)
пользовательские макросы можно использовать в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Интервал обновления|<|нет|
|*SNMP v1, v2*|<|<|
| |SNMP community|да|
|^|SNMP OID|да|
|*SNMP v3*|<|<|
| |Context name|да|
|^|Security name|да|
|^|Authentication passphrase|да|
|^|Privacy passphrase|да|
|^|SNMP OID|да|

[comment]: # ({/7c6ab06a-95f2f372})

[comment]: # ({3962fa7e-575d88fc})
#### Прокси

В конфигурации [прокси](/manual/distributed_monitoring/proxies#configuration)
пользовательские макросы можно использовать в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|*Адрес для активных агентов > Порт* (если прокси принадлежит группе)|<|нет|
|Адрес и порт интерфейса (для пассивного прокси)|<|нет|
|Тайм-ауты для типов элементов данных|<|нет|

[comment]: # ({/3962fa7e-575d88fc})

[comment]: # ({76ff2b0f-dbeb9eca})
#### Группы прокси

В конфигурации [группы прокси](/manual/distributed_monitoring/proxies/ha#configuring-a-proxy-group)
пользовательские макросы можно использовать в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Период переключения при отказе|<|нет|
|Минимальное количество прокси|<|нет|

[comment]: # ({/76ff2b0f-dbeb9eca})

[comment]: # ({d5117b03-32b6aef1})
#### Шаблоны

В конфигурации [шаблона](/manual/config/templates/template) пользовательские
макросы можно использовать в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|*Метки*^[2](supported_by_location_user#footnotes)^|<|<|
| |Имена меток|yes|
|^|Значения меток|yes|

[comment]: # ({/d5117b03-32b6aef1})

[comment]: # ({0d27e496-c78b04ef})
#### Триггеры

В настройке [триггера](/manual/config/triggers/trigger) пользовательские макросы могут использоваться в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Имя|<|да|
|Рабочие данные|<|да|
|Выражение (только в константах и параметрах функций; секретные макросы не поддерживаются)|<|да|
|Тег для сопоставления|<|да|
|Имя пункта меню|<|да|
|URL пункта меню^[3](supported_by_location_user#footnotes)^|<|да|
|Описание|<|да|
|*Теги*^[2](supported_by_location_user#footnotes)^|<|<|
| |Имена тегов|да|
|^|Значения тегов|да|

[comment]: # ({/0d27e496-c78b04ef})

[comment]: # ({423f6587-78f1f511})
#### Веб-сценарий

В конфигурации [веб-сценария](/manual/web_monitoring) пользовательские макросы
можно использовать в следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Имя|<|да|
|Интервал обновления|<|нет|
|Агент|<|да|
|HTTP-прокси|<|да|
|Переменные (только значения)|<|да|
|Заголовки (имена и значения)|<|да|
|*Шаги*|<|<|
| |Имя|да|
|^|URL^[3](supported_by_location_user#footnotes)^|да|
|^|Переменные (только значения)|да|
|^|Заголовки (имена и значения)|да|
|^|Таймаут|нет|
|^|Требуемая строка|да|
|^|Требуемые коды состояния|нет|
|*Аутентификация*|<|<|
| |Пользователь|да|
|^|Пароль|да|
|^|SSL-сертификат|да|
|^|Файл SSL-ключа|да|
|^|Пароль SSL-ключа|да|
|*Теги*^[2](supported_by_location_user#footnotes)^|<|<|
| |Имена тегов|да|
|^|Значения тегов|да|

[comment]: # ({/423f6587-78f1f511})

[comment]: # ({f63f6226-efe84e1d})
#### Другие расположения

Помимо расположений, перечисленных здесь, пользовательские макросы можно использовать в
следующих полях:

|Расположение|<|Несколько макросов/смешивание с текстом^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|Глобальные скрипты (URL, script, SSH, Telnet, IPMI), включая текст подтверждения|<|да|
|Вебхуки|<|<|
| |JavaScript script|нет|
|^|Имя параметра JavaScript script|нет|
|^|Значение параметра JavaScript script|да|
|*Панели*|<|<|
| |Столбец типа данных *Text* в виджете панели *Top hosts*|да|
|^|Параметр *Description* в виджетах панели *Item value* и *Gauge*|да|
|^|Параметр *Text* основной/вторичной метки в виджете панели *Honeycomb*|да|
|^|Параметр *URL*^[3](supported_by_location_user#footnotes)^ в виджете панели *URL*|да|
|*Пользователи → Пользователи → Способы оповещения*|<|<|
| |Когда активно|да|
|*Администрирование → Общие → GUI*|<|<|
| |Рабочее время|нет|
|*Администрирование → Общие → Тайм-ауты*|<|<|
| |Тайм-ауты для типов элементов данных|нет|
|*Администрирование → Общие → Коннекторы*|<|<|
| |URL|да|
|^|Имя пользователя|да|
|^|Пароль|да|
|^|Bearer token|да|
|^|Тайм-аут|нет|
|^|HTTP proxy|да|
|^|Файл SSL-сертификата|да|
|^|Файл SSL-ключа|да|
|^|Пароль SSL-ключа|да|
|*Оповещения → Способы оповещения → Шаблоны сообщений*|<|<|
| |Тема|да|
|^|Сообщение|да|
|*Оповещения → Способы оповещения → Скрипт*|<|<|
| |Параметры скрипта|да|
|*Оповещения → Способы оповещения → Способ оповещения*|<|<|
| |Поля *Username* и *Password* для способа оповещения *Email* (когда *Authentication* установлено в "Username and password"; рекомендуется использовать [секретные макросы](/manual/config/macros/user_macros#configuration))|да|

Полный список всех макросов, поддерживаемых в Zabbix, см. в разделе [поддерживаемые
макросы](/manual/appendix/macros/supported_by_location).

[comment]: # ({/f63f6226-efe84e1d})

[comment]: # ({3f947571-5a370e78})
##### Сноски

^**1**^ Если несколько макросов в поле или макросы, смешанные с текстом, не поддерживаются для данного расположения, одно значение макроса должно заполнять всё поле целиком.

^**2**^ Макросы, используемые в именах и значениях тегов, разрешаются только в процессе генерации события.

^**3**^ URL-адреса, содержащие [секретный
макрос](/manual/config/macros/user_macros#configuration), не будут работать,
так как макрос в них будет разрешён как "\*\*\*\*\*\*".

[comment]: # ({/3f947571-5a370e78})