4 历史函数
此处列出的所有函数都支持：
下面列出的函数没有附加信息。点击该函数查看完整的详细信息。
| 函数 | 说明 |
|---|---|
| change | 上一个值和最新值之间的差值。 |
| changecount | 在定义的评估期内相邻值之间的变化数值。 |
| count | 在定义的评估期内的值计数。 |
| countunique | 在定义的评估期内唯一值的数量。 |
| find | 在定义的评估期间查找匹配的值。 |
| first | 在定义的评估间内的第一个（最早的）值。 |
| fuzzytime | 检查被动代理时间与Zabbix server/proxy 时间的差异。 |
| last | 最新的值。 |
| logeventid | 检查最后一个日志条目的事件ID是否与正则表达式匹配。 |
| logseverity | 最后一个日志条目的日志严重性。 |
| logsource | 检查最后一个日志条目的日志源是否匹配正则表达式。 |
| monodec | 检查值是否单调下降。 |
| monoinc | 检查值是否单调增加。 |
| nodata | 检查是否未收到数据。 |
| percentile | 周期的第P个百分位数，其中P（百分比）由第三个参数指定。 |
| rate | 在定义的时间段内，单调递增的计数器每秒的平均递增速率。 |
常用参数
/host/key是引用主机监控项历史记录函数的常用强制性首选参数(sec|#num)<:time shift>是引用主机监控项历史记录函数的常用强制性次选参数 ，其中：
函数详情
关于函数参数的一般性说明：
- 函数参数用逗号分隔
- 可选函数参数（或参数部分）由
<>表示 - 每个函数都描述了特定的函数参数
/host/key和(sec|#num)<:time shift>参数绝对不能加引号
change(/host/key)
最新值与前一个值之间的差异量。
支持的值类型：浮点数，整数，字符串，文本，日志。
对于字符串，返回：0 - 值相等；1 - 值不同。
参数：参见通用参数。
注释：
- 将计算数值差异，如以下示例所示（'前一个'和'最新'值 = 差异）：
'1' 和 '5' =+4
'3' 和 '1' =-2
'0' 和 '-2.5' =-2.5 - 另请参阅：abs进行比较。
示例：
changecount(/host/key,(sec|#num)<:time shift>,<mode>)
在定义的评估期内相邻值之间的变化数值。
支持的值类型：浮点、整数、字符串、文本、日志。
参数：
- 参见常用参数;
- mode (必须用双引号括起来) - 可能的值： all - 所有变更项的计数 （默认）； dec - 计数减少；inc - 计数增加
对于非数值类型，忽略 mode参数。
示例：
changecount(/host/key,1w) #the number of value changes for the last week until now
changecount(/host/key,#10,"inc") #the number of value increases (relative to the adjacent value) among the last 10 values
changecount(/host/key,24h,"dec") #the number of value decreases (relative to the adjacent value) for the last 24 hours until nowcount(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>)
在定义的评估期内的值计数。
支持的值类型：浮点、整数、字符串、文本、日志。
参数：
- 参见常用参数;
- operator (必须用双引号引用起来)。 支持的
运算符:
eq - 等于
ne - 不等于
gt - 大于
ge - 大于或等于
lt - 小于
le - 小于或等于
like - 如果包含模式则匹配 (区分大小写)
bitand - 按位进行 AND
regexp - 在pattern中区分大小写匹配给定的正则表达式
iregexp - 在pattern中不区分大小写匹配给定的正则表达式 - pattern - 必需的模式（字符串参数必须用双引号引起来）。
备注：
- 浮点数监控项匹配精度为 2.22e-16；
- like不支持作为整数值的运算符；
- 不支持like 和 bitand 作为浮点数值的运算符；
- 对于字符串、文本和日志值，仅支持eq, ne, like, regexp and iregexp 运算符；
- 使用bitand 作为运算符，第四个
pattern参数可以被指定为两个数字， 由 '/'分隔：number_to_compare_with/mask。count()从值和掩码中计算“按位与” ，并将结果与number_to_compare_with进行比较。如果"按位与" 的结果等于 number_to_compare_with，则对该值进行计数。
如果number_to_compare_with 和 掩码 相等，则只需要指定掩码（不带“/”）。 - 使用regexp or iregexp 作为运算符，第四个
pattern参数可以是普通 或者全局 (以 '@'开头)正则表达式。在全局正则表达式的情况下，区分大小写是从全局正则表达式设置继承的。 出于正则表达式匹配的目的，浮点值将始终在 '.'之后用4个十进制数字表示。还要注意的是对于大数字，十进制（存储在数据库中）和二进制（由Zabbix Server使用）表示的差异可能会影响第四个十进制数字。
示例：
count(/host/key,10m) #the values for the last 10 minutes until now
count(/host/key,10m,"like","error") #the number of values for the last 10 minutes until now that contain 'error'
count(/host/key,10m,,12) #the number of values for the last 10 minutes until now that equal '12'
count(/host/key,10m,"gt",12) #the number of values for the last 10 minutes until now that are over '12'
count(/host/key,#10,"gt",12) #the number of values within the last 10 values until now that are over '12'
count(/host/key,10m:now-1d,"gt",12) #the number of values between 24 hours and 10 minutes and 24 hours ago from now that were over '12'
count(/host/key,10m,"bitand","6/7") #the number of values for the last 10 minutes until now having '110' (in binary) in the 3 least significant bits
count(/host/key,10m:now-1d) #the number of values between 24 hours and 10 minutes and 24 hours ago from nowcountunique(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>)
在定义的评估期内唯一值的数量。
支持的值类型：浮点、整数、字符串、文本、日志。
参数：
- 参见常用参数;
- operator (必须用双引号引用起来)。 支持的
运算符:
eq - 等于
ne - 不等于
gt - 大于
ge - 大于或等于
lt - 小于
le - 小于或等于
like - 如果包含模式则匹配 (区分大小写)
bitand - 按位进行 AND
regexp - 在pattern中区分大小写匹配给定的正则表达式
iregexp - 在pattern中不区分大小写匹配给定的正则表达式 - pattern - 必需的模式（字符串参数必须用双引号引起来）。
备注：
- 浮点数监控项匹配精度为 2.22e-16；
- like不支持作为整数值的运算符；
- 不支持like 和 bitand 作为浮点数值的运算符；
- 对于字符串、文本和日志值，仅支持eq, ne, like, regexp and iregexp 运算符；
- 使用bitand 作为运算符，第四个
pattern参数可以被指定为两个数字， 由 '/'分隔：number_to_compare_with/mask。count()从值和掩码中计算“按位与” ，并将结果与number_to_compare_with进行比较。如果"按位与" 的结果等于 number_to_compare_with，则对该值进行计数。
如果number_to_compare_with 和 掩码 相等，则只需要指定掩码（不带“/”）。 - 使用regexp or iregexp 作为第三参数，第四个
pattern参数可以是普通 或者全局 (以 '@'开头)正则表达式。在全局正则表达式的情况下，区分大小写是从全局正则表达式设置继承的。 出于正则表达式匹配的目的，浮点值将始终在 '.'之后用4个十进制数字表示。还要注意的是对于大数字，十进制（存储在数据库中）和二进制（由Zabbix Server使用）表示的差异可能会影响第四个十进制数字。
示例：
countunique(/host/key,10m) #the number of unique values for the last 10 minutes until now
countunique(/host/key,10m,"like","error") #the number of unique values for the last 10 minutes until now that contain 'error'
countunique(/host/key,10m,,12) #the number of unique values for the last 10 minutes until now that equal '12'
countunique(/host/key,10m,"gt",12) #the number of unique values for the last 10 minutes until now that are over '12'
countunique(/host/key,#10,"gt",12) #the number of unique values within the last 10 values until now that are over '12'
countunique(/host/key,10m:now-1d,"gt",12) #the number of unique values between 24 hours and 10 minutes and 24 hours ago from now that were over '12'
countunique(/host/key,10m,"bitand","6/7") #the number of unique values for the last 10 minutes until now having '110' (in binary) in the 3 least significant bits
countunique(/host/key,10m:now-1d) #the number of unique values between 24 hours and 10 minutes and 24 hours ago from nowfind(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>)
在定义的评估期间查找匹配的值。
支持的值类型：浮点、整数、字符串、文本、日志。
返回值: 1 - 找到； 0 - 否则。
参数：
- 参见 常用参数;
- sec or #num (可选) - 如果未指定，则默认为最新值
- operator (必须用双引号引用起来)。 支持的
运算符:
eq - 等于
ne - 不等于
gt - 大于
ge - 大于或等于
lt - 小于
le - 小于或等于
like - 如果包含模式则匹配 (区分大小写)
bitand - 按位进行 AND
regexp - 在pattern中区分大小写匹配给定的正则表达式
iregexp - 在pattern中不区分大小写匹配给定的正则表达式 - pattern - 必需的模式（字符串参数必须用双引号引起来）；Perl 兼容正则表达式 (PCRE)正则表达式，如果
运算符是 regexp, iregexp。
备注：
当处理多个值时， 如果至少有一个匹配值，则返回“1”；
like不支持作为整数值的运算符；
不支持like 和 bitand 作为浮点数值的运算符；
对于字符串、文本和日志值，仅支持eq, ne, like, regexp and iregexp 运算符；
使用regexp or iregexp 作为运算符，第四个
pattern参数可以是普通 或者全局 (以 '@'开头)正则表达式。在全局正则表达式的情况下，区分大小写是从全局正则表达式设置继承的。示例：
find(/host/key,10m,"like","error") #find a value that contains 'error' within the last 10 minutes until now
first(/host/key,sec<:time shift>)
在定义的评估间内的第一个（最早的）值。
支持的值类型：浮点、整数、字符串、文本、日志。
参数：
- 参见 常用参数。
另参见 last()。
示例：
fuzzytime(/host/key,sec)
检查被动agent时间与Zabbix server/proxy时间的差异程度。
支持的值类型：Float, Integer。
返回值：1 - 被动监控项值（作为时间戳）与Zabbix server/proxy时间戳（值收集时钟）之间的差异小于或等于sec秒；0 - 否则。
参数：
- 参见通用参数。
注释：
- 通常与'system.localtime'监控项一起使用，以检查本地时间是否与Zabbix server的本地时间同步。注意 'system.localtime'必须配置为被动检查。
- 也可以与
vfs.file.time[/path/file,modify]键一起使用，以检查文件长时间未得到更新； - 不建议在复杂的触发器表达式（涉及多个监控项）中使用此函数，因为它可能导致意外结果（时间差异将根据最近的指标进行测量），例如在
fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0中。
示例：
last(/host/key,<#num<:时间偏移>>)
最近的值。
支持的值类型：浮点数, 整数, 字符串, 文本, 日志。
参数：
- 参见 通用参数;
- #num（可选）- 第N个最近的值。
注释：
- 请注意，带井号标记的时间段（#N）在此处的工作方式与许多其他函数不同。例如：
last(/host/key)总是等于last(/host/key,#1)；last(/host/key,#3)- 第三个最近的值（不是 最近三个值）； - 如果历史记录中一秒内存在超过两个值，Zabbix 不保证值的确切顺序；
- 另请参阅 first()。
示例：
last(/host/key) #检索最后一个值
last(/host/key,#2) #检索前一个值
last(/host/key,#1) <> last(/host/key,#2) #最后一个和前一个值不同logeventid(/host/key,<#num<:time shift>>,<pattern>)
检查最后一个日志条目的事件ID是否与正则表达式匹配。.
支持的值类型：日志。
返回值： 0 - 不匹配； 1 - 匹配。
参数：
- 参见 常用参数；
- #num (可选) - 第N个最近的值；
- pattern (可选) - 描述所需模式的正则表达式， Perl 兼容正则表达式 (PCRE) 样式（字符串参数必须用双引号引起来）。
logseverity(/host/key,<#num<:time shift>>)
最后一个日志条目的日志严重性。
支持的值类型：日志。
返回值： 0 - 默认严重性； N - 严重性 （整数，适用于Windows事件日志： 1 -信息， 2 - 警告， 4 - 错误， 7 - 失败审计， 8 - 成功审计，9 - 严重， 10 - 详细）。
参数：
- 参见 常用参数；
- #num (可选) - 第N个最近的值；
Zabbix从Windows事件日志的信息 字段获取日志严重性。
logsource(/host/key,<#num<:time shift>>,<pattern>)
检查最后一个日志条目的日志源是否匹配正则表达式。
支持的值类型：日志。
返回值： 0 - 不匹配； 1 - 匹配。
参数：
- 参见 常用参数；
- #num (可选) - 第N个最近的值；
- pattern (可选) - 描述所需模式的正则表达式， Perl 兼容正则表达式 (PCRE) 样式（字符串参数必须用双引号引起来）。
通常用于Windows事件日志。
示例：
monodec(/host/key,(sec|#num)<:time shift>,<mode>)
检查值是否单调下降。
支持的值类型： 整数。
返回值： 1 - 如果时间段中的所有元素连续减少； 0 - 否则。
参数：
- 参见 常用参数；
- mode (必须用双引号括起来) - weak （每个值都小于前一个值或与前一个值相同；默认值）或者strict （每个值都减小了）。
示例：
monodec(/Host1/system.swap.size[all,free],60s) + monodec(/Host2/system.swap.size[all,free],60s) + monodec(/Host3/system.swap.size[all,free],60s) #calculate in how many hosts there has been a decrease in free swap sizemonoinc(/host/key,(sec|#num)<:time shift>,<mode>)
检查值是否单调增加。
支持的值类型： 整数。
返回值： 1 - 如果时间段中的所有元素连续增加； 0 - 否则。
参数：
- 参见 常用参数；
- mode (必须用双引号括起来) - weak （每个值都大于前一个值或与前一个值相同；默认值）或者strict （每个值都增加了）。
示例：
monoinc(/Host1/system.localtime,#3,"strict")=0 #check if the system local time has been increasing consistentlynodata(/host/key,sec,<mode>)
检查在指定时间内是否未接收到数据。
支持的值类型：Integer, Float, Character, Text, Log。
返回值：1 - 如果在定义的时间段内未接收到数据；0 - 否则。
参数：
- 参见 通用参数；
- sec - 时间段不应少于30秒，因为历史同步进程每30秒计算此函数一次；
nodata(/host/key,0)不被允许。 - mode - 如果设置为 strict（双引号括起），此函数将不考虑proxy的可用性（参见注释以了解详细信息）。
注释：
- 默认情况下，由proxy监控的 'nodata' 告警对proxy的可用性敏感 - 如果proxy变得不可用，'nodata' 告警在连接恢复后不会立即触发，而是会跳过延迟期间的数据。请注意，对于被动proxy，如果连接恢复超过15秒且不少于2秒后，将激活抑制。对于主动proxy，如果连接恢复超过15秒后，将激活抑制。要关闭对proxy可用性的敏感性，使用第三个参数，例如：
nodata(/host/key,5m,"strict")；在这种情况下，函数将在没有数据的评估期（五分钟）过去后立即触发。 - 如果在第一个参数指定的期间内：
- 没有数据且Zabbix server重启
- 没有数据且维护完成
- 没有数据且监控项被添加或重新启用
此函数将显示错误。 - 错误显示在触发器 配置 的 Info 列中；
- 如果Zabbix server、proxy和agent之间存在时间差异，此函数可能无法正常工作。另请参阅：时间同步要求；
- nodata() 函数不能单独在表达式中使用；至少必须包含一个来自 其他组 的函数，引用主机的监控项（除了 日期和时间函数）。有关nodata()函数在表达式中如何工作的详细信息，请参阅 计算时间。
percentile(/host/key,(sec|#num)<:time shift>,percentage)
周期的第P个百分位数，其中P（百分比）由第三个参数指定。
支持的值类型：浮点、整数。
参数：
- 参见常用参数;
- percentage - 介于0和100（含）之间的浮点数，小数点后最多4位。
rate(/host/key,sec<:time shift>)
在定义的时间段内，单调递增的计数器每秒的平均递增速率。
支持的值类型：浮点、整数。
参数：
- 参见常用参数;
功能上对应于PromQL的 'rate' 。
示例：
rate(/host/key,30s) #if the monotonic increase over 30 seconds is 20, this function will return 0.67.参见 所有支持的函数。