Пользовательские макросы с контекстом

Обзор

В пользовательских макросах можно использовать опциональный контекст, который позволяет переопределять значение по умолчанию значением с учётом конкретной ситуации.

Контекст добавляется к имени макроса; синтаксис зависит от того, является ли контекст обычным текстовым значением:

{$МАКРОС:"обычный текст"}

или регулярным выражением:

{$МАКРОС:regex:"регулярное выражение"} 

Обратите внимание, макрос с контекстом в виде регулярного выражения можно задавать только в настройках пользовательских макросов. Если префикс regex: используется в каком-либо другом месте как контекст пользовательского макроса, например в выражении триггера, этот префикс будет рассматриваться как обычный контекст.

Заключение в кавычки контекста опционально (смотрите также важные замечания).

Примеры контекста макросов:

Варианты использования

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

• {$LOW_SPACE_LIMIT} = 10
• {$LOW_SPACE_LIMIT:/home} = 20
• {$LOW_SPACE_LIMIT:regex:"^/[a-z]+$"} = 30

Затем макрос обнаружения на низком уровне может использоваться как контекст макроса в прототипе триггера для обнаружения смонтированных файловых систем:

last(/host/vfs.fs.size[{#FSNAME},pfree])<{$LOW_SPACE_LIMIT:"{#FSNAME}"}

После обнаружения в триггерах будут применяться разные пороги по низкому объему свободного места в зависимости от обнаруженных точек монтирования или типов файловых систем. События о проблеме будут сгенерированы, если:

• в папке /home свободно менее 20% дискового пространства
• в папках, соответствующих шаблону regexp (например, /etc, /tmp или /var), свободно менее 30% дискового пространства
• в папках, не соответствующих шаблону regexp и не являющихся /home, свободно менее 10% дискового пространства

Важные замечания

• Если существует более одного пользовательского макроса с контекстом, Zabbix сначала попытается сопоставить макросы с простым контекстом и только затем макросы с контекстом в виде регулярного выражения в неопределённом порядке.

• Если макрос со своим контекстом не найден на узле сети, присоединённых шаблонах или на глобальном уровне, тогда будет произведён поиск макроса без контекста.
• В контекстах макроса поддерживаются только макросы низкоуровневого обнаружения. Любые другие макросы игнорируются и обрабатываются как текстовые значения.

Технически, контекст макроса задаётся с использованием правил, похожих на параметры ключей элементов данных, за исключением того, что контекст макроса при наличии символа , не обрабатывается как несколько параметров:

• Контекст макроса необходимо заключать в кавычки ​", если контекст содержит символ } или он начинается с символа ​". Кавычки внутри заключённого в кавычки контекста необходимо экранировать при помощи символа \.
• Сам символ \ не экранируется, что означает, что невозможно задать заключённый в кавычки контекст, оканчивающийся на символ \ — макрос {$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​"]» одинаковы семантически, но различны для критерия уникальности.