Zabbix Documentation 4.2

3.04.04.45.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


ru:manual:appendix:triggers:functions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
ru:manual:appendix:triggers:functions [2019/06/28 03:46]
neogan fixed upstream changes
ru:manual:appendix:triggers:functions [2019/12/02 08:07] (current)
Line 3: Line 3:
 Здесь перечислены все поддерживаемые функции в [[:​ru/​manual/​config/​triggers/​expression|выражениях триггеров]]:​ Здесь перечислены все поддерживаемые функции в [[:​ru/​manual/​config/​triggers/​expression|выражениях триггеров]]:​
  
-^ ФУКНЦИЯ ​ ^^^^+^ ФУНКЦИЯ ​ ^^^^
 ^ ^  **Описания** ​ ^  **Параметры** ​ ^  **Комментарии** ​ ^ ^ ^  **Описания** ​ ^  **Параметры** ​ ^  **Комментарии** ​ ^
 |**abschange** ​ ^^^^ |**abschange** ​ ^^^^
Line 9: Line 9:
 ^ |||| ^ ||||
 |**avg** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**avg** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
-^ |Среднее значение элемента данных за указанный период времени. |**сек** или **кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - точка вычисления перемещается на указанное количество секунд назад во времени |Поддерживаемые типы значений:​ float, int\\ \\ Примеры:​\\ => avg(#5) -> среднее значение за пять последних значений\\ => avg(1h) -> среднее значение за час\\ => avg(1h,1d) -> среднее значение за час днем ранее.\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. Этот параметр очень полезен,​ если требуется сравнить текущее значение усреднения со значением усреднения сдвиг_времени секунд ранее. |+^ |Среднее значение элемента данных за указанный период времени. |**сек** или **кол-во** - максимальный ​период<​sup>​**[[#​примечания|1]]**</​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - точка вычисления перемещается на указанное количество секунд назад во времени |Поддерживаемые типы значений:​ float, int\\ \\ Примеры:​\\ => avg(#5) -> среднее значение за пять последних значений\\ => avg(1h) -> среднее значение за час\\ => avg(1h,1d) -> среднее значение за час днем ранее.\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. Этот параметр очень полезен,​ если требуется сравнить текущее значение усреднения со значением усреднения сдвиг_времени секунд ранее. |
 ^ |||| ^ ||||
 |**band** (<​сек<​nowiki>​|</​nowiki>#​кол-во>,​маска,<​сдвиг_времени>​) ​ ^^^^ |**band** (<​сек<​nowiki>​|</​nowiki>#​кол-во>,​маска,<​сдвиг_времени>​) ​ ^^^^
-^ |Значение "​побитового И" от значения элемента данных и маски. |**сек** (игнорируется,​ равно #1) или **кол-во** (опционально) - N-ое наиболее новое значение\\ **маска** (обязательна) - 64-битное целое число (0 - 18446744073709551615)\\ **сдвиг_времени** (опционально) - см. функцию avg() |Поддерживаемые типы значений:​ int\\ \\ Обратите внимание,​ что ''#​кол-во''​ здесь работает иначе, чем во многих других функциях (смотри last()).\\ \\ Хотя сравнение выполняется побитовым образом,​ все значения должны подставляться и возвращаться в десятичном виде. Например,​ выполнение проверки 3-го бита, сравнением с 4, не со 100.\\ \\ Примеры:​\\ => %%band(,​​12)=8 or band(,​​12)=4%% -> 3-ий и 4-ый биты установлены,​ но не оба в одно время\\ => %%band(,​​20)=16%% -> 3-ий бит не установлен и 5 бит установлен.\\ \\ Эта функция поддерживается начиная с Zabbix 2.2.0. |+^ |Значение "​побитового И" от значения элемента данных и маски. |**сек** (игнорируется,​ равно #1) или **#кол-во** (опционально) - N-ое наиболее новое значение\\ **маска** (обязательна) - 64-битное целое число (0 - 18446744073709551615)\\ **сдвиг_времени** (опционально) - см. функцию avg() |Поддерживаемые типы значений:​ int\\ \\ Обратите внимание,​ что ''#​кол-во''​ здесь работает иначе, чем во многих других функциях (смотри last()).\\ \\ Хотя сравнение выполняется побитовым образом,​ все значения должны подставляться и возвращаться в десятичном виде. Например,​ выполнение проверки 3-го бита, сравнением с 4, не со 100.\\ \\ Примеры:​\\ => %%band(,​​12)=8 or band(,​​12)=4%% -> 3-ий и 4-ый биты установлены,​ но не оба в одно время\\ => %%band(,​​20)=16%% -> 3-ий бит не установлен и 5 бит установлен.\\ \\ Эта функция поддерживается начиная с Zabbix 2.2.0. |
 ^ |||| ^ ||||
 |**change** ​ ^^^^ |**change** ​ ^^^^
Line 18: Line 18:
 ^ |||| ^ ||||
 |**count** (сек<​nowiki>​|</​nowiki>#​кол-во,<​шаблон>,<​оператор>,<​сдвиг_времени>​) ​ ^^^^ |**count** (сек<​nowiki>​|</​nowiki>#​кол-во,<​шаблон>,<​оператор>,<​сдвиг_времени>​) ​ ^^^^
-^ |Количество собранных значений за указанный период вычисления. |**сек** или **кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **шаблон** (опционально) - требуемый шаблон\\ \\ **оператор** (опционально)\\ \\ Поддерживаемые ''​операторы'': ​ //eq// - равно\\ //ne// - не равно\\ //gt// - больше\\ //ge// - больше или равно\\ //lt// - меньше\\ //le// - меньше или равно\\ //like// - совпадают,​ если содержат шаблон (регистрозависимое)\\ //band// - побитовое И\\ //regexp// - совпадение с учетом регистра с регулярным выражением,​ заданным в ''​шаблон''​\\ //iregexp// - совпадение без учета регистра с регулярным выражением,​ заданным в ''​шаблон''​\\ \\ Обратите внимание:​\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le//, //band//, //regexp//, //iregexp// поддерживаются целочисленными элементами данных\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le//, //regexp//, //iregexp// поддерживаются числовыми с плавающей точкой элементами данных\\ //like// (по умолчанию),​ //eq//, //ne//, //regexp//, //iregexp// поддерживаются строковыми,​ текстовыми и журнальными элементами данных\\ \\ **сдвиг_времени** (опционально) - смотрите avg()  |Поддерживаемые типы значений:​ float, integer, string, text, log\\ Элементы данных с плавающей точкой совпадают с точностью до 0.000001.\\ \\ При наличии **band** третьим параметром,​ второй параметр ''​шаблон''​ можно указывать двумя числами,​ разделенными с помощью '/':​ **количество_для_сравнения/​маска**. count() вычисляет "​побитовое И", используя значение и //​маску//,​ и сравнивает результат с //​количеством_для_сравнения//​. Если результат "​побитового И" равен //​количеству_для_сравнения//,​ значение засчитывается.\\ Если //​количество_для_сравнения//​ и //​маска//​ равны, то необходимо указать только параметр //​маска//​ (без '/'​).\\ \\ При наличии //regexp// или //iregexp// третьим параметром,​ второй параметр ''​шаблон''​ может быть как обычным,​ так и [[:​ru/​manual/​regular_expressions#​глобальные_регулярные_выражения|глобальным]] (которое начинается с '​@'​) регулярным выражением. В случае глобального регулярного выражения учет регистра наследуется из настроек глобального регулярного выражения. Для цели соответствия регулярному выражению числа с плавающей точкой всегда будут представлены с 4 десятичными знаками после '​.'​. Также обратите внимание на то, что при разница между большими числами в десятичном (хранится в базе данных) и бинарном (используется Zabbix сервере) представлениях может повлиять на 4 цифру после запятой. \\ \\ Примеры:​\\ => count(10m) -> количество значений за последние 10 минут\\ => %%count(10m,"​error",​eq)%% -> количество значений за последние 10 минут, которые равны '​error'​ \\ => count(10m,​12) -> количество значений за последние 10 минут, которые равны '​12'​\\ => %%count(10m,​12,​gt)%% -> количество значений за последние 10 минут, которые больше '​12'​\\ => %%count(#​10,​12,​gt)%% -> количество значений из последних 10 значений,​ которые больше '​12'​\\ => %%count(10m,​12,​gt,​1d)%% -> количество значений за 10 минут 24 часами ранее, которые больше '​12'​\\ => %%count(10m,​6/​7,​band)%% -> количество значений за последние 10 минут, которые имеют '​110'​ (в бинарном виде) в 3 младших битах.\\ => count(10m,,,​1d) -> количество значений за 10 минут 24 часами ранее\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.1.\\ Параметр ''​сдвиг_времени''​ и строковые операторы поддерживаются начиная с Zabbix 1.8.2.\\ Оператор //band// поддерживается начиная с Zabbix 2.2.0.\\ Параметры //regexp//, //iregexp// поддерживаются начиная с Zabbix 3.2.0. |+^ |Количество собранных значений за указанный период вычисления. |**сек** или **кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **шаблон** (опционально) - требуемый шаблон\\ \\ **оператор** (опционально)\\ \\ Поддерживаемые ''​операторы'': ​ //eq// - равно\\ //ne// - не равно\\ //gt// - больше\\ //ge// - больше или равно\\ //lt// - меньше\\ //le// - меньше или равно\\ //like// - совпадают,​ если содержат шаблон (регистрозависимое)\\ //band// - побитовое И\\ //regexp// - совпадение с учетом регистра с регулярным выражением,​ заданным в ''​шаблон''​\\ //iregexp// - совпадение без учета регистра с регулярным выражением,​ заданным в ''​шаблон''​\\ \\ Обратите внимание:​\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le//, //band//, //regexp//, //iregexp// поддерживаются целочисленными элементами данных\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le//, //regexp//, //iregexp// поддерживаются числовыми с плавающей точкой элементами данных\\ //like// (по умолчанию),​ //eq//, //ne//, //regexp//, //iregexp// поддерживаются строковыми,​ текстовыми и журнальными элементами данных\\ \\ **сдвиг_времени** (опционально) - смотрите avg()  |Поддерживаемые типы значений:​ float, integer, string, text, log\\ Элементы данных с плавающей точкой совпадают с точностью до 0.000001.\\ \\ При наличии **band** третьим параметром,​ второй параметр ''​шаблон''​ можно указывать двумя числами,​ разделенными с помощью '/':​ **количество_для_сравнения/​маска**. count() вычисляет "​побитовое И", используя значение и //​маску//,​ и сравнивает результат с //​количеством_для_сравнения//​. Если результат "​побитового И" равен //​количеству_для_сравнения//,​ значение засчитывается.\\ Если //​количество_для_сравнения//​ и //​маска//​ равны, то необходимо указать только параметр //​маска//​ (без '/'​).\\ \\ При наличии //regexp// или //iregexp// третьим параметром,​ второй параметр ''​шаблон''​ может быть как обычным,​ так и [[:​ru/​manual/​regular_expressions#​глобальные_регулярные_выражения|глобальным]] (которое начинается с '​@'​) регулярным выражением. В случае глобального регулярного выражения учет регистра наследуется из настроек глобального регулярного выражения. Для цели соответствия регулярному выражению числа с плавающей точкой всегда будут представлены с 4 десятичными знаками после '​.'​. Также обратите внимание на то, что при разница между большими числами в десятичном (хранится в базе данных) и бинарном (используется Zabbix сервере) представлениях может повлиять на 4 цифру после запятой. \\ \\ Примеры:​\\ => count(10m) -> количество значений за последние 10 минут\\ => %%count(10m,"​error",​eq)%% -> количество значений за последние 10 минут, которые равны '​error'​ \\ => count(10m,​12) -> количество значений за последние 10 минут, которые равны '​12'​\\ => %%count(10m,​12,​gt)%% -> количество значений за последние 10 минут, которые больше '​12'​\\ => %%count(#​10,​12,​gt)%% -> количество значений из последних 10 значений,​ которые больше '​12'​\\ => %%count(10m,​12,​gt,​1d)%% -> количество значений за 10 минут 24 часами ранее, которые больше '​12'​\\ => %%count(10m,​6/​7,​band)%% -> количество значений за последние 10 минут, которые имеют '​110'​ (в бинарном виде) в 3 младших битах.\\ => count(10m,,,​1d) -> количество значений за 10 минут 24 часами ранее\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.1.\\ Параметр ''​сдвиг_времени''​ и строковые операторы поддерживаются начиная с Zabbix 1.8.2.\\ Оператор //band// поддерживается начиная с Zabbix 2.2.0.\\ Параметры //regexp//, //iregexp// поддерживаются начиная с Zabbix 3.2.0. |
 ^ |||| ^ ||||
 |**date** ​ ^^^^ |**date** ​ ^^^^
Line 30: Line 30:
 ^ |||| ^ ||||
 |**delta** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**delta** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
-^ |Разницы между максимальным и минимальным значениями за указанный период вычисления ('​max()'​ минус '​min()'​). |**сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg() |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. |+^ |Разницы между максимальным и минимальным значениями за указанный период вычисления ('​max()'​ минус '​min()'​). |**сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg() |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. |
 ^ |||| ^ ||||
 |**diff** ​ ^^^^ |**diff** ​ ^^^^
Line 36: Line 36:
 ^ |||| ^ ||||
 |**forecast** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>,​время,<​аппроксимация>,<​режим>​) ^^^^ |**forecast** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>,​время,<​аппроксимация>,<​режим>​) ^^^^
-^ |Будущее значение,​ макс, мин, дельта или сред элемента данных. ​ |**сек** или **#​кол-во** - указывается ​период вычисления в секундах или в количестве собранных значений (начинается с решетки)\\ **сдвиг_времени** (опционально) - см. функцию avg()\\ **время** - горизон предсказания в секундах\\ **аппроксимация** (опционально) - используемая функция для аппроксимации данных истории\\ \\ Поддерживаемые ''​аппроксимации'':​\\ //linear// - линейная функция\\ //​polynomialN//​ - полином степени N (1 <​nowiki><​=</​nowiki>​ N <​nowiki><​=</​nowiki>​ 6)\\ //​exponential//​ - экспоненциальная функция\\ //​logarithmic//​ - логарифмическая функция\\ //power// - степенная функция\\ \\ Обратите внимание,​ что:\\ //linear// является умолчанием,​ //​polynomial1//​ эквивалент //​linear//​\\ \\ **режим** (опционально) - запрашиваемый вывод\\ \\ Поддерживаемые ''​режимы'':​\\ //value// - значение (по умолчанию)\\ //max// - максимальное\\ //min// - минимальное\\ //delta// - //​max//​-//​min//​\\ //avg// - среднее\\ \\ Обратите внимание:​\\ //value// оценивает значение элемента данных за момент ''​сейчас''​ + ''​время''​\\ //max//, //min//, //delta// и //avg// оценивают значение элемента данных за интервал между ''​сейчас''​ и ''​сейчас''​ + ''​время'' ​ |Поддерживаемые типы значений:​ float, int\\ \\ Если возвращаемое значение больше чем 999999999999.9999 или меньше чем -999999999999.9999,​возвращаемое значение обрезается до 999999999999.9999 или -999999999999.9999 соответственно.\\ \\ Становится не поддерживаемым только,​ если в выражении имеется злоупотребление (ошибочный тип элемента данных,​ некорректные параметры),​ в противном случае возвращает -1 в случае ошибок.\\ \\ Примеры:​\\ => forecast(#​10,,​1h) -> прогноз значения элемента данных через один час на основе последних 10 значений\\ => forecast(1h,,​30m) -> прогноз значения элемента данных через 30 минут на основе данных последнего часа\\ => forecast(1h,​1d,​12h) -> прогноз значения элемента данных через 12 часов на основе одного часа днем ранее\\ => forecast(1h,,​10m,​exponential) -> прогноз значения элемента данных через 10 минут на основе данных последнего часа и экспоненциальной функции\\ => forecast(1h,,​2h,​polynomial3,​max) -> прогноз максимального значения элемента данных,​ которое может достичь элемент данных через два часа, на основе данных последнего часа и кубического (третьей степени) полинома\\ => forecast(#​2,,​-20m) -> оценивает значение элемента данных,​ которое было 20 минут назад на основе двух последних значений (эта функция может быть более точной,​ чем использование last() или prev(), особенно,​ если элемент данных обновляется редко, скажем,​ раз в час)\\ \\ Эта функция поддерживается начиная с Zabbix 3.0.0.\\ Отрицательные значения ''​времени''​ поддерживаются начиная с Zabbix 3.0.6 и 3.2.2.\\ Смотрите дополнительную информацию о [[:​ru/​manual/​config/​triggers/​prediction|функциях предсказания в триггерах]]. ​ |+^ |Будущее значение,​ макс, мин, дельта или сред элемента данных. ​ |**сек** или **#​кол-во** - максимальный период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в количестве собранных значений (начинается с решетки)\\ **сдвиг_времени** (опционально) - см. функцию avg()\\ **время** - горизонт предсказания в секундах\\ **аппроксимация** (опционально) - используемая функция для аппроксимации данных истории\\ \\ Поддерживаемые ''​аппроксимации'':​\\ //linear// - линейная функция\\ //​polynomialN//​ - полином степени N (1 <​nowiki><​=</​nowiki>​ N <​nowiki><​=</​nowiki>​ 6)\\ //​exponential//​ - экспоненциальная функция\\ //​logarithmic//​ - логарифмическая функция\\ //power// - степенная функция\\ \\ Обратите внимание,​ что:\\ //linear// является умолчанием,​ //​polynomial1//​ эквивалент //​linear//​\\ \\ **режим** (опционально) - запрашиваемый вывод\\ \\ Поддерживаемые ''​режимы'':​\\ //value// - значение (по умолчанию)\\ //max// - максимальное\\ //min// - минимальное\\ //delta// - //​max//​-//​min//​\\ //avg// - среднее\\ \\ Обратите внимание:​\\ //value// оценивает значение элемента данных за момент ''​сейчас''​ + ''​время''​\\ //max//, //min//, //delta// и //avg// оценивают значение элемента данных за интервал между ''​сейчас''​ и ''​сейчас''​ + ''​время'' ​ |Поддерживаемые типы значений:​ float, int\\ \\ Если возвращаемое значение больше чем 999999999999.9999 или меньше чем -999999999999.9999,​возвращаемое значение обрезается до 999999999999.9999 или -999999999999.9999 соответственно.\\ \\ Становится не поддерживаемым только,​ если в выражении имеется злоупотребление (ошибочный тип элемента данных,​ некорректные параметры),​ в противном случае возвращает -1 в случае ошибок.\\ \\ Примеры:​\\ => forecast(#​10,,​1h) -> прогноз значения элемента данных через один час на основе последних 10 значений\\ => forecast(1h,,​30m) -> прогноз значения элемента данных через 30 минут на основе данных последнего часа\\ => forecast(1h,​1d,​12h) -> прогноз значения элемента данных через 12 часов на основе одного часа днем ранее\\ => forecast(1h,,​10m,​exponential) -> прогноз значения элемента данных через 10 минут на основе данных последнего часа и экспоненциальной функции\\ => forecast(1h,,​2h,​polynomial3,​max) -> прогноз максимального значения элемента данных,​ которое может достичь элемент данных через два часа, на основе данных последнего часа и кубического (третьей степени) полинома\\ => forecast(#​2,,​-20m) -> оценивает значение элемента данных,​ которое было 20 минут назад на основе двух последних значений (эта функция может быть более точной,​ чем использование last() или prev(), особенно,​ если элемент данных обновляется редко, скажем,​ раз в час)\\ \\ Эта функция поддерживается начиная с Zabbix 3.0.0.\\ Отрицательные значения ''​времени''​ поддерживаются начиная с Zabbix 3.0.6 и 3.2.2.\\ Смотрите дополнительную информацию о [[:​ru/​manual/​config/​triggers/​prediction|функциях предсказания в триггерах]]. ​ |
 ^ |||| ^ ||||
 |**fuzzytime** (сек) ^^^^ |**fuzzytime** (сек) ^^^^
-^ |Проверка,​ на сколько отличается значение элемента данных (как штамп времени) от времени Zabbix сервера. ​ |**сек** - секунды ​ |Поддерживаемые типы значений:​ float, int\\ \\ Возвращает:​\\ ​- если разница между значением элемента данных ​(как штамп времени) ​и штампом времени Zabbix сервера меньше или равна T секунд\\ ​- в противном случае.\\ \\ Обычно используется с system.localtime ​элементом данных ​для проверки,​ что локальное время синхронизировано с локальным временем Zabbix сервера. //​Обратите внимание // что элемент данных '​system.localtime'​ должен быть настроен [[:manual:appendix:items:activepassive#​​passive_checks|пассивной проверокой]]. \\ Также можно использовать с ключем vfs.file.time[/​путь/​к/​файлу,​modify] для проверки,​ что файл не обновлялся длительное время.\\ \\ Пример:​\\ => fuzzytime(60)=0 -> обнаружение проблемы,​ если разница во времени больше 60 секунд ​ |+^ |Проверка,​ на сколько отличается значение элемента данных (как штамп времени) от времени Zabbix сервера. |**сек** - секунды ​ |Поддерживаемые типы значений:​ float, int\\ \\ Возвращает:​\\ ​- если разница между ​штампом времени ​значения элемента данных и штампом времени Zabbix сервера меньше или равна T секунд\\ ​- в противном случае.\\ \\ Обычно используется с system.localtime для проверки,​ что локальное время синхронизировано с локальным временем Zabbix сервера. //​Обратите внимание//​что элемент данных '​system.localtime'​ должен быть настроен [[:ru:manual:​appendix:​items:​activepassive#​пассивные_проверки|пассивной проверкой]]. \\ Также можно использовать с ключем vfs.file.time[/​путь/​к/​файлу,​modify] для проверки,​ что файл не обновлялся длительное время.\\ \\ Пример:​\\ => fuzzytime(60)=0 -> обнаружение проблемы,​ если разница во времени больше 60 секунд ​ |
 ^ |||| ^ ||||
 |**iregexp** (<​шаблон>,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^ |**iregexp** (<​шаблон>,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^
Line 45: Line 45:
 ^ |||| ^ ||||
 |**last** (<​сек<​nowiki>​|</​nowiki>#​кол-во>,<​сдвиг_времени>​) ​ ^^^^ |**last** (<​сек<​nowiki>​|</​nowiki>#​кол-во>,<​сдвиг_времени>​) ​ ^^^^
-^ |Самое новое значение. |**сек** (игнорируется,​равно #1) или ​ **#​кол-во** (опционально) - N-ое самое новое значение\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Обратите внимание,​ что ''#​кол-во''​ здесь работает иначе, чем во многих других функциях.\\ Например:​\\ last() всегда идентичен last(#1)\\ last(#3) - третье самое новое значение (//не// три последних значения)\\ \\ Zabbix не гарантирует точный порядок значений,​ если в истории существуют более двух значений менее чем за секунду..\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.2.\\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. |+^ |Самое новое значение. |**сек** (игнорируется,​ равно #1) или ​ **#​кол-во** (опционально) - N-ое самое новое значение\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Обратите внимание,​ что ''#​кол-во''​ здесь работает иначе, чем во многих других функциях.\\ Например:​\\ last() всегда идентичен last(#1)\\ last(#3) - третье самое новое значение (//не// три последних значения)\\ \\ Zabbix не гарантирует точный порядок значений,​ если в истории существуют более двух значений менее чем за секунду..\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.2.\\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. |
 ^ |||| ^ ||||
 |**logeventid** (<​шаблон>​) ​ ^^^^ |**logeventid** (<​шаблон>​) ​ ^^^^
Line 57: Line 57:
 ^ |||| ^ ||||
 |**max** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**max** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
-^ |Максимальное значение за указанный период вычисления. ​ |**сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. ​ |+^ |Максимальное значение за указанный период вычисления. ​ |**сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**min** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**min** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
-^ |Минимальное значение за указанный период вычисления. ​ |**сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. ​ |+^ |Минимальное значение за указанный период вычисления. ​ |**сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**nodata** (сек) ​ ^^^^ |**nodata** (сек) ​ ^^^^
Line 69: Line 69:
 ^ |||| ^ ||||
 |**percentile** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>,​процент) ​ ^^^^ |**percentile** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>,​процент) ​ ^^^^
-^ |P-ый процентиль за период,​ где P (процент) задается третьим параметров. ​ |**сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **time_shift** (опционально) - см. функцию avg()\\ **процент** - число с плавающей точкой между 0 и 100 (включительно) с точностью до 4 цифр после десятичной точки ​ |Поддерживаемые типы значений:​ float, int\\ \\ Эта функция поддерживается начиная с Zabbix 3.0.0. ​ |+^ |P-ый процентиль за период,​ где P (процент) задается третьим параметров. ​ |**сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **time_shift** (опционально) - см. функцию avg()\\ **процент** - число с плавающей точкой между 0 и 100 (включительно) с точностью до 4 цифр после десятичной точки ​ |Поддерживаемые типы значений:​ float, int\\ \\ Эта функция поддерживается начиная с Zabbix 3.0.0. ​ |
 ^ |||| ^ ||||
 |**prev** ​ ^^^^ |**prev** ​ ^^^^
Line 75: Line 75:
 ^ |||| ^ ||||
 |**regexp** (<​шаблон>,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^ |**regexp** (<​шаблон>,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^
-^ |Проверка,​ совпадает ли последне (самое новое) значение с регулярным выражением. |**шаблон** (опционально) - регулярное выражение,​ в формате [[https://​ru.wikipedia.org/​wiki/​PCRE|Perl совместимых регулярных выражений]] (PCRE).\\ **сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Если обрабатывается более одного значения,​ '​1'​ возвращается,​ если имеется по крайней мере одно совпадающее значение.\\ \\ Эта функция является чувствительной к регистру. |+^ |Проверка,​ совпадает ли последнее (самое новое) значение с регулярным выражением. |**шаблон** (опционально) - регулярное выражение,​ в формате [[https://​ru.wikipedia.org/​wiki/​PCRE|Perl совместимых регулярных выражений]] (PCRE).\\ **сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Если обрабатывается более одного значения,​ '​1'​ возвращается,​ если имеется по крайней мере одно совпадающее значение.\\ \\ Эта функция является чувствительной к регистру. |
 ^ |||| ^ ||||
 |**str** (<​шаблон>,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^ |**str** (<​шаблон>,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^
-^ |Поиск строки в последнем (самом новом) значении. |**шаблон** (опционально) - требуемая строка\\ ​ **сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Если обрабатывается более одного значения,​ '​1'​ возвращается,​ если имеется по крайней мере одно совпадающее значение.\\ \\ Эта функция является чувствительной к регистру. ​ |+^ |Поиск строки в последнем (самом новом) значении. |**шаблон** (опционально) - требуемая строка\\ ​ **сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Если обрабатывается более одного значения,​ '​1'​ возвращается,​ если имеется по крайней мере одно совпадающее значение.\\ \\ Эта функция является чувствительной к регистру. ​ |
 ^ |||| ^ ||||
 |**strlen** (<​сек<​nowiki>​|</​nowiki>#​кол-во>,<​сдвиг_времени>​) ​ ^^^^ |**strlen** (<​сек<​nowiki>​|</​nowiki>#​кол-во>,<​сдвиг_времени>​) ​ ^^^^
Line 84: Line 84:
 ^ |||| ^ ||||
 |**sum** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**sum** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
-^ |Сумма собранных значений за указанный период вычисления. |**сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg() |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. ​ |+^ |Сумма собранных значений за указанный период вычисления. |**сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - смотри avg() |Поддерживаемые типы значений:​ float, int\\ \\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. ​ |
 ^ |||| ^ ||||
 |**time** ​ ^^^^ |**time** ​ ^^^^
Line 90: Line 90:
 ^ |||| ^ ||||
 |**timeleft** (сек<​nowiki>​​|</​nowiki>#​кол-во,<​сдвиг_времени>,​порог,<​аппроксимация>​) ​ ^^^^ |**timeleft** (сек<​nowiki>​​|</​nowiki>#​кол-во,<​сдвиг_времени>,​порог,<​аппроксимация>​) ​ ^^^^
-^ |Требуемое время в секундах элементу данных для достижения заданного порога. ​ |**сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - см. функцию avg()\\ **порог** - значение,​ которое необходимо достичь\\ **аппроксимация** (опционально) - см. функцию forecast() ​ |Поддерживаемые типы значений:​ float, int\\ \\ Если возвращаемое значение больше чем 999999999999.9999,​ возвращаемое значение обрезается до 999999999999.9999.\\ \\ Возвращает 999999999999.9999,​ если порог нельзя достичь.\\ \\ Становится не поддерживаемым только,​ если в выражении имеется злоупотребление (ошибочный тип элемента данных,​ некорректные параметры),​ в противном случае возвращает -1 в случае ошибок.\\ \\ Примеры:​\\ => timeleft(#​10,,​0) -> время до тех пор, когда значение элемента данных достигнет нуля на основе последних 10 значений\\ => timeleft(1h,,​100) -> время до тех пор, когда значение элемента данных достигнет 100 на основе данных последнего часа\\ => timeleft(1h,​1d,​0) -> время до тех пор, когда значение элемента данных достигнет 0 на основе одного часа днем ранее\\ => timeleft(1h,,​200,​polynomial2) -> время до тех пор, когда значение элемента данных достигнет 200 на основе данных последнего часа и предположения,​ что элемент данных ведет себя как квадратичный (вторая степень) полином\\ \\ Эта функция поддерживается начиная с Zabbix 3.0.0.\\ [[ru/​manual/​appendix/​suffixes|Символы единиц измерения]] в параметре ''​​порог''​ поддерживаются начиная с Zabbix 3.0.6 и 3.2.2.\\ Смотрите дополнительную информацию о [[:​ru/​manual/​config/​triggers/​prediction|функциях предсказания в триггерах]]. ​ |+^ |Требуемое время в секундах элементу данных для достижения заданного порога. ​ |**сек** или **#​кол-во** - максимальный ​период<​​sup>​​**[[#​​примечание|1]]**</​​sup> ​вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **сдвиг_времени** (опционально) - см. функцию avg()\\ **порог** - значение,​ которое необходимо достичь\\ **аппроксимация** (опционально) - см. функцию forecast() ​ |Поддерживаемые типы значений:​ float, int\\ \\ Если возвращаемое значение больше чем 999999999999.9999,​ возвращаемое значение обрезается до 999999999999.9999.\\ \\ Возвращает 999999999999.9999,​ если порог нельзя достичь.\\ \\ Становится не поддерживаемым только,​ если в выражении имеется злоупотребление (ошибочный тип элемента данных,​ некорректные параметры),​ в противном случае возвращает -1 в случае ошибок.\\ \\ Примеры:​\\ => timeleft(#​10,,​0) -> время до тех пор, когда значение элемента данных достигнет нуля на основе последних 10 значений\\ => timeleft(1h,,​100) -> время до тех пор, когда значение элемента данных достигнет 100 на основе данных последнего часа\\ => timeleft(1h,​1d,​0) -> время до тех пор, когда значение элемента данных достигнет 0 на основе одного часа днем ранее\\ => timeleft(1h,,​200,​polynomial2) -> время до тех пор, когда значение элемента данных достигнет 200 на основе данных последнего часа и предположения,​ что элемент данных ведет себя как квадратичный (вторая степень) полином\\ \\ Эта функция поддерживается начиная с Zabbix 3.0.0.\\ [[ru/​manual/​appendix/​suffixes|Символы единиц измерения]] в параметре ''​​порог''​ поддерживаются начиная с Zabbix 3.0.6 и 3.2.2.\\ Смотрите дополнительную информацию о [[:​ru/​manual/​config/​triggers/​prediction|функциях предсказания в триггерах]]. ​ |
  
-<​note ​important>1) Все функции возвращают только числовые значения. ​Например,​ сравнение строк не поддерживается.\\ 2) Некоторые функции нельзя использовать для нечисловых ​параметров!\\ 3) Строковые аргументы должны быть заключены в двойные кавычки. В противном случае,​ они могут быть неправильно интерпретированы..\\ 4) У всех функций триггеров параметры **сек** и **сдвиг_времени** должны быть целым числом с опциональным [[ru:​manual:​appendix:​suffixes#​суффиксы_времени|суффиксом единицы времени]] и это требование не имеет абсолютно ничего общего с типом данных элемента данных.</​note>​+<​note ​warning>Важные заметки:​\\ **1)** Все функции возвращают только числовые значения. ​Сравнение строк не поддерживается.\\ ​**2)** Некоторые функции нельзя использовать для нечисловых ​значений!\\ **3)** Строковые аргументы должны быть заключены в двойные кавычки. В противном случае,​ они могут быть неправильно интерпретированы.\\ ​**4)** У всех функций триггеров параметры **сек** и **сдвиг_времени** должны быть целым числом с опциональным [[ru:​manual:​appendix:​suffixes#​суффиксы_времени|суффиксом единицы времени]] и это требование не имеет абсолютно ничего общего с типом данных элемента данных.</​note>​ 
 + 
 +== Примечание ==  
 + 
 +<​sup>​**1**</​sup>​ Функция начинает вычисляться с момента получения первого значения (если не пользуется ''​сдвиг_времени''​ параметр).
  
 === Функции и неподдерживаемые элементы данных === === Функции и неподдерживаемые элементы данных ===
  
-<note important>​Начиная с Zabbix 3.2, функции **nodata()**,​ **date()**, **dayofmonth()**,​ **dayofweek()**,​ **now()** и **time()** вычисляются также и для неподдерживаемых элементов данных. Другие функции требуют чтобы элементы данных на которые они ссылаются были поддерживаемом состоянии.</​note>​+Начиная с Zabbix 3.2, функции **nodata()**,​ **date()**, **dayofmonth()**,​ **dayofweek()**,​ **now()** и **time()** вычисляются также и для неподдерживаемых элементов данных. Другие функции требуют чтобы элементы данных на которые они ссылаются были поддерживаемом состоянии.