Prometheus API稳定性保证

完整译文请访问：http://www.coderdocument.com/docs/prometheus/v2.14/prometheus/api_stability_guarantees.html。

Prometheus承诺API在主版本中保持稳定，并努力避免破坏关键特性的变化。一些cosmetic功能，仍在开发中，或依赖于第三方服务，不包括在此。

如下内容在2.x版本中是稳定的：

• 查询语言或数据模型
• 告警和记录规则
• 摄入暴露格式
• v1 HTTP API（仪表盘和UI使用）
• 配置文件格式（除去服务发现远程读/写，如下）
• 规则和告警文件格式
• 控制台模板语法和语义

如下内容在2.x版本中是不稳定的：

• 任何标记为试验性或可能更改的功能，包括：

  • holt_winters PromQL 函数
  • 远程读、远程写和远程读端点
  • v2 HTTP 和 GRPC API

• 服务发现集成，除了static_configs 和 file_sd_configs

• 包（package）的Go API是服务器的一部分

• web UI生成的HTML

• Prometheus自身的/metrics端点中的指标

• 确切的磁盘格式。然而，潜在的变化将由Prometheus向前兼容和透明地处理

只要你没有使用任何标记为实验性/不稳定性的特性，一个主版本的升级通常可以在不进行任何操作调整的情况下执行，并且很少有任何东西会崩溃的风险。任何破坏性更改都将在发布说明中都有CHANGE标记。

完整译文请访问：http://www.coderdocument.com/docs/prometheus/v2.14/prometheus/api_stability_guarantees.html。