otel-telemetry-emissions

テレメトリーの出力

OpenTelemetry コンポーネントが実際に出力するテレメトリーを、上流のバージョンに固定してまとめたレジストリです。

注： これらのファイルに記載されたテレメトリーの出力は、上流ソースをLLMで分析して検出したものであり、誤りが含まれている可能性があります。重要な判断の根拠として行を利用する前に、コンポーネントのソースまたはドキュメントで確認してください。

構成

<repo basename>/<path in repo>/v<version>.md

例：opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md

スキャンしたバージョンごとに1ファイルあります。コンポーネントのディレクトリ内のファイルが、そのコンポーネントのテレメトリー履歴です。index.md にはすべてのファイルが一覧表示されています。まずここを確認して、どの範囲がカバーされているか確認してください。

指定したバージョンのコンポーネントを調べる

1. コンポーネントのディレクトリ（または index.md 内の該当する行）を探します。
2. 対象バージョンと完全に一致するファイルを選びます。
3. 完全に一致するファイルがない場合は、対象バージョンより前のバージョンのうち、最も新しいファイルを使用し、正確なバージョンは未検証であることを明記します。
4. コンポーネントまたはバージョンがまったくカバーされていない場合は、その旨を伝えます。セマンティック規約からテレメトリーを推測してはいけません。

データファイルの内容

フロントマター（repo、path、version、scope_name、commit_sha、last_verified）に続いて、シグナルごとのテーブルが記載されています。

• トレース — スパン名、種類、属性、注記
• メトリクス — メトリクス名、計測器の種類、単位、属性、注記
• ログ — ログ／イベント名、属性、注記

scope_name はコンポーネントのインストルメンテーションスコープであり、実行時のテレメトリーをコンポーネントと照合する際の基準となります。ヘルパーまたはパイプラインのテレメトリーで別のスコープが使われている場合は、その行の Notes にスコープ名が記載されています。 last_verified: null は、過去の検証日を裏付けられなかったことを意味します。行を検証済みとして提示する前に、固定されたソースを再確認してください。 存在しないシグナルは省略されています。Notes は、条件付きで出力されるテレメトリー（機能ゲート、オプトイン設定、実験的なセマンティック規約）を示します。Sources には、データの取得元である上流ファイルが一覧表示されています。