# OpenCost v1.119.0

2025-12-18 · [Original release notes](https://github.com/opencost/opencost/releases/tag/v1.119.0) · [Full summary](https://ratatosk.io/en/releases/opencost/v1.119.0)

Security 2 · Breaking changes 7 · Important fixes 13 · Enhancements 28 · Dependency updates 3 · Other changes 37

## Security (2)

### OpenCost TLS minimum raised to TLS 1.2

- Affects: OpenCost TLS connections to the Kubelet API, Prometheus, or storage backends

Previously, these connections could negotiate TLS 1.0 or 1.1 because no minimum was set. They now require TLS 1.2 or later, so peers that support only TLS 1.0 or 1.1 cannot connect.

> * 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 build image pinned to `golang:1.24-alpine3.20`

- Affects: builds using the OpenCost Dockerfile (Inferred)
- [CVE-2024-24790](https://www.cve.org/CVERecord?id=CVE-2024-24790), [CVE-2024-45337](https://www.cve.org/CVERecord?id=CVE-2024-45337)

Previously, the `golang:latest` build image included vulnerabilities and made builds unpredictable. The PR reports that the count across those findings fell from 13 to 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

## Breaking changes (7)

### Cloud Cost `Status` JSON key now uses `refreshRate`

- Affects: setups using Cloud Cost `Status` JSON or displaying integration refresh rates in the Kubecost UI

Previously, the `RefreshRate` key prevented the integration refresh rate from appearing in the Kubecost UI; with the new `refreshRate` key, it appears there.

Evidence: “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)

### Unreadable plugin configuration directories now return errors

- Affects: plugin discovery with a configured plugin directory

Previously, a failed directory read was logged and discovery continued with an empty plugin list; this could happen when the configured path did not exist or was a file rather than a directory. The returned error message is prefixed `failed to read plugin config directory`.

Evidence: “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 workflow now selects only `vX.Y.Z` tags

- Affects: SBOM workflow tag selection (Inferred)

Previously, tags beginning with `v` and a digit could be selected even if they lacked exactly three numeric version segments; those tags are no longer selected.

Evidence: “- 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 event-storage path now uses `collector`

- Affects: `collector` WAL event storage (Inferred)

Previously, the path was formatted using the event name `controller`.

Evidence: “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 server filter-parsing warnings use structured logging

- Affects: filter parsing in the MCP server

When filter strings or combined filters are malformed, warnings previously went to stdout through `fmt.Printf` without log levels. They now use structured warning-level logging, while malformed-filter handling continues without failing the request.

Evidence: “**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

### Cloud-cost and custom-cost environment getters now return `int`

- Affects: Go code that calls the affected cloud-cost or custom-cost environment getter functions (Inferred)

The getters previously returned `int64`; their configured environment values and shown defaults are unchanged, including 6 for cloud-cost refresh hours, 7 for the cloud-cost query window, and 1 for custom-cost query window hours.

Evidence: “+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 and UPDATE HTTP handlers removed

- Affects: setups or automation calling the config GET/UPDATE HTTP handlers

Evidence: “* 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

## Important fixes (13)

### Promless asset CPU and RAM pricing fallback fixed

- Affects: promless mode with custom pricing available

When collector asset pricing returned 0 or NaN—especially just after startup or while collector metrics were unavailable—allocations fell back to custom pricing but assets stayed at $0, producing negative idle costs. Idle costs are now positive or zero in that situation.

> * 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 billing partition-time filter logic corrected

- Affects: GCP BigQuery billing integrations using `ExcludePartitionTime` (Inferred)

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

### [Silent failure] GCP A100 GPU price mapping fixed

- Affects: GKE nodes in the GCP A2-Ultra (A100 80GB) and A2-HighGPU (A100 40GB) instance families

On A2-Ultra nodes labeled like `nvidia-a100-80gb`, SKU-derived names did not match GKE labels, so OpenCost fell back to default GPU pricing; the A2-HighGPU mapping was also affected. These families now receive their correctly mapped GPU prices.

> * 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 root-path directory listing fixed

- Affects: GCS storage with directory listings from the root path (`path=""`)

Before this release, root-path listings returned no entries because the filter discarded prefixes with an empty `attrs.Name`. They now return the GCS directory prefixes.

> * 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)

### Ownerless ReplicaSets now emit owner metrics

- Affects: Kubernetes ReplicaSets without owner references

For these ReplicaSets, `KubeReplicasetOwner` is emitted with `<none>` for the owner name and kind and a value of `0`.

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

### [Silent failure] `/allocation` idle-by-node breakdown fixed

- Affects: `/allocation` API requests with `includeIdle=true`

On clusters with multiple nodes, `idleByNode=true` was ignored, so requests returned one cluster-level idle allocation without `node` or `providerID` instead of a per-node breakdown. Now `idleByNode=true` returns separate idle allocations for each node, while `idleByNode=false` selects cluster-level idle allocations.

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

### Order-independent AND filters in v2 allocations

- Affects: v2 allocation filters using `+`

Previously, aggregation could merge or lose properties such as cluster before filtering, so namespace and cluster conditions could return different results depending on their order. Filters now match individual allocations before aggregation, and an allocation is included only when both conditions match.

> - 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 provider PV matching now handles uppercase `InstanceIDField` values

- Affects: CSV pricing for PVs with uppercase letters in `InstanceIDField`

Previously, the CSV value was lowercased but the PV's `ProviderID` was not, so uppercase letters could keep a PV from matching its pricing entry.

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

### Idle allocation `properties.providerID` now uses asset `ProviderID`

- Affects: setups querying idle allocations

Previously, `properties.providerID` held the Kubernetes node name, making idle costs impossible to reconcile with cloud-provider billing data. `properties.node` continues to hold the Kubernetes node name.

> - 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 node price selection corrected

- Affects: Azure node pricing through the Retail Prices API without Azure credentials

Spot-versus-on-demand selection could be wrong, and the on-demand heuristic could include low-priority or cloud services virtual machines, producing inaccurate Azure node prices. The selection is corrected, and the heuristic now excludes those virtual machines.

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

### Node stats client no longer skips nodes without `SpecProviderID`

- Affects: Kubernetes installations with nodes whose `SpecProviderID` is empty, including on-premises installations

Previously, the node stats client logged a warning and skipped a node when its `SpecProviderID` was empty.

> * 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 export continues with missing coverage data and failed dates

- Affects: CSV export

Previously, missing coverage results or an unavailable metric could cause “no data” or “querying oldest sample: no results,” while a failed allocation computation for any requested date aborted the export. It now uses a one-day range when coverage metrics are unavailable, skips dates whose allocation computation fails, and still returns `errNoData` if no allocation rows are exported.

> * 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)

### Graceful shutdown for the MCP HTTP server

- Affects: setups running the MCP HTTP server (Inferred)

During pod termination or restart, connections previously dropped abruptly and could corrupt in-flight queries. On context cancellation, existing requests can now complete before the server stops, with a 10-second timeout.

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

## Enhancements (28)

- Unicode identifiers and clearer errors in the filter lexer
- `Window` temporal overlap detection implemented
- Kubernetes version added to `ClusterInfo`
- OpenCost MCP server with allocation and asset cost tools (To use: Enabled by default; `MCP_SERVER_ENABLED` controls enablement.)
- Cloud Cost View table token metadata support
- Cloud cost properties gain slice-key generation and name splitting
- Kubernetes resource UIDs added to metric results and metrics
- Azure storage connection-string authorizer for custom URLs (To use: Configure `authorizerType` as `AzureStorageConnectionString` and provide `storageConnectionString`.)
- MCP `get_efficiency` workload analysis tool added
- Optional mutual TLS for the Prometheus backend (To use: Specify all three environment variables—`PROM_MTLS_AUTH_CA_FILE`, `PROM_MTLS_AUTH_CRT_FILE`, and `PROM_MTLS_AUTH_KEY_FILE`—together, and mount their respective files.)
- `config.ParseConfig()` exported for external callers
- CLI configuration flags for cost-model and agent settings (To use: `cost-model`: `--port`, `--kubernetes-enabled`, `--carbon-estimates-enabled`, `--cloud-cost-enabled`, and `--custom-cost-enabled`; `agent`: `--port`)
- Core MCP server structs and query types added
- New protobuf label-set messages and generic data decoders
- Optional partition-time filter exclusion for BigQuery queries (To use: Set `ExcludePartitionTime` to true in `BigQueryConfiguration` to omit the partition-time filter.)
- CPU and memory limit averages added to allocation results
- Kubernetes `ResourceQuota` support in cluster cache and export/import
- Summary allocations now use the RAM limit average
- OpenCost scrape job restored in Prometheus configuration
- ResourceQuota CPU and memory request and limit metrics added
- SBOM generation and attachment to GitHub releases (To use: Completion of “Build and Publish Release”; manual dispatch requires `release_version`.)
- Synchronous cloud-integration status checks
- KubeModel computation and `ResourceQuotas` export
- New container-limit and `ResourceQuota` metrics, plus cluster and namespace `info` metrics
- Namespace label filtering in allocation filters
- `ResourceQuota` filtering gains a parser and fields
- Kubeconfig adds the `GetClusterUID` helper
- Protobuf window conversion with `ConvertWindow`

## Dependency updates (3)

### Go 1.25.5 and other dependency updates

- [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)

The Go update is described as fixing a few CVEs. Other changes include updates to Azure SDK packages and `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 more, none mentioning security

- `* 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`

## Other changes (37)

- `ComputeCostData` refactored into private helpers and covered by unit tests
- `Window.Contains()` now includes the window end
- Expanded AWS Athena integration test coverage
- Initial `golangci-lint` workflow added
- golangci-lint version updated
- `AppVersion` added to `pkg/version`
- Cliff Colvin moved to the emeritus list in `MAINTAINERS.md`
- Dockerfile builds optimized with BuildKit cross-compilation
- Capitalized `Bearer` scheme in node-stat requests
- Missing Athena bucket logged at Debug for `ReservedInstanceData` and `SavingsPlanData` watchers
- Warwick Peatey added as a maintainer
- Clarity edits to `docs/modular-opencost.md`
- Grammar and formatting fixes in `spec/opencost-specv01.md`
- Oracle node pricing recognizes preemptible labels
- SBOM workflow switches to Trivy and attaches files to versioned releases
- bingen skips selected `KubeModelSet` fields and drops type directives
- `CLAUDE.md` for AI assistants working with the OpenCost codebase
- Image-building and testing workflows fixed
- Integration-testing workflow updated and tests fixed
- Protobuf validation fixed
- Integration-testing workflow skips `hold-on-failure` on `merge_group` events
- `ComputeCostData` refactored without behavior changes
- v2 OpenCost data-model protobuf schema and generated Go types
- Node pricing logs identify the default-pricing fallback
- AWS Athena pricing logic integration test coverage improved
- On-demand GitHub Actions workflow for `golangci-lint`
- GitHub Actions workflow updates `golangci-lint` to v2.5
- Dockerfile image builds optimized with BuildKit cross-compilation
- Modular OpenCost documentation clarified
- Grammar and formatting updates to OpenCost pricing definitions
- Expanded test coverage for the GCP cloud provider package
- Unused custom pricing fields and default handling removed
- Internal `kubemodel` package added
- AI assistant guide to the OpenCost codebase
- Merge-group events included in GitHub Actions permission checks
- Node stats tests updated
- Node stats request tests added

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
