Skip to main content

timeSeriesAvgToGrid

引入版本:v26.9.0 聚合函数,接收由时间戳和值对组成的时间序列数据,并在由起始时间戳、结束时间戳和步长定义的等间隔时间网格上,基于这些数据计算类 PromQL 的 avg_over_time。对于网格上的每个点,用于计算平均值的样本均取自指定的时间窗口内。 样本可以通过以下三种形式之一传入:
  • 以 timestamp 和 value 两个参数传入,每行包含一个样本;
  • 以时间戳array和值array两个array传入,每行包含一整条时间序列;
  • 以由 (timestamp, value) Tuple 组成的单个array传入,每行包含一整条时间序列。
如果多个样本的时间戳相同,则只使用其中值最大的那个样本。非数字 (NaN) 值在比较中总是输给任何其他值,因此只有当该时间戳上的所有样本均为 NaN 时,才会使用 NaN 值。
此函数目前处于私有预览阶段,可通过设置 enable_time_series_aggregate_functions=true 启用。
语法
参数
  • start_timestamp — 指定网格的起点。也可以是小数,或包含数字或日期时间文本的字符串。UInt32 或 DateTime 或 DateTime64 或 Float* 或 Decimal* 或 String
  • end_timestamp — 指定网格的终点。也可以是小数,或包含数字或日期时间文本的字符串。UInt32 或 DateTime 或 DateTime64 或 Float* 或 Decimal* 或 String
  • grid_step — 指定网格的步长 (单位为秒) 。也可以是小数,或包含数字或时长 (如 ’15s’ 或 ‘1m’) 的字符串。UInt32 或 Float* 或 Decimal* 或 String
  • staleness — 指定参与计算的样本的最大陈旧时长 (单位为秒) 。陈旧窗口为左开右闭区间。也可以是小数,或包含数字或时长 (如 ’15s’ 或 ‘1m’) 的字符串。UInt32 或 Float* 或 Decimal* 或 String
参数 返回值 返回指定网格上的平均值。返回的array中,每个时间网格点对应一个值。若某个网格点的窗口内没有样本,则该点的值为 NULL。Array(Nullable(Float64)) 示例 基本用法:使用单个时间戳-值对
Query
Response
使用 array 参数
Query
Response
最后修改于 2026年10月14日