Zabbix Documentation 3.2

2.23.03.23.4In development:4.0Unsupported versions:1.82.02.4

User Tools

Site Tools


Sidebar

ru:manual:config:macros:macro_functions

1 Функции макросов

Обзор

Функции макросов дают возможность индивидуализации значений макросов.

Периодически макрос может раскрыться в значение с которым не всегда легко работать. Значение может быть длинным или содержать определённую подстроку, которая вас интересует и которую вы бы хотели извлечь. Это та задача, где функции макросов могут быть полезны.

Синтаксис функции макросов:

{<макрос>.<функция>(<параметры>)}

где:

  • <макрос> - настраиваемый макрос (например {ITEM.VALUE})
  • <функция> - применяемая функция
  • <параметры> - список параметров функции разделенных запятыми. Параметры необходимо заключать в кавычки, если они начинаются с (пробел), " или содержат ), ,.

Например:

{{ITEM.VALUE}.regsub(шаблон, вывод)}

Поддерживаемые функции макросов

ФУНКЦИЯ
Описание Параметры Поддерживается для
regsub (<шаблон>,<вывод>)
Извлечение подстроки при помощи совпадения с регулярным выражением (с учетом регистра). шаблон - регулярное выражение для поиска совпадения
вывод - опции вывода. \1 - \9 для совпадающих групп поддерживаются управляющие последовательности.

Если шаблон не является корректным регулярным выражением, то вернется 'НЕИЗВЕСТНО'.
{ITEM.VALUE}
{ITEM.LASTVALUE}
iregsub (<шаблон>,<вывод>)
Извлечение подстроки при помощи совпадения с регулярным выражением (без учета регистра). шаблон - регулярное выражение для поиска совпадения
вывод - опции вывода. \1 - \9 для совпадающих групп поддерживаются управляющие последовательности.

Если шаблон не является корректным регулярным выражением, то вернется 'НЕИЗВЕСТНО'.
{ITEM.VALUE}
{ITEM.LASTVALUE}

Если функция используется в поддерживаемых местах, но применён макрос, который не поддерживает функции макросов, тогда макрос раскроется в 'НЕИЗВЕСТНО'.

Если функция макросов применяется в макросе в местах, которые не поддерживают функции макросов, тогда функция будет игнорироваться.

Примеры

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

Полученное значениеМакросВывод
123Log line {{ITEM.VALUE}.regsub(^[0-9]+, Problem)} Problem
123 Log line {{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")} Problem
123 Log line {{ITEM.VALUE}.regsub("^([0-9]+)", Problem ID: \1)} Problem ID: 123
Log line {{ITEM.VALUE}.regsub(".*", "Problem ID: \1")} Problem ID:
MySQL crashed errno 123 {{ITEM.VALUE}.regsub("^([A-Z]+).*([0-9]+)", " Problem ID: \1_\2 ")} Problem ID: MySQL_123 
123 Log line {{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")} *НЕИЗВЕСТНО* (некорректное регулярное выражение)