Zabbix Documentation 2.4

3.04.04.24.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.4Guidelines

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/19 16:14]
dotneft
ru:manual:appendix:triggers:functions [2017/05/15 11:11] (current)
dotneft
Line 1: Line 1:
-==== - #1 Поддерживаемые функции триггеров ====+==== 1 Поддерживаемые функции триггеров ====
  
 Здесь перечислены все поддерживаемые функции в [[:​ru/​manual/​config/​triggers/​expression|выражениях триггеров]]:​ Здесь перечислены все поддерживаемые функции в [[:​ru/​manual/​config/​triggers/​expression|выражениях триггеров]]:​
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, int, str, 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. |+^ |Количество собранных значений за указанный период вычисления. |**сек** или **кол-во** - период вычисления в секундах или в последних собранных значениях (начинается с решетки)\\ **шаблон** (опционально) - требуемый шаблон (целые числа - точное совпадение;​ числа с плавающей точкой - совпадение с точностью до 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, int, str, 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. |
 ^ |||| ^ ||||
 |**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 42: Line 42:
 ^ |||| ^ ||||
 |**last** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^ |**last** (сек<​nowiki>​|</​nowiki>#​кол-во,<​сдвиг_времени>​) ​ ^^^^
-^ |Самое новое значение. |**сек** (игнорируется) или ​ **#​кол-во** - N-ое самое новое значение\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Обратите внимание,​ что ​**#​кол-во** здесь работает иначе, чем во многих других функциях.\\ Например:​\\ last() всегда идентичен last(#1)\\ last(#3) - третье самое новое значение (//не// три последних значения)\\ \\ Zabbix не гарантирует точный порядок значений,​ если в истории существуют более двух значений менее чем за секунду..\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.2.\\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. |+^ |Самое новое значение. |**сек** (игнорируется) или ​ **#​кол-во** - N-ое самое новое значение\\ **сдвиг_времени** (опционально) - смотри avg()  |Поддерживаемые типы значений:​ float, int, str, text, log\\ \\ Обратите внимание,​ что ​''​#​кол-во'' ​здесь работает иначе, чем во многих других функциях.\\ Например:​\\ last() всегда идентичен last(#1)\\ last(#3) - третье самое новое значение (//не// три последних значения)\\ \\ Zabbix не гарантирует точный порядок значений,​ если в истории существуют более двух значений менее чем за секунду..\\ \\ Параметр ''#​кол-во''​ поддерживается начиная с Zabbix 1.6.2.\\ Параметр ''​сдвиг_времени''​ поддерживается начиная с Zabbix 1.8.2. |
 ^ |||| ^ ||||
 |**logeventid** (шаблон) ​ ^^^^ |**logeventid** (шаблон) ​ ^^^^
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** ​ ^^^^