RATATOSKRATATOSK
ログイン

OpenTelemetry

v0.162.0Observability
2026年9月28日

ACTION 2CHECK 2OTHER 19

性能と正確性に関する修正に加え、設定やプロセッサー名の変更、新しいエクスポーター、テレメトリー、スキーマ機能を含むメンテナンスリリースです。既存の設定やプロセッサー名を利用している場合は、変更内容の確認が必要です。

要対応 (2)

  • breakingkeepalive 設定を既定で有効化

    pkg/confighttp では、keepalive の設定が既定で有効になりました。

  • breakingパーティションのアイドルタイムアウトを設定可能に変更

    pkg/exporterhelper のパーティションアイドルタイムアウトを batch::partition::idle_timeout で設定できるようになり、既定値が 90 秒に変更されました。

影響確認 (2)

  • breakingプロセッサーのコンテキスト伝播を既定で検証

    skip_context_propagation を設定していない場合に適用されます。

    生成されるプロセッサーのライフサイクルテストでは、プロセッサーが受け取ったコンテキストを変更せず次のコンシューマーへ渡す動作を既定値として検証します。skip_context_propagation: true を設定すると、この動作を無効にできます。

  • breakingqueuebatch プロセッサーを queue_batch に改称

    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をスタックに追加

対応が必要なリリースが出たときに、週次メールでお知らせします。 今回の破壊的変更も、その一例です。

スタックに追加 →
公式リリースノート ↗OpenTelemetryのリリース一覧 →