# OpenCost v1.119.0

2025-12-18 · [릴리스 노트 원문](https://github.com/opencost/opencost/releases/tag/v1.119.0) · [전체 정리](https://ratatosk.io/ko/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`와 숫자로 시작하는 태그라면 숫자 버전 세그먼트가 정확히 세 개가 아니어도 선택될 수 있었습니다. 이제 그런 태그는 선택되지 않습니다.

근거: “- 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`를 통해 stdout으로 경고를 출력했습니다. 이제 구조화된 warning 레벨 로깅을 사용하며, 잘못된 필터를 처리해도 요청은 실패하지 않습니다.

근거: “**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`를 반환했지만, 이제 `int`를 반환합니다. 설정된 환경 변수 값과 표시되는 기본값은 그대로이며, 클라우드 비용 갱신 시간은 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 모드에서 커스텀 가격을 사용할 수 있는 경우

collector의 자산 가격이 0 또는 NaN으로 반환되면, 특히 시작 직후나 collector 메트릭을 사용할 수 없을 때 할당 비용은 커스텀 가격으로 폴백했지만 자산 비용은 $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에서 owner 메트릭 출력

- 영향 대상: 소유자 참조가 없는 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`가 없는 클러스터 수준의 유휴 할당 하나만 반환됐습니다. 이제 `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 할당의 순서와 무관한 AND 필터

- 영향 대상: `+`를 사용하는 v2 할당 필터

이전에는 필터링 전에 집계 과정에서 클러스터 같은 속성이 합쳐지거나 사라질 수 있어, 네임스페이스 조건과 클러스터 조건의 순서에 따라 결과가 달라질 수 있었습니다. 이제 개별 할당을 집계 전에 필터링하며, 두 조건을 모두 충족하는 할당만 포함합니다.

> - 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 매칭에서 `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`가 이제 asset `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로 Azure 노드 가격을 산정하는 경우

스팟과 온디맨드 중 어떤 가격을 선택할지 잘못 판단할 수 있었고, 온디맨드 휴리스틱에 저우선순위 가상 머신이나 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

### 노드 stats 클라이언트가 `SpecProviderID`가 없는 노드도 건너뛰지 않음

- 영향 대상: 노드의 `SpecProviderID`가 비어 있는 Kubernetes 설치. 온프레미스 설치 포함

이전에는 `SpecProviderID`가 비어 있으면 노드 stats 클라이언트가 경고를 로그에 남기고 해당 노드를 건너뛰었습니다.

> * 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 내보내기

이전에는 커버리지 결과가 없거나 메트릭을 사용할 수 없으면 “데이터 없음” 또는 “가장 오래된 샘플 조회: 결과 없음”이 발생할 수 있었고, 요청한 날짜 중 하나라도 allocation 계산에 실패하면 내보내기가 중단됐습니다. 이제 커버리지 메트릭을 사용할 수 없으면 하루 범위를 사용하고, allocation 계산에 실패한 날짜는 건너뜁니다. 내보낸 allocation 행이 하나도 없으면 여전히 `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 서버의 graceful shutdown

- 영향 대상: 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)

- 필터 렉서의 유니코드 식별자 지원 및 오류 개선
- `Window` 시간 중첩 감지 구현
- `ClusterInfo`에 Kubernetes 버전 추가
- 할당 및 자산 비용 도구를 제공하는 OpenCost MCP 서버 (사용 조건: 기본 활성화; `MCP_SERVER_ENABLED`로 활성화 여부 제어)
- Cloud Cost View 테이블 토큰 메타데이터 지원
- 클라우드 비용 속성의 슬라이스 키 생성 및 이름 분리
- 메트릭 결과 및 메트릭에 Kubernetes 리소스 UID 추가
- 사용자 지정 URL용 Azure 스토리지 연결 문자열 authorizer (사용 조건: `authorizerType`을 `AzureStorageConnectionString`으로 설정하고 `storageConnectionString`을 제공합니다.)
- MCP `get_efficiency` 워크로드 분석 도구 추가
- Prometheus 백엔드 선택적 상호 TLS (사용 조건: 세 환경 변수 `PROM_MTLS_AUTH_CA_FILE`, `PROM_MTLS_AUTH_CRT_FILE`, `PROM_MTLS_AUTH_KEY_FILE`을 모두 함께 지정하고 각 변수에 해당하는 파일 마운트)
- 외부 호출자를 위한 `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 및 메모리 limit 평균 추가
- 클러스터 캐시와 내보내기/가져오기의 Kubernetes `ResourceQuota` 지원
- 요약 할당에서 RAM 제한 평균값 사용
- Prometheus 설정에서 OpenCost 스크레이프 잡 복원
- ResourceQuota CPU 및 메모리 요청·제한 메트릭 추가
- SBOM 생성 및 GitHub 릴리스 첨부 (사용 조건: “Build and Publish Release” 완료; 수동 디스패치 시 `release_version` 필요)
- 동기식 클라우드 통합 상태 확인
- KubeModel 계산 및 `ResourceQuotas` 내보내기
- 새 컨테이너 제한 및 `ResourceQuota` 메트릭과 클러스터·네임스페이스 `info` 메트릭
- Allocation 필터의 네임스페이스 레이블 필터링
- 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` 워처의 Athena 버킷 누락 로그 수준 변경
- Warwick Peatey 메인테이너 추가
- `docs/modular-opencost.md` 문서 명확성 개선
- `spec/opencost-specv01.md`의 문법 및 서식 수정
- Oracle 노드 가격 산정 시 선점형 레이블 인식
- Trivy로 전환한 SBOM 워크플로와 버전별 릴리스 파일 첨부
- bingen이 일부 `KubeModelSet` 필드를 건너뛰고 타입 지시문 제거
- OpenCost 코드베이스에서 작업하는 AI 어시스턴트를 위한 `CLAUDE.md`
- 이미지 빌드 및 테스트 워크플로 수정
- 통합 테스트 워크플로 업데이트 및 테스트 수정
- Protobuf 검증 수정
- 통합 테스트 워크플로, `merge_group` 이벤트에서 `hold-on-failure` 건너뜀
- 동작 변경 없이 `ComputeCostData` 리팩터링
- v2 OpenCost 데이터 모델 프로토버프 스키마 및 생성된 Go 타입
- 노드 가격 로그에 기본 가격 폴백 표시
- AWS Athena 가격 산정 로직 통합 테스트 커버리지 개선
- 필요 시 실행하는 `golangci-lint`용 GitHub Actions 워크플로
- GitHub Actions 워크플로에서 `golangci-lint`를 v2.5로 업데이트
- BuildKit 크로스 컴파일을 통한 Dockerfile 이미지 빌드 최적화
- 모듈형 OpenCost 문서 명확화
- OpenCost 가격 정의의 문법 및 서식 업데이트
- GCP 클라우드 프로바이더 패키지 테스트 범위 확대
- 미사용 사용자 지정 가격 필드 및 기본값 처리 제거
- 내부 `kubemodel` 패키지 추가
- OpenCost 코드베이스용 AI 어시스턴트 가이드
- GitHub Actions 권한 검사에 merge-group 이벤트 포함
- 노드 통계 테스트 업데이트
- 노드 통계 요청 테스트 추가

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
