# OpenTelemetry v0.145.0

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

중요 수정 5 · 기능·개선 2 · 기타 2

## 중요 수정 (5)

### OTLP gRPC exporter 기본 balancer를 `round_robin`으로 수정

- 영향 대상: 기본 balancer를 사용하는 `exporter/otlp_grpc` OTLP exporter 설정 (추정)

기본 balancer를 사용하면 동작이 `pick_first`로 폴백될 수 있었습니다. passthrough resolver 스킴에서는 `round_robin`이 적용되지 않았습니다.

> - `exporter/otlp_grpc`: Fix the OTLP exporter balancer to use round_robin by default, as intended. (#14090)

### Exporter 배치 사이저 기본값 복원

- 영향 대상: exporter 설정에서 `sending_queue` 배칭을 사용하는 경우 (추정)

설정을 `Optional`로 감싸면 `Unmarshal` 메서드가 호출되지 않아 배치 `min_size`와 `max_size`의 단위가 잘못될 수 있었습니다. 이제 래퍼 타입에서 `xconfmap.WithForceUnmarshaler`를 사용해 내부 `Unmarshal`을 호출할 수 있습니다. 다만 `confmap.Conf`의 최상위 `Unmarshal` 호출은 기본적으로 최상위 메서드를 계속 건너뜁니다.

> - `pkg/config/configoptional`: Fix `Unmarshal` methods not being called when config is wrapped inside `Optional` (#14500)
>   This bug notably manifested in the fact that the `sending_queue::batch::sizer` config for exporters
>   stopped defaulting to `sending_queue::sizer`, which sometimes caused the wrong units to be used
>   As part of the fix, `xconfmap` exposes a new `xconfmap.WithForceUnmarshaler` option, to be used in the `Unmarshal` methods
>   The default behavior remains that calling `conf.Unmarshal` on the `confmap.Conf` passed as argument to an `Unmarshal`
>   method will skip any top-level `Unmarshal` methods to avoid infinite recursion in standard use cases.
> - `pkg/config/configoptional`: Fix `Unmarshal` methods not being called when config is wrapped inside `Optional` (#14500)
>   This bug notably manifested in the fact that the `sending_queue::batch::sizer` config for exporters
>   stopped defaulting to `sending_queue::sizer`, which sometimes caused the wrong units to be used
>   when configuring `sending_queue::batch::min_size` and `max_size`.

### Optional로 래핑된 설정 언마샬링 및 익스포터 배치 sizer 기본값 복구

- 영향 대상: `Optional`로 래핑된 익스포터 설정, 특히 `sending_queue::batch::sizer`, `sending_queue::batch::min_size` 또는 `sending_queue::batch::max_size`를 사용하는 설정

`sending_queue::batch::sizer` 설정이 기본값으로 `sending_queue::sizer`를 사용하지 않게 될 수 있어, `sending_queue::batch::min_size`와 `sending_queue::batch::max_size`가 잘못된 단위를 사용할 수 있었습니다. 해당 기본값을 복구했습니다.

> - `pkg/config/configoptional`: Fix `Unmarshal` methods not being called when config is wrapped inside `Optional` (#14500)
>   This bug notably manifested in the fact that the `sending_queue::batch::sizer` config for exporters
>   stopped defaulting to `sending_queue::sizer`, which sometimes caused the wrong units to be used
>   when configuring `sending_queue::batch::min_size` and `max_size`.

### `pkg/confmap` struct 컬렉션의 보간 문자열 디코딩 수정

- 영향 대상: struct 컬렉션 내 문자열 필드에 보간 값이 있는 구성

수정 전에는 환경 변수에서 가져온 `1234`처럼 문자열이 아닌 값으로 파싱되면 디코딩이 실패할 수 있었습니다. `confmap.newExpandedValueSanitizer`를 활성화하면 필드별 디코딩으로 이 실패를 방지합니다.

> - `pkg/confmap`: Fix an issue where configs could fail to decode when using interpolated values in string fields. (#14413)
>   For example, a header can be set via an environment variable to a string that is parseable as a number, e.g. `1234`

### `pkg/service`에서 지원되지 않는 OS의 프로세스 메트릭 시작 오류 수정

- 영향 대상: 지원되지 않는 OS에서 프로세스 메트릭을 활성화한 커스텀 컴파일 컬렉터

이러한 컬렉터는 이전에는 `failed to register process metrics: not implemented yet` 오류와 함께 시작에 실패했지만, 이제는 해당 오류 없이 시작됩니다.

> - `pkg/service`: Don't error on startup when process metrics are enabled on unsupported OSes (e.g. AIX) (#14307)

## 기능·개선 (2)

- 래퍼 타입의 내부 `Unmarshal` 강제 호출 (사용 조건: 내부 타입의 `Unmarshal` 메서드 호출을 보장하기 위해 래퍼 타입의 `Unmarshal` 메서드에서 사용하는 `xconfmap.WithForceUnmarshaler`)
- `pkg/xscraperhelper`에 `AddProfilesScraper` 헬퍼 추가

## 기타 (2)

- `pkg/scraperhelper` 오류 로그에 스크레이퍼 ID 추가
- `pkg/config/configgrpc` 서버 인증 전에 클라이언트 정보 추가

---

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