1 聚合函数

除非另有说明，此处列出的所有功能均受支持：

• 触发器表达式
• 计算型监控项

聚合函数可以与以下任一项一起使用：

• 监控项的历史记录, 例如 , min(/host/key,1h)
• Foreach函数 作为唯一的参数，例如，min(last_foreach(/*/key))` (仅用在计算型监控项，不能在触发器中使用)

这里列出了函数的基本释义，若需要可以点击函数查看详细信息。

常用参数

• /host/key是函数的常见强制性第一个参数 引用主机监控项历史
• (sec|#num)<:time shift> 是常见的第二个参数 引用主机监控项历史的函数，其中
  • sec - 以秒为单位的最大评估周期 (可以使用时间戳后缀 )，或者
  • #num - 最新收集值最大 评估范围（如果前面有#号）
  • time shift（可选）允许将评估点向后移动。请参阅有关指定时间偏移的更多详细信息。

函数详情

关于函数参数的一般性说明：

• 函数参数用逗号分隔
• 可选函数参数（或参数部分）由< >表示
• 每个函数都描述了特定的函数参数
• /host/key 和(sec|#num)<:time shift>参数绝对不能加引号

avg(/host/key,(sec|#num)<:time shift>)

在定义的评估期内监控项的平均值。
支持的值类型： 浮点, 整数.
支持的 foreach函数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

参数: 参见 常用参数.

当需要将当前平均值与一段时间前的平均值进行比较时，时间偏移很有用。

示例：

avg(/host/key,1h) #the average value for the last hour until now
       avg(/host/key,1h:now-1d) #the average value for an hour from 25 hours ago to 24 hours ago from now
       avg(/host/key,#5) #the average value of the five latest values
       avg(/host/key,#5:now-1d) #the average value of the five latest values excluding the values received in the last 24 hours

bucket_percentile(item filter,time period,percentage)

根据直方图的桶计算百分比。

参数：

• 监控项过滤器 - 参见 监控项过滤器；
  
• 时间段 - 参见 时间段；
  
• 百分比 - 百分比 (0-100)。

注释:

• 仅在计算监控项中支持；
• 次函数是histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))的一个别名。

count(func_foreach(item filter,<time period>),<operator>,<pattern>)

返回由foreach函数返回的数组中的值的计数。
支持的foreach函数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

参数:

• func_foreach - 需要计算返回值数量的foreach函数。有关详细信息，请参阅foreach函数。注意，count_foreach和bucket_rate_foreach支持附加参数。
• item filter - 参见item filter;
  
• time period - 参见time period;
  
• operator（必须双引号括起）。支持的运算符:
  eq - 等于
  ne - 不等于
  gt - 大于
  ge - 大于或等于
  lt - 小于
  le - 小于或等于
  like - 如果包含模式则匹配（区分大小写）
  bitand - 位与
  regexp - 匹配pattern中给出的区分大小写的正则表达式
  iregexp - 匹配pattern中给出的不区分大小写的正则表达式
  
• pattern - 所需的模式（字符串参数必须双引号括起）；如果在第三个参数中指定了operator，则支持。

注释:

• 使用count()与历史相关的foreach函数（max_foreach，avg_foreach等）可能会导致性能影响，而使用exists_foreach()，它只与配置数据一起工作，将不会有这种效果。
• 可选参数operator或pattern在逗号后不能留空，只能完全省略。
• 当bitand作为第三个参数时，第四个pattern参数可以指定为两个数字，用'/'分隔：number_to_compare_with/mask。count()从值和mask计算“位与”，并将结果与number_to_compare_with进行比较。如果“位与”的结果等于number_to_compare_with，则计算值。
  如果number_to_compare_with和mask相等，只需指定mask（不带'/'）。
• 当regexp或iregexp作为第三个参数时，第四个pattern参数可以是一个普通或全局（以'@'开头）的正则表达式。对于全局正则表达式，大小写敏感性继承自全局正则表达式设置。为了进行正则表达式匹配，浮点值将始终表示为小数点后4位数字。请注意，对于大数，十进制（存储在数据库中）和二进制（Zabbix服务器使用）表示之间的差异可能会影响第四位小数。

示例:

count(max_foreach(/*/net.if.in[*],1h)) #在过去的1小时直到现在接收数据的net.if.in监控项的数量
       count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #磁盘空间使用超过95%的文件系统的数量

histogram_quantile(quantile,bucket1,value1,bucket2,value2,...)

根据直方图的桶计算φ分位数。
支持的 foreach 函数: bucket_rate_foreach。

参数：

• quantile - 0 ≤ φ ≤ 1；
  
• bucketN, valueN -手动输入参数对 (>=2) 或者bucket_rate_foreach的响应。

注释：

• 仅在计算型监控项中支持；
• 在功能上对应于PromQL的'histogram_quantile'；
• 如果最后一个 'Infinity' bucket ("+inf")的值等于0，则返回-1。

示例：

histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf])) histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s))

item_count(item filter)

配置中与过滤条件匹配的现有监控项的计数。
支持值类型： 整数。

参数：

• item filter - 监控项选择标准，允许按主机组、主机、监控项键和标签进行引用。 支持通配符。 参见 监控项过滤器 获得更多详细信息。
  

注释：

• 仅在计算型监控项中支持；
• 用作count(exists_foreach(item_filter)) 函数的别名。

示例：

item_count(/*/agent.ping?[group="Host group 1"]) #the number of hosts with the *agent.ping* item in the "Host group 1"

kurtosis(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值中概率分布的“尾部”。参见: Kurtosis.
支持的值类型：浮点， 整数.
支持的 foreach 函数： last_foreach。

参数： 参见 常用参数。

示例：

kurtosis(/host/key,1h) #kurtosis for the last hour until now

mad(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的中值绝对偏差。See also: 中值绝对偏差。
支持的值类型：浮点， 整数。
支持的 foreach 函数： last_foreach。

参数： 参见 常用参数。

示例：

mad(/host/key,1h) #median absolute deviation for the last hour until now

max(/host/key,(sec|#num)<:time shift>)

在定义的评估期内监控项的最大值。
支持的值类型：浮点， 整数。
支持的 foreach 函数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

参数： 参见 常用参数。

示例：

max(/host/key,1h) - min(/host/key,1h) #calculate the difference between the maximum and minimum values within the last hour until now (the delta of values)

min(/host/key,(sec|#num)<:time shift>)

在定义的评估期内监控项的最小值。
支持的值类型：浮点， 整数。
支持的 foreach 函数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

参数： 参见 常用参数。

示例：

max(/host/key,1h) - min(/host/key,1h) #calculate the difference between the maximum and minimum values within the last hour until now (the delta of values)

skewness(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的概率分布不对称性。 另参见 Skewness。
支持的值类型：浮点，整数。
支持的 foreach 函数：last_foreach。

参数： 参见 常用参数。

示例：

skewness(/host/key,1h) #the skewness for the last hour until now

stddevpop(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的总体标准差。另参见： 标准差。
支持的值类型：浮点，整数。
支持的 foreach 函数：last_foreach。

参数： 参见 常用参数。

示例：

stddevpop(/host/key,1h) #the population standard deviation for the last hour until now

stddevsamp(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的样本标准差。 另参见： 标准差。
支持的值类型：浮点，整数。
支持的 foreach 函数：last_foreach。

参数： 参见 常用参数。

此函数至少需要两个数据值才能工作。

示例：

stddevsamp(/host/key,1h) #the sample standard deviation for the last hour until now

sum(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的总和。
支持的值类型：浮点，整数。
支持的 foreach 函数：avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

参数： 参见 常用参数。

示例：

sum(/host/key,1h) #the sum of values for the last hour until now

sumofsquares(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的平方和。
支持的值类型：浮点，整数。
支持的 foreach 函数：last_foreach。

参数： 参见 常用参数。

示例：

sumofsquares(/host/key,1h) #the sum of squares for the last hour until now

varpop(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的总体方差。另参见：方差。
支持的值类型：浮点，整数。
支持的 foreach 函数：last_foreach。

参数： 参见 常用参数。

示例：

varpop(/host/key,1h) #the population variance for the last hour until now

varsamp(/host/key,(sec|#num)<:time shift>)

在定义的评估期内收集的值的样本方差。 另参见： 方差。
支持的值类型：浮点，整数。
支持的 foreach 函数：last_foreach。

参数： 参见 常用参数。

此函数至少需要两个数据值才能工作。

示例：

varsamp(/host/key,1h) #the sample variance for the last hour until now

参见 所有支持的函数。