Zabbix Documentation 2.2

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

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 [2015/12/25 17:07]
dotneft
ru:manual:appendix:triggers:functions [2018/03/08 21:54] (current)
dotneft
Line 6: Line 6:
 ^ ^  **Описания** ​ ^  **Параметры** ​ ^  **Комментарии** ​ ^ ^ ^  **Описания** ​ ^  **Параметры** ​ ^  **Комментарии** ​ ^
 |**abschange** ​ ^^^^ |**abschange** ​ ^^^^
-^ |Абсолютная разница между последним и предыдущим значениями. | |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Например:​\\ (предыдущее значение/последнее значение=abschange)\\ 1/5=4\\ 3/1=2\\ 0/-2.5=2.5\\ \\  Результат для строк:​\\ 0 - значения равны\\ 1 - значения различаются ​ |+^ |Абсолютная разница между последним и предыдущим значениями. | |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Например:​\\ (предыдущее значение;последнее значение=abschange)\\ 1;5=4\\ 3;1=2\\ 0;-2.5=2.5\\ \\  Результат для строк:​\\ 0 - значения равны\\ 1 - значения различаются ​ |
 ^ |||| ^ ||||
 |**avg** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**avg** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
Line 12: Line 12:
 ^ |||| ^ ||||
 |**band** (сек<​nowiki>​|</​nowiki>#​кол-во,​маска,<​сдвиг_времени>​) ​ ^^^^ |**band** (сек<​nowiki>​|</​nowiki>#​кол-во,​маска,<​сдвиг_времени>​) ​ ^^^^
-^ |Значение "​побитового И" от значения элемента данных и маски. |**сек** (игнорируется) или **кол-во** - 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. |+^ |Значение "​побитового И" от значения элемента данных и маски. |**сек** (игнорируется) или **кол-во** - 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** ​ ^^^^
-^ |Величина разницы между последним и предыдущим значениями. | |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Например:​\\ (предыдущее значение/последнее значение=изменение)\\ 1/5=+4\\ 3/1=-2\\ 0/-2.5=-2.5\\ \\ Для строк:​\\ 0 - значения равны\\ 1 - значения различаются ​ |+^ |Величина разницы между последним и предыдущим значениями. | |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Например:​\\ (предыдущее значение;последнее значение=изменение)\\ 1;5=+4\\ 3;1=-2\\ 0;-2.5=-2.5\\ \\ Для строк:​\\ 0 - значения равны\\ 1 - значения различаются ​ |
 ^ |||| ^ ||||
 |**count** (сек<​nowiki>​|</​nowiki>#​кол-во,<​шаблон>,<​оператор>,<​сдвиг_времени>​) ​ ^^^^ |**count** (сек<​nowiki>​|</​nowiki>#​кол-во,<​шаблон>,<​оператор>,<​сдвиг_времени>​) ​ ^^^^
-^ |Количество собранных значений за указанный период вычисления. |**сек** или **кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **шаблон** (опционально) - требуемый шаблон (целые числа - точное совпадение; числа с плавающей точкой - совпадение с точностью до 0.000001)\\ **оператор** (опционально)\\ \\ Поддерживаемые ''​операторы'': ​ //eq// - равно\\ //ne// - не равно\\ //gt// - больше\\ //ge// - больше или равно\\ //lt// - меньше\\ //le// - меньше или равно\\ //like// - совпадают,​ если содержат шаблон (регистрозависимое)\\ //band// - побитовое И (поддерживается начиная с Zabbix 2.2.0).\\ \\ Обратите внимание:​\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le//, //band// поддерживаются целочисленными элементами данных\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le// поддерживаются числовыми с плавающей точкой элементами данных\\ //like// (по умолчанию),​ //eq//, //ne// поддерживаются строковыми,​ текстовыми и журнальными элементами данных\\ \\ **сдвиг_времени** (опционально) - смотрите avg()  |Поддерживаемые типы значений:​ float, ​intstr, text, log\\ \\ При наличии **band** третьим параметром,​ второй параметр можно указывать двумя числами,​ разделенными с помощью '/':​ **количество_для_сравнения/​маска**. count() вычисляет "​побитовое И", используя значение и //​маску//,​ и сравнивает результат с //​количеством_для_сравнения//​. Если результат "​побитового И" равен //​количеству_для_сравнения//,​ значение засчитывается.\\ Если //​количество_для_сравнения//​ и //​маска//​ равны, то необходимо указать только параметр //​маска//​ (без '/'​).\\ \\ Примеры:​\\ => count(600) -> количество значений за последние 10 минут\\ => count(600,​12) -> количество значений за последние 10 минут, которые равны '​12'​\\ => %%count(600,​12,​"gt")%% -> количество значений за последние 10 минут, которые больше '​12'​\\ => %%count(#​10,​12,​"gt")%% -> количество значений из последних 10 значений,​ которые больше '​12'​\\ => %%count(600,​12,​"gt",86400)%% -> количество значений за 10 минут 24 часами ранее, которые больше '​12'​\\ => %%count(600,​6/​7,​"band")%% -> количество значений за последние 10 минут, которые имеют '​110'​ (в бинарном виде) в 3 младших битах.\\ => count(600,,,​86400) -> количество значений за 10 минут 24 часами ранее\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.1.\\ Параметр ''​сдвиг_времени''​ и строковые операторы поддерживаются начиная с Zabbix 1.8.2. |+^ |Количество собранных значений за указанный период вычисления. |**сек** или **кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **шаблон** (опционально) - требуемый шаблон (целые числа - точное совпадение\\ \\ **оператор** (опционально)\\ \\ Поддерживаемые ''​операторы'': ​ //eq// - равно\\ //ne// - не равно\\ //gt// - больше\\ //ge// - больше или равно\\ //lt// - меньше\\ //le// - меньше или равно\\ //like// - совпадают,​ если содержат шаблон (регистрозависимое)\\ //band// - побитовое И (поддерживается начиная с Zabbix 2.2.0).\\ \\ Обратите внимание:​\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le//, //band// поддерживаются целочисленными элементами данных\\ //eq// (по умолчанию),​ //ne//, //gt//, //ge//, //lt//, //le// поддерживаются числовыми с плавающей точкой элементами данных\\ //like// (по умолчанию),​ //eq//, //ne// поддерживаются строковыми,​ текстовыми и журнальными элементами данных\\ \\ **сдвиг_времени** (опционально) - смотрите avg()  |Поддерживаемые типы значений:​ float, ​integerstring, text, log\\ Элементы данных с плавающей точкой совпадают с точностью до 0.000001.\\ \\ При наличии **band** третьим параметром,​ второй параметр можно указывать двумя числами,​ разделенными с помощью '/':​ **количество_для_сравнения/​маска**. count() вычисляет "​побитовое И", используя значение и //​маску//,​ и сравнивает результат с //​количеством_для_сравнения//​. Если результат "​побитового И" равен //​количеству_для_сравнения//,​ значение засчитывается.\\ Если //​количество_для_сравнения//​ и //​маска//​ равны, то необходимо указать только параметр //​маска//​ (без '/'​).\\ \\ Примеры:​\\ => count(600) -> количество значений за последние 10 минут\\ => %%count(10m,"​error",​eq)%% -> количество значений за последние 10 минут, которые равны '​error'​\\ => count(600,​12) -> количество значений за последние 10 минут, которые равны '​12'​\\ => %%count(600,​12,​gt)%% -> количество значений за последние 10 минут, которые больше '​12'​\\ => %%count(#​10,​12,​gt)%% -> количество значений из последних 10 значений,​ которые больше '​12'​\\ => %%count(600,​12,​gt,​86400)%% -> количество значений за 10 минут 24 часами ранее, которые больше '​12'​\\ => %%count(600,​6/​7,​band)%% -> количество значений за последние 10 минут, которые имеют '​110'​ (в бинарном виде) в 3 младших битах.\\ => count(600,,,​86400) -> количество значений за 10 минут 24 часами ранее\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.1.\\ Параметр ''​сдвиг_времени''​ и строковые операторы поддерживаются начиная с Zabbix 1.8.2. |
 ^ |||| ^ ||||
 |**date** ​ ^^^^ |**date** ​ ^^^^
Line 36: Line 36:
 ^ |||| ^ ||||
 |**fuzzytime** (сек) ^^^^ |**fuzzytime** (сек) ^^^^
-^ |Проверка,​ синхронизировано ли системное локальное время со временем на Zabbix сервере.  |**сек** - секунды ​ |Поддерживаемые типы значений:​ float, int\\ \\ Возвращает ​'​1'​ в случае, ​если штамп времени ​из значения элемента данных ​не отличается ​от времени Zabbix сервера более чем на N секунд, 0 - в противном случае. Обычно используется с system.localtime для проверки,​ что локальное время синхронизировано с локальным временем Zabbix сервера. ​ |+^ |Проверка, ​на сколько отличается штамп времени значения элемента данных ​от времени Zabbix сервера.  |**сек** - секунды ​ |Поддерживаемые типы значений:​ float, int\\ \\ Возвращает:\\ 0 - если ​разница между ​штампом времени значения элемента данных ​и штампом времени Zabbix сервера больше секунд\\ 1 - в противном случае.\\ \\ Обычно используется с system.localtime для проверки,​ что локальное время синхронизировано с локальным временем Zabbix сервера.\\ Также можно использовать с ключем vfs.file.time[/​путь/​к/​файлу,​modify] для проверки,​ что файл не обновлялся длительное время.\\ \\ Пример:​\\ => fuzzytime(60)=0 -> обнаружение проблемы,​ если разница во времени больше 60 секунд ​ |
 ^ |||| ^ ||||
 |**iregexp** (шаблон,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^ |**iregexp** (шаблон,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^
Line 60: Line 60:
 ^ |||| ^ ||||
 |**nodata** (сек) ​ ^^^^ |**nodata** (сек) ​ ^^^^
-^ |Проверка,​ отсутствия полученных данных. ​ |**сек** - период вычисления в секундах. Период не должен быть меньше 30 секундам. ​ |Поддерживаемые типы значений:​ //​любые//​\\ \\ Результат:​\\ 1 - если нет полученных данных за указанный период времени\\ 0 - в противном случае\\ \\ Обратите внимание,​ эта функция отобразит ошибку в случае,​ если за указанный период в первом параметре:​\\ - нет данных и Zabbix сервер был перезапущен\\ - нет данных и было завершено обслуживание\\ - нет данных и элемент данных был добавлен или активирован снова ​ |+^ |Проверка,​ отсутствия полученных данных. ​ |**сек** - период вычисления в секундах. Период не должен быть меньше 30 секундам. ​ |Поддерживаемые типы значений:​ //​любые//​\\ \\ Результат:​\\ 1 - если нет полученных данных за указанный период времени\\ 0 - в противном случае\\ \\ Обратите внимание,​ эта функция отобразит ошибку в случае,​ если за указанный период в первом параметре:​\\ - нет данных и Zabbix сервер был перезапущен\\ - нет данных и было завершено обслуживание\\ - нет данных и элемент данных был добавлен или активирован снова\\ Ошибки отображаются в колонке //​Инфо//​ в [[:​ru/​manual/​web_interface/​frontend_sections/​configuration/​hosts/​triggers|настройке]] триггеров. ​ |
 ^ |||| ^ ||||
 |**now** ​ ^^^^ |**now** ​ ^^^^
Line 69: Line 69:
 ^ |||| ^ ||||
 |**regexp** (шаблон,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^ |**regexp** (шаблон,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^
-^ |Проверка,​ совпадает ли последне (самое новое) значение с регулярным выражением. |**шаблон** - регулярное выражение,​ в формате [[https://​ru.wikipedia.org/​wiki/​Регулярные_выражения#​.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.BD.D1.8B.D0.B5_.D1.80.D0.B5.D0.B3.D1.83.D0.BB.D1.8F.D1.80.D0.BD.D1.8B.D0.B5_.D0.B2.D1.8B.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D1.8F_POSIX|расширенных регулярных выражений POSIX]].\\ **сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Эта функция является чувствительной к регистру. |+^ |Проверка,​ совпадает ли последне (самое новое) значение с регулярным выражением. |**шаблон** - регулярное выражение,​ в формате [[https://​ru.wikipedia.org/​wiki/​Регулярные_выражения#​.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.BD.D1.8B.D0.B5_.D1.80.D0.B5.D0.B3.D1.83.D0.BB.D1.8F.D1.80.D0.BD.D1.8B.D0.B5_.D0.B2.D1.8B.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D1.8F_POSIX|расширенных регулярных выражений POSIX]].\\ **сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Если обрабатывается более одного значения,​ тогда '​1'​ возвращается,​ если имеется по крайней мере одно совпавшее значение.\\ \\ Эта функция является чувствительной к регистру. |
 ^ |||| ^ ||||
 |**str** (шаблон,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^ |**str** (шаблон,<​сек<​nowiki>​|</​nowiki>#​кол-во>​) ​ ^^^^
-^ |Поиск строки в последнем (самом новом) значении. |**шаблон** - требуемая строка\\ ​ **сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Эта функция является чувствительной к регистру. ​ |+^ |Поиск строки в последнем (самом новом) значении. |**шаблон** - требуемая строка\\ ​ **сек** или **#​кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки). В этом случае,​ может быть обработано более одного значения. |Поддерживаемые типы значений:​ str, text, log\\ \\ Результат:​\\ 1 - найдено\\ 0 - в противном случае\\ \\ Если обрабатывается более одного значения,​ тогда '​1'​ возвращается,​ если имеется по крайней мере одно совпавшее значение.\\ \\ Эта функция является чувствительной к регистру. ​ |
 ^ |||| ^ ||||
 |**strlen** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**strlen** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^