Sidebar

1 聚合函数

除非另有说明,此处列出的所有功能均受支持 在:

聚合函数可以使用:

  • 监控项历史数据, 例如, min(/host/key,1h)
  • 预测函数 作为 唯一的参数,例如, min(last_foreach(/*/key))

关于函数参数的一些一般说明:

  • Function parameters are separated by a comma
  • 函数参数用逗号分隔
  • 可选函数参数(或参数部分)由 < >
  • 每个函数都描述了函数特定的参数
  • /host/key(sec|#num)<:time shift> 参数绝不能 引用
常用参数
  • /host/key是函数的常见强制性第一个参数 引用主机监控项历史
  • (sec|#num)<:time shift> 是常见的第二个参数 引用主机监控项历史的函数,其中
    • sec - 最大 评估周期 in seconds (时间 时间戳后缀 可以使用), or
    • #num - 最大次数 评估范围最新 收集的值(如果前面有井号)
    • time shift(可选)允许移动评估点 历史点。关于指定时移更多 [细节]可查看(/manual/config/triggers/expression#time_shift) 。

聚合 函数

函数
描述 特定函数参数 注释
avg (/host/key,(sec|#num)<:time shift>)
监控项在定义的评估期内的平均值。 参考 common parameters. 支持的值类型 : float, int

例子:
=> avg(/host/key,1h) → 最后一小时的平均值,直到 now
=> avg(/host/key,1h:now-1d) → 从 25 小时前到 24 小时前一小时的平均值 now
=> avg(/host/key,#5) → 五个最新值的平均值
=> avg(/host/key,#5:now-1d) → 不包括最近 24 小时内收到的值的五个最新值的平均值

当需要将当前平均值与前一段时间的平均值进行比较时,时移很有用.
bucket_percentile (监控项 过滤器、时间段、百分比)
从直方图的桶中计算百分位数. item filter - 参看 item filter
time period - 参看 time period
percentage - 百分比 (0-100)
仅在计算监控项中支持.

这个函数是一个别名 histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))
count (func_foreach(item filter,<time period>))
foreach 函数返回的数组中的值的计数. func_foreach - 应计算返回值数量的 foreach 函数(带有支持的参数). 参看 foreach functions 详情. 支持的值类型: int

例子:
=> count(max_foreach(/*/net.if.in[*],1h)) → number of net.if.in items that received data in the last hour until now

请注意,使用 count() 使用与历史相关的 foreach 函数(max_foreach、avg_foreach 等)可能会影响性能,而使用 exists_foreach(), 仅适用于配置数据,不会有这样的效果.
histogram_quantile (quantile,bucket1,value1,bucket2,value2,...)
从直方图的桶中计算 φ 分位数。 quantile - 0 ≤ φ ≤ 1
bucketN, valueN - 手动输入的参数对 (>=2) 或 [bucket_rate_foreach] (/manual/appendix/functions/aggregate/foreach)
仅在计算项中支持。

功能对应'histogram_quantile' 参考PromQL.

如果最后一个 'Infinity' 存储桶 ("+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 - 项目选择标准,允许按主机组、主机、监控项键和标签进行引用。支持通配符 参看 item filter 更多详情. 支持数据类型: int

作为别名工作count(exists_foreach(item_filter)) 函数.

例子:
=> item_count(/*/agent.ping?[group="Host group 1"]) → 主机组"Host group 1"中带有 agent.ping 项的主机数量
kurtosis (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集值的概率分布的“Tailedness”。

See also: Kurtosis
参看 common parameters. 支持数据类型: float, int

例子:
=> kurtosis(/host/key,1h) → kurtosis 最后一小时,直到now
mad (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集值的中值绝对偏差.

另见: Median absolute deviation
参看 common-parameters. 支持的数据类型: float, int

例子:
=> mad(/host/key,1h) → 最后一小时的绝对偏差中位数,直到 now
max (/host/key,(sec|#num)<:time shift>)
监控项在规定的评估期内的最高值。 参看 common parameters. 支持的数据类型: float, int

例子:
=> max(/host/key,1h) - min(/host/key,1h) → 计算最后一小时内的最大值和最小值之间的差,直到 now (值的增量)
min (/host/key,(sec|#num)<:time shift>)
在定义的评估期内监控项的最低值。 参看 common parameters. 支持的数据类型: float, int

Example:
=> max(/host/key,1h) - min(/host/key,1h) → 计算最后一小时内的最大值和最小值之间的差,直到 now (值的增量)
skewness (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集值的概率分布对称。

参见: Skewness
参看 common parameters. 支持的数据类型: float, int

Example:
=> skewness(/host/key,1h) → 最后一小时的偏度,直到now
stddevpop (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集的值的总体标准偏差。

参见: Standard deviation
参看 common parameters. 支持的数据类型: float, int

例子:
=> stddevpop(/host/key,1h) → 最后一小时的总体标准差,直到 now
stddevsamp (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集的值的样本标准偏差。

参见: Standard deviation
参看 common parameters. 支持的数据类型: float, int

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

例子:
=> stddevsamp(/host/key,1h) → 最后一小时的样本标准偏差,直到 now
sum (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集的值的总和。 参看 common parameters. 支持的数据类型: float, int

例子:
=> sum(/host/key,1h) → 最后一小时的值总和,直到 now
sumofsquares (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集的值的平方和。 参看 common parameters. 支持的数据类型: float, int

例子:
=> sumofsquares(/host/key,1h) → 最后一小时的平方和,直到 now
varpop (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集的值的总体方差。

参见: Variance
参看 common parameters. 支持的数据类型: float, int

Example:
=> varpop(/host/key,1h) → 最后一小时的总体方差,直到 now
varsamp (/host/key,(sec|#num)<:time shift>)
在定义的评估期内收集值的样本方差。

参见: Variance
参看 common parameters. 支持的数据类型: float, int

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

例子:
=> varsamp(/host/key,1h) → 最后一小时的样本方差,直到 now