# OpenTelemetry v0.144.0

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

호환성 변경 5 · 폐기 예정 4 · 기능·개선 8 · 기타 5

## 업그레이드 전 확인

### 릴리스 이후 확인된 결함

- `otelcol components`의 중복 항목 수정 · v0.146.0에서 수정됨
- 리졸버 스킴 URI를 허용하는 gRPC 클라이언트 엔드포인트 · v0.151.0에서 수정됨

## 호환성 변경 (5)

### 상세 verbosity로 제한된 Exporter 큐 배치 전송 크기 메트릭

- 영향 대상: `otelcol_exporter_queue_batch_send_size` 메트릭을 내보내는 Collector 구성 (추정)

히스토그램은 경계마다 버킷 메트릭을 하나씩 생성하므로 카디널리티가 높아질 수 있습니다.

근거: “I think it makes sense to expose the `otelcol_exporter_queue_batch_send_size` metric when telemetry verbosity is set to `detailed` level, consistent with the existing `otelcol_exporter_queue_batch_send_size_bytes` metric.” https://github.com/open-telemetry/opentelemetry-collector/issues/14278

> - `pkg/exporterhelper`: Change verbosity level for otelcol_exporter_queue_batch_send_size metric to detailed. (#14278)

### `pkg/service`의 `telemetry.disableHighCardinalityMetrics` 게이트 제거

- 영향 대상: `pkg/service`에서 `telemetry.disableHighCardinalityMetrics`를 사용하는 구성 (추정)

제거 전에는 이 게이트로 콜렉터에서 카디널리티가 높을 수 있는 메트릭을 활성화할지 제어했습니다. 소스에서는 대신 `service::telemetry::metrics::views`를 설정하도록 안내하지만, 업그레이드 후 기존 게이트 설정이 어떻게 되는지는 밝히지 않습니다.

근거: “This feature gate has been deprecated since 0.132.0, which is way more than the 2 releases we require for deprecated feature flags.” https://github.com/open-telemetry/opentelemetry-collector/pull/14373

> - `pkg/service`: Remove deprecated `telemetry.disableHighCardinalityMetrics` feature gate. (#14373)

### `service.noopTracerProvider` 기능 게이트 제거

- 영향 대상: `service.noopTracerProvider`를 활성화하는 구성

이 게이트를 활성화하면 메모리 할당을 줄이기 위해 Noop OpenTelemetry TracerProvider를 선택했지만, zPages 확장과 호환되지 않았습니다.

근거: “This feature gate has been deprecated since 0.132.0, which is way more than the 2 releases we require for deprecated feature flags.” https://github.com/open-telemetry/opentelemetry-collector/pull/14374

> - `pkg/service`: Remove deprecated `service.noopTracerProvider` feature gate. (#14374)

### `confighttp`의 HTTP 서버 엔드포인트 필드 교체

- 영향 대상: `pkg/config/confighttp`를 사용하는 HTTP 서버 설정 (추정)

기존 `ServerConfig.Endpoint` 필드는 `NetAddr confignet.AddrConfig`로 대체되며, `transport` 옵션으로 `tcp`, `unix`와 같은 프로토콜을 지정할 수 있습니다.

> - `pkg/config/confighttp`: Replace `ServerConfig.Endpoint` with `NetAddr confignet.AddrConfig`, enabling more flexible transport configuration. (#14187, #8752)
>   This change adds "transport" as a configuration option, allowing users to specify
>   different transport protocols (e.g., "tcp", "unix").

### `pkg/xconnector` `Create` 메서드의 컴포넌트 ID 타입 검증

- 영향 대상: `pkg/xconnector` 팩토리의 `Create` 메서드를 사용하는 설정 (추정)

ID 타입이 일치하면 해당 생성 함수로 진행하고, 일치하지 않으면 ID 불일치 오류를 반환합니다.

근거: “Adds component ID type validation to all xconnector Create methods to match the pattern used in the all other factories. The checks were missed in https://github.com/open-telemetry/opentelemetry-collector/pull/12381” https://github.com/open-telemetry/opentelemetry-collector/pull/14357

> - `pkg/xconnector`: Add component ID type validation to all xconnector Create methods (#14357)

## 폐기 예정 (4)

### OTLP exporter 유형을 `otlp_grpc`로 변경

- 영향 대상: `otlp` 또는 `otlp_grpc` exporter 유형을 사용하는 구성 (추정)
- 제거 시점: 미상

`otlp`를 사용하는 구성은 지원 중단 예정인 별칭을 통해 계속 동작합니다.

> - `exporter/otlp_grpc`: Rename `otlp` exporter to `otlp_grpc` exporter and add deprecated alias `otlp`. (#14403)

### Exporter 이름을 `otlp_http`로 변경하고 `otlphttp`는 지원 중단 예정 별칭으로 유지

- 영향 대상: `otlphttp` 익스포터를 설정한 환경
- 제거 시점: 미상

`otlphttp`를 사용하는 설정은 기존 구현을 계속 사용하며, 지원 중단 예정 경고가 자동으로 로그에 기록됩니다.

> - `exporter/otlp_http`: Rename `otlphttp` exporter to `otlp_http` exporter and add deprecated alias `otlphttp`. (#14396)

### `AddScraper` 지원 중단 예정 및 `AddMetricsScraper`로 대체

- 영향 대상: `pkg/scraperhelper`에서 `AddScraper`를 사용하는 코드 (추정)
- 제거 시점: 미상

기존 호출자는 계속 사용할 수 있습니다. `AddScraper`가 `AddMetricsScraper`를 호출하기 때문입니다.

> - `pkg/scraperhelper`: Deprecate the `AddScraper` method. (#14428)
> - `pkg/scraperhelper`: Introduce `AddMetricsScraper` to be more explicit than `AddScraper`. (#14428)

### `xextension`의 지원 중단 예정 타입 별칭 등록

- 영향 대상: 등록된 지원 중단 예정 타입 별칭을 사용하는 확장 설정
- 제거 시점: 미상

설정에서 등록된 별칭을 사용하면 지원 중단 예정 경고가 자동으로 로그에 기록되고, 해당 별칭을 사용하는 확장 함수는 원래 구현을 실행합니다.

> - `extension/xextension`: Add deprecated type alias support for extensions via `xextension` module (#14208)
>   Extensions can now register deprecated type aliases using the experimental `xextension.WithDeprecatedTypeAlias` option.
>   ```go
>   return xextension.NewFactory(
>       metadata.Type,
>       createDefaultConfig,
>       createExtension,
>       metadata.Stability,
>       xextension.WithDeprecatedTypeAlias("old_extension_name"),
>   )
>   ```
>   When the alias is used in configuration, a deprecation warning will be automatically logged, and the extension will function normally using the original implementation.
> - `all`: Add support for deprecated component type aliases (#14208)
>   To add a deprecated type alias to a component factory, use the `WithDeprecatedTypeAlias` option.
>   ```go
>   return xexporter.NewFactory(
>       metadata.Type,
>       createDefaultConfig,
>       xexporter.WithTraces(createTracesExporter, metadata.TracesStability),
>       xexporter.WithDeprecatedTypeAlias("old_component_name"),
>   )
>   ```
>   When the alias is used in configuration, a deprecation warning will be automatically logged, and the component will function normally using the original implementation.

## 기능·개선 (8)

- `receiver/nop` 프로파일 지원 추가
- OTel 프로파일링 리시버용 `pkg/xscraperhelper` 추가 (사용 조건: `pkg/xscraperhelper`와 `scraper/xscraper`를 함께 사용해야 OTel 프로파일링 시그널 리시버를 활성화할 수 있음)
- `cmd/mdatagen`의 메트릭 단위 어트리뷰트 비활성화 및 데이터 포인트 재집계
- consumertest 프로파일 sink의 프로파일 개수 조회 메서드
- `exporterhelper` 익스포터의 프로파일 샘플 카운터
- 프로파일 샘플 작업 보고
- 메트릭 스크레이퍼 구성을 위한 명시적 `AddMetricsScraper` 헬퍼
- OTLP 리시버에 프로파일 샘플 메트릭 추가

## 기타 (5)

- 빌더로 생성한 Collector 바이너리의 CLI 오류 중복 로깅 수정
- `metadata.yaml`의 선택적 `display_name` 및 `description` 필드
- `cmd/mdatagen`의 엔터티 안정성 값 검증
- `pkg/xexporterhelper`의 프로파일 배칭 재활성화
- 파티션 배처의 참조 횟수 버그 수정

---

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