OpenTelemetryの取り込みリファレンス

このページは、AmplitudeのOTLPエンドポイントがOpenTelemetry GenAIスパンをエージェント分析[Agent]イベントにどのように変換するかを示すリファレンスです。設定手順については、OpenTelemetryトレースをエージェント分析に送信するを参照してください。

エンドポイントとプロトコル

  • プロトコル:OTLP over HTTPのみ。http/protobufまたはhttp/jsonで、オプションでgzip可能。AmplitudeはOTLP/gRPCをサポートしていません。
  • 認証:プロジェクトのAPIキーをBearerトークンとして、またはapi_keyクエリパラメータとして指定します。Amplitudeは、プロジェクトごとの有効化リクエストを必要としません。
  • サポートされているインストルメンテーション:OpenTelemetry GenAIのセマンティック規約、OpenInference(llm.*)、OpenLLMetryとTraceloop(traceloop.*)、OpenLIT、LiteLLM。Amplitudeは、GenAI以外のスパンを無視します。

属性の解決順序

Amplitudeは、存在する最初の属性をこの順序で読み取ります。

何が何にマップされるか

Amplitudeは、gen_ai.usage.costが不在の場合にコストを計算しません。コストの計算方法を参照してください。

チャット呼び出しはプロンプト履歴全体を再送信するため、最後のアシスタントメッセージの後のユーザーメッセージのみが新しいになります[Agent] User Message。 Amplitudeはリプレイされた履歴を再出力しません。また、新しい入力がツールの結果であるtool-loopの継続は、ユーザーのTurnを生成しません。

AI SDKのプロセス内OpenTelemetryエクスポータは、独自のマッピングを使用しています。SDKリファレンスのOpenTelemetry属性マッピングを参照してください。

機能フラグの属性

Amplitudeは、GenAIスパンからOpenTelemetry機能フラグの評価を読み取り、それぞれを実験として記録します。 まずすべてのfeature_flag.evaluationスパンイベントを読み取り、次にスパン自身のfeature_flag.*属性を読み取ります。リソース属性はカウントされません。

このスパンが生成するすべてのイベントには[Agent] Experimentsが含まれ、評価がちょうど1つ残っている場合は、さらに[Agent] Experiment Key、Variant、Unit、Providerも含まれます。エラーを返したようなバリアントのない評価では、何も追加されません。 2つの評価がキーを共有している場合、後者の方が勝ちます。そのため、span属性は同じキーを持つspanイベントを上書きします。 検証ルールと10個の実験制限は、AI SDKと一致します。 Agent Analyticsの実験バリアントの記録を参照してください。

Claude Platformのスパン

Amplitudeは、スパン名がanthropic.で始まり、スパンに、gen_ai.provider.name=anthropic、com.anthropic.claude-platformまたはcom.anthropic.sdkインストルメンテーションスコープ、またはリソースservice.name=claude-platformも含まれる場合にのみ、これらのルールを適用します。 汎用invoke_agentスパンと、その他の名前を持つAnthropicチャットスパンは上記のマッピングに残ります。

gen_ai.response.finish_reasonsが存在しない場合、anthropic.message.stop_reason、ついでanthropic.session.turn.stop_reasonがAIレスポンス上の[Agent] Finish Reasonになります。Amplitudeはenduser.idまたはgen_ai.usage.costを発明しません。親スパンIDは階層を維持します。それらは[Agent] Parent Agent IDではありません。

送信先を追加するには、Send Claude Platformのトレースを参照してください。

配信、制限、およびレスポンス

配信は少なくとも1回です。永続的な送信キューを使用してコレクタを実行し、再試行は有効なままにします。メモリ内キューは、再起動時にバッファリングされたスパンを失います。

OTLPレシーバーは決して403を返しません。CDNやWAFなどの別のホップからのものは、Amplitudeが有効になっていないの403ではなく、設定エラーとして扱ってください。

これは役に立ちましたか?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

このページでは