1 聚合函数

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

聚合函数可以使用：

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

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

  • 函数参数用逗号分隔
  • 可选函数参数（或参数部分）由 < >
  • 每个函数都描述了函数特定的参数
  • /host/key 和 (sec|#num)<:time shift> 参数绝不能引用
常用参数
  • /host/key是函数的常见强制性第一个参数 引用主机监控项历史
  • (sec|#num)<:time shift> 是常见的第二个参数 引用主机监控项历史的函数，其中
    • sec - 最大评估周期 in seconds(时间 时间戳后缀 可以使用), or
    • #num - 最大次数 评估范围最新 收集的值（如果前面有#号）
    • 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)) → 最近1小时net.if.in监控项值的个数。

请注意，使用 count() 使用与历史相关的 foreach 函数（max_foreach、avg_foreach 等）可能会影响性能，而使用 exists_foreach(), 仅适用于配置数据，不会有这样的效果.
histogram_quantile (quantile,bucket1,value1,bucket2,value2,…)
从直方图的桶中计算 φ 分位数。quantile - 0 ≤ φ ≤ 1
bucketN, valueN - 手动输入的参数对 (>=2) 或 bucket_rate_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