首页/数据/NoSQL 速查/Flux aggregateWindow 时间窗口聚合
本包目录(322 条)

Flux aggregateWindow 时间窗口聚合

aggregateWindow 按固定时间窗口聚合(如每 5 分钟取均值):every 定义窗口、fn 定义聚合函数,createEmpty 决定空窗口是否补值,timeSrc 决定结果时间戳来源。

NoSQL 速查数据更新于 2026-10-12
语法|> aggregateWindow(every: 5m, fn: mean, createEmpty: false)
常用参数every、period、offset、fn(mean/max/min/sum/count/last)、createEmpty、timeSrc
补值createEmpty: true 用空值补齐无数据窗口,画图时时间轴更连续

示例

示例
from(bucket: "metrics")
  |> range(start: -6h)
  |> filter(fn: (r) => r._measurement == "cpu" and r._field == "usage")
  |> aggregateWindow(every: 5m, fn: mean, createEmpty: false)
  |> yield(name: "cpu_5m_avg")
窗口按 UTC 对齐,需要本地零点对齐时用 offset 调整;跨夏令时地区要确认对齐行为。

易错点

  • every 小于原始采样间隔时会引入锯齿,先确认原始数据精度再定窗口
  • 同时输出多个聚合结果要用多个管道并 yield 命名,否则结果会混在一起

数据来源与参考

  • InfluxData Docs: aggregateWindow()
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌