# OpenTelemetry v0.147.0

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

破壊的変更 4 · 重大な修正 3 · 機能・改善 2 · その他の変更 5

## 破壊的変更 (4)

### ログスクレーパーがログに適したレシーバーテレメトリーを出力

- 影響対象: `pkg/scraperhelper` のログスクレーパーを使用する構成 (推定)

従来、ログスクレーパーは `otelcol_receiver_accepted_log_records` と `receiver/myreceiver/LogsReceived` ではなく、`otelcol_receiver_accepted_metric_points` と `receiver/myreceiver/MetricsReceived` を出力していました。スクレーパー固有のスパンとメトリクスには影響しません。

> - `pkg/scraperhelper`: Log scrapers now emit log-appropriate receiver telemetry (#14654)
>   Log scrapers previously emitted the same receiver telemetry as metric scrapers,
>   such as the otelcol_receiver_accepted_metric_points metric (instead of otelcol_receiver_accepted_log_records),
>   or spans named receiver/myreceiver/MetricsReceived (instead of receiver/myreceiver/LogsReceived).
>   This did not affect scraper-specific spans and metrics.

### `memory_limiter` 拡張機能のストリーミング対応

- 影響対象: gRPC ストリーミングサービスで `memory_limiter` 拡張機能を使用する構成 (推定)

`MustRefuse()` が true の場合、ストリーミングリクエストは `RESOURCE_EXHAUSTED` を受け取ります。

> - `extension/memory_limiter`: Add support for streaming services. (#14634)

### `featuregate` の余分な位置引数の拒否

- 影響対象: `featuregate` サブコマンド (推定)

これまでは位置引数が複数ある呼び出しも成功し、余分な引数は黙って無視されていました。現在はエラーが返されます。

> - `pkg/otelcol`: The featuregate subcommand now rejects extra positional arguments instead of silently ignoring them. (#14554)

### gRPC ミドルウェアのコンストラクターが `context.Context` を受け取るように変更

- 影響対象: `pkg/config/configmiddleware` または `pkg/extensionmiddleware` にある gRPC ミドルウェアの実装およびコンストラクター

オプション関数はリモート呼び出しを通じてオプションを取得できます。たとえば、サイドカーから TLS 設定を読み取れます。

根拠: “Interfaces like GRPCClient/GRPCServer for the option function should accept context as first param. This is important if to retrieve some option a remote call is needed, for example read TLS config from a sidecar.” https://github.com/open-telemetry/opentelemetry-collector/issues/14523

> - `pkg/config/configmiddleware`: Add context.Context to gRPC middleware interface constructors. (#14523)
> - `pkg/extensionmiddleware`: Add context.Context to gRPC middleware interface constructors. (#14523)
>   This is a breaking API change for components that implement or use extensionmiddleware.
> - `pkg/config/configmiddleware`: Add context.Context to HTTP middleware interface constructors. (#14523)
>   This is a breaking API change for components that implement or use extensionmiddleware.

## 重大な修正 (3)

### `processor/batch` の `SchemaUrl` コピー処理の修正

- 影響対象: `processor/batch` を使用する構成 (推定)

バッチを部分的に分割する際、`processor/batch` はリソースおよびスコープのコンテナーから `SchemaUrl` メタデータをコピーしていませんでした。現在は、部分的なバッチ分割時にこのメタデータをコピーします。

> - `processor/batch`: Fixes a bug where the batch processor would not copy `SchemaUrl` metadata from resource and scope containers during partial batch splits. (#12279, #14620)

### memory_limiter 拡張機能での `UnaryInterceptor` のチェーン化

- 影響対象: `memory_limiter` 拡張機能と、`UnaryInterceptor` を使用する複数の拡張機能を使う構成 (推定)

`UnaryInterceptor` を使用する拡張機能を複数設定すると、gRPC がインターセプターを1つしか受け付けないため、バイナリーは起動時にパニックを起こしていました。`memory_limiter` 拡張機能は、これらの単項インターセプターをチェーンするようになりました。

> - `extension/memory_limiter`: Use ChainUnaryInterceptor instead of UnaryInterceptor to allow multiple interceptors. (#14634)
>   If multiple extensions that use the UnaryInterceptor are set the binary panics at start time.

### 補間された文字列ポインター型フィールドの設定デコード修正

- 影響対象: 内部的に文字列へのポインター型として定義されたフィールドに補間値を含む設定

この修正前は、`1234` のような補間済み環境変数の値が整数として扱われ、文字列の検証に失敗して設定のデコードが失敗していました。

> - `pkg/confmap`: Fix another issue where configs could fail to decode when using interpolated values in string fields. (#14034)
>   For example, a resource attribute can be set via an environment variable to a string that is parseable as a number, e.g. `1234`.
>   (A similar bug was fixed in a previous release: that one was triggered when the field was nested in a struct,
>   whereas this one is triggered when the field internally has type "pointer to string" rather than "string".)

## 機能・改善 (2)

- メタデータに基づくエクスポーターバッチのパーティション分割 (利用条件: `sending_queue.batch.partition` での `metadata_keys` の指定。`exporterhelper.WithQueue()` によるパーティショナーとマージ関数の自動設定)
- アンダースコアを含むアンカーを持つ Semantic Convention URL の `cmd/mdatagen` による検証

## その他の変更 (5)

- `exporter/debug` の指数ヒストグラムのバケット数出力
- `cmd/builder` CLI のエラー出力重複を修正
- `cmd/mdatagen` の CLI エラー出力重複の修正
- `partition_batcher` のタイマーリセット競合の修正
- `pkg/xexporterhelper` による送信キューの無制限なパーティションへの対応

---

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