# Prometheus v3.5.0

2025-07-14 · [元のリリースノート](https://github.com/prometheus/prometheus/releases/tag/v3.5.0) · [全体のまとめ](https://ratatosk.io/ja/releases/prometheus/v3.5.0)

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

## セキュリティ (1)

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

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

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

> * [BUGFIX] API: Add HTTP `Vary: Origin` header to responses to avoid cache poisoning. #16008

## 破壊的変更 (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.” https://github.com/prometheus/prometheus/pull/16069

> * [PERF] Labels: Simpler/faster stringlabels encoding. #16069

## 重大な修正 (16)

### PromQL 範囲集約におけるスカラーパラメーターの変更への対応

- 影響対象: `quantile` や `topk` などの集約で、定数でないスカラーパラメーターを使用する PromQL 範囲クエリ

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

> * [ENHANCEMENT] PromQL: support non-constant parameter in aggregations like `quantile` and `topk`. #16404

### 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

### PromQL `last_over_time` のネイティブヒストグラム処理の修正

- 影響対象: ネイティブヒストグラムに対する `last_over_time` クエリ

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

> * [BUGFIX] PromQL: Fix native histogram `last_over_time`. #16744

### 入力が競合する場合に結果を返さない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

### PromQL の duration 丸め処理の修正

- 影響対象: オフセット、範囲セレクター、サブクエリの範囲またはステップにおける PromQL の数値 duration

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

> * [BUGFIX] PromQL: Incorrect rounding of `[1001ms]` to `[1s]` and similar. #16478

### ヒストグラムクエリにおける 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

### 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

### 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

### Prometheus と OpenMetrics のテキストパーサーにおけるメモリー破損の修正

- 影響対象: Prometheus または OpenMetrics のテキスト形式を使用するスクレイプ (推定)

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

> * [BUGFIX] Scraping: Fix rare memory corruption bug. #16623

### 指数型ネイティブヒストグラム後のNHCB変換再開

- 影響対象: ネイティブヒストグラムとNHCB変換対象のクラシックヒストグラムを含むProtobufスクレイプ (推定)

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

> * [BUGFIX] Scraping: continue handling custom-bucket histograms after an exponential histogram is encountered. #16720

### サービスディスカバリー UI のターゲット数にサーバー側の合計値を使用

- 影響対象: `keep_dropped_targets` によって保持されるドロップターゲットの詳細数が制限されるサービスディスカバリー UI

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

> * [ENHANCEMENT] UI: Better total target count display when using `keep_dropped_targets` option. #16604

### WAL 読み込み前の Prometheus ルールファイル検証

- 影響対象: ルールファイルのパターンを設定している Prometheus 構成

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

> * [ENHANCEMENT] Rules: Check that rules parse without error earlier at startup. #16601

### TSDB WAL 初期化時の Prometheus のメモリー使用量を修正

- 影響対象: TSDB WAL を初期化して読み込む Prometheus 環境 (推定)

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

> * [BUGFIX] Top-level: Update GOGC before loading TSDB. #16491

### PromQL 集約式の位置修正と不正な式によるパニックの修正

- 影響対象: PromQL クエリの解析

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

> * [BUGFIX] PromQL: Fix reported parser position range in errors for aggregations wrapped in ParenExpr #16041 #16754

### ディスカバリーのロック順序によるデッドロックの修正

- 影響対象: Prometheus のサービスディスカバリー (推定)

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

> * [BUGFIX] Discovery: Avoid deadlocks by taking locks in consistent order. #16587

### `otlp:` 未設定時の OTLP レシーバーのデフォルト適用

- 影響対象: `otlp:` ブロックのない OTLP レシーバー設定

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

> * [BUGFIX] OTLP: Default config not respected when `otlp:` block is unset. #16693

## 機能・改善 (12)

- PromQL の型アノテーションに対応した型・単位メタデータラベル (利用条件: `--enable-feature=type-and-unit-labels`)
- PromQL のサンプルタイムスタンプ関数の追加 (利用条件: `experimental-promql-functions` フィーチャーフラグの有効化)
- クラシックヒストグラムの併用スクレイプに関するグローバル制御 (利用条件: グローバルの `always_scrape_classic_histograms` オプションが有効)
- OTLP リソース属性の昇格オプション追加 (利用条件: `otlp.promote_all_resource_attributes: true` の設定による全リソース属性の昇格。`ignore_resource_attributes` はこの設定時のみ指定可能で、`promote_resource_attributes` との併用不可。)
- STACKIT Cloud サービスディスカバリー
- Hetzner ディスカバリーにおける `label_selector` によるサーバーフィルタリング (利用条件: `role=hcloud`。`label_selector` の利用はこのロールに限定)
- `/rules` ページでルールを状態・名前・ラベルで絞り込み
- テーブルクエリータブでのクエリ統計情報 (利用条件: テーブルクエリーリクエストで `stats: "true"` を指定)
- `promtool test rules` での任意のあいまい浮動小数点比較 (利用条件: `--fuzzy-compare` または `fuzzy_compare: true`)
- チャンク書き込み向けの実験的な非キャッシュ I/O (利用条件: `--enable-feature=use-uncached-io` の有効化。実験的機能で、Linux でのみ利用可能)
- グラフビューでのクエリ警告と情報の表示
- Azure AD remote-write での既定のマネージド ID のサポート (利用条件: `managed_identity` を設定し、`client_id` を空欄にした Azure AD remote-write 認証)

## その他の変更 (9)

- 検索時にスクレイププール選択欄の入力内容を消去
- `histogramStatsIterator` の再利用による PromQL のアロケーション削減
- PromQL でネイティブヒストグラムのカスタムバケット用ストレージを再利用
- `/targets` ページでの不要な再レンダリングの削減
- ステータスメニューからのページ全体の再レンダリングを修正
- Kubernetes EndpointSlice ディスカバリーで service `cache.Indexer` を使用
- TSDBのラベル値取得が指定上限で停止
- 設定適用中のスクレイププール再読み込みの並行化
- PromQL の平均計算を Kahan 加算による平均値と範囲フォールバックに切り替え

---

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