GenAIセマンティック規約は何を標準化しますか？

LLM操作がgen_ai.*属性によって記録される方式を標準化しています。モデル名、入力トークンカウント、出力トークンカウント、終了理由（モデルが停止した理由）、操作タイプ（chat、execute_tool、invoke_agent、embeddings）、プロバイダー名、エージェント名とツール名、そしてオプションで完全なプロンプトとレスポンスコンテンツが含まれます。

これらの規約は任意の可観測性バックエンドで使用できますか？

はい。規約はOTLPをネイティブに発行するため、Jaeger、Grafana Tempo、OpenTelemetry Collector、ベンダーエージェント、またはガイドで使用されているオープンソース可観測性エンジンのIceGateを含む任意のOTLPバックエンドが機能します。計装を変更することなく後でバックエンドを切り替えることができます。

破壊的な変更の可能性はありますか？

はい。GenAI規約は開発段階（Development status）であり、ほとんどの属性は実験的なため、チームは計装バージョンをピン止めし、仕様が確定するにつれて時折破壊的な変更が起こることを想定すべきです。環境変数OTEL_SEMCONV_STABILITY_OPT_INはプロセス開始前に設定する必要があり、最新の実験的規約にオプトインします。設定されない場合はデフォルトのv1.30名が使用されます。

AIコーディング大規模言語モデルHacker News2026年7月30日2026年7月31日 6:005分で読める

OpenTelemetryがLLMエージェント向けに標準トレーシング機能を追加

LINEで送る

要点

OpenTelemetryはLLM操作のトレーシング用に標準セマンティック規約を定義しました。
これはモデル呼び出し、トークンカウント、終了理由、ツール呼び出しにまたがり、主要なクラウドベンダーと可観測性企業の支援を受けています。
この規約により開発者はLLMエージェントを一度だけ計装し、ベンダーロックインを回避しながら、LLM呼び出しが従来の可観測性ツールに対して不透明だった問題を埋めることができます。

3つのポイント

何が起きたか
OpenTelemetryのGenAIセマンティック規約により、gen_ai.*属性やchat、execute_tool、invoke_agentなどのスパンタイプを含む共有語彙が定義され、Amazon、Elastic、Google、IBM、Microsoft、Datadog、Langtrace、OpenLIT、Scorecard、Traceloopなどのベンダーがこれを実装することに合意しました。この規約は開発段階（Development status）であり、open-telemetry/semantic-conventions-genaiリポジトリで公開されています。
なぜ重要か
LLM呼び出しは従来、可観測性ツールにとってブラックボックスでした。遅いリクエストが見えてもどのモデルが実行されたのか、何トークン消費したのか、エージェントがツール上でループしたのかは不明でした。標準規約により、チームはgen_ai.*テレメトリを使って一度だけ計装し、その後OTLPバックエンドを切り替える際に計装コードに触れることなく、ベンダー非依存のデータを保つことができます。
注目点
GenAI規約はまだ実験的段階であり、仕様が確定するにつれて時折破壊的な変更が予想されるため、チームは計装バージョンをピン止めすべきです。このガイドではPythonでopentelemetry-instrumentを使用したゼロコード自動計装と、エージェント・ツール構造、トークン使用量、マルチターン会話のための手動スパン作成を示しており、実行可能なレシピは統合クックブックで利用できます。

この記事についてAIに質問する →

こういう要約が、毎朝あなたのメールに届きます。

こうしたAIニュースを毎朝無料で受け取る LINEで友だち追加して受け取る

背景と解説

OpenTelemetryによるGenAIセマンティック規約の採用は、LLM操作から可観測性シグナルを発行する方法に関する業界初の統一合意を表しています。ハイパースケーラー（Amazon、Google、Microsoft）、インフラストラクチャベンダー（Elastic、IBM、Datadog）、LLM特化の可観測性スタートアップ（Langtrace、OpenLIT、Traceloop）にまたがる作業グループのメンバーシップは、最終化前にスキーマが広範なコンセンサスを得ていることを示し、初期採用者のリスクを低減しています。

実用的な利点は計装とバックエンド選択の分離にあります。従来の可観測性ではチームはベンダー固有のSDKに書き込み、バックエンドを切り替えるには計装の書き直しが必要でした。ポータブルなgen_ai.*テレメトリにより、同じスパン発行がJaeger、Datadog、IceGate、または任意のOTLP互換レシーバー全体で機能します。これはOpenTelemetryのより広い使命（チームが可観測性データを所有し、ロックインを回避できるようにすること）と一致していますが、モデル呼び出し、トークン消費、エージェントループが従来の標準トレーシングツールに対して不可視だったLLM可観測性の固有のギャップに対処しています。

開発段階と実験的属性の指定は、仕様がまだ確定していることを反映しています。早期採用するチームは計装パッケージのバージョンをピン止めし、open-telemetry/semantic-conventions-genaiリポジトリの変更を監視する必要があります。特に環境変数OTEL_SEMCONV_STABILITY_OPT_INの周辺で注視が必要です。これは計装が最新の実験的名前を発行するか凍結されたv1.30デフォルトを使用するかを制御します。

よくある質問

GenAIセマンティック規約は何を標準化しますか？: LLM操作がgen_ai.*属性によって記録される方式を標準化しています。モデル名、入力トークンカウント、出力トークンカウント、終了理由（モデルが停止した理由）、操作タイプ（chat、execute_tool、invoke_agent、embeddings）、プロバイダー名、エージェント名とツール名、そしてオプションで完全なプロンプトとレスポンスコンテンツが含まれます。
これらの規約は任意の可観測性バックエンドで使用できますか？: はい。規約はOTLPをネイティブに発行するため、Jaeger、Grafana Tempo、OpenTelemetry Collector、ベンダーエージェント、またはガイドで使用されているオープンソース可観測性エンジンのIceGateを含む任意のOTLPバックエンドが機能します。計装を変更することなく後でバックエンドを切り替えることができます。
破壊的な変更の可能性はありますか？: はい。GenAI規約は開発段階（Development status）であり、ほとんどの属性は実験的なため、チームは計装バージョンをピン止めし、仕様が確定するにつれて時折破壊的な変更が起こることを想定すべきです。環境変数OTEL_SEMCONV_STABILITY_OPT_INはプロセス開始前に設定する必要があり、最新の実験的規約にオプトインします。設定されない場合はデフォルトのv1.30名が使用されます。

Hacker News元記事を読む

LINEで送る