这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

1 触发器函数

所有触发器表达式支持的函数都在下表中。

函数
描述信息 **参 ** **备注*
abschange
后一个值与前一个值变动的绝对值。 支持的值类型: float, nt, str, text, log

例如:
(前一个值;后一个值=绝对值)
1;5=4
3;1=2
0;-2.5=2.5

值类型为str型的返回值:
0 - 两个str相等
1 - 两个str不相等
avg (sec|#num,<time_shift>)
指定评估期内的一个item的平均值。 sec or ** #num** - 评估期以多少秒或最新值个数(个数跟在#号后)表示  支持的值类型: float, int
time_shift (可选) - 评估时间点相对于当前时间的偏移量
<Examples:
=> avg(#5) → 最新5个值的平均值
=> avg(1h) → 最近一小时的平均值
=> avg(1h,1d) → 一天前的一小时内的平均值

从Zabbix 1.8.2开始支持time_shift参数。 主要用于将当前平均值与偏移若干秒后的平均值进行比较。
band (sec|#num,mask,<time_shift>)
将item值与mask进行按位与操作。 sec (可 略) or #num - 第N个最近的价值。  支持的值类型: int
mask (不可省略) - 64-bit无符号整数 (0 - 18446744073709551615) 
time_shift (可选) - 参见avg() 函数 请注意#|<um在这里的工作方式与其他函数不同(具体用法参见last()函数)。
\\尽管以二进制方式进行比较,但是所有的参数和返回值都是十进制。

示例:
=> band(,12)=8 or band(,12)=4 → 第三位和第四位被设置,但不是同时设置。
=> band(,20)=16 →第三位没有被设置但是第五位被设置了。

从Zabbix 2.2.0开始支持该函数。
change
最近获取值与之前获取值的差。 支持值类型: float, int, str, text, log

例如:
(前一个值;后一个值=差)
1;5=+4
3;1=-2
0;-2.5=-2.5

可与abschange函数对照。

值类型为str型的返回值:
0 - 两个str相等
1 - 两个str不相等
count (sec|#num,<pattern>,<operator>,<time_shift>)
指定评估期内值出现的次数。 sec or * #num** - 评估期以多少秒或最新值个数(个数跟在#号后)表示。  支持值类型: float, integer, string, text,pattern (可选) - 指定模式  浮点类型的
operator (可选) 
支持的操作符: 
eq* - 等于  **ne* - 不等于 
gt - 大于  示ge - 大于等于  =&glt - 小于  =le - 小于等于  =&glike - 只要包含(区分大小写)就被匹配  => count(band - 按位与  =&regexp - 按pattern参数进行正则表达式匹配(大小写敏感)  => count(10m,12iregexp - 按pattern参数进行正则表达式匹配(不区分大小)  => count(10m,6/
注意: 
eq (默认), ne, gt, ge, lt, le, band, regexp, iregexp仅仅支持整型数据。  #num 参数从eq (默认), ne, gt, ge, lt, le, regexp, iregexp仅仅支持浮点型数据。  time_shift*like* (默认), *eq*, *ne*, *regexp*, *iregexp*支持string, text和log类型数据。\ *band*操作从
**time\_shift** (可选) - 参考avg()函数|log
据精度为0.000001。

and*作为第三个参数时, 第二个参数
pattern可以用'/'分隔的两个数字表示: **number\_to\_compare\_with/mask**。 count() 函数计算值和掩码的按位与,再和 number\_to\_compare\_with 参数进行比较,如果与*number\_to\_compare\_with*参数结果相等, 则该值被计数。
如果参数*number\_to\_compare\_with*和参数*mask*相等时, 只需要指定*mask*参数,不需要指定number\_to\_compare\_with参数以及使用'/'。
egexp*或*iregexp*作为第三个参数时,第二个参数
pattern可以是一个普通的或以 '@'开头的[全局](/manual/regular_expressions#global_regular_expressions)正则表达式。使用全局正则表达式时,是否大小写敏感取决于全局正则表达式的配置。为了进行正则表达式匹配,浮点值将始终用'.'后的4位数字表示。另请注意,对于十进制(存储在数据库中)和二进制(由Zabbix server使用)表示的数字差异,可能会对4位数字有影响。
:
; count(10m) → 过去10分钟值的个数。
gt; count(10m,"error",eq) → 过去十分钟值等于'error'的个数。
; count(10m,12) → 过去10分钟值等于12的个数。
0m,12,gt) → 过去10分钟值大于12的个数。
t; count(\#10,12,gt) → 最新10个值大于12的个数。
gt,1d) → 昨天这个时间点前十分钟值大于12的个数。
,band) → 过去10分钟值最低三个有效位是 '110' (二进制)的个数。
=> count(10m,,,1d) → 昨天这个时间点前十分钟值的个数。
abbix 1.6.1开始获得支持。
参数和字符类型操作从Zabbix 1.8.2开始获得支持。
abbix 2.2.0开始获得支持。
*regexp*, *iregexp*从Zabbix 3.2.0开始获得支持。| |**date**|<|<|<| |<|当前时间,格式为:YYYYMMDD。|支持值类型: *a|y*

例如返回值: 20150731| |**dayofmonth**|<|<|<| |<|当前是本月的第几天,取值范围从1到31。|支持值类型: *any*
|<
从Zabbix 1.8.5开始支持该函数。| |**dayofweek**|<|<|<| |<|当前是本周的第几天,取值范围从1到7 (周一 - 1, 周日 - 7).|支持值的类型: *any*|<| |**delta** (sec\|\#num,<time\_shift>)|<|<|<| |<|指定评估期内最大值和最小值的差('max()' 减去 'min()')。 **sec** or **\#nu|** - 评估期以多少秒或最新值个数(个数跟在\#号后)表示。\ 支持值类型: float, int
**time\_shift** (可选) - 参考avg()函数
|<从Zabbix 1.8.2开始支持
time_shift参数。| |**diff**|<|<|<| |<|比较最近获取值与之前获取值是否相同。|支持值类型: float, int|str, text, log

返回值:
1 - 两值不等
0 - 两值相等| |**forecast** (sec\|\#num,<time\_shift>,time,<fit>,<mode>)|<|<|<| |<|预测item未来的最大值,最小值,增量值或平均值。 **sec** or **\#num**|- 评估期以多少秒或最新值个数(个数跟在\#号后)表示。\ 支持值类型: float, int
**time\_shift** (可选) - 参考avg()函数\
**time** - 需要预测的时间点\ 如果返回值大于**fit** (可选) - 用于匹配历史数据的函数\

支持的匹配函数:\
*linear* - 线性函数\ Exa*polynomialN* - N次多项式 (1 <= N <= 6)\ =&g*exponential* - 指数函数\ =&g*logarithmic* - 对数函数\ =&g*power* - 幂函数\ =&
注意:\ =*linear*函数为默认, *polynomial1*等同于*linear*\

**mode** (可选) - 按需输出\ 参数
t
支持的modes:
value - 值 (默认)
max - 最大值
min - 最小值
delta - 最大-最小
avg - 平均值

注意:
value 预测item值在now + time时间点
max, min, deltaavg 函数在nownow + time 时间段计算item值
<999999999999.9999 或者小于 -999999999999.9999, 返回值相应被设置为999999999999.9999 或 -999999999999.9999 。
只有在表达式被错误使用时才不可用(错误的项目类型,无效的参数),出现错误时返回-1。
ples:
; forecast(#10,,1h) → 根据最新的十个值预测一小时后的值
; forecast(1h,,30m) → 根据过去一小时的值预测三十分钟后的值
; forecast(1h,1d,12h) → 根据昨天这个时间点前一个小时的值预测十二个小时后的值
t; forecast(1h,,10m,exponential) → 根据过去一小时的值并按照指数函数方式预测十分钟后的值
=> forecast(1h,,2h,polynomial3,max) → 根据过去一小时的值并按照三次多项式方式预测两小时后的最大值
gt; forecast(#2,,-20m) → 根据最新的两个值预测二十分钟前的值 (比使用last()或prev()函数更加精确, 特别是item很少更新的时候, 比如说, 一小时一次)
从Zabbix 3.0.0开始支持该函数。
me允许负值从Zabbix 3.0.6和3.2.2开始支持。
参考 [触发器预测函数](/manual/config/triggers/prediction).| |**fuzzytime** (sec)|<|<|<| |<|检查item的时间戳和zabbix server时间之间相差多大。 **sec** - 秒数|支持值类型: float, int|<
返回值:
0 - item时间戳和zabbix server时间戳之间相差超过指定的时间
1 - 其它。

常使用system.localtime来检查本地时间是否与zabbix server的时间相同。
也可以使用vfs.file.time\[/path/file,modify\]键值检测文件是否长时间未更新。

例如:
=> fuzzytime(60)=0 → 如果时间差超过60秒,就会检测到一个问题| |**iregexp** (pattern,<sec\|\#num>)|<|<|<| |<|该函数和 regexp() 类似,只是不区分大小写。 参考regexp()函数|支持值类型: str, log, te|t| |**last** (sec\|\#num,<time\_shift>)|<|<|<| |<|最近的值。 **se|** (可省略) or **\#num** - 最新的第N个值\ 支持值类型: float,**time\_shift** (可选) - 参考avg()函数
|int, str, text, log
注意此处的
#num参数和在其它函数中的作用不一样。
例如:
last() 通常等同于 last(\#1)
last(\#3) - 第三个最新值 (不是三个最新值)

如果在history中同一秒有多个值存在,Zabbix不能保证值的精确顺序。

从Zabbix 1.6.2开始支持
#num参数。
从Zabbix 1.8.2开始支持
time_shift参数。| |**logeventid** (pattern)|<|<|<| |<|检查最近日志记录的EventID是否匹配正则表达式。 **pattern** - 正则表达|需要匹配的模式, 支持[POSIX extended](http://en.wikipedia.org/wiki/Regular_expression#POSIX_Extended_Regular_Expressions) 类型。 支持值类型: log
|<
返回值:
0 - 不匹配
1 - 匹配

从Zabbix 1.8.5开始支持该函数。| |**logseverity**|<|<|<| |<|最近日志记录的日志等级。|支持值类型: log
|<
返回值:
0 - 默认等级
N - 对应的等级 (整数,常用的Windows日志等级: 1 - 信息, 2 - 警告, 4 - 错误, 7 - 审计失败, 8 - 审计成功, 9 - 严重错误, 10 - Verbose).
Zabbix从Windows日志事件中的 **Information**字段获取日志等级。| |**logsource** (pattern)|<|<|<| |<|检查最近的日志记录是否匹配参数指定的日志来源。 **pattern** - string类型|支持值类型: log
|<
返回值:
0 - 不匹配
1 - 匹配
通常用于Windows日志事件。 例如, logsource("VMware Server").| |**max** (sec\|\#num,<time\_shift>)|<|<|<| |<|指定评估期内一个item的最大值。 **sec** or *|\#num** - 评估期以多少秒或最新值个数(个数跟在\#号后)表示\ 支持值类型: float, int
**time\_shift** (可选) - 参考avg()函数
|<从Zabbix 1.8.2开始支持
time_shift参数。| |**min** (sec\|\#num,<time\_shift>)|<|<|<| |<|指定评估期内一个item的最小值。 **sec** or *|\#num** - 评估期以多少秒或最新值个数(个数跟在\#号后)表示\ 支持值类型: float, int
**time\_shift** (可选) - 参考avg()函数
|<从Zabbix 1.8.2开始支持
time_shift参数。| |**nodata** (sec)|<|<|<| |<|检查评估期内是否接收到数据。 **sec** - 评估期|单位为秒。\ 支持值类型: *any*
评估期不应该少于30秒,因为timer处理器每30秒调用一次该函数。\

nodata(0) 不被允许. 1 -|<返回值:
指定评估期没有接收到数据
0 - 其它

注意,如果在第一个参数指定的时间内出现以下问题,该函数会报错:
- Zabbix server被重启
- 刚出维护期
- item被添加或重新激活
- 错误显示在触发器[配置界面](/manual/web_interface/frontend_sections/configuration/hosts/triggers)的 *Info* 列。| |**now**|<|<|<| |<|距离Epoch (00:00:00 UTC, January 1, 1970)的秒数。|支持值的类|: *any*| |**percentile** (sec\|\#num,<time\_shift>,percentage)|<|<|<| |<|P-th 一段时间的百分值, P (percentage) 做为第三个参数。 **sec** or **\#n|m** - 评估期以多少秒或最新值个数(个数跟在\#号后)表示\ 支持值类型: float, int
**time\_shift** (可选) - 参考avg()函数\
**percentage** - 0 到 100 (包括)之间的浮点数,小数点后最多保留四位 从Zabbix 3.0.0开始支持该函|<。| |**prev**|<|<|<| |<|取前一个值。|支持值类型|float, int, str, text, log

返回值和 last(\#2)相同。| |**regexp** (pattern,<sec\|\#num>)|<|<|<| |<|检查最近的值是否匹配正则表达式。 **pattern** - 正|表达式, 支持[POSIX extended](http://en.wikipedia.org/wiki/Regular_expression#POSIX_Extended_Regular_Expressions) 样式。\ 支持值类型: str, text, log
**sec** or **\#num** (可选) - 评估期以多少秒或最新值个数(个数跟在\#号后)表示。 这种情况下,可能有多个值被处理。
|<返回值:
1 - 匹配
0 - 不匹配。如果有多个值被处理,其中有一个值匹配也会返回1。

该函数区分大小写。| |**str** (pattern,<sec\|\#num>)|<|<|<| |<|从最新值中查找一个字符串。 **pattern**|string型\ 支持值类型: str, t**sec** or **\#num** (可选) - 评估期以多少秒或最新值个数(个数跟在\#号后)表示。 这种情况下,可能有多个值被处理。
|xt, log
返回值:
1 - 找到
0 - 没找到。如果有多个值被处理,其中有一个值找到也会返回1。

该函数区分大小写。| |**strlen** (sec\|\#num,<time\_shift>)|<|<|<| |<|最新值的字符长度(而不是字节数)。 **sec** (可省略) or|**\#num** - 最新的第N个值\ 支持值类型: str, text, log
**time\_shift** (可选) - 参考avg()函数
|<注意此处的
#num参数和它在其它函数中的作用不一样。

示例:
=> strlen()(等同于 strlen(\#1)) → 最新值的长度
=> strlen(\#3) → 最新的第三个值的长度
=> strlen(,1d) → 一天前最新值的长度。

从Zabbix 1.8.4开始支持该函数。| |**sum** (sec\|\#num,<time\_shift>)|<|<|<| |<|指定评估期内item值的和。 **sec** o|**\#num** - 评估期以多少秒或最新值个数(个数跟在\#号后)表示\ 支持值类型: float, int
**time\_shift** (可选) - 参考avg()函数
|<从Zabbix 1.8.2开始支持
time_shift参数。| |**time**|<|<|<| |<|当前时间,以HHMMSS格式表示。|支持值类型: *an|*

返回值如: 123055| |**timeleft** (sec\|\#num,<time\_shift>,threshold,<fit>)|<|<|<| |<|item达到定义阀值需要多久时间,单位为秒。 **sec** or **\#nu|** - 评估期以多少秒或最新值个数(个数跟在\#号后)表示\ 支持值类型: float, int
**time\_shift** (可选) - 参考 avg()函数\
**threshold** - 阀值\ 如**fit** (可选) - 参考forecast()函数
|<返回值大于 999999999999.9999, 则被设置为999999999999.9999。
如果达不到阀值也将返回值设置为999999999999.9999。

只有在表达式错误时才不可用(错误的item类型,无效的参数),出现错误时返回-1。

示例:
=> timeleft(\#10,,0) → 根据最新的十个值计算值达到0需要的时间
=> timeleft(1h,,100) → 根据过去一小时的值计算值达到100需要的时间
=> timeleft(1h,1d,0) → 根据昨天当前时间点前一个小时的值计算值达到0需要的时间
=> timeleft(1h,,200,polynomial2) → 根据过去一小时的值并按照二次多项式方式计算值达到200需要的时间

从Zabbix 3.0.0开始支持该函数。
从Zabbix 3.0.6 和 3.2.2开始支持[Unit symbols](/manual/config/triggers/suffixes) 的
threshold` 参数。
通过 predictive trigger functions查看扩展信息。

重要事项:
1) 部分函数不能用于非数值类型数据。
2) 字符型参数都应该使用双引号。否则,可能会被错误解析。
3) 所有trigger函数中的sectime_shift参数都必须是带有可选时间单位后缀的整数。 时间单位后缀与item的数据类型完全无关。

注脚

1 从第一个接收值开始计算函数 (除非使用 time_shift 参数).

函数与不被支持的监控项

从Zabbix 3.2开始, nodata(), date(), dayofmonth(), dayofweek(), now()time() 函数都支持用于不被支持的监控项。 但其他函数都要求用于可支持的监控项。