# OpenCost v1.119.0

2025-12-18 · [元のリリースノート](https://github.com/opencost/opencost/releases/tag/v1.119.0) · [全体のまとめ](https://ratatosk.io/ja/releases/opencost/v1.119.0)

セキュリティ 2 · 破壊的変更 7 · 重大な修正 13 · 機能・改善 28 · 依存関係の更新 3 · その他の変更 37

## セキュリティ (2)

### OpenCost の TLS 最小バージョンを TLS 1.2 に引き上げ

- 影響対象: OpenCost から Kubelet API、Prometheus、またはストレージバックエンドへの TLS 接続

従来は最小バージョンが設定されていなかったため、これらの接続では TLS 1.0 または 1.1 でネゴシエーションできました。現在は TLS 1.2 以降が必須となり、TLS 1.0 または 1.1 のみをサポートするピアは接続できません。

> * Enforce secure TLS MinVersion across all configurations by @fromsaurav in https://github.com/opencost/opencost/pull/3309
> - 3690a9047f0e Enforce secure TLS MinVersion across all configurations (#3309) (Saurav Teli)

### Dockerfile のビルドイメージを `golang:1.24-alpine3.20` に固定

- 影響対象: OpenCost の Dockerfile を使用するビルド (推定)
- [CVE-2024-24790](https://www.cve.org/CVERecord?id=CVE-2024-24790), [CVE-2024-45337](https://www.cve.org/CVERecord?id=CVE-2024-45337)

以前は、ビルドイメージに `golang:latest` を使用していたため、脆弱性が含まれ、ビルドの結果が予測しにくくなっていました。PR では、該当する指摘の件数が13件から2件に減少したと報告されています。

> - 07832d1baa92 security: update to Go 1.24-alpine3.20 to fix critical vulnerabilities (#3367) (Brian Olson)
> * security: update to Go 1.24-alpine3.20 to fix critical vulnerabilities by @brian-olson in https://github.com/opencost/opencost/pull/3367

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

## 破壊的変更 (7)

### Cloud Cost `Status` JSONキーを `refreshRate` に変更

- 影響対象: Cloud Cost `Status` JSONを使用する、またはKubecost UIにインテグレーションの更新間隔を表示する環境

以前は `RefreshRate` キーが原因で、インテグレーションの更新間隔がKubecost UIに表示されませんでした。新しい `refreshRate` キーでは表示されます。

根拠: “Updates the JSON casing on the Cloud Cost `Status` type, which will allow the refresh rate to show up in the Kubecost UI.” https://github.com/opencost/opencost/pull/3462

> * Fix JSON Casing by @nik-kc in https://github.com/opencost/opencost/pull/3462
> - e5e045db8607 Fix JSON Casing (#3462) (nik-kc)

### 読み取り不能なプラグイン設定ディレクトリでエラーを返すように

- 影響対象: プラグインディレクトリを設定したプラグイン検出

以前は、ディレクトリの読み取りに失敗してもログに記録するだけで、空のプラグインリストを使って検出を続行していました。設定したパスが存在しない場合や、ディレクトリではなくファイルの場合に、この状況が発生することがありました。返されるエラーメッセージには、`failed to read plugin config directory` が先頭に付加されます。

根拠: “return nil, fmt.Errorf("failed to read plugin config directory: %w", err)” https://github.com/opencost/opencost/pull/3491

> * fix(plugins): Return error when plugin config directory is unreadable by @vtushar06 in https://github.com/opencost/opencost/pull/3491
> - 55c7f42a8b8d fix(plugins): Return error when plugin config directory is unreadable (#3491) (Tushar-Verma)

### SBOM ワークフローで `vX.Y.Z` タグのみを選択

- 影響対象: SBOM ワークフローのタグ選択 (推定)

以前は、`v` の後に数字が続くタグであれば、数値のバージョンセグメントがちょうど3つでなくても選択される場合がありましたが、今後は選択されません。

根拠: “- TAG=$(git tag --points-at $SHA | grep '^v[0-9]' | head -1)” https://github.com/opencost/opencost/pull/3509

> * use major minor path version for SBOM by @ameijer in https://github.com/opencost/opencost/pull/3509
> - db5391182d39 use major minor path version for SBOM (#3509) (Alex Meijer)

### WALイベントストレージのパスで`collector`を使用

- 影響対象: `collector` の WAL イベントストレージ (推定)

以前は、イベント名 `controller` を使ってパスを組み立てていました。

根拠: “pathFormatter, err := pathing.NewEventStoragePathFormatter(applicationName, clusterID, CollectorEventName)” https://github.com/opencost/opencost/pull/3376

> - 55d1f7a28d9e Sth/kcm 4452 (#3376) (Sean Holcomb)

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### MCP サーバーのフィルター解析警告に構造化ログを使用

- 影響対象: MCP サーバーでのフィルター解析

フィルター文字列または結合フィルターの形式が不正な場合、以前はログレベルのない `fmt.Printf` を使って警告を標準出力に出していました。現在は構造化された警告レベルのログを使用します。不正なフィルターの処理は引き続き行われ、リクエストは失敗しません。

根拠: “**After**: Warning messages use structured logging with appropriate log levels and formatting” https://github.com/opencost/opencost/pull/3488

> - 095b293a7657 Refactor logging to use structured logging for filter parsing errors (#3488) (Tushar-Verma)
> * Refactor logging to use structured logging for filter parsing errors by @vtushar06 in https://github.com/opencost/opencost/pull/3488

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### クラウドコストとカスタムコストの環境変数 getter が `int` を返すように変更

- 影響対象: 対象となるクラウドコストまたはカスタムコストの環境変数 getter 関数を呼び出す Go コード (推定)

以前、これらの getter 関数は `int64` を返していました。環境変数で設定する値と記載されているデフォルト値は変わらず、クラウドコストの更新間隔は6時間、クラウドコストのクエリ期間は7、カスタムコストのクエリ期間は1時間です。

根拠: “+func GetCloudCostRefreshRateHours() int {” https://github.com/opencost/opencost/pull/3376

> - 55d1f7a28d9e Sth/kcm 4452 (#3376) (Sean Holcomb)

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### Config GET/UPDATE HTTP ハンドラーの削除

- 影響対象: config GET/UPDATE HTTP ハンドラーを呼び出すセットアップまたは自動化

根拠: “* Deletes unused HTTP handlers to GET/UPDATE configs” https://github.com/opencost/opencost/pull/3470

> - 5c929fb08308 Remove unused configs (#3470) (Thomas Nguyen)

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

## 重大な修正 (13)

### Promless のアセット CPU・RAM 価格フォールバックの修正

- 影響対象: カスタム価格設定が利用可能な Promless モード

コレクターのアセット価格が 0 または NaN を返した場合、特に起動直後やコレクターのメトリクスを取得できない間は、アロケーションの価格はカスタム価格にフォールバックする一方、アセットの価格は $0 のままとなり、アイドルコストがマイナスになっていました。この状況でのアイドルコストは、現在は正の値または 0 になります。

> * fix: Negative idle cost on promless mode by @spa-raj in https://github.com/opencost/opencost/pull/3393
> - 9bf926c15c1b fix: Negative idle cost on promless mode (#3393) (Sparsh Raj)

### GCP BigQuery 請求のパーティション時刻フィルター処理の修正

- 影響対象: `ExcludePartitionTime` を使用する GCP BigQuery 請求連携 (推定)

> * feat: increase test coverage for pkg/cloud/gcp by @Jetshree in https://github.com/opencost/opencost/pull/3329

### [表面化しなかった不具合] GCP A100 GPU 価格マッピングの修正

- 影響対象: GCP A2-Ultra（A100 80GB）および A2-HighGPU（A100 40GB）インスタンスファミリーの GKE ノード

`nvidia-a100-80gb` のようなラベルが付いた A2-Ultra ノードでは、SKU 由来の名前が GKE のラベルと一致せず、OpenCost はデフォルトの GPU 価格にフォールバックしていました。A2-HighGPU のマッピングも影響を受けていました。現在は、これらのファミリーに正しくマッピングされた GPU 価格が適用されます。

> * Fix GCP GPU mapping for A100 40GB/80GB (A2-HighGPU & A2-Ultra) instances by @mohamedosama113 in https://github.com/opencost/opencost/pull/3446
> - 1798f562af55 Fix GCP GPU mapping for A100 40GB/80GB (A2-HighGPU & A2-Ultra) instances (#3446) (mohamedosama113)

### GCS のルートパスでのディレクトリー一覧表示の修正

- 影響対象: ルートパス（`path=""`）からディレクトリー一覧を取得する GCS ストレージ

このリリース以前は、`attrs.Name` が空のプレフィックスがフィルターで除外されるため、ルートパスからの一覧取得でエントリーが返されませんでした。現在は GCS のディレクトリープレフィックスが返されます。

> * Fix listing directories in root path(empty string path) by @mittal-ishaan in https://github.com/opencost/opencost/pull/3499
> - 2c004e2ef433 Fix listing directories in root path(empty string path) (#3499) (Ishaan Mittal)

### オーナー参照のない ReplicaSet でオーナーメトリクスを出力

- 影響対象: オーナー参照のない Kubernetes ReplicaSet

これらの ReplicaSet では、所有者名と種類に `<none>` を設定し、値を `0` とした `KubeReplicasetOwner` が出力されます。

> - 7de9e7f49d01 Write Unowned ReplicaSet Owner as <none> (#3380) (Matt Bolt)
> * Write Unowned ReplicaSet Owner as <none> by @mbolt35 in https://github.com/opencost/opencost/pull/3380

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### [表面化しなかった不具合] `/allocation` のノード別アイドル内訳の修正

- 影響対象: `includeIdle=true` を指定した `/allocation` API リクエスト

複数ノードのクラスターでは、`idleByNode=true` が無視され、ノードごとの内訳ではなく、`node` や `providerID` を含まないクラスター単位のアイドル割り当てが1件返されていました。現在は、`idleByNode=true` を指定するとノードごとに個別のアイドル割り当てが返され、`idleByNode=false` を指定するとクラスター単位のアイドル割り当てが選択されます。

> - 2d29127dcb05 Fix idleByNode parameter ignored in allocation API (#3402) (Robert Kessler)
> * Fix idleByNode parameter ignored in allocation API by @rbtkess in https://github.com/opencost/opencost/pull/3402

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### v2 Allocation の順序に依存しない AND フィルター

- 影響対象: `+` を使う v2 の Allocation フィルター

従来は、フィルタリング前に集計処理で `cluster` などのプロパティが統合または失われることがあり、namespace と cluster の条件は指定順序によって異なる結果を返す場合がありました。現在は集計前に個々の Allocation に対してフィルターが適用され、両方の条件に一致した Allocation のみが含まれます。

> - 38281b6b227d fix: Apply allocation filters before aggregation to ensure AND operator order independence (#3394) (Sparsh Raj)
> * fix: Apply allocation filters before aggregation to ensure AND operator order independence by @spa-raj in https://github.com/opencost/opencost/pull/3394

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### CSV プロバイダーによる PV の照合で `InstanceIDField` の大文字に対応

- 影響対象: `InstanceIDField` に大文字を含む PV の CSV 料金設定

以前は CSV の値だけが小文字化され、PV の `ProviderID` は小文字化されていなかったため、大文字が含まれていると PV が対応する料金エントリーと一致しないことがありました。

> - 5beea6ca53da fix(csvprovider): convert ProviderID to lowercase for pv (#3361) (Salwa Mohamed)
> * fix(csvprovider): convert ProviderID to lowercase for pv by @jumana-s in https://github.com/opencost/opencost/pull/3361

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### アイドルアロケーションの `properties.providerID` がアセットの `ProviderID` を使用

- 影響対象: アイドルアロケーションを照会する環境

以前は `properties.providerID` に Kubernetes ノード名が格納されていたため、アイドルコストをクラウドプロバイダーの課金データと突合できませんでした。`properties.node` には引き続き Kubernetes ノード名が格納されます。

> - e7eb25b169c8 Fix providerID set to node name in idle allocations (#3403) (Robert Kessler)
> * Fix providerID set to node name in idle allocations by @rbtkess in https://github.com/opencost/opencost/pull/3403

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### Azure Retail Prices API におけるノード価格選択の修正

- 影響対象: Azure の資格情報を使わずに Retail Prices API でノード価格を算出する場合

スポットとオンデマンドの選択が誤ることがあり、オンデマンドの判定ロジックに低優先度または Cloud Services の仮想マシンが含まれて、Azure のノード価格が不正確になる可能性がありました。選択ロジックを修正し、判定ロジックでこれらの仮想マシンを除外するようになりました。

> - 7d41c8915332 Improve heuristics to get Azure node prices from Retail Prices API (#3230) (João Pimentel)
> * Improve heuristics to get Azure node prices from Retail Prices API by @joao-pimentel-randoli in https://github.com/opencost/opencost/pull/3230

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

### `SpecProviderID` が空のノードをスキップしなくなったノード統計クライアント

- 影響対象: `SpecProviderID` が空のノードを含む Kubernetes 環境（オンプレミス環境を含む）

以前は、ノードの `SpecProviderID` が空の場合、ノード統計クライアントは警告をログに記録して、そのノードをスキップしていました。

> * Remove requirement for SpecProviderID for node stats by @mbolt35 in https://github.com/opencost/opencost/pull/3418
> - 503c0cdea187 Remove requirement for SpecProviderID for node stats (#3418) (Matt Bolt)
> - core/pkg/nodestats/nodestats.go (+0 -5)

### カバレッジデータ不足や計算失敗日があっても継続するCSVエクスポート

- 影響対象: CSV エクスポート

これまでは、カバレッジ結果がない場合やメトリクスを取得できない場合に「no data」または「querying oldest sample: no results」となり、要求した日付のいずれかで割り当て計算に失敗するとエクスポート全体が中断されていました。今後は、カバレッジメトリクスを取得できない場合は1日間の範囲を使用し、割り当て計算に失敗した日付をスキップします。エクスポートされた割り当て行がない場合は、引き続き `errNoData` を返します。

> * Fix: CSV export data query failures with missing metrics by @fromsaurav in https://github.com/opencost/opencost/pull/3284
> - 7048a93b0491 Fix: CSV export data query failures with missing metrics (#3284) (Saurav Teli)

### MCP HTTP サーバーのグレースフルシャットダウン

- 影響対象: MCP HTTP サーバーを実行する構成 (推定)

Pod の終了時や再起動時に接続が突然切断され、処理中のクエリが破損することがありました。コンテキストのキャンセル時に、サーバーの停止前に既存のリクエストが完了するようになりました。タイムアウトは 10 秒です。

> - 296dd00b374d fix(mcp): Implement graceful shutdown for MCP HTTP server (#3494) (Tushar-Verma)
> * fix(mcp): Implement graceful shutdown for MCP HTTP server by @vtushar06 in https://github.com/opencost/opencost/pull/3494

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

## 機能・改善 (28)

- Unicode 識別子とエラー表示の明確化
- `Window` の時間的な重複判定の実装
- `ClusterInfo` に Kubernetes バージョンを追加
- 割り当て・アセットコストツールを備えた OpenCost MCP サーバー (利用条件: デフォルトで有効。`MCP_SERVER_ENABLED` で有効化を制御)
- Cloud Cost View テーブルのトークンメタデータ対応
- Cloud cost properties のキー生成と名前分割
- Kubernetes リソースの UID をメトリクス結果とメトリクスに追加
- Azure ストレージのカスタム URL 向け接続文字列オーソライザー (利用条件: `authorizerType` を `AzureStorageConnectionString` に設定し、`storageConnectionString` を指定する構成)
- MCP `get_efficiency` ワークロード分析ツールの追加
- Prometheus バックエンドのオプションの相互 TLS (利用条件: 環境変数 `PROM_MTLS_AUTH_CA_FILE`、`PROM_MTLS_AUTH_CRT_FILE`、`PROM_MTLS_AUTH_KEY_FILE` の3つすべてをまとめて指定し、それぞれに対応するファイルをマウント)
- `config.ParseConfig()` の外部呼び出し元への公開
- cost-model と agent の設定用 CLI フラグ (利用条件: `cost-model`: `--port`、`--kubernetes-enabled`、`--carbon-estimates-enabled`、`--cloud-cost-enabled`、`--custom-cost-enabled`; `agent`: `--port`)
- コア MCP サーバーの構造体とクエリ型の追加
- 新しい protobuf ラベルセットメッセージと汎用データデコーダー
- BigQuery クエリでのパーティション時刻フィルターの任意除外 (利用条件: パーティション時刻フィルターを省略するための、`BigQueryConfiguration` における `ExcludePartitionTime` の true 設定)
- CPU・メモリー上限の平均値を Allocation 結果に追加
- クラスターキャッシュとエクスポート／インポートでの Kubernetes `ResourceQuota` 対応
- サマリーアロケーションでRAM上限平均値を使用
- Prometheus 設定での OpenCost スクレイプジョブの復元
- ResourceQuota の CPU・メモリーのリクエストおよび上限メトリクスの追加
- SBOM の生成と GitHub リリースへの添付 (利用条件: 「Build and Publish Release」の完了。手動実行では `release_version` が必要)
- 同期的なクラウド連携のステータス確認
- KubeModel の計算と `ResourceQuotas` のエクスポート
- コンテナー上限・`ResourceQuota` メトリクスとクラスター・名前空間の `info` メトリクスの追加
- アロケーションフィルターでの Namespace ラベルによる絞り込み
- `ResourceQuota` フィルタリングのパーサーとフィールドの追加
- Kubeconfig に `GetClusterUID` ヘルパーを追加
- `ConvertWindow` による Protobuf ウィンドウ変換

## 依存関係の更新 (3)

### Go 1.25.5 とその他の依存関係の更新

- [GO-2025-4006](https://osv.dev/vulnerability/GO-2025-4006), [GO-2025-4007](https://osv.dev/vulnerability/GO-2025-4007), [GO-2025-4008](https://osv.dev/vulnerability/GO-2025-4008), [GO-2025-4009](https://osv.dev/vulnerability/GO-2025-4009), [GO-2025-4010](https://osv.dev/vulnerability/GO-2025-4010), [GO-2025-4011](https://osv.dev/vulnerability/GO-2025-4011), [GO-2025-4012](https://osv.dev/vulnerability/GO-2025-4012), [GO-2025-4013](https://osv.dev/vulnerability/GO-2025-4013), [GO-2025-4014](https://osv.dev/vulnerability/GO-2025-4014), [GO-2025-4015](https://osv.dev/vulnerability/GO-2025-4015), [GO-2025-4155](https://osv.dev/vulnerability/GO-2025-4155), [GO-2025-4175](https://osv.dev/vulnerability/GO-2025-4175)

Go の更新では、いくつかの CVE が修正されると説明されています。その他の変更には、Azure SDK パッケージと `github.com/aws/aws-sdk-go-v2` の更新が含まれます。

> - 8be8620c63aa bump dependabot dependencies (#3506) (Ishaan Mittal)
> * bump dependabot dependencies by @mittal-ishaan in https://github.com/opencost/opencost/pull/3506

https://github.com/opencost/opencost/compare/v1.117.4...v1.119.0

ほか2件（いずれもセキュリティへの言及なし）

- `* bump dependencies by @mittal-ishaan in https://github.com/opencost/opencost/pull/3382`
- `* use 3.22 by @ameijer in https://github.com/opencost/opencost/pull/3490`

## その他の変更 (37)

- `ComputeCostData` の非公開ヘルパーへのリファクタリングと単体テスト
- ウィンドウ終端を含む `Window.Contains()`
- AWS Athena 統合テストのカバレッジ拡充
- 初期の `golangci-lint` ワークフローの追加
- golangci-lint のバージョン更新
- `pkg/version` に `AppVersion` を追加
- Cliff Colvin の `MAINTAINERS.md` における名誉メンテナー一覧への移動
- BuildKit のクロスコンパイルによる Dockerfile ビルドの最適化
- node-stat リクエストでの大文字表記 `Bearer` スキーム
- `ReservedInstanceData` と `SavingsPlanData` の watcher における Athena バケット未設定ログの変更
- Warwick Peatey のメンテナーへの追加
- `docs/modular-opencost.md` の記述を明確化する編集
- `spec/opencost-specv01.md` の文法と書式の修正
- Oracle ノードの価格設定でプリエンプティブルラベルを認識
- SBOM ワークフローの Trivy への切り替えとバージョン付きリリースへのファイル添付
- bingen による `KubeModelSet` の一部フィールドのスキップと型ディレクティブの削除
- OpenCost コードベースを扱う AI アシスタント向けの `CLAUDE.md`
- イメージ構築とテストのワークフロー修正
- 統合テスト用ワークフローの更新とテストの修正
- Protobuf の検証を修正
- 統合テストワークフローでの `merge_group` イベント時における `hold-on-failure` のスキップ
- 動作変更を伴わない `ComputeCostData` のリファクタリング
- v2 OpenCost データモデルの protobuf スキーマと生成 Go 型
- ノード価格ログでデフォルト価格へのフォールバックを識別
- AWS Athena の価格計算ロジックに関する統合テストのカバレッジ改善
- `golangci-lint` 用のオンデマンド GitHub Actions ワークフロー
- GitHub Actions ワークフローで `golangci-lint` を v2.5 に更新
- BuildKit のクロスコンパイルによる Dockerfile イメージビルドの最適化
- モジュール型 OpenCost のドキュメントの明確化
- OpenCost の価格定義における文法と書式の更新
- GCP クラウドプロバイダーパッケージのテストカバレッジ拡充
- 未使用のカスタム料金フィールドとデフォルト処理の削除
- 内部 `kubemodel` パッケージの追加
- OpenCost コードベースの AI アシスタント向けガイド
- GitHub Actions の権限チェック対象にマージグループイベントを追加
- ノード統計テストの更新
- ノード統計リクエストテストの追加

---

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