# OpenTelemetry v0.146.0

2026-02-17 · [元のリリースノート](https://github.com/open-telemetry/opentelemetry-collector/releases/tag/v0.146.0) · [全体のまとめ](https://ratatosk.io/ja/releases/opentelemetry/v0.146.0)

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

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

### 既知の問題

- **カスタム SDK 向けの Builder `telemetry` フィールド**
  >   intend to provide your own OpenTelemetry SDK.

## セキュリティ (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.

## 破壊的変更 (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)

### `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.” https://github.com/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.

### `cmd/mdatagen` のメトリクスとイベントにおけるエンティティ関連付け要件

- 影響対象: エンティティとメトリクスまたはイベントを併せて定義する `cmd/mdatagen` のメタデータ

生成された設定では、エンティティとの関連付けを考慮せずに個々のリソース属性を無効化できるため、識別に使われるエンティティ属性が無効化され、無効なエンティティデータが生成されることがあります。エンティティが定義されている場合、メトリクスとイベントのメタデータはエンティティとの関連付け要件を満たす必要があります。

> - `cmd/mdatagen`: Add entity association requirement for metrics and events when entities are defined (#14284)

## 非推奨 (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)

## 重大な修正 (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)

### 初期化時に生成メトリクスの `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)

### `mdatagen` の引数なし実行時のパニック修正

- 影響対象: `mdatagen` を呼び出すセットアップ

以前は引数なしで `mdatagen` を実行するとインデックス範囲外のパニックが発生していましたが、現在は引数エラーを返します。

> - `cmd/mdatagen`: Fix panic when mdatagen is run without arguments. (#14506)

## 機能・改善 (7)

- エクスポーターの送信失敗メトリクスに失敗属性を追加 (利用条件: テレメトリーレベルを Detailed に設定)
- `cmd/builder` 向けの実験的な `ocb init` サブコマンド
- `cmd/builder` におけるテレメトリープロバイダーモジュールの選択 (利用条件: テレメトリーモジュール内の `gomod` エントリー)
- `cmd/mdatagen` の非推奨メトリクスメタデータに非推奨化バージョンと理由を追加
- `cmd/mdatagen` のエンティティスキーマへの任意の `relationships` フィールドの追加
- デバッグエクスポーターの出力先設定 (利用条件: `output_paths` の使用には `use_internal_logger` を `false` に設定)
- `confmap.Conf` デコード用の実験的な `ToStringMapRaw` 関数

## その他の変更 (3)

- `pdata/pprofile` が文字列テーブル境界のインデックスを拒否
- `components` 出力のアルファベット順での並び替え
- `pkg/otelcol` のプロセスシグナルをビルドタグで制御

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
