API 稳定性保证
Prometheus 承诺在其主要版本内保持 API 的稳定性,致力于避免关键功能的破坏性更改。然而,某些特性(外观调整、仍在开发中或第三方服务提供的特性等)不在这一承诺的覆盖范围内。
2.x 版本被视为稳定的特性:
- 查询语言和数据模型
- 告警和记录规则
- 数据消费的展示格式
- v1 HTTP API(用于仪表板和 UI)
- 配置文件格式(除了服务发现 remote read/write 功能,见下文)
- 规则/告警文件格式
- 控制台模板语法及其语义
- 远程写入发送,按照1.0规范进行。
2.x 版本被视为不稳定的特性:
- 标记为实验性或可能变更的任何功能,包括但不限于:
holt_winters
PromQL 函数(见 GitHub issue #2458)- remote write 接收、remote read和 remote read 端点
- 服务器端的 HTTPS 和基本认证(basic authentication)
- 服务发现集成,除
static_configs
和file_sd_configs
外 - 作为服务器部分的 Go API
- 由 Web UI 生成的 HTML
- 自身 Prometheus 的 /metrics 端点中的指标
- 确切的硬盘存储格式。可能出现的改变将向前兼容,并由 Prometheus 透明处理
- 日志格式
只要你未使用任何标记为实验性/不稳定的特性,在同一主要版本内进行升级通常是无需任何操作调整的,而且风险极小,不会发生任何服务中断。所有破坏性更改将在发布说明中标记为CHANGE
。
该文档基于 Prometheus 官方文档翻译而成。