# OpenTelemetry v0.142.0

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

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

## 호환성 변경 (3)

### 정적 gRPC 엔드포인트 검증을 모든 클라이언트로 확대

- 영향 대상: `pkg/config/configgrpc`를 사용하는 gRPC 클라이언트

이번 변경 전에는 OTLP 익스포터에서 검증했지만, 모든 gRPC 클라이언트에 적용되지는 않았습니다.

> - `pkg/config/configgrpc`: Statically validate gRPC endpoint (#10451)
>   This validation was already done in the OTLP exporter. It will now be applied to any gRPC client.

### Entity 어트리뷰트 메서드 이름 변경

- 영향 대상: `pdata/xpdata` `Entity` API (추정)

`IDAttributes()`는 `IdentifyingAttributes()`로, `DescriptionAttributes()`는 `DescriptiveAttributes()`로 대체됩니다.

근거: “+func (e Entity) IdentifyingAttributes() EntityAttributeMap {” https://github.com/open-telemetry/opentelemetry-collector/pull/14275

> - `pdata/xpdata`: Rename `Entity.IDAttributes()` to `Entity.IdentifyingAttributes()` and `Entity.DescriptionAttributes()` to `Entity.DescriptiveAttributes()` to align with OpenTelemetry specification terminology for attributes. (#14275)

### `pkg/exporterhelper` 큐 구성에 옵셔널 타입 사용

- 영향 대상: `QueueBatchConfig` 필드가 있거나 영향받는 `pkg/exporterhelper` 큐 헬퍼를 호출하는 컴포넌트 (추정)

기존에는 이 필드와 헬퍼 호출에서 `exporterhelper.QueueBatchConfig`를 직접 사용했습니다. 옵셔널 형식은 `enabled` 하위 필드를 그대로 유지합니다. `configoptional.Some(exporterhelper.NewDefaultQueueConfig())`를 사용하면 기본적으로 활성화되고, `configoptional.Default(exporterhelper.NewDefaultQueueConfig())`를 사용하면 기본적으로 비활성화됩니다.

> - `pkg/exporterhelper`: Use `configoptional.Optional` for the `exporterhelper.QueueBatchConfig` (#14155)
>   It's recommended to change the field type in your component configuration to be `configoptional.Optional[exporterhelper.QueueBatchConfig]` to keep the `enabled` subfield. Use configoptional.Some(exporterhelper.NewDefaultQueueConfig()) to enable by default. Use configoptional.Default(exporterhelper.NewDefaultQueueConfig()) to disable by default.

## 폐기 예정 (1)

### 로깅 옵션 지원 중단 예정 및 zap 로거 빌더 추가

- 영향 대상: `pkg/service`에서 `Settings.LoggingOptions` 또는 `telemetry.LoggerSettings.ZapOptions`를 사용해 로깅하는 경우와, 파일 출력이 지정되지 않은 zap config를 사용하는 `otelcol` 설정
- 제거 시점: 미상

`BuildZapLogger`는 `zap.Config`에 접근할 수 있습니다. `otelcol`은 zap config에 파일 출력이 지정되지 않은 경우 이를 사용해 Windows Event Log 출력을 설정합니다.

> - `pkg/service`: Deprecate Settings.LoggingOptions and telemetry.LoggerSettings.ZapOptions, add telemetry.LoggerSettings.BuildZapLogger (#14002)
>   BuildZapLogger provides a more flexible way to build the Zap logger,
>   since the function will have access to the zap.Config. This is used
>   in otelcol to install a Windows Event Log output when the zap config
>   does not specify any file output.

## 중요 수정 (1)

### `pkg/confmap`에서 임베디드 구조체의 `Unmarshal` 상태 보존

- 영향 대상: `Unmarshal`을 구현하는 임베디드 구조체

`Unmarshal`을 구현하는 임베디드 구조체에 `configopaque.String`이 있으면, 훅이 마샬링한 데이터를 `mapstructure`에 전달할 수 있었습니다. 마샬링 결과가 `[REDACTED]`였기 때문에 값이 왕복 과정에서 보존되지 않았고, `Unmarshal`이 설정한 필드가 덮어써질 수 있었습니다. 이제 훅은 이미 언마샬링된 구조체를 `mapstructure`에 전달하고, `Unmarshaler`가 아닌 하위 필드는 별도로 디코딩합니다.

> - `pkg/confmap`: Ensure that embedded structs are not overwritten after Unmarshal is called (#14213)
>   This allows embedding structs which implement Unmarshal and contain a configopaque.String.

## 기능·개선 (2)

- `pkg/service` 내부 로그의 리소스 어트리뷰트 선택적 포함
- `pdata/pprofile`에 `ProfileCount()` 추가

## 기타 (2)

- 상세 `exporter/debug` 출력의 드롭 항목 개수
- `memorylimiter` HTTP/GRPC 미들웨어로 사용 가능

---

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