RATATOSKRATATOSK
로그인

OpenTelemetry

v0.162.0Observability
2026년 9월 28일

ACTION 2CHECK 2OTHER 19

성능과 정확성 개선이 포함된 유지보수 릴리스입니다. 구성 기본값과 프로세서 이름 변경처럼 호환성에 영향을 주는 변경과 익스포터, 텔레메트리, 스키마 기능 확장이 함께 들어갔습니다.

조치 필요 (2)

  • breaking킵얼라이브 설정 기본 활성화

    pkg/confighttp에서 킵얼라이브 설정을 기본으로 활성화합니다.

  • breaking파티션 유휴 시간 설정 지원

    파티션 유휴 시간을 batch::partition::idle_timeout으로 설정할 수 있게 했으며, 기본값을 90초로 높였습니다.

영향 확인 (2)

  • breaking프로세서의 기본 컨텍스트 전달 검증

    skip_context_propagation을 설정하지 않은 경우 적용됩니다.

    cmd/mdatagen에서 생성하는 프로세서 수명 주기 테스트가 기본적으로 프로세서가 입력 컨텍스트를 변경하지 않고 다음 소비자에게 전달하는지 확인합니다. skip_context_propagation: true로 이 동작을 끌 수 있습니다.

  • breakingqueuebatch 프로세서 이름 변경

    queuebatch를 설정한 경우 적용됩니다.

    queuebatch 프로세서의 이름을 queue_batch로 변경했습니다.

그 외 기록된 변경 19건 전체additions 7 · fixes 5 · value changes 4 · constraints 1 · removals 1 · renames 1

additions (7)

  • - extension/memory_limiter: Add otelcol_memorylimiter_refused_requests metric to record network request refusals in extension mode. (#15561)
  • Introduces the feature gate pkg.confighttp.PrioritizeNewKeepalive. When disabled, this flag restores the old behaviour of removing the keepalive configuration in favour of the deprecated fields IdleConnTimeout, MaxIdleConns, MaxIdleConnsPerHost, DisableKeepAlives when the flag is disabled.
  • - pkg/exporterhelper: Make the partition idle timeout configurable via batch::partition::idle_timeout and raise the default to 90s. (#15894)
  • - pkg/exporterhelper: Make the multi-batcher partition LRU cache size configurable and export cache size metrics. (#14526) Adds sending_queue::batch::partition::cache_size (default 10000) to cap the number of active partition batchers. The value must be positive. Current size and configured capacity are exported as otelcol_exporter_queue_batch_partition_cache_size and otelcol_exporter_queue_batch_partition_cache_capacity.×2
  • - cmd/mdatagen: Allow config metadata authors to choose configoptional.Some or configoptional.Default for generated optional fields (#15977) Set go_struct.optional_mode: default to generate an optional object configuration section with a fallback default while keeping it absent until configured. Omitting optional_mode preserves the existing configoptional.Some behavior.
  • - pkg/exporterhelper: Add NewDefaultBatchConfig to build a BatchConfig with default values, including the partition cache_size and idle_timeout defaults. (#14526, #15894)

fixes (5)

  • - exporter/debug: Support known sync error handling on AIX (#15924) Enable the debug exporter to handle known synchronous errors on AIX.
  • - pkg/exporterhelper: Drop only the oversized item when splitting a batch, instead of discarding every item queued behind it (#15936) Applied to logs only for now
  • - receiver/otlp: Error handler preserves the HTTP status code when the request Content-Type is not one a Status can be encoded in (#15995) Extends the fix in #13414, which handled a missing Content-Type. A Content-Type that was present but unsupported, or malformed, still fell through to 500 {"code": 13, "message": "failed to marshal error message"}, reporting client errors such as 401 from a server auth extension or 400 from an unsupported Content-Encoding as server faults.
  • - cmd/schemagen: Fix RefResolver mutating shared, cached type definitions with per-occurrence annotations, which caused generated schemas to have incorrect (and run-to-run nondeterministic) description/x-optional/x-pointer values whenever multiple fields referenced the same type. (#15984)
  • - pkg/pdata: Fix pcommon.Value.CopyTo to deep-copy ValueTypeBytes values instead of sharing the backing array (#15621) The bytes oneof field in CopyAnyValue was assigned directly, so the copy and source shared the same []byte. This also affected Map.CopyTo and Slice.CopyTo, which delegate to CopyAnyValue.

value changes (4)

  • - pkg/pprofile: Speed up profiles dictionary merging during exporter-queue batching by replacing the linear-scan dedup in switchDictionary with an indexed lookup, reducing per-merge cost from O(N*L^2) to O(N+L). (#15544) No behavior change: merged dictionary contents and remapped indices are identical to before.
  • - pkg/xpdata: Reduce the time xhash.MapHash takes for maps with many entries. (#15990)
  • - pkg/exporterhelper: Add exporter and data_type attributes to exporter/enqueue spans. (#16022)
  • - pkg/config/configgrpc: Migrate core types of common settings for a gRPC client to schema-based configuration generated by mdatagen. (#15967)

constraints (1)

  • - pkg/exporterhelper: Make the multi-batcher partition LRU cache size configurable and export cache size metrics. (#14526) Adds sending_queue::batch::partition::cache_size (default 10000) to cap the number of active partition batchers. The value must be positive. Current size and configured capacity are exported as otelcol_exporter_queue_batch_partition_cache_size and otelcol_exporter_queue_batch_partition_cache_capacity.

removals (1)

  • - pkg/receiverhelper: Stop allocating a span link that is always discarded when a long-lived-context receiver starts an operation without a parent span context. (#15998) Receivers created with LongLivedCtx: true no longer build a trace.Link when the long-lived context carries no valid span context. The SDK already discarded such a link, so behaviour is unchanged. This removes 3 of 7 allocations per receive operation.

renames (1)

  • - pkg/xpdata: Move pdata hash APIs from the contrib repo (#15914)
OpenTelemetry 스택에 추가

조치가 필요한 릴리스가 나왔을 때 주간 메일로 알려드립니다. 이번 릴리스의 브레이킹 체인지 같은 것들입니다.

스택에 추가 →