首页 > 代码库 > Zabbix触发器支持的函数说明

Zabbix触发器支持的函数说明

abschange

  • 参数: 直接忽略后边的参数

  • 支持值类型: float, int, str, text, log

  • 描述: 返回最近获取到的值与之前的值的差值的绝对值. 对于字符串类型,0表示值相等,1表示值不同

avg

  • 参数: 秒或#num

  • 支持值类型: float, int

  • 描述: 返回指定时间间隔的平均值. 时间间隔可以通过第一个参数通过秒数设置或收集的值的数目(需要前边加上#,比如#5表示最近5次的值) 。如果有第二个,则表示时间漂移(time shift),例如像查询一天之前的一小时的平均值,对应的函数是 avg(3600,86400), 时间漂移是Zabbix 1.8.2加入进来的

change

  • 参数: 直接忽略掉后边的参数

  • 支持值类型: float, int, str, text, log

  • 描述: 返回最近获取到的值与之前的值的差值. 对于字符串类型,0表示值相等,1表示值不同

count

  • 参数: 秒或#num

  • 支持值类型: float, int, str, text, log

  • 描述: 返回指定时间间隔内的数值统计。 时间间隔可以通过第一个参数通过秒数设置或收集的值数目(需要值前边加上#)。本函数可以支持第二个参数作为样本(pattern)数据,第三个参数作为 操作(operator)参数,第四个参数作为时间漂移(time shift)参数. 对于样本,整数(iteeger)监控项实用精确匹配,浮点型(float)监控项允许偏差0.0000001

支持的操作(operators)类型:

  eq: 相等
  ne: 不相等 
  gt: 大于
  ge: 大于等于
  lt: 小于
  le: 小于等于
  like: 内容匹配

对于整数和浮点型监控项目支持eq(默认), ne, gt, ge, lt, le;对于string、text、log监控项支持like(默认), eq, ne

例子:

  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): 24小时之前的前10分钟数据中,值大于12的个数
  count(600,,,86400): 24小时之前的前10分钟数据的值的个数

#num参数从Zabbix 1.6.1起开始支持, time shift参数和字符串操作支持从Zabbix 1.8.2开始支持

date

  • 参数: 直接忽略掉后边的参数

  • 支持值类型: 所有(any)

  • 描述: 返回当前日期(格式为YYYYMMDD), 例如20031025

dayofmonth

  • 参数: 直接忽略掉后边的参数

  • 支持值类型: 所有(any)

  • 描述: 返回当前是本月第几天(数值范围:1-31),该函数从Zabbix 1.8.5起开始支持

dayofweek

  • 参数: 直接忽略掉后边的参数

  • 支持值类型: 所有(any)

  • 描述: 返回当前是本周的第几天(数值返回:1-7),星期一是 1,星期天是7

delta

  • 参数: 秒或#num

  • 支持值类型: float, int

  • 描述: 返回指定时间间隔内的最大值与最小值的差值(max()-min())。时间间隔作为第一个参数可以是秒或者收集值的数目. 从Zabbix 1.8.2开始,支持可选的第二个参数 time_shift.

diff

  • 参数: 忽略

  • 支持值类型: float, int, str, text, log

  • 描述: 返回值为1 表示最近的值与之前的值不同,0为其他情况

fuzzytime

  • 参数: 秒

  • 支持值类型: float, int

  • 描述: 返回值为1表示监控项值的时间戳与Zabbix Server的时间多N秒, 0为其他. 常使用system.localtime来检查本地时间是否与Zabbix server时间相同.

iregexp

  • 参数: 第一个为字符串,第二个为秒或#num

  • 支持值类型: str, log, text

  • 描述: 与regexp类似,区别是不区分大小写

last

  • 参数: 秒或#num

  • 支持值类型: float, int, str, text, log

  • 描述: 最近的值,如果为秒,则忽略,#num表示最近第N个值,请注意当前的#num和其他一些函数的#num的意思是不同的

例子:

last(0) 等价于 last(#1)last(#3) 表示最近**第**3个值(并不是最近的三个值)本函数也支持第二个参数**time_shift**,例如last(0,86400) 返回一天前的最近的值如果在history中同一秒中有多个值存在,Zabbix不保证值的精确顺序#num从Zabbix 1.6.2起开始支持, timeshift从1.8.2其开始支持,可以查询 avg()函数获取它的使用方法

logeventid

  • 参数: string

  • 支持值类型: log

  • 描述: 检查最近的日志条目的Event ID是否匹配正则表达式. 参数为正则表达式,POSIX扩展样式. 当返回值为0时表示不匹配,1表示匹配。 该函数从Zabbix 1.8.5起开始支持.

logseverity

  • 参数: 忽略

  • 支持值类型: log

  • 描述: 返回最近日志条目的日志等级(log severity). 当返回值为0时表示默认等级,N为具体对应等级(整数,常用于Windows event logs). Zabbix日志等级来源于Windows event log的Information列.

logsource

  • 参数: string

  • 支持值类型: log

  • 描述: 检查最近的日志条目是否匹配参数的日志来源. 当返回值为0时表示不匹配,1表示匹配。通场用于Windows event logs监控. 例如 logsource["VMWare Server"]

max

  • 参数: 秒或#num

  • 支持值类型: float, int

  • 描述: 返回指定时间间隔的最大值. 时间间隔作为第一个参数可以是秒或收集值的数目(前缀为#). 从Zabbix 1.8.2开始,函数支持第二个可选参数 time_shift,可以查看avg()函数获取它的使用方法.

min

  • 参数: 秒或#num

  • 支持值类型: float, int

  • 描述: 返回指定时间间隔的最小值. 时间间隔作为第一个参数可以是秒或收集值的数目(前缀为#). 从Zabbix 1.8.2开始,函数支持第二个可选参数 time_shift,可以查看avg()函数获取它的使用方法.

nodata

  • 参数: 秒

  • 支持值类型: any

  • 描述: 当返回值为1表示指定的间隔(间隔不应小于30秒)没有接收到数据, 0表示其他.

now

  • 参数: 忽略

  • 支持值类型: any

  • 描述: 返回距离Epoch(1970年1月1日 00:00:00 UTC)时间的秒数

prev

  • 参数: 忽略

  • 支持值类型: float, int, str, text, log

  • 描述:返回之前的值,类似于 last(#2)

regexp

  • 参数: 第一个参数为string, 第二个参数为秒或#num

  • 支持值类型: str, log, text

  • 描述: 检查最近的值是否匹配正则表达式,参数的正则表达式为POSIX扩展样式, 第二个参数为秒数或收集值的数目,将会处理多个值. 本函数区分大小写。当返回值为1时表示找到,0为其他.

str

  • 参数: 第一个参数为string, 第二个参数为秒或#num

  • 支持值类型: str, log, text

  • 描述: 查找最近值中的字符串。第一个参数指定查找的字符串,大小写敏感。第二个可选的参数指定秒数或收集值的数目,将会处理多个值。 当返回值为1时表示找到,0为其他.

strlen

  • 参数: 秒或#num

  • 支持值类型: str, log, text

  • 描述: 指定最近值的字符串长度(并非字节), 参数值类似于last函数. 例如strlen(0)等价于strlen(#1),strlen(#3)表示最近的第三个值, strlen(0,86400)表示一天前的最近的值. 该函数从Zabbix 1.8.4起开始支持

sum

  • 参数: 秒或#num

  • 支持值类型: float, int

  • 描述: 返回指定时间间隔中收集到的值的总和. 时间间隔作为第一个参数支持秒或收集值的数目(以#开始). 从Zabbix 1.8.2开始,本函数支持time_shift作为第二个参数。 可以查看avg函数获取它的用法

time

  • 参数: 忽略

  • 支持值类型: any

  • 描述: 返回当前时间,格式为HHMMSS,例如123055



本文出自 “晓风残月” 博客,请务必保留此出处http://kinda22.blog.51cto.com/2969503/1582576

Zabbix触发器支持的函数说明