# OpenTelemetry v0.146.0

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

보안 1 · 호환성 변경 3 · 폐기 예정 1 · 중요 수정 3 · 기능·개선 7 · 기타 3

## 업그레이드 전 확인

### 알려진 문제

- **커스텀 SDK용 Builder `telemetry` 필드**
  >   intend to provide your own OpenTelemetry SDK.

## 보안 (1)

### Confighttp가 서버 span 이름에서 요청 메서드 카디널리티를 제한

- 영향 대상: `pkg/config/confighttp`에서 발생하는 서버 내부 텔레메트리

이전에는 `FOOBAR` 같은 원시 메서드가 span 이름에 포함되어 카디널리티가 높아질 수 있었습니다.

> - `pkg/config/confighttp`: Fix high cardinality span name from request method from confighttp server internal telemetry (#14516)
>   Follow spec to bound request method cardinality.

## 호환성 변경 (3)

### 빌드에 필요한 최소 Go 버전 1.25로 상향

- 영향 대상: Go 1.25보다 이전 버전을 사용하는 Collector 빌드 (추정)
- 필요 조치: 프로젝트 빌드에 Go 1.25 이상 필요

이전에는 프로젝트에서 Go 1.24.*를 사용했고, 모듈의 Go 버전은 1.24.0이었습니다.

> - `all`: Increase minimum Go version to 1.25 (#14567)

### `cmd/mdatagen`의 메트릭 안정성 필드 구조 평탄화

- 영향 대상: `cmd/mdatagen`에서 처리하는 `metadata.yaml`의 메트릭 메타데이터 (추정)

이전에는 `stability`가 `level`을 담는 그룹이었고, `level` 값이 `deprecated`일 때는 `since`도 포함할 수 있었습니다. 이제 지원 중단 예정 정보는 별도의 `deprecated` 그룹으로 표현하며, 추가 지원 중단 정보도 이 그룹에 설정합니다.

근거: “Currently, we define `stability` as a group that typically includes only the `level` field. The only additional field used is `since`, which applies to the `deprecated` stability level.” https://github.com/open-telemetry/opentelemetry-collector/issues/14113

> - `cmd/mdatagen`: Flatten the metric stability field (#14113)
>   So we better match the weaver schema. Additional deprecation data can be set within the `deprecated` field.

### `cmd/mdatagen` 메트릭 및 이벤트의 엔티티 연관성 요건

- 영향 대상: `cmd/mdatagen`에서 엔티티와 메트릭 또는 이벤트를 함께 정의하는 메타데이터

생성된 설정에서는 엔티티 연관성을 고려하지 않은 채 개별 리소스 어트리뷰트를 비활성화할 수 있습니다. 이로 인해 식별 엔티티 어트리뷰트가 비활성화되어 유효하지 않은 엔티티 데이터가 생성될 수 있습니다. 엔티티를 정의하는 경우 메트릭과 이벤트의 메타데이터는 엔티티 연관성 요건을 충족해야 합니다.

> - `cmd/mdatagen`: Add entity association requirement for metrics and events when entities are defined (#14284)

## 폐기 예정 (1)

### `pprofile` aggregation API 지원 중단 예정

- 영향 대상: `pdata/pprofile` aggregation 요소를 사용하는 코드 (추정)
- 제거 시점: 미상

`AggregationTemporality`와 그 상수, `String` 메서드가 지원 중단 예정으로 표시됐습니다. Profiles 시그널에는 이를 대체할 항목이 없습니다.

> - `pdata/pprofile`: Declare removed aggregation elements as deprecated. (#14528)
> - `pdata/pprofile`: Declare removed aggregation elements as deprecated. (#14528)

## 중요 수정 (3)

### `otelcol components`의 중복 항목 수정

- 영향 대상: 컴포넌트 별칭이 있는 생성된 collector (추정)

v0.144.0에서는 생성된 collector에서 `otelcol components`를 실행하면 `otlp_grpc`, `otlp_http` 같은 OTLP 익스포터가 두 번 표시될 수 있었습니다.

> - `pkg/otelcol`: Ignore component aliases in the `otelcol components` command (#14492)

### 생성 메트릭 초기화 중 `aggDataPoints` 재설정

- 영향 대상: 재집계를 사용하는 생성 메트릭

재집계를 활성화한 상태에서 emit 사이클이 충분히 반복되면, `emit()`이 데이터 포인트 슬라이스와 더 이상 일치하지 않는 카운터를 읽어 인덱스 범위 초과 오류로 패닉할 수 있었습니다. `init()`에서 `aggDataPoints`를 재설정하면 이 불일치를 방지합니다.

> - `cmd/mdatagen`: Reset aggDataPoints during metric init to avoid index out of range panic across emit cycles when reaggregation is enabled. (#14569)

### 인자 없이 실행할 때 발생하던 `mdatagen` 패닉 수정

- 영향 대상: `mdatagen`을 호출하는 설정

이전에는 `mdatagen`을 인자 없이 실행하면 인덱스 범위 초과 패닉이 발생했지만, 이제는 인자 오류를 반환합니다.

> - `cmd/mdatagen`: Fix panic when mdatagen is run without arguments. (#14506)

## 기능·개선 (7)

- Exporter 전송 실패 메트릭에 실패 어트리뷰트 추가 (사용 조건: 텔레메트리 수준을 Detailed로 설정)
- 실험적 `ocb init` 하위 명령
- `cmd/builder`의 텔레메트리 프로바이더 모듈 선택 (사용 조건: 텔레메트리 모듈의 `gomod` 항목)
- 지원 중단 예정 메트릭 메타데이터에 지원 중단 버전과 사유 추가
- 엔티티 스키마에 선택적 `relationships` 필드 추가
- 디버그 익스포터 출력 대상 설정 (사용 조건: `output_paths` 사용을 위한 `use_internal_logger`의 `false` 설정)
- `confmap.Conf` 디코딩용 실험적 `ToStringMapRaw` 함수

## 기타 (3)

- `pdata/pprofile`에서 문자열 테이블 경계 인덱스 거부
- `components` 출력의 알파벳순 정렬
- 프로세스 시그널의 빌드 태그 적용

---

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