Для большей гибкости, Zabbix поддерживает пользовательские макросы, которые можно определить на глобальном уровне, на уровне шаблонов и на уровне узлов сети. Эти макросы имеют специальный синтаксис: {$МАКРОС}. В пользовательских макросах можно использовать опциональный контекст, который позволяет переопределить значение по умолчанию для указанного значения контекста. Пользовательские макросы с контекстом имеют схожий синтаксис: {$МАКРОС:контекст}.
Макросы можно использовать в:
В именах макросов допускаются следующие символы: A-Z , 0-9 , _ , .
Zabbix раскрывает макросы в соответствии со следующей очередностью:
Иными словами, если макрос не существует непосредственно у узла сети, тогда Zabbix попытается найти его в шаблонах, присоединенных к этому узлу сети, с учетом увеличивающейся глубины шаблонов. Если макрос все еще не найден, то будет использован макрос глобального уровня, если он существует конечно.
В случае, если Zabbix не удалось найти макрос, макрос не будет раскрыт.
Для добавления пользовательских макросов, перейдите в соответствующие разделы в веб-интерфейсе:
Если пользовательский макрос используется в элементах данных или триггерах шаблона, то предлагается добавить этот макрос к шаблону, даже если он задан на глобальном уровне. Таким образом при экспорте шаблона в XML и импорте его в другую систему элементы данных и триггеры продолжат работать, как это и ожидалось.
Наиболее общие случаи использования глобальных макросов и макросов уровня узлов сети:
Контекстом макроса является простое текстовое значение. Общим случаем использования контекстов в макросах будет использование значения LLD макроса в качестве контекста пользовательских макросов. Например, можно определить прототип триггера для обнаружения примонтированных файловых систем с использованием различных порогов малого свободного места в зависимости от точек монтирования или типов файловых систем.
В контекстах макроса поддерживаются только макросы низкоуровневого обнаружения. Любые другие макросы игнорируются и обрабатываются как текстовые значения.
Технически, контекст макроса задается с использованием правил, похожих на параметры ключей элементов данных, за исключением того, что контекст макроса при наличии ,
символа не обрабатывается как несколько параметров:
"
кавычки, если контекст содержит }
символ или начинается с "
символа. Кавычки внутри заключенном в кавычки контексте необходимо экранировать при помощи \
символа. Сам символ \
не экранируется, что означает, что невозможно задать заключенный в кавычки контекст оканчивающийся на \
символ - макрос {$MACRO:"a:\b\c\"}
ошибочный{$MACRO:A}
тоже самое что и {$MACRO: A}
, но не {$MACRO:A }
.{$MACRO:"A"}
, {$MACRO: "A"}
, {$MACRO:"A" }
и {$MACRO: "A" }
одинаковы, но макрос {$MACRO:"A"}
и {$MACRO:" A "}
не одинаковы.Следующие макросы одинаковы, так как имеют один и тот же контекст: {$MACRO:A}
, {$MACRO: A}
и {$MACRO:"A"}
. Такое поведение отлично от ключей элементов данных, где key[a]
, key[ a]
и key["a"]
одинаковы семантически, но различны для критерия уникальности.
Когда макросы с контекстами обрабатываются, Zabbix ищет макрос со своим контекстом вычисляется. Если макрос с этим контекстом не задан на узле сети или присоединенных шаблонах, и не задан как глобальный макрос с контекстом, тогда выполняется поиск макроса без контекста.
Использование макроса в ключе элемента данных "Состояние демона SSH":
net.tcp.service[ssh,{$SSH_PORT}]
Этот элемент данных можно присоединить к нескольким узлам сети, при условии, что значение {$SSH_PORT} указано на этих узлах сети.
Использование макроса уровня узла сети в триггере "Загрузка CPU слишком высокая":
{ca_001:system.cpu.load[,avg1].last()}>{$MAX_CPULOAD}
Такой триггер можно создать у шаблона, он не будет изменен у отдельных узлов сети.
Если вы хотите использовать количество значений в качестве параметра функции (например, max(#3)), добавьте символ решетки # непосредственно в значение макроса, например вот так: SOME_PERIOD ⇒ #3
Использование двух макросов в триггере "Загрузка CPU слишком высокая":
{ca_001:system.cpu.load[,avg1].min({$CPULOAD_PERIOD})}>{$MAX_CPULOAD}
Заметьте, что макрос можно использовать в качестве параметра в функциях триггеров, в этом примере в функции min().
Пользовательские макросы будут раскрыты в триггерах, если макросы используются в параметрах или как константы. Они НЕ будут раскрыты, если используются как ссылка на функции, имена узлов сети, ключи элементов данных или операторы.
Смотрите пример использования для прототипа триггеров дискового пространства и обратите внимание на пункт ограничения.