# OpenTelemetry v0.149.0

2026-03-31 · [릴리스 노트 원문](https://github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.149.0) · [전체 정리](https://ratatosk.io/ko/releases/opentelemetry/v0.149.0)

호환성 변경 1 · 중요 수정 2 · 기능·개선 2 · 기타 2

## 호환성 변경 (1)

### `pkg/service`의 내부 메트릭에서 서비스 아이덴티티 라벨 제거

- 영향 대상: 내부 Collector 메트릭

이전에는 모든 내부 메트릭 시계열에 `service_name`, `service_instance_id`, `service_version` 라벨이 포함됐습니다. 이제 이 라벨은 `target_info`에만 나타나므로, 개별 메트릭을 이 라벨로 필터링하거나 그룹화하는 쿼리에는 `target_info` 조인이 필요합니다.

> - `pkg/service`: Remove `service_name`, `service_instance_id`, and `service_version` as constant labels on every internal metric datapoint. These attributes are already present in `target_info` and were being duplicated on each series for OpenCensus backwards compatibility. (#14811)
>   Previously, the collector stamped every internal metric series (e.g. `otelcol_process_runtime_heap_alloc_bytes`)
>   with `service_name`, `service_instance_id`, and `service_version` labels to match the old OpenCensus behavior.
>   These attributes are now only present in the `target_info` metric, which is the correct Prometheus/OTel convention.
>   Users who filter or group by these labels on individual metrics will need to update their queries to use
>   `target_info` joins instead.

## 중요 수정 (2)

### 엔티티 코드 생성 시 `extra_attributes`를 리소스에 배치

- 영향 대상: 엔티티 메타데이터에서 `extra_attributes`를 사용해 `cmd/mdatagen`으로 생성한 엔티티 코드 (추정)

이전에는 `cmd/mdatagen`이 엔티티 코드를 생성할 때 `k8s.namespace.name`, `k8s.node.name` 같은 어트리뷰트를 리소스가 아닌 엔티티 설명 어트리뷰트로 추가했습니다.

> - `cmd/mdatagen`: Fix entity code generation so `extra_attributes` are emitted as resource attributes instead of entity descriptive attributes. (#14778)

### `cmd/mdatagen`의 `RootPackage`에 Go 모듈 루트 적용

- 영향 대상: Go 모듈 루트가 Git 저장소 루트와 다른 환경에서 `cmd/mdatagen`을 실행하는 설정

v0.148.0부터 `cmd/mdatagen`은 `helpers.RootPackage`를 사용해 import 루트를 확인했으며, 이 설정에서 실행하면 불일치의 영향을 받을 수 있습니다.

> ### 🧰 Bug fixes 🧰
> - `cmd/mdatagen`: Fix RootPackage to use go module root instead of git repo root (#14801)
>   Fixes issue with running mdatagen when the git repository root is different from the go module root.

## 기능·개선 (2)

- `cmd/mdatagen`의 SemConv 어트리뷰트 참조
- mdatagen 설정 Go 구조체용 필수 필드 검증 코드 생성

## 기타 (2)

- aix/ppc64 tier 3 지원으로 전환
- Profiles 안정성 수준을 alpha로 상향

---

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