# OpenTelemetry v0.147.0

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

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

## 호환성 변경 (4)

### 로그에 맞는 receiver 텔레메트리를 출력하는 로그 스크레이퍼

- 영향 대상: `pkg/scraperhelper`의 로그 스크레이퍼를 사용하는 설정 (추정)

이전에는 로그 스크레이퍼가 `otelcol_receiver_accepted_log_records`와 `receiver/myreceiver/LogsReceived` 대신 `otelcol_receiver_accepted_metric_points`와 `receiver/myreceiver/MetricsReceived`를 출력했습니다. 스크레이퍼별 span과 메트릭에는 영향이 없습니다.

> - `pkg/scraperhelper`: Log scrapers now emit log-appropriate receiver telemetry (#14654)
>   Log scrapers previously emitted the same receiver telemetry as metric scrapers,
>   such as the otelcol_receiver_accepted_metric_points metric (instead of otelcol_receiver_accepted_log_records),
>   or spans named receiver/myreceiver/MetricsReceived (instead of receiver/myreceiver/LogsReceived).
>   This did not affect scraper-specific spans and metrics.

### `memory_limiter` 익스텐션에 스트리밍 지원 추가

- 영향 대상: gRPC 스트리밍 서비스를 사용하며 `memory_limiter` 익스텐션을 설정한 환경 (추정)

`MustRefuse()`가 true이면 스트리밍 요청에 `RESOURCE_EXHAUSTED`가 반환됩니다.

> - `extension/memory_limiter`: Add support for streaming services. (#14634)

### 추가 위치 인수를 거부하는 `featuregate` 하위 명령

- 영향 대상: `featuregate` 하위 명령 (추정)

이전에는 위치 인수를 두 개 이상 지정해도 실행이 성공하고 추가 인수는 알리지 않고 무시됐습니다. 이제는 오류를 반환합니다.

> - `pkg/otelcol`: The featuregate subcommand now rejects extra positional arguments instead of silently ignoring them. (#14554)

### gRPC 미들웨어 생성자가 이제 `context.Context`를 받음

- 영향 대상: `pkg/config/configmiddleware` 또는 `pkg/extensionmiddleware`의 gRPC 미들웨어 구현체와 생성자

옵션 함수는 원격 호출을 통해 옵션을 가져올 수 있습니다. 예를 들어 사이드카에서 TLS 구성을 읽을 수 있습니다.

근거: “Interfaces like GRPCClient/GRPCServer for the option function should accept context as first param. This is important if to retrieve some option a remote call is needed, for example read TLS config from a sidecar.” https://github.com/open-telemetry/opentelemetry-collector/issues/14523

> - `pkg/config/configmiddleware`: Add context.Context to gRPC middleware interface constructors. (#14523)
> - `pkg/extensionmiddleware`: Add context.Context to gRPC middleware interface constructors. (#14523)
>   This is a breaking API change for components that implement or use extensionmiddleware.
> - `pkg/config/configmiddleware`: Add context.Context to HTTP middleware interface constructors. (#14523)
>   This is a breaking API change for components that implement or use extensionmiddleware.

## 중요 수정 (3)

### `processor/batch`의 `SchemaUrl` 복사 수정

- 영향 대상: `processor/batch`를 사용하는 구성 (추정)

부분 배치를 분할할 때 `processor/batch`가 리소스 및 스코프 컨테이너의 `SchemaUrl` 메타데이터를 복사하지 않았습니다. 이제 부분 배치를 분할할 때 해당 메타데이터를 복사합니다.

> - `processor/batch`: Fixes a bug where the batch processor would not copy `SchemaUrl` metadata from resource and scope containers during partial batch splits. (#12279, #14620)

### memory_limiter 확장의 유니어리 인터셉터 체이닝

- 영향 대상: `UnaryInterceptor`를 사용하는 확장 여러 개와 memory_limiter 확장을 함께 쓰는 구성 (추정)

여러 확장에서 `UnaryInterceptor`를 설정하면 gRPC가 인터셉터를 하나만 허용하기 때문에 시작 시 바이너리에서 패닉이 발생했습니다. 이제 memory_limiter 확장이 이들 유니어리 인터셉터를 체인으로 연결합니다.

> - `extension/memory_limiter`: Use ChainUnaryInterceptor instead of UnaryInterceptor to allow multiple interceptors. (#14634)
>   If multiple extensions that use the UnaryInterceptor are set the binary panics at start time.

### 보간된 문자열 포인터 필드의 설정 디코딩 수정

- 영향 대상: 내부적으로 문자열 포인터 타입인 필드에 보간 값을 사용하는 설정

이 수정 전에는 `1234` 같은 보간된 환경 변수 값이 정수로 처리되어 문자열 검증에 실패했고, 설정 디코딩도 실패했습니다.

> - `pkg/confmap`: Fix another issue where configs could fail to decode when using interpolated values in string fields. (#14034)
>   For example, a resource attribute can be set via an environment variable to a string that is parseable as a number, e.g. `1234`.
>   (A similar bug was fixed in a previous release: that one was triggered when the field was nested in a struct,
>   whereas this one is triggered when the field internally has type "pointer to string" rather than "string".)

## 기능·개선 (2)

- 메타데이터 기반 익스포터 배치 파티셔닝 (사용 조건: `sending_queue.batch.partition`에 `metadata_keys`를 지정합니다. `exporterhelper.WithQueue()`가 파티셔너와 병합 함수를 자동으로 설정합니다.)
- 언더스코어 앵커가 포함된 시맨틱 컨벤션 URL의 `cmd/mdatagen` 검증

## 기타 (5)

- `exporter/debug`의 지수 히스토그램 버킷 카운트 출력
- 중복 `cmd/builder` CLI 오류 출력 수정
- `cmd/mdatagen`의 중복 CLI 오류 출력 수정
- `partition_batcher` 타이머 재설정 경쟁 상태 수정
- `pkg/xexporterhelper`의 무제한 sending_queue 파티션 처리 추가

---

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