APIリファレンスOpenTelemetry
OpenTelemetryスパンリファレンス
Claude APIとClaude SDKが出力するOpenTelemetryのスパンとスパン属性。
エクスポートを設定するには、Claude SDKでOpenTelemetryを使用するおよびClaude APIでOpenTelemetryを使用するを参照してください。
スパン名と種類
| プロパティ | SDKスパン | APIスパン |
|---|---|---|
service.name | アプリケーションのservice.name | claude-platform |
| インストルメンテーションスコープ | com.anthropic.sdk.<language> または com.anthropic.sdk.cli（クラウドプラットフォームのクライアントではさらに .<platform> が付加）、およびパッケージのバージョン | com.anthropic.claude-platform |
| スパンの種類 | リクエストのスパンではCLIENT、それ以外ではINTERNAL | リクエストのスパンではSERVER、それ以外ではINTERNAL |
- リクエストのスパンは、そのリクエストのAPIメソッドの名前を持ちます。これは
anthropic.の後に、APIリファレンスにおけるメソッドのパスを、スラッシュの代わりにドットを使い、betaを除いた形で続けたものです。たとえば、client.beta.sessions.events.send()はセッションイベントを送信するリクエストを送信し、そのスパンの名前はanthropic.sessions.events.sendになります。 - ツールスパンは、固定の名前、スペース、ツール名で構成される名前を持ちます。たとえば
anthropic.tool_use bashです。
スパンのステータス
OK： ステップが完了しました。ERROR： ステップが失敗しました。- 未設定： アプリケーションがステップをキャンセルしました。たとえば、
user.interruptイベントを送信した場合です。
ストリームのスパンは、ストリームが終了したときに終了します。アプリケーションがストリームを早期に閉じた場合、SDKスパンのステータスは未設定になります。そのため、anthropic.sessions.events.streamのように完了しないストリームのSDKスパンは、ステータスが未設定またはERRORになります。
属性
属性は、該当するものが存在する場合、生成AI向けのOpenTelemetryセマンティック規約（gen_ai.*）を使用します。Anthropicの属性はanthropic.で始まります。スパンは、2026年9月24日のコミットe57c543b時点の規約に従います。この規約はまだ開発中です。
共通属性
リクエストのすべてのスパンは、説明に別途記載がある場合を除き、次の属性を持ちます。他のスパンは最初の3つの属性のみを持つことがあります。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.provider.name | string | anthropic。すべてのスパンに付与されます。SDK： Amazon Bedrockクライアント（Mantleを含む）では aws.bedrock、Google Cloud's Agent Platform用のクライアントではgcp.vertex_aiです。 |
anthropic.organization.id | string | 組織のID。 |
anthropic.workspace.id | string | 処理が実行されるワークスペースのID。 |
anthropic.request.id | string | request-idレスポンスヘッダーの値です。 |
http.request.method | string | リクエストのHTTPメソッド（例：POST）。 |
http.route | string | エンドポイントのパス。パスパラメーターはプレースホルダーで表されます（例：/v1/sessions/{session_id}）。 |
http.response.status_code | int | 最終レスポンスのHTTPステータスコード。ストリームの場合は、ヘッダーとともに送信されたステータスコードです。レスポンスがなかった場合は存在しません。 |
server.address | string | リクエストの送信先ホスト（例：api.anthropic.com）。 |
server.port | int | リクエストURLのポート。URLにポートがない場合はそのスキームのデフォルトポート。 |
url.scheme | string | URLのスキーム（例：https）。 |
url.path | string | URLのパス（例：/v1/messages）。 |
url.query | string | URLのクエリ文字列。エンドポイントで定義されているクエリパラメーターのみを含みます。該当するパラメーターがない場合は存在しません。 |
url.full | string | リクエストのURL。 |
server.address、server.port、url.full は含まれません。
セッション属性
Managed Agentsセッションでは、スパンは次の属性を持ちます。セッションのスパンは複数のトレースにまたがる場合があるため、トランスクリプトなどのセッションのビューを組み立てるには、これらのIDでスパンをグループ化してください。
| 属性 | 型 | 説明 |
|---|---|---|
anthropic.session.id | string | セッションID。anthropic.sessions.listなど、1つのセッションに作用しないメソッドのスパンには存在しません。 |
gen_ai.conversation.id | string | スパンが属するセッションスレッドのID。SDKのconversation_idオプションによって、独自の会話IDに置き換えられます。スレッドのないSDKのスパンには、オプションを設定しない限り存在せず、1つのスレッドへのリクエスト以外のSessions APIリクエストのAPIのスパンにも存在しません。 |
コンテンツ属性
Contentのタグが付いた属性は、SDKとAPIのどちらでも、コンテンツモードのスパンにのみ存在します。ガイドでコンテンツモードの違いを参照してください。このコンテンツが大きすぎる場合、SDKとAPIはコンテンツを短縮し、anthropic.content.truncatedをtrueに設定します。Anthropicのセーフガードがレスポンスからコンテンツを差し控えた場合、APIのスパンにもそのコンテンツは含まれません。
メッセージ属性は、OpenTelemetry GenAI規約のメッセージ形式によるJSON文字列です。Messages APIおよびagent.messageなどのManaged Agentsメッセージイベントにおいて、各Anthropicコンテンツブロックは1つのGenAI規約メッセージパートになります。
| Anthropicコンテンツブロック | GenAI規約メッセージパート |
|---|---|
text | text |
tool_use、server_tool_use | tool_call、computerなどのtoolset_nameを持つtool_useブロックの場合はanthropic_toolset_name付き |
mcp_tool_use | anthropic_mcp_server_nameを持つtool_call |
tool_result、mcp_tool_result、web_search_tool_resultなどのサーバーツールの結果ブロック | tool_call_response |
thinking | reasoning（thinkingブロックの署名は持たない）。agent.thinkingイベントには思考の内容が含まれないため、Managed Agentsのスパンには含まれない。 |
imageなどのその他のブロック | ブロックのtypeに接頭辞anthropic_を付けたもの（anthropic_imageなど）。このパートは、ほかのフィールドを持ちません。 |
Managed Agentsの各ツール使用イベントまたはツール結果イベントも、1つのGenAI規約メッセージパートになります。
| Managed Agentsイベント | GenAI規約メッセージパート |
|---|---|
agent.tool_use、agent.custom_tool_use | tool_call |
agent.mcp_tool_use | anthropic_mcp_server_nameを持つtool_call |
user.tool_result、user.custom_tool_result、agent.tool_result、agent.mcp_tool_result | tool_call_response |
トークン使用量
次のスパンはトークン使用量の属性を持ちます：anthropic.messages.create、anthropic.model_request、anthropic.compaction、anthropic.session.outcome_evaluation。値は、リクエスト、モデルリクエスト、コンパクションなど、各スパンのステップに対するものです。各トークンを1回だけカウントするには、ガイドのトークンのカウント方法を参照してください。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.usage.input_tokens | int | 入力トークン。キャッシュの読み取りと書き込みを含みます。 |
gen_ai.usage.output_tokens | int | 出力トークン。 |
gen_ai.usage.cache_write.input_tokens | int | プロンプトキャッシングのキャッシュに書き込まれたトークン。anthropic.session.outcome_evaluationスパンには存在しません。 |
anthropic.usage.cache_creation.ephemeral_5m_input_tokens | int | 5分間キャッシュに書き込まれたトークン。Messages APIリクエストのスパンにのみ存在します。ストリーミングレスポンスのSDKスパンでは、最初の出力トークンより前に書き込まれたトークンのみです。 |
anthropic.usage.cache_creation.ephemeral_1h_input_tokens | int | 1時間キャッシュに書き込まれたトークン。Messages APIリクエストのスパンにのみ存在します。ストリーミングレスポンスのSDKスパンでは、最初の出力トークンより前に書き込まれたトークンのみです。 |
gen_ai.usage.cache_read.input_tokens | int | プロンプトキャッシングのキャッシュから読み取られたトークン。anthropic.session.outcome_evaluationスパンには存在しません。 |
スパン
「span」（スパン）は、アプリケーション内のSDKから、またはAPIから出力されるため、このリファレンスの各スパンにはその出力元が記載されています。Messages API：またはManaged Agents：で始まる説明は、その製品のスパンに関するものです。SDK：やAPI：などの出力元で始まる属性の説明は、その出力元のスパンに関するものです。
anthropic.messages.create
- 出力元： SDKとAPI。
- 種類： SDKからは
CLIENT、APIからはSERVER。 - SDKスパンの親： アプリケーションがメソッドを呼び出した時点でアプリケーション内で現在のスパン。現在のスパンがない場合、親はありません。
- APIスパンの親： リクエストの
traceparentヘッダー内のスパン。リクエストがSDKから送信された場合はSDKスパンです。ヘッダーがない場合、APIスパンには親がありません。traceparentヘッダーの送信方法を参照してください。 - SDKスパンの子： そのリクエストのAPIのスパン。
- APIスパンの子： 各モデルリクエストの
anthropic.model_requestスパン、APIがリクエスト内で実行するサーバーツールまたはMCPコネクタツールの各使用のツールスパン、および各コンパクションのanthropic.compactionスパン。
SDKは、ストリーミングかどうかにかかわらず、各Messagesリクエストに対してこのスパンを出力します。
APIは、認証した各POST /v1/messagesリクエストに対してこのスパンを出力します。OpenAI互換エンドポイントであるPOST /v1/chat/completionsへのリクエストに対しては、このスパンを出力しません。
APIは、フォールバックモデルがリクエストを処理した場合でも、1つのリクエストに対して1つのスパンを出力します。
このスパンはトークン使用量の属性を持ちます。SDKスパンは、すべてのリクエストのSDKスパンの属性も持ちます。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.operation.name | string | chat |
gen_ai.request.model | string | リクエストのmodel。 |
gen_ai.response.id | string | レスポンスのid。 |
gen_ai.response.model | string | リクエストを処理したモデル。リクエストがモデルエイリアスを使用している場合や、フォールバックモデルがリクエストを処理した場合は、リクエストされたモデルと異なります。 |
anthropic.message.stop_reason | string | レスポンスのstop_reason。たとえばend_turnです。 |
anthropic.response.service_tier | string | リクエストを処理したサービスティア。レスポンスのusage.service_tierです。リクエストへのティアの割り当て方法を参照してください。 |
error.type | string | 失敗したリクエストのエラータイプ。たとえばrate_limit_errorです。SDK： リクエストのSDKスパンに記載されているその他の値も含みます。 API： APIがエラーレスポンスなしでリクエストを終了した場合は api_errorです。 |
gen_ai.response.time_to_first_chunk | double | ストリーミングレスポンスのSDKスパンにのみ存在します。SDKが最初にリクエストを送信してから、ストリームの最初のcontent_block_deltaイベント（存在する場合）までの秒数です。 |
gen_ai.usage.reasoning.output_tokens | int | レスポンスの思考トークン。出力トークンの一部です。レスポンスの使用量に出力トークンの詳細がない場合は存在しません。 |
anthropic.usage.compaction.input_tokens | int | リクエストのコンパクションの入力トークン。キャッシュの読み取りと書き込みを含みます。gen_ai.usage.input_tokensには含まれません。レスポンスにコンパクションがない場合は存在しません。 |
anthropic.usage.compaction.output_tokens | int | リクエストのコンパクションの出力トークン。gen_ai.usage.output_tokensには含まれません。レスポンスにコンパクションがない場合は存在しません。 |
gen_ai.request.max_tokens | int | リクエストのmax_tokens。 |
gen_ai.request.temperature | double | リクエストのtemperature。リクエストで設定されていない場合は存在しません。 |
gen_ai.request.top_p | double | リクエストのtop_p。リクエストで設定されていない場合は存在しません。 |
gen_ai.request.top_k | int | リクエストのtop_k。リクエストで設定されていない場合は存在しません。 |
gen_ai.request.stream | boolean | リクエストでstream: trueが設定されている場合はtrue。それ以外の場合は存在しません。 |
gen_ai.request.reasoning.level | string | リクエストのoutput_config内のeffort。リクエストで設定されていない場合は存在しません。 |
gen_ai.output.type | string | リクエストで出力形式がJSONに設定されている場合はjson。それ以外の場合は存在しません。 |
anthropic.request.service_tier | string | リクエストのservice_tier。リクエストで設定されていない場合は存在しません。 |
anthropic.thinking.type | string | リクエストのthinking.type。リクエストで設定されていない場合は存在しません。 |
anthropic.thinking.budget_tokens | int | リクエストのthinkingオブジェクト内のbudget_tokens。リクエストで設定されていない場合は存在しません。 |
anthropic.beta | string[] | SDKスパンにのみ存在します。リクエストのanthropic-betaヘッダー内のベータ名です。 |
gen_ai.system_instructions | string | Content OpenTelemetryのSystemInstructionsスキーマに従うJSON文字列。リクエストのsystemプロンプトです。 |
gen_ai.input.messages | string | Content OpenTelemetryのInputMessagesスキーマに従うJSON文字列。リクエストのmessagesです。 |
gen_ai.output.messages | string | Content OpenTelemetryのOutputMessagesスキーマに従うJSON文字列。レスポンスのcontentを1つのassistantメッセージとしたものです。SDK： ストリームでは、ストリームのトレースで説明されているとおりにアプリケーションがストリームを読み取った場合にのみ存在します。 |
gen_ai.request.stop_sequences | string[] | Content リクエストのstop_sequences。 |
リクエストのスパンは、web_search_requestsなどのレスポンスのサーバーツール使用回数を持ちません。代わりに、APIはサーバーツールの各使用に対してツールスパンを出力します。
anthropic.messages.count_tokens
- 出力元： SDK。APIは
POST /v1/messages/count_tokensに対してスパンを出力しません。 - 種類：
CLIENT。 - 親： アプリケーションがメソッドを呼び出した時点でアプリケーション内で現在のスパン。現在のスパンがない場合はなし。
- 子： なし。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.request.model | string | リクエストのモデル。 |
anthropic.message.count_tokens.input_tokens | int | レスポンス内のトークン数。このカウントは使用量ではありません。トークン使用量を合計する際には含めないでください。 |
anthropic.sessions.create
次の子と属性を除き、anthropic.sessions.<method>と同じです。
- SDKスパンの子： そのリクエストのAPIのスパン。
- APIスパンの子： リクエストに空でない
initial_eventsがある場合、最初のターンのanthropic.session.turnスパン。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.agent.id | string | セッションの作成元となったエージェントのID。 |
gen_ai.agent.name | string | そのエージェントの名前。 SDK： リクエストが失敗した場合は存在しません。 |
gen_ai.request.model | string | プライマリスレッドを実行する、そのエージェントのモデル。 SDK： リクエストが失敗した場合は存在しません。 |
anthropic.session.environment.id | string | セッションの環境のID。 |
anthropic.sessions.events.send
APIスパンの子を除き、anthropic.sessions.<method>と同じです。
- SDKスパンの子： そのリクエストに対するAPIのスパン。
- APIスパンの子： リクエストのイベントによって開始される各ターンの
anthropic.session.turnスパン。
anthropic.sessions.update
APIスパンの子を除き、anthropic.sessions.<method>と同じです。
- SDKスパンの子： そのリクエストに対するAPIのスパン。
- APIスパンの子： リクエストがセッション予算を引き上げるか削除したことによって再開される各ターンの
anthropic.session.turnスパン。
anthropic.session.turn
- 出力元： Managed AgentsセッションのAPI。
- 種類：
INTERNAL。 - 親： ターンが開始された理由によって異なります。
- 空でない
initial_eventsで作成されたセッションの最初のターンの場合、anthropic.sessions.createスパン。 - イベント（たとえば
user.messageイベント）によって開始されたターンの場合、そのイベントが送信されたリクエストのanthropic.sessions.events.sendスパン。 - リクエストによってセッション予算が引き上げられたか削除されたために再開されるターンの場合、
anthropic.sessions.updateスパン。 - 別のスレッド上のターンの場合、セッションが実行するエージェントのターンのうち、そのエージェントがこのターンを開始したターンの
anthropic.session.turnスパン。 - 別のスレッド上のエージェント（プライマリエージェントが呼び出したエージェントなど）が返信した、またはターンを終了したために開始されるターンの場合、なし。
- 空でない
- 子：
- ターン内の各モデルリクエストの
anthropic.model_requestスパン。 - APIがターン内でツールを実行するたびのツールスパン。ただし、ツールスパンのセクションに記載されているケースを除きます。
- このターン中にセッションが実行するエージェントが別のスレッドで開始した各ターンの
anthropic.session.turnスパン。 - このターンが開始するアウトカム評価の各イテレーションの
anthropic.session.outcome_evaluationスパン。
- ターン内の各モデルリクエストの
ターンは、そのスレッドがrunning状態に入ったときに開始し、スレッドがその状態を離れたときに終了します。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.operation.name | string | invoke_agent |
gen_ai.agent.id | string | ターンのスレッドを実行するエージェントのID。アドバイザースレッドには存在しません。 |
gen_ai.agent.name | string | そのエージェントの名前。アドバイザースレッドではanthropic.advisorです。 |
gen_ai.request.model | string | そのエージェントのモデル。アドバイザースレッドでは、アドバイザーのモデルです。 |
anthropic.session.turn.stop_reason | string | ターンが終了した理由。session.thread_status_idleイベントのstop_reason.typeで、たとえばrequires_actionです。スレッドがアイドル状態にならなかった場合は存在しません。 |
error.type | string | ターンが失敗した場合、ターンを終了させたsession.errorイベントのerror.type。 |
gen_ai.agent.description | string | そのエージェントの説明。アドバイザースレッドの場合、またはエージェントに説明がない場合は存在しません。 |
gen_ai.system_instructions | string | Content OpenTelemetryのSystemInstructionsスキーマに従うJSON文字列。ターンで有効なシステムプロンプトです。スレッドの最初のターンにのみ存在します。アドバイザースレッドには存在しません。 |
gen_ai.input.messages | string | Content OpenTelemetryのInputMessagesスキーマに従うJSON文字列。ターンの入力イベントで、ユーザーメッセージとツール結果、system.messageイベント、および他のスレッドからのメッセージです。アドバイザースレッドには存在しません。 |
gen_ai.output.messages | string | Content OpenTelemetryのOutputMessagesスキーマに従うJSON文字列。ターンの出力イベントで、エージェントのメッセージ、ツール使用、ツール結果です。 |
anthropic.model_request
- 出力元： Messages APIリクエストおよびManaged AgentsセッションのAPI。
- 種類：
INTERNAL。 - 親：
- Messages API： リクエストの
anthropic.messages.createスパン。 - Managed Agents： リクエストを行うターンの
anthropic.session.turnスパン。
- Messages API： リクエストの
- 子： なし。
Messages APIでは、各スパンはAPIリクエスト内の1つのモデルリクエストです。
このスパンはトークン使用量の属性を持ちます。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.operation.name | string | Managed Agentsセッションのスパンにのみ存在し、値はchatです。Messages APIでは、リクエストのanthropic.messages.createスパンがchatオペレーションです。 |
gen_ai.request.model | string | リクエストのモデル。 |
gen_ai.response.model | string | Messages APIリクエストのスパンにのみ存在します。モデルリクエストを実行したモデルです。 |
error.type | string | Messages API： このモデルリクエスト中にリクエストが失敗した場合、anthropic.messages.createスパンのerror.type。Managed Agents： モデルリクエストが失敗した場合、そのエラータイプ。たとえば rate_limit_errorです。モデルリクエストがレスポンスなしで失敗した場合はapi_errorです。 |
anthropic.tool_use、anthropic.mcp_tool_use、anthropic.custom_tool_use
- 出力元： SDKとAPI。
- 名前：
anthropic.tool_use <tool>、anthropic.mcp_tool_use <tool>、またはanthropic.custom_tool_use <tool>。<tool>はツールの名前です。 - 種類：
INTERNAL。 - SDKスパンの親： ツールが開始した時点でアプリケーション内で現在のスパン。Messagesツールランナーでは
anthropic.messages.tool_runnerスパンです。現在のスパンがない場合、親はありません。 - APIスパンの親：
- Messages API： APIがツールを実行するリクエストの
anthropic.messages.createスパン。 - Managed Agents： ツールが実行されるターンの
anthropic.session.turnスパン。user.tool_confirmationイベントを待機するツール使用の場合は、その確認によって開始されるターンです。 - 別のツールが実行するコードからのツール使用の場合は、そのツールのツールスパン。Messages APIでは、そのツールはコード実行ツールです。
- Messages API： APIがツールを実行するリクエストの
- SDKスパンの子： ツールのコードが開始するスパン。
- APIスパンの子： このツールが実行するコードからの各ツール使用のツールスパン。たとえば、コード実行ツールが実行するコードは
web_searchを使用する場合があります。
スパン名の接頭辞は、ツールの種類によって異なります。
anthropic.tool_use <tool>は、Messages APIでのサーバーツールの各使用、またはManaged Agentsのエージェントツールセットのツールの各使用のスパンです。エージェントツールセットのツールはAPIが実行しますが、セルフホスト型サンドボックスでは環境ワーカーが実行します。anthropic.mcp_tool_use <tool>は、SDK、Messages API、およびManaged AgentsでのMCPツールの各使用のスパンです。SDKでは、Messagesツールランナーまたはセッションツールランナーが実行するMCPヘルパーのツールです。Messages APIでは、ツールはMCPコネクターから提供されます。Managed Agentsでは、MCPサーバーへの接続が失敗した場合、スパン名にツール名は含まれません。anthropic.custom_tool_use <tool>は、アプリケーションが定義し、ツールランナーが実行するツールの各使用のスパンです。このスパンを出力するのはSDKのみです。
APIは次の場合にツールスパンを出力しません。
- モデルが、カスタムツールなど、アプリケーションが実行するツールの使用を要求した場合。SDKのツールランナーがツールを実行する場合は、ツールランナーがそのスパンを出力します。
- Managed Agents： エージェントがセルフホスト型サンドボックスで実行されるツールを使用した場合。ツールを実行するSDK内のワーカーがそのスパンを出力します。セルフホスト型サンドボックスのトレース方法を参照してください。
- Managed Agents： エージェントがマルチエージェントツールまたはアドバイザーツールを使用した場合。
- Managed Agents： エージェントがツールの使用を要求したものの、
auto権限ポリシーのもとでサーバーがその使用を拒否した場合、またはアプリケーションがuser.tool_confirmationイベントで拒否した場合。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.operation.name | string | execute_tool |
gen_ai.tool.name | string | ツールの名前。たとえばbashです。APIスパンでは、MCPツールの名前にサーバー名は含まれません。Managed Agentsでは、MCPサーバーへの接続が失敗した場合、モデルが生成した名前になり、コンテンツモードのスパンにのみ存在します。 |
gen_ai.tool.call.id | string | Messages API： モデルがツールの使用を要求したブロックのid。tool_use、server_tool_use、またはmcp_tool_useブロックです。Managed Agents： エージェントがツールの使用を要求したイベントのID。 agent.tool_use、agent.mcp_tool_use、またはagent.custom_tool_useイベントです。 |
anthropic.mcp.server.name | string | MCPツールのAPIスパンにのみ存在します。ツールのMCPサーバーの名前です。Messages APIでは、mcp_tool_useブロックのserver_nameです。 |
gen_ai.conversation.id | string | セッション属性で説明されているとおりのセッションスレッドID。Messagesツールランナーでは、conversation_idオプションで渡された会話IDで、渡されていない場合は存在しません。Messages APIリクエストのAPIスパンには存在しません。 |
anthropic.session.id | string | セッションのID。Messages APIやMessagesツールランナーなど、Managed Agentsセッション外でのツール使用には存在しません。 |
anthropic.session.thread.id | string | セッションツールランナーのSDKスパンにのみ存在します。セッションスレッドのIDです。プライマリスレッドでのツール使用には存在しません。 |
anthropic.tool.evaluated_permission | string | Managed AgentsセッションでAPIが出力するスパンにのみ存在します。ツール使用に対する権限ポリシーの評価結果で、allowまたはaskです。 |
error.type | string | ツール使用が失敗した場合のエラータイプ。ツールのコードがエラーを発生させた場合、またはツールがエラー結果を返した場合はtool_errorです。API： Messages APIでは、サーバーツールのエラー結果は代わりにその error_codeを持ちます。たとえばmax_uses_exceededです。Managed Agentsでは、MCPサーバーへの接続が失敗した場合、認証が失敗したときはmcp_authentication_failed_error、それ以外はmcp_connection_failed_errorです。ツール使用中にリクエストが失敗した場合は、リクエストのエラータイプです。 |
gen_ai.tool.description | string | SDKスパンにのみ存在します。ツール定義内の説明です。説明が空の場合は存在しません。 |
gen_ai.tool.type | string | SDKスパンにのみ存在します。function |
gen_ai.tool.call.arguments | string | Content OpenTelemetryのToolCallArgumentsスキーマに従うJSON文字列。ツール使用のinputです。 |
anthropic.tool_result.content | string | Content コンテンツブロックの配列または1つのオブジェクトを含むJSON文字列。モデルに返されるツール結果のcontentです。エラー結果の場合も存在しますが、Managed AgentsでMCPサーバーへの接続が失敗した場合は除きます。API： Messages APIでは、文字列の contentは1つのtextブロックを含む配列になります。 |
anthropic.compaction
- ソース： Messages APIリクエストの場合はAPI。
- 種類：
INTERNAL。 - 親： リクエストの
anthropic.messages.createスパン。 - 子： なし。
このスパンには、コンパクションのトークン使用量属性があります。anthropic.messages.createでは、コンパクションの使用量はgen_ai.usage.*の合計ではなく、anthropic.usage.compaction.*属性に含まれます。
| 属性 | 型 | 説明 |
|---|---|---|
error.type | string | コンパクション中にリクエストが失敗した場合の、リクエストのエラータイプ。 |
anthropic.session.outcome_evaluation
- ソース： Managed Agentsセッションの場合はAPI。
- 種類：
INTERNAL。 - 親： イテレーションを開始したターンの
anthropic.session.turnスパン。そのターンがイテレーションより前に終了した場合も同様です。 - 子： なし。
ステータスは、結果がinterruptedの場合は未設定となり、それ以外の結果の場合はOKとなります。
このスパンには、トークン使用量属性のうち2つ、gen_ai.usage.input_tokensとgen_ai.usage.output_tokensがあります。
| 属性 | 型 | 説明 |
|---|---|---|
anthropic.session.outcome.id | string | イテレーションが評価するアウトカムのID。 |
anthropic.session.outcome_evaluation.result | string | イテレーションの結果：satisfied、needs_revision、max_iterations_reached、failed、またはinterrupted。 |
anthropic.session.outcome_evaluation.iteration | int | イテレーション番号。 |
anthropic.session.outcome_evaluation.explanation | string | Content グレーダーによる結果の説明（プレーンテキスト）。 |
anthropic.messages.tool_runner
- ソース： SDK。
- 種類：
INTERNAL。 - 親： ループ開始時にアプリケーションで現在アクティブなスパン。現在アクティブなスパンがない場合はなし。
- 子： ループ内の各リクエストの
anthropic.messages.createスパンと、ランナーが実行する各ツール使用のツールスパン。
このスパンはループとともに終了します。アプリケーションがランナーを停止した場合、ステータスは未設定となります。ツールのコードがエラーを発生させた場合、そのツールスパンのステータスはERRORとなり、ループは継続します。このスパンには使用量属性がないため、使用量は子のanthropic.messages.createから読み取ってください。
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.operation.name | string | invoke_agent |
gen_ai.request.model | string | ループ内の最初のリクエストのモデル。 |
gen_ai.conversation.id | string | conversation_idオプションで渡された会話ID。指定がない場合は存在しません。 |
error.type | string | ループが失敗した場合の、ループを終了させたリクエストのエラータイプ。ランナー自体が失敗した場合はclient_error。 |
gen_ai.output.type | string | リクエストが出力形式をJSONに設定している場合はjson。それ以外の場合は存在しません。 |
anthropic.messages.batches.<method>
- ソース： すべてのMessage BatchesメソッドについてはSDK。
- 種類：
CLIENT。 - 親： アプリケーションがメソッドを呼び出す時点で現在アクティブなスパン。現在アクティブなスパンがない場合はなし。
- 子： なし。
これらのスパンには、すべてのリクエストのSDKスパンの属性もあります。
| 属性 | 型 | 説明 |
|---|---|---|
anthropic.message.batch.id | string | メソッドが対象とするバッチのID。createの場合は新しいバッチのID。listおよび失敗したcreateでは存在しません。 |
anthropic.message.batch.request_count | int | createのみ。requests配列内の項目数。 |
anthropic.sessions.<method>
- ソース： SDKおよびAPI。
- 種類： SDKからは
CLIENT、APIからはSERVER。 - SDKスパンの親： アプリケーションがメソッドを呼び出す時点で現在アクティブなスパン。現在アクティブなスパンがない場合はなし。
- APIスパンの親： リクエストの
traceparentヘッダー内のスパン。リクエストがSDKから送信された場合はSDKスパンとなり、ヘッダーがない場合はなし。 - SDKスパンの子： そのリクエストに対するAPIのスパン。
- APIスパンの子： なし。
APIは、Sessions APIのエンドポイントへの認証済みリクエストごとにanthropic.sessions.<method>スパンを出力します。Claude Consoleで送信されたメッセージや、スケジュールされたデプロイメントが開始するセッションなど、プラットフォームがユーザーに代わって送信するリクエストにもスパンがあり、それぞれ新しいトレース内に作成されます。
このスパンにはセッション属性があります。SDKスパンには、すべてのリクエストのSDKスパンの属性もあります。
| 属性 | 型 | 説明 |
|---|---|---|
error.type | string | 失敗したリクエストのエラータイプ。例：rate_limit_error。SDK： リクエストのSDKスパンのその他の値も含みます。 API： APIがエラーレスポンスなしで接続を閉じた場合、またはAPIの障害によりストリームが終了した場合は api_error。 |
anthropic.environment.work
- ソース： CLI、およびPython、TypeScript、GoのSDK。
- 種類：
INTERNAL。 - 親： 環境ワーカーまたはワークポーラーがワークアイテムを取得する時点でアプリケーションで現在アクティブなスパン。現在アクティブなスパンがない場合はなし。
ant beta:worker pollでは、このスパンはルートスパンです。 - 子： 環境ワーカーがワークアイテムを処理する間に送信するリクエストのスパンと、ワークアイテムのために実行する各ツールのツールスパン。
環境ワーカーとワークポーラーは、セルフホスト型サンドボックスでワークアイテムを取得するSDKヘルパーです。これらは、ポーリングがワークアイテムを返した時点からその処理が終了するまで、ワークアイテムごとに1つのanthropic.environment.workスパンを出力します。
| 属性 | 型 | 説明 |
|---|---|---|
anthropic.environment.id | string | 環境のID。 |
anthropic.environment.work.id | string | ワークアイテムのID。 |
anthropic.session.id | string | ワークアイテムが属するセッションのID。 |
error.type | string | リクエストによって処理が終了した場合の、失敗したリクエストのスパンのerror.type。その他の失敗の場合はclient_error。 |
anthropic.<resources>.<method>
- ソース： SDK。
- 種類：
CLIENT。 - 親： アプリケーションがメソッドを呼び出す時点で現在アクティブなスパン。現在アクティブなスパンがない場合はなし。
- 子： なし。
リクエストを送信し、このページにセクションがない各SDKメソッドは、anthropic.<resources>.<method>スパンを出力します。例：anthropic.models.listやanthropic.files.upload。リストの後続ページごとのリクエストには、それぞれ独自のスパンがあります。
スパンはリトライを含むリクエスト全体をカバーし、SDKが値を持っている場合は、同じ名前のAPIのスパンの各属性を持ちます。SDKはスパンの開始時にhttp.request.methodとhttp.routeを設定するため、サンプラーはそれらを使用できます。
anthropic.messages.create、anthropic.messages.count_tokens、anthropic.messages.batches.<method>を含む、すべてのリクエストに対するSDKスパンには、次の属性があります：
| 属性 | 型 | 説明 |
|---|---|---|
gen_ai.conversation.id | string | conversation_idオプションで渡された会話ID。指定がない場合、セッション属性に記載されているManaged AgentsリクエストではセッションスレッドIDとなり、その他のリクエストでは存在しません。 |
anthropic.<resource>.id | string | リクエストのパス内の各IDにつき1つの属性と、メソッドが作成するオブジェクトのIDにつき1つの属性。名前はパスから単数形で取られます。例：anthropic.session.idやanthropic.session.thread.id。 |
gen_ai.agent.id | string | エージェントメソッドにおける、エージェントのID。 |
gen_ai.memory.store.id | string | メモリストアメソッドにおける、メモリストアのID。 |
gen_ai.memory.record.id | string | メモリメソッドにおける、メモリのID。 |
http.request.resend_count | int | リトライなど、何らかの理由でSDKがリクエストを再送信した回数。SDKが再送信しなかった場合は存在しません。 |
error.type | string | 失敗した呼び出しのエラータイプ。例：rate_limit_error。エラーレスポンスにエラータイプがない場合はHTTPステータスコード（例：502）。SDK内で呼び出しが失敗した場合はconnection_error、client_timeout_error、またはclient_error。サーバーがストリームを早期に終了した場合はapi_error。 |
server.address | string | クライアントのベースURLのホスト。デフォルトはapi.anthropic.com。クラウドプラットフォームのクライアントでは、そのプラットフォームのホスト。 |
url.query | string | エンドポイントが定義するクエリパラメータのみを含む、URLのクエリ文字列。該当するものがない場合は存在しません。メタデータのみモードでは、クエリにemailなどの機密パラメータが含まれる場合は存在しません。 |
url.full | string | url.scheme、server.address、ベースURLにポートがある場合はそのポート、url.path、url.queryから構成されるURL。メタデータのみモードでは、そのモードがurl.queryを除外する場合は常に存在しません。 |
Was this page helpful?