跳转到主要内容
使用 TimeSeries 表中的数据计算 Prometheus 查询结果。

语法

参数

  • db_name - TimeSeries 表所在的数据库名称。
  • time_series_table - TimeSeries 表的名称。
  • promql_query - 使用 PromQL 语法 编写的查询。
  • evaluation_time - 求值时间戳。要在当前时间对查询进行求值,请使用 now()作为evaluation_time`。

返回值

该函数会根据传给参数 promql_query 的查询结果类型,返回不同的列:

支持的 PromQL 特性

选择器

即时选择器、范围选择器、标签匹配器 (=!==~!~) 、偏移修饰符、@ 时间戳修饰符以及子查询。

函数

注意histogram_quantile 在经典直方图桶 (由 le 标签标识) 上使用线性插值。原生直方图暂不受支持,并且 phi (分位数级别) 参数当前必须是常量标量——像 histogram_quantile(time() / 1000, ...) 这样每个时间步都会变化的表达式会因 NOT_IMPLEMENTED 错误而被拒绝。

运算符

所有算术 (+-*/%^) 、比较 (==!=<><=>=,可选 bool) 和逻辑 (andorunless) 二元运算符,以及 on()/ignoring()group_left()/group_right() 修饰符。 一元运算符 +-

聚合运算符

sumavgminmaxcountstddevstdvargroupquantiletopkbottomklimitk —— 可选使用 by()without() 修饰符。 尚不支持:count_values

示例

最后修改于 2026年6月25日