# OpenTelemetry v0.144.0

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

破壊的変更 5 · 非推奨 4 · 機能・改善 8 · その他の変更 5

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

### リリース後に確認された不具合

- `otelcol components` の重複エントリー修正 · v0.146.0で修正済み
- リゾルバースキーム URI を受け付ける gRPC クライアントエンドポイント · v0.151.0で修正済み

## 破壊的変更 (5)

### Exporter キューのバッチ送信サイズメトリクスを詳細度に限定

- 影響対象: `otelcol_exporter_queue_batch_send_size` を出力する Collector の構成 (推定)

このヒストグラムは境界値ごとにバケットメトリクスを生成するため、カーディナリティが高くなる可能性があります。

根拠: “I think it makes sense to expose the `otelcol_exporter_queue_batch_send_size` metric when telemetry verbosity is set to `detailed` level, consistent with the existing `otelcol_exporter_queue_batch_send_size_bytes` metric.” https://github.com/open-telemetry/opentelemetry-collector/issues/14278

> - `pkg/exporterhelper`: Change verbosity level for otelcol_exporter_queue_batch_send_size metric to detailed. (#14278)

### `pkg/service` からの `telemetry.disableHighCardinalityMetrics` ゲートの削除

- 影響対象: `pkg/service` で `telemetry.disableHighCardinalityMetrics` を使用する設定 (推定)

削除前、このゲートは、コレクターでカーディナリティが高くなる可能性のあるメトリクスを有効にするかどうかを制御していました。ソースでは、代わりに `service::telemetry::metrics::views` を設定するよう示されていますが、アップグレード後に従来のゲート設定がどう扱われるかは明記されていません。

根拠: “This feature gate has been deprecated since 0.132.0, which is way more than the 2 releases we require for deprecated feature flags.” https://github.com/open-telemetry/opentelemetry-collector/pull/14373

> - `pkg/service`: Remove deprecated `telemetry.disableHighCardinalityMetrics` feature gate. (#14373)

### `service.noopTracerProvider` フィーチャーゲートの削除

- 影響対象: `service.noopTracerProvider` を有効にしている構成

有効にすると、このゲートはメモリー割り当てを減らすために Noop OpenTelemetry TracerProvider を選択していましたが、zPages 拡張機能とは互換性がありませんでした。

根拠: “This feature gate has been deprecated since 0.132.0, which is way more than the 2 releases we require for deprecated feature flags.” https://github.com/open-telemetry/opentelemetry-collector/pull/14374

> - `pkg/service`: Remove deprecated `service.noopTracerProvider` feature gate. (#14374)

### `confighttp` の HTTP サーバーエンドポイントフィールドの置き換え

- 影響対象: `pkg/config/confighttp` を使用する HTTP サーバー設定 (推定)

従来の `ServerConfig.Endpoint` フィールドは `NetAddr confignet.AddrConfig` に置き換えられます。また、`transport` オプションにより、`tcp` や `unix` などのプロトコルを指定できます。

> - `pkg/config/confighttp`: Replace `ServerConfig.Endpoint` with `NetAddr confignet.AddrConfig`, enabling more flexible transport configuration. (#14187, #8752)
>   This change adds "transport" as a configuration option, allowing users to specify
>   different transport protocols (e.g., "tcp", "unix").

### `pkg/xconnector` の `Create` メソッドによるコンポーネント ID 型の検証

- 影響対象: `pkg/xconnector` ファクトリーの `Create` メソッドを使用する構成 (推定)

ID の型が一致する場合は対応する作成関数に進み、一致しない場合は ID 不一致エラーを返します。

根拠: “Adds component ID type validation to all xconnector Create methods to match the pattern used in the all other factories. The checks were missed in https://github.com/open-telemetry/opentelemetry-collector/pull/12381” https://github.com/open-telemetry/opentelemetry-collector/pull/14357

> - `pkg/xconnector`: Add component ID type validation to all xconnector Create methods (#14357)

## 非推奨 (4)

### OTLP エクスポーターのタイプ名を `otlp_grpc` に変更

- 影響対象: `otlp` または `otlp_grpc` のエクスポータータイプを使用する設定 (推定)
- 削除予定: 不明

`otlp` を使用する設定は、非推奨のエイリアスを通じて引き続き動作します。

> - `exporter/otlp_grpc`: Rename `otlp` exporter to `otlp_grpc` exporter and add deprecated alias `otlp`. (#14403)

### エクスポーターを `otlp_http` に改称し、`otlphttp` を非推奨の別名として維持

- 影響対象: `otlphttp` エクスポーターを設定した構成
- 削除予定: 不明

`otlphttp` を使用する構成では、従来の実装が引き続き使用され、非推奨を示す警告が自動的にログに記録されます。

> - `exporter/otlp_http`: Rename `otlphttp` exporter to `otlp_http` exporter and add deprecated alias `otlphttp`. (#14396)

### `pkg/scraperhelper` における `AddScraper` の非推奨化

- 影響対象: `pkg/scraperhelper` で `AddScraper` を使用するコード (推定)
- 削除予定: 不明

`AddScraper` は `AddMetricsScraper` に処理を委譲するため、既存の呼び出し元は引き続き動作します。

> - `pkg/scraperhelper`: Deprecate the `AddScraper` method. (#14428)
> - `pkg/scraperhelper`: Introduce `AddMetricsScraper` to be more explicit than `AddScraper`. (#14428)

### `xextension` における型エイリアス登録の非推奨化

- 影響対象: 登録済みの非推奨型エイリアスを使用する拡張機能の設定
- 削除予定: 不明

設定で登録済みのエイリアスを使用すると、非推奨の警告が自動的にログに記録され、そのエイリアスを使用する拡張機能の関数は元の実装を実行します。

> - `extension/xextension`: Add deprecated type alias support for extensions via `xextension` module (#14208)
>   Extensions can now register deprecated type aliases using the experimental `xextension.WithDeprecatedTypeAlias` option.
>   ```go
>   return xextension.NewFactory(
>       metadata.Type,
>       createDefaultConfig,
>       createExtension,
>       metadata.Stability,
>       xextension.WithDeprecatedTypeAlias("old_extension_name"),
>   )
>   ```
>   When the alias is used in configuration, a deprecation warning will be automatically logged, and the extension will function normally using the original implementation.
> - `all`: Add support for deprecated component type aliases (#14208)
>   To add a deprecated type alias to a component factory, use the `WithDeprecatedTypeAlias` option.
>   ```go
>   return xexporter.NewFactory(
>       metadata.Type,
>       createDefaultConfig,
>       xexporter.WithTraces(createTracesExporter, metadata.TracesStability),
>       xexporter.WithDeprecatedTypeAlias("old_component_name"),
>   )
>   ```
>   When the alias is used in configuration, a deprecation warning will be automatically logged, and the component will function normally using the original implementation.

## 機能・改善 (8)

- `receiver/nop` にプロファイルのサポートを追加
- OTel Profiling レシーバー向け `pkg/xscraperhelper` の追加 (利用条件: `pkg/xscraperhelper` と `scraper/xscraper` の併用による OTel Profiling シグナルレシーバーの有効化)
- メトリクス単位の属性無効化とデータポイントの再集約
- consumertest のプロファイルシンク向け件数取得メソッド
- プロファイルサンプル数カウンター
- `receiverhelper.ObsReport` によるプロファイルサンプル操作の報告
- メトリクススクレイパー設定用の明示的な `AddMetricsScraper` ヘルパー
- OTLP レシーバーのプロファイルサンプルメトリクス追加

## その他の変更 (5)

- ビルダー生成 Collector バイナリーでの CLI エラー二重ログの修正
- `metadata.yaml` の任意の `display_name` フィールドと `description` フィールド
- `cmd/mdatagen` におけるエンティティ安定性値の検証
- `pkg/xexporterhelper` のプロファイルバッチ処理を再有効化
- パーティションバッチャーの参照カウント不具合の修正

---

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