API安定性保証

Prometheusはメジャーバージョン内でのAPI安定性を保証し、主要な機能に対する破壊的変更を避けるよう努めています。ただし、外観に関する機能、まだ開発中の機能、またはサードパーティサービスに依存する機能は対象外です。

3.xで安定とみなされるもの

• クエリ言語とデータモデル
• アラートと記録ルール
• 取り込みの表示形式
• v1 HTTP API（ダッシュボードおよびUIで使用）
• 設定ファイル形式（サービスディスカバリのリモート読み書きを除く、以下を参照）
• ルール/アラートファイル形式
• コンソールテンプレートの構文とセマンティクス
• 1.0仕様に基づくリモート書き込みの送信と受信
• エージェントモード
• 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としてマークされます。