API 稳定性保证
Prometheus 承诺在一个主要版本内保持 API 稳定性,并努力避免关键特性出现重大变更。某些美观性的、仍在开发中的或依赖第三方服务的特性不在此列。
3.x 版本中视为稳定的部分
- 查询语言和数据模型
- 告警和记录规则
- 摄入暴露格式
- v1 HTTP API(由仪表盘和 UI 使用)
- 配置文件格式(不包括服务发现的远程读/写,详见下文)
- 规则/告警文件格式
- 控制台模板语法和语义
- 远程写入发送(根据1.0 规范)和接收
- Agent 模式
- OTLP 接收器端点
3.x 版本中视为不稳定的部分
- 任何被列为实验性或可能更改的特性,包括
double_exponential_smoothing
PromQL 函数- 远程读取和远程读取端点
- 服务器端 HTTPS 和基本认证
- 服务发现集成,`static_configs`、`file_sd_configs` 和 `http_sd_config` 除外
- 作为服务器一部分的 Go 包的 API
- Web UI 生成的 HTML
- Prometheus 自身 /metrics 端点中的指标
- 精确的磁盘格式。但潜在的更改将向前兼容并由 Prometheus 透明处理
- 日志格式
Prometheus 2.x 稳定性保证可以在2.x 文档中找到。
只要您不使用任何标记为实验性/不稳定性的功能,主要版本内的升级通常可以在无需任何操作调整的情况下进行,并且出现问题的风险很小。任何重大变更都将在发行说明中标记为 CHANGE
。