Prometheus 3.14.0 发布解读：PromQL 时长表达式默认启用、OCI 计算服务发现

Prometheus 于 2026 年 8 月 17 日发布 3.14.0。本版本在 PromQL 表达力、服务发现与 TSDB 直方图能力上继续推进。

核心变化

PromQL 时长表达式默认启用：step()、range()、min_of()、max_of() 等时长表达式不再需要 promql-duration-expr 特性开关，该 flag 成为空操作。UI 同时为时长表达式在范围选择器与子查询中加入语法高亮、自动补全与 lint。

first_over_time 转 Stable：不再需要 promql-experimental-functions 特性开关即可使用。

实验性能力：

• start_timestamp(instant-vector) 函数返回向量中每个样本的开始时间戳（需 use-start-timestamps flag）；rate()/increase() 可改用开始时间戳进行速率外推；
• TSDB 支持在直方图与 float 直方图中编码开始时间戳（histograms-st-encoding flag），远端写 V2 协议同步转发直方图开始时间戳。

服务发现：新增 Oracle Cloud Infrastructure 计算服务发现 oci_sd_configs。Hetzner 发现移除 __meta_hetzner_datacenter 标签（Hetzner Cloud API 已移除该字段）。

OTLP 标签冲突可观测：OTLP 属性经清洗后冲突成同一 Prometheus 标签（如 k8s.pod.name 与 k8s_pod_name 都变成 k8s_pod_name）时发出警告，并以 prometheus_api_otlp_translation_warnings_total 计数器按类别跟踪。

其他：

• API 弃用 /api/v1/query 与 /api/v1/query_range 的 stats 参数非 true/all 取值（仍可用但返回弃用警告，下个大版本拒绝）；
• promtool 新增 --remote-write.path 用于非默认 remote-write 端点的后端；
• TSDB head 新增原生直方图系列数与桶数 gauge：prometheus_tsdb_head_native_histogram_series、prometheus_tsdb_head_native_histogram_buckets。

适用场景

• 依赖 PromQL 时长表达式但之前被特性开关挡住的查询，升级后可直接使用；
• 在 Oracle Cloud 运行工作负载的团队可启用 oci_sd_configs 自动发现计算实例；
• 使用 OTLP 接入且标签存在冲突可能性的场景，建议关注新增警告计数器。

来源：Prometheus v3.14.0 Release