# OpenTelemetry v0.142.0

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

破壊的変更 3 · 非推奨 1 · 重大な修正 1 · 機能・改善 2 · その他の変更 2

## 破壊的変更 (3)

### 静的な gRPC エンドポイント検証の全クライアントへの拡大

- 影響対象: `pkg/config/configgrpc` を使用する gRPC クライアント

変更前は、検証は OTLP エクスポーターで実施されていましたが、すべての gRPC クライアントには適用されていませんでした。

> - `pkg/config/configgrpc`: Statically validate gRPC endpoint (#10451)
>   This validation was already done in the OTLP exporter. It will now be applied to any gRPC client.

### Entity 属性メソッドの改名

- 影響対象: `pdata/xpdata` の `Entity` API (推定)

`IDAttributes()` は `IdentifyingAttributes()` に、`DescriptionAttributes()` は `DescriptiveAttributes()` に置き換えられました。

根拠: “+func (e Entity) IdentifyingAttributes() EntityAttributeMap {” https://github.com/open-telemetry/opentelemetry-collector/pull/14275

> - `pdata/xpdata`: Rename `Entity.IDAttributes()` to `Entity.IdentifyingAttributes()` and `Entity.DescriptionAttributes()` to `Entity.DescriptiveAttributes()` to align with OpenTelemetry specification terminology for attributes. (#14275)

### `pkg/exporterhelper` のキュー設定でオプショナル型を使用

- 影響対象: `QueueBatchConfig` フィールド、または影響を受ける `pkg/exporterhelper` のキューヘルパーを呼び出すコンポーネント (推定)

以前は、これらのフィールドとヘルパー呼び出しで `exporterhelper.QueueBatchConfig` を直接受け取っていましたが、オプショナル形式では `enabled` サブフィールドが保持されます。`configoptional.Some(exporterhelper.NewDefaultQueueConfig())` はデフォルトで有効にし、`configoptional.Default(exporterhelper.NewDefaultQueueConfig())` はデフォルトで無効にします。

> - `pkg/exporterhelper`: Use `configoptional.Optional` for the `exporterhelper.QueueBatchConfig` (#14155)
>   It's recommended to change the field type in your component configuration to be `configoptional.Optional[exporterhelper.QueueBatchConfig]` to keep the `enabled` subfield. Use configoptional.Some(exporterhelper.NewDefaultQueueConfig()) to enable by default. Use configoptional.Default(exporterhelper.NewDefaultQueueConfig()) to disable by default.

## 非推奨 (1)

### ロギングオプションの非推奨化と zap ロガービルダーの追加

- 影響対象: `Settings.LoggingOptions` または `telemetry.LoggerSettings.ZapOptions` を使用する `pkg/service` のロギング、および zap 設定でファイル出力が指定されていない `otelcol` の構成
- 削除予定: 不明

`BuildZapLogger` から `zap.Config` にアクセスできます。zap 設定でファイル出力が指定されていない場合、`otelcol` はこれを使って Windows イベントログへの出力を設定します。

> - `pkg/service`: Deprecate Settings.LoggingOptions and telemetry.LoggerSettings.ZapOptions, add telemetry.LoggerSettings.BuildZapLogger (#14002)
>   BuildZapLogger provides a more flexible way to build the Zap logger,
>   since the function will have access to the zap.Config. This is used
>   in otelcol to install a Windows Event Log output when the zap config
>   does not specify any file output.

## 重大な修正 (1)

### `pkg/confmap` の埋め込み構造体のアンマーシャリングで `Unmarshal` の状態を保持

- 影響対象: `Unmarshal` を実装する埋め込み構造体

`Unmarshal` を実装する埋め込み構造体に `configopaque.String` が含まれている場合、フックがマーシャリングしたデータを `mapstructure` に渡すことがありました。マーシャリング結果は `[REDACTED]` となるため値を往復できず、`Unmarshal` が設定したフィールドが上書きされる可能性がありました。現在、フックはアンマーシャリング済みの構造体を `mapstructure` に渡し、`Unmarshaler` を実装していないサブフィールドは個別にデコードします。

> - `pkg/confmap`: Ensure that embedded structs are not overwritten after Unmarshal is called (#14213)
>   This allows embedding structs which implement Unmarshal and contain a configopaque.String.

## 機能・改善 (2)

- `pkg/service` の内部ログにおけるリソース属性の任意設定
- `pdata/pprofile` に `ProfileCount()` を追加

## その他の変更 (2)

- 詳細な `exporter/debug` 出力での破棄項目数
- HTTP/GRPC ミドルウェアとして利用可能な `memorylimiter`

---

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