RATATOSK
← 전체 릴리스

OpenTelemetryv0.142.0

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

OpenTelemetry 알림 받기

확인할 변경이 있을 때만 주 1회, critical 보안 공지는 즉시 발송

호환성 변경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.
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.142.0

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

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

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

근거“+func (e Entity) IdentifyingAttributes() EntityAttributeMap {” 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)
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.142.0

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.
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.142.0

폐기 예정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.
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.142.0

중요 수정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.
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.142.0

기능·개선2

기타2

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