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 官方文档翻译而成。