RATATOSK
← 전체 릴리스

OpenTelemetryv0.146.0

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

OpenTelemetry 알림 받기

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

업그레이드 전 확인

알려진 문제1
커스텀 SDK용 Builder telemetry 필드

보안1

Confighttp가 서버 span 이름에서 요청 메서드 카디널리티를 제한

영향 대상pkg/config/confighttp에서 발생하는 서버 내부 텔레메트리

이전에는 FOOBAR 같은 원시 메서드가 span 이름에 포함되어 카디널리티가 높아질 수 있었습니다.

원문 보기
- `pkg/config/confighttp`: Fix high cardinality span name from request method from confighttp server internal telemetry (#14516)
  Follow spec to bound request method cardinality.
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0

호환성 변경3

빌드에 필요한 최소 Go 버전 1.25로 상향

영향 대상Go 1.25보다 이전 버전을 사용하는 Collector 빌드(추정)
필요 조치프로젝트 빌드에 Go 1.25 이상 필요

이전에는 프로젝트에서 Go 1.24.*를 사용했고, 모듈의 Go 버전은 1.24.0이었습니다.

원문 보기
- `all`: Increase minimum Go version to 1.25 (#14567)
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0

cmd/mdatagen의 메트릭 안정성 필드 구조 평탄화

영향 대상cmd/mdatagen에서 처리하는 metadata.yaml의 메트릭 메타데이터(추정)

이전에는 stability가 level을 담는 그룹이었고, level 값이 deprecated일 때는 since도 포함할 수 있었습니다. 이제 지원 중단 예정 정보는 별도의 deprecated 그룹으로 표현하며, 추가 지원 중단 정보도 이 그룹에 설정합니다.

근거“Currently, we define `stability` as a group that typically includes only the `level` field. The only additional field used is `since`, which applies to the `deprecated` stability level.” open-telemetry/opentelemetry-collector/issues/14113 ↗
원문 보기
- `cmd/mdatagen`: Flatten the metric stability field (#14113)
  So we better match the weaver schema. Additional deprecation data can be set within the `deprecated` field.
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0

cmd/mdatagen 메트릭 및 이벤트의 엔티티 연관성 요건

영향 대상cmd/mdatagen에서 엔티티와 메트릭 또는 이벤트를 함께 정의하는 메타데이터

생성된 설정에서는 엔티티 연관성을 고려하지 않은 채 개별 리소스 어트리뷰트를 비활성화할 수 있습니다. 이로 인해 식별 엔티티 어트리뷰트가 비활성화되어 유효하지 않은 엔티티 데이터가 생성될 수 있습니다. 엔티티를 정의하는 경우 메트릭과 이벤트의 메타데이터는 엔티티 연관성 요건을 충족해야 합니다.

원문 보기
- `cmd/mdatagen`: Add entity association requirement for metrics and events when entities are defined (#14284)
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0

폐기 예정1

pprofile aggregation API 지원 중단 예정

영향 대상pdata/pprofile aggregation 요소를 사용하는 코드(추정)
제거 시점미상

AggregationTemporality와 그 상수, String 메서드가 지원 중단 예정으로 표시됐습니다. Profiles 시그널에는 이를 대체할 항목이 없습니다.

원문 보기
- `pdata/pprofile`: Declare removed aggregation elements as deprecated. (#14528)
- `pdata/pprofile`: Declare removed aggregation elements as deprecated. (#14528)
github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0

중요 수정3

  • otelcol components의 중복 항목 수정
    영향 대상컴포넌트 별칭이 있는 생성된 collector(추정)

    v0.144.0에서는 생성된 collector에서 otelcol components를 실행하면 otlp_grpc, otlp_http 같은 OTLP 익스포터가 두 번 표시될 수 있었습니다.

    - `pkg/otelcol`: Ignore component aliases in the `otelcol components` command (#14492)
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • 생성 메트릭 초기화 중 aggDataPoints 재설정
    영향 대상재집계를 사용하는 생성 메트릭

    재집계를 활성화한 상태에서 emit 사이클이 충분히 반복되면, emit()이 데이터 포인트 슬라이스와 더 이상 일치하지 않는 카운터를 읽어 인덱스 범위 초과 오류로 패닉할 수 있었습니다. init()에서 aggDataPoints를 재설정하면 이 불일치를 방지합니다.

    - `cmd/mdatagen`: Reset aggDataPoints during metric init to avoid index out of range panic across emit cycles when reaggregation is enabled. (#14569)
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • 인자 없이 실행할 때 발생하던 mdatagen 패닉 수정
    영향 대상mdatagen을 호출하는 설정

    이전에는 mdatagen을 인자 없이 실행하면 인덱스 범위 초과 패닉이 발생했지만, 이제는 인자 오류를 반환합니다.

    - `cmd/mdatagen`: Fix panic when mdatagen is run without arguments. (#14506)
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0

기능·개선7

  • Exporter 전송 실패 메트릭에 실패 어트리뷰트 추가

    사용 조건 텔레메트리 수준을 Detailed로 설정

    - `all`: Add detailed failure attributes to exporter send_failed metrics at detailed telemetry level. (#13956)
      The `otelcol_exporter_send_failed_{spans,metric_points,log_records}` metrics now include
      failure attributes when telemetry level is Detailed: `error.type` (OpenTelemetry semantic convention
      describing the error class) and `error.permanent` (indicates if error is permanent/non-retryable).
      The `error.type` attribute captures gRPC status codes (e.g., "Unavailable", "ResourceExhausted"),
      standard Go context errors (e.g., "canceled", "deadline_exceeded"),
      and collector-specific errors (e.g., "shutdown").
      This enables better alerting and debugging by providing standardized error classification.
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • 실험적 ocb init 하위 명령
    - `cmd/builder`: Introduce new experimental `init` subcommand (#14530)
      The new `init` subcommand initializes a new custom collector
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • cmd/builder의 텔레메트리 프로바이더 모듈 선택

    사용 조건 텔레메트리 모듈의 gomod 항목

    - `cmd/builder`: Add "telemetry" field to allow configuring telemetry providers (#14575)
      Most users should not need to use this, this field should only be set if you
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • 지원 중단 예정 메트릭 메타데이터에 지원 중단 버전과 사유 추가
    - `cmd/mdatagen`: Introduce additional metadata (the version since the deprecation started, and the deprecation reason) for deprecated metrics. (#14113)
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • 엔티티 스키마에 선택적 relationships 필드 추가
    - `cmd/mdatagen`: Add optional `relationships` field to entity schema in metadata.yaml (#14284)
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • 디버그 익스포터 출력 대상 설정

    사용 조건 output_paths 사용을 위한 use_internal_logger의 false 설정

    - `exporter/debug`: Add `output_paths` configuration option to control output destination when `use_internal_logger` is false. (#10472)
      When `use_internal_logger` is set to `false`, the debug exporter now supports configuring the output destination via the `output_paths` option.
      This allows users to send debug exporter output to `stdout`, `stderr`, or a file path.
      The default value is `["stdout"]` to maintain backward compatibility.
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
  • confmap.Conf 디코딩용 실험적 ToStringMapRaw 함수
    - `pkg/confmap`: Add experimental `ToStringMapRaw` function to decode `confmap.Conf` into a string map without losing internal types (#14480)
      This method exposes the internal structure of a `confmap.Conf` which may change at any time without prior notice
    github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0
기타3

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