RATATOSK
← リリース一覧

Prometheusv3.5.0

セキュリティ 1破壊的変更 1重大な修正 16機能・改善 12その他の変更 9

Prometheusの通知を受け取る

週次メールは確認すべき変更がある週だけ、深刻度がcriticalのセキュリティアドバイザリは即時に届きます。

セキュリティ1

CORS 応答で Origin ごとに異なる内容を返す変更

影響対象応答が SetCORS を通る HTTP エンドポイント(推定)

Origin に応じて応答を変えることで、Origin を考慮しないキャッシュの再利用を防ぎます。

原文を表示
* [BUGFIX] API: Add HTTP `Vary: Origin` header to responses to avoid cache poisoning. #16008
github.com/prometheus/prometheus/releases/tag/v3.5.0

破壊的変更1

文字列ラベルのサイズ符号化方式の変更と長さの16MB上限

影響対象16MBを超えるラベル名または値を使用する環境(推定)

従来、ラベルのサイズには可変長整数を使用していましたが、現在はサイズが0~254の場合は1バイト、255の場合は値255に続けて3バイトのリトルエンディアン形式でサイズを表します。メモリー使用量は、サイズが0~127および2MB~16MBの場合は変わらず、128~254および16384~2MBの場合は1バイト減り、255~16383の場合は2バイト増えます。

根拠“Instead of using varint to encode the size of each label, use a single byte for size 0-254, or a flag value of 255 followed by the size in 3 bytes little-endian.” prometheus/prometheus/pull/16069 ↗
原文を表示
* [PERF] Labels: Simpler/faster stringlabels encoding. #16069
github.com/prometheus/prometheus/releases/tag/v3.5.0

重大な修正16

  • PromQL 範囲集約におけるスカラーパラメーターの変更への対応
    影響対象quantile や topk などの集約で、定数でないスカラーパラメーターを使用する PromQL 範囲クエリ

    クエリ範囲内の各評価時刻におけるパラメーター値が、結果に反映されるようになりました。

    * [ENHANCEMENT] PromQL: support non-constant parameter in aggregations like `quantile` and `topk`. #16404
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • Prometheus の GOGC 環境変数の処理を修正
    影響対象GOGC が設定され、読み込まれた設定に runtime.gogc フィールドがない Prometheus 環境(推定)

    以前は、GOGC が設定されていても設定に runtime ブロックがない場合、Prometheus はその値を無視し、デフォルトの 75% を使用していました。今後は、runtime ブロックの有無にかかわらず環境変数の値を使用します。ただし、runtime.gogc が設定されている場合は、そちらが優先されます。

    * [BUGFIX] Config: Respect GOGC environment variable if no "runtime" block exists. #16558
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • PromQL last_over_time のネイティブヒストグラム処理の修正
    影響対象ネイティブヒストグラムに対する last_over_time クエリ

    float サンプルを含まず、ヒストグラムのタイムスタンプが 0 未満である混在サンプルの場合、誤って T=0, V=0.0 のデフォルトの float を返していました。

    * [BUGFIX] PromQL: Fix native histogram `last_over_time`. #16744
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • 入力が競合する場合に結果を返さないPromQLヒストグラム関数
    影響対象同一タイムスタンプの同一系列にクラシックヒストグラムとネイティブヒストグラムがあるデータに対して、histogram_fraction または histogram_quantile を使用する環境

    この競合ケースでは、以前は結果がないはずのところで関数が値を返すことがありました。現在は結果を返さず、クラシック/ネイティブ混在ヒストグラムの警告を出力します。

    * [BUGFIX] PromQL: Don't emit a value from `histogram_fraction` or `histogram_quantile` if classic and native histograms are present at the same timestamp. #16552
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • PromQL の duration 丸め処理の修正
    影響対象オフセット、範囲セレクター、サブクエリの範囲またはステップにおける PromQL の数値 duration

    [1001ms] のような duration が [1s] に切り捨てられ、データが密な場合にセレクターがサンプルを取りこぼすことがありました。現在はナノ秒単位で最も近い値に丸められるため、[1001ms] は1001ミリ秒として表現されます。

    * [BUGFIX] PromQL: Incorrect rounding of `[1001ms]` to `[1s]` and similar. #16478
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • ヒストグラムクエリにおける PromQL のカウンターリセット検出の修正
    影響対象histogram_count、histogram_sum、histogram_avg と rate、irate、increase を使うネイティブヒストグラムクエリ

    範囲内の最後のサンプルが直前のサンプルからカウンターリセットを引き起こした場合、リセットの検出に失敗し、histogram_count と histogram_sum の結果に一貫性がなくなったり、負の値になったりすることがありました。

    * [BUGFIX] PromQL: Fix inconsistent / sometimes negative `histogram_count` and `histogram_sum`. #16682
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • PromQL の histogram_quantile と histogram_fraction における NaN 処理の修正
    影響対象NaN の観測値を含み、histogram_quantile または histogram_fraction で使用されるネイティブヒストグラム

    NaN の観測値を含むネイティブヒストグラムでは、すべての観測値が NaN の場合や、分位点が通常の観測値を超えた場合に、histogram_quantile が 0 または上限バケットの境界値を返すことがありました。また、histogram_fraction の計算には NaN が含まれていました。修正後は、分位点が通常の観測値をすべて超えて NaN の領域に達すると NaN を返し、histogram_fraction は NaN を除外します。NaN が結果に影響する場合は、info レベルの注釈で示されます。

    * [BUGFIX] PromQL: Improve handling of NaNs in native histograms. #16724
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • PromQL の期間式における単項マイナスの優先順位を修正
    影響対象promql-duration-expr を有効にした PromQL の期間式

    単項マイナスの後に別の演算子が続くと、foo offset -1^1 のような式が誤った優先順位で解析されることがありました。単項マイナスが先に期間に適用されるようになり、foo offset -1^1 は foo offset (-1^1) ではなく (foo offset -1) ^ 1 として解析されます。

    * [BUGFIX] PromQL: Fix unary operator precedence in duration expressions. #16713
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • Prometheus と OpenMetrics のテキストパーサーにおけるメモリー破損の修正
    影響対象Prometheus または OpenMetrics のテキスト形式を使用するスクレイプ(推定)

    パーサーのラベル処理で、パーサーバッファー内のデータへの参照が保持される可能性がありました。再現テストでは、スクレイプ中に TSDB ヘッドのコンパクションが重なった場合のデータ競合を確認します。

    * [BUGFIX] Scraping: Fix rare memory corruption bug. #16623
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • 指数型ネイティブヒストグラム後のNHCB変換再開
    影響対象ネイティブヒストグラムとNHCB変換対象のクラシックヒストグラムを含むProtobufスクレイプ(推定)

    以前は、指数型ネイティブヒストグラムが検出されると、その後に続く変換対象のクラシックヒストグラムがNHCBに変換されませんでした。今回の修正により、ラベルが指数型ネイティブヒストグラムと異なる場合は変換が再開されます。ラベルが一致する場合は、引き続き変換されません。

    * [BUGFIX] Scraping: continue handling custom-bucket histograms after an exponential histogram is encountered. #16720
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • サービスディスカバリー UI のターゲット数にサーバー側の合計値を使用
    影響対象keep_dropped_targets によって保持されるドロップターゲットの詳細数が制限されるサービスディスカバリー UI

    UIでは、ドロップされたターゲットの詳細がこれ以上表示されない場合に、その旨が示されます。

    * [ENHANCEMENT] UI: Better total target count display when using `keep_dropped_targets` option. #16604
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • WAL 読み込み前の Prometheus ルールファイル検証
    影響対象ルールファイルのパターンを設定している Prometheus 構成

    設定されたパターンが存在しないファイルに解決された場合や、ファイルに無効なルールが含まれていた場合、この起動段階では解析が行われず、systemd によるクラッシュ後の再起動ループにつながる可能性がありました。現在は早期チェックでこれらのケースについて起動エラーをログに記録し、終了ステータス 2 で終了します。

    * [ENHANCEMENT] Rules: Check that rules parse without error earlier at startup. #16601
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • TSDB WAL 初期化時の Prometheus のメモリー使用量を修正
    影響対象TSDB WAL を初期化して読み込む Prometheus 環境(推定)

    初期化と WAL の読み込み中、Prometheus が設定値または既定値の 75% を適用する前に、Go の既定値 GOGC 100% が有効になっていたため、メモリー使用量が増加していました。アップグレード後は、このフェーズでも設定された GOGC 値または既定値の 75% が使用されます。

    * [BUGFIX] Top-level: Update GOGC before loading TSDB. #16491
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • PromQL 集約式の位置修正と不正な式によるパニックの修正
    影響対象PromQL クエリの解析

    以前は、ParenExpr 内の集約式の終了位置が括弧で囲まれた式の末尾まで延びていたため、位置情報に基づく出力に余分なトークンが含まれていました。また、sum(rate( のような不正な式では、範囲外アクセスによるパニックが発生することがありました。終了位置は集約式の末尾で止まるようになり、不正な式もパニックを起こさずに処理されます。

    * [BUGFIX] PromQL: Fix reported parser position range in errors for aggregations wrapped in ParenExpr #16041 #16754
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • ディスカバリーのロック順序によるデッドロックの修正
    影響対象Prometheus のサービスディスカバリー(推定)

    シャットダウン中に、Manager.ApplyConfig() と Manager.cleaner() が Provider.mu と Manager.targetsMtx を逆の順序で取得し、Prometheus がハングすることがありました。これらの処理でロックを一貫した順序で取得するようになり、このデッドロックの発生条件に対処しています。

    * [BUGFIX] Discovery: Avoid deadlocks by taking locks in consistent order. #16587
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • otlp: 未設定時の OTLP レシーバーのデフォルト適用
    影響対象otlp: ブロックのない OTLP レシーバー設定

    以前は otlp: ブロックを省略すると OTLP のデフォルト設定が適用されませんでしたが、現在は TranslationStrategy: UnderscoreEscapingWithSuffixes を含む DefaultOTLPConfig が使用されます。

    * [BUGFIX] OTLP: Default config not respected when `otlp:` block is unset. #16693
    github.com/prometheus/prometheus/releases/tag/v3.5.0

機能・改善12

  • PromQL の型アノテーションに対応した型・単位メタデータラベル

    利用条件 --enable-feature=type-and-unit-labels

    * [FEATURE] PromQL: Add experimental type and unit metadata labels, behind feature flag `type-and-unit-labels`. #16228 #16632 #16718 #16743
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • PromQL のサンプルタイムスタンプ関数の追加

    利用条件 experimental-promql-functions フィーチャーフラグの有効化

    * [FEATURE] PromQL: Add `ts_of_(min|max|last)_over_time`, behind feature flag `experimental-promql-functions`. #16722 #16733
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • クラシックヒストグラムの併用スクレイプに関するグローバル制御

    利用条件 グローバルの always_scrape_classic_histograms オプションが有効

    * [FEATURE] Scraping: Add global option `always_scrape_classic_histograms` to scrape a classic histogram even if it is also exposed as native. #16452
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • OTLP リソース属性の昇格オプション追加

    利用条件 otlp.promote_all_resource_attributes: true の設定による全リソース属性の昇格。ignore_resource_attributes はこの設定時のみ指定可能で、promote_resource_attributes との併用不可。

    * [FEATURE] OTLP: New config options `promote_all_resource_attributes` and `ignore_resource_attributes`. #16426
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • STACKIT Cloud サービスディスカバリー
    * [FEATURE] Discovery: New service discovery for STACKIT Cloud. #16401
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • Hetzner ディスカバリーにおける label_selector によるサーバーフィルタリング

    利用条件 role=hcloud。label_selector の利用はこのロールに限定

    * [ENHANCEMENT] Hetzner SD: Add `label_selector` to filter servers. #16512
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • /rules ページでルールを状態・名前・ラベルで絞り込み
    * [ENHANCEMENT] UI: Add simple filtering on the `/rules` page. #16605
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • テーブルクエリータブでのクエリ統計情報

    利用条件 テーブルクエリーリクエストで stats: "true" を指定

    * [ENHANCEMENT] UI: Display query stats in hover tooltip over table query tab. #16723
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • promtool test rules での任意のあいまい浮動小数点比較

    利用条件 --fuzzy-compare または fuzzy_compare: true

    * [ENHANCEMENT] Promtool: Optional fuzzy float64 comparison in rules unittests. #16395
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • チャンク書き込み向けの実験的な非キャッシュ I/O

    利用条件 --enable-feature=use-uncached-io の有効化。実験的機能で、Linux でのみ利用可能

    * [PERF] TSDB: Optionally use Direct IO for chunks writing. #15365
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • グラフビューでのクエリ警告と情報の表示
    * [BUGFIX] UI: Add query warnings and info to graph view. #16753 #16759
    github.com/prometheus/prometheus/releases/tag/v3.5.0
  • Azure AD remote-write での既定のマネージド ID のサポート

    利用条件 managed_identity を設定し、client_id を空欄にした Azure AD remote-write 認証

    * [BUGFIX] Remote-write: For Azure AD auth, allow empty `client_id` to suppport system assigned managed identity. #16421
    github.com/prometheus/prometheus/releases/tag/v3.5.0
その他の変更9

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。