API 稳定性保证

Prometheus 承诺在一个主要版本内保持 API 稳定性,并努力避免关键特性出现重大变更。某些美观性的、仍在开发中的或依赖第三方服务的特性不在此列。

3.x 版本中视为稳定的部分

  • 查询语言和数据模型
  • 告警和记录规则
  • 摄入暴露格式
  • v1 HTTP API(由仪表盘和 UI 使用)
  • 配置文件格式(不包括服务发现的远程读/写,详见下文)
  • 规则/告警文件格式
  • 控制台模板语法和语义
  • 远程写入发送(根据1.0 规范)和接收
  • Agent 模式
  • OTLP 接收器端点

3.x 版本中视为不稳定的部分

  • 任何被列为实验性或可能更改的特性,包括
  • 服务器端 HTTPS 和基本认证
  • 服务发现集成,`static_configs`、`file_sd_configs` 和 `http_sd_config` 除外
  • 作为服务器一部分的 Go 包的 API
  • Web UI 生成的 HTML
  • Prometheus 自身 /metrics 端点中的指标
  • 精确的磁盘格式。但潜在的更改将向前兼容并由 Prometheus 透明处理
  • 日志格式

Prometheus 2.x 稳定性保证可以在2.x 文档中找到

只要您不使用任何标记为实验性/不稳定性的功能,主要版本内的升级通常可以在无需任何操作调整的情况下进行,并且出现问题的风险很小。任何重大变更都将在发行说明中标记为 CHANGE

本页内容