RATATOSK
← リリース一覧

OpenTelemetryv0.146.0

セキュリティ 1破壊的変更 3非推奨 1重大な修正 3機能・改善 7その他の変更 3

OpenTelemetryの通知を受け取る

週次メールは確認すべき変更がある週だけ、深刻度がcriticalのセキュリティアドバイザリは即時に届きます。

アップグレード前の確認事項

既知の問題1
カスタム SDK 向けの Builder telemetry フィールド

セキュリティ1

Confighttp によるサーバースパン名のリクエストメソッドのカーディナリティ制限

影響対象pkg/config/confighttp からのサーバー内部テレメトリー

以前は、FOOBAR のような生のメソッド名がスパン名に含まれ、カーディナリティが高くなることがありました。

原文を表示
- `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 集約 API の非推奨化

影響対象pdata/pprofile の集約要素を使用するコード(推定)
削除予定不明

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() を十分な回数実行すると、カウンターとデータポイントのスライスが一致しなくなり、インデックス範囲外エラーでパニックすることがありました。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

  • エクスポーターの送信失敗メトリクスに失敗属性を追加

    利用条件 テレメトリーレベルを 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
  • cmd/builder 向けの実験的な 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 の非推奨メトリクスメタデータに非推奨化バージョンと理由を追加
    - `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
  • cmd/mdatagen のエンティティスキーマへの任意の 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 が作成するため誤っている可能性があり、無保証で提供されます。