Referensi span OpenTelemetry

Span OpenTelemetry dan atribut span yang dipancarkan oleh Claude API dan Claude SDK.

Untuk menyiapkan ekspor, lihat Menggunakan OpenTelemetry dengan Claude SDK dan Menggunakan OpenTelemetry dengan Claude API.

Nama dan jenis span

Properti	Span SDK	Span API
`service.name`	`service.name` dari aplikasi	`claude-platform`
Cakupan instrumentasi	`com.anthropic.sdk.<language>` atau `com.anthropic.sdk.cli`, ditambah `.<platform>` pada klien platform cloud, beserta versi paketnya	`com.anthropic.claude-platform`
Jenis span	`CLIENT` pada span untuk sebuah permintaan, `INTERNAL` untuk lainnya	`SERVER` pada span untuk sebuah permintaan, `INTERNAL` untuk lainnya

Span untuk permintaan memiliki nama metode API dari permintaan tersebut: anthropic. diikuti oleh path metode dalam referensi API, dengan titik sebagai pengganti garis miring dan tanpa beta. Misalnya, client.beta.sessions.events.send() mengirim permintaan untuk mengirim event sesi, dan span-nya memiliki nama anthropic.sessions.events.send.
Span alat memiliki nama tetap, sebuah spasi, dan nama alat, misalnya anthropic.tool_use bash.

Status span

OK: Langkah selesai.
ERROR: Langkah gagal.
Tidak diatur (unset): Aplikasi membatalkan langkah tersebut, misalnya ketika aplikasi mengirim event user.interrupt.

Span dari sebuah stream berakhir ketika stream berakhir. Jika aplikasi menutup stream lebih awal, span SDK memiliki status tidak diatur, sehingga span SDK dari stream yang tidak pernah selesai, seperti anthropic.sessions.events.stream, memiliki status tidak diatur atau ERROR.

Atribut

Atribut menggunakan konvensi semantik OpenTelemetry untuk AI generatif (gen_ai.*) jika tersedia. Atribut Anthropic diawali dengan anthropic.. Span mengikuti konvensi pada commit e57c543b tanggal 24 September 2026. Konvensi tersebut masih dalam pengembangan.

Atribut umum

Setiap span untuk sebuah permintaan memiliki atribut berikut, kecuali jika deskripsinya menyatakan lain. Span lain hanya dapat memiliki tiga atribut pertama:

Atribut	Tipe	Deskripsi
`gen_ai.provider.name`	`string`	`anthropic`. Ada di setiap span. SDK: `aws.bedrock` pada klien Amazon Bedrock (termasuk Mantle) dan `gcp.vertex_ai` pada klien untuk Google Cloud's Agent Platform.
`anthropic.organization.id`	`string`	ID organisasi.
`anthropic.workspace.id`	`string`	ID workspace tempat pekerjaan dijalankan.
`anthropic.request.id`	`string`	Nilai header respons `request-id`.
`http.request.method`	`string`	Metode HTTP dari permintaan, misalnya `POST`.
`http.route`	`string`	Path dari endpoint, dengan placeholder untuk parameter path-nya, misalnya `/v1/sessions/{session_id}`.
`http.response.status_code`	`int`	Kode status HTTP dari respons akhir. Untuk stream, kode status yang dikirim bersama header. Tidak ada jika tidak ada respons.
`server.address`	`string`	Host tujuan pengiriman permintaan, misalnya `api.anthropic.com`.
`server.port`	`int`	Port dari URL permintaan, atau port default dari skemanya ketika URL tidak memilikinya.
`url.scheme`	`string`	Skema dari URL, misalnya `https`.
`url.path`	`string`	Path dari URL, misalnya `/v1/messages`.
`url.query`	`string`	Query string dari URL, hanya berisi parameter query yang didefinisikan oleh endpoint. Tidak disertakan ketika tidak ada parameter tersebut.
`url.full`	`string`	URL permintaan.

Di Claude Platform on AWS, span API tidak memiliki server.address, server.port, atau url.full.

Atribut sesi

Dalam sesi Managed Agents, span memiliki atribut berikut. Span dari sebuah sesi dapat berada di lebih dari satu trace, jadi untuk menyusun tampilan sesi, seperti transkrip, kelompokkan span-nya berdasarkan ID ini.

Atribut	Tipe	Deskripsi
`anthropic.session.id`	`string`	ID sesi. Tidak ada pada span dari metode yang tidak bekerja pada satu sesi, seperti `anthropic.sessions.list`.
`gen_ai.conversation.id`	`string`	ID thread sesi tempat span berada. Opsi `conversation_id` SDK menggantinya dengan ID percakapan Anda sendiri. Tidak ada pada span SDK tanpa thread kecuali Anda mengatur opsi tersebut, dan pada span API untuk permintaan Sessions API selain permintaan ke satu thread.

Atribut konten

Atribut yang ditandai dengan Content hanya ada pada span dalam mode konten, baik dari SDK maupun API. Lihat perbedaan mode konten dalam panduan. Ketika konten ini terlalu besar, SDK dan API memperpendeknya dan mengatur anthropic.content.truncated ke true. Jika pengamanan Anthropic menahan konten dari respons, span API juga tidak menyertakannya.

Atribut pesan adalah string JSON dalam format pesan dari konvensi GenAI OpenTelemetry. Setiap blok konten Anthropic menjadi satu bagian pesan konvensi GenAI, pada Messages API dan dalam event pesan Managed Agents seperti agent.message:

Blok konten Anthropic	Bagian pesan konvensi GenAI
`text`	`text`
`tool_use`, `server_tool_use`	`tool_call`, dengan `anthropic_toolset_name` untuk blok `tool_use` yang memiliki `toolset_name`, seperti `computer`
`mcp_tool_use`	`tool_call` dengan `anthropic_mcp_server_name`
`tool_result`, `mcp_tool_result`, blok hasil dari alat server seperti `web_search_tool_result`	`tool_call_response`
`thinking`	`reasoning`, tanpa signature dari blok `thinking`. Tidak ada dalam span Managed Agents, karena event `agent.thinking` tidak menyertakan konten pemikiran.
Blok lainnya, seperti `image`	`type` dari blok tersebut dengan awalan `anthropic_`, seperti `anthropic_image`. Bagian tersebut tidak memiliki field lain.

Setiap event penggunaan alat atau hasil alat Managed Agents juga menjadi satu bagian pesan konvensi GenAI:

Event Managed Agents	Bagian pesan konvensi GenAI
`agent.tool_use`, `agent.custom_tool_use`	`tool_call`
`agent.mcp_tool_use`	`tool_call` dengan `anthropic_mcp_server_name`
`user.tool_result`, `user.custom_tool_result`, `agent.tool_result`, `agent.mcp_tool_result`	`tool_call_response`

Penggunaan token

Span berikut memiliki atribut penggunaan token: anthropic.messages.create, anthropic.model_request, anthropic.compaction, dan anthropic.session.outcome_evaluation. Nilainya adalah untuk langkah dari span tersebut, misalnya permintaan, permintaan model, atau compaction. Untuk menghitung setiap token satu kali, lihat cara menghitung token dalam panduan.

Atribut	Tipe	Deskripsi
`gen_ai.usage.input_tokens`	`int`	Token input, termasuk pembacaan dan penulisan cache.
`gen_ai.usage.output_tokens`	`int`	Token output.
`gen_ai.usage.cache_write.input_tokens`	`int`	Token yang ditulis ke cache prompt. Tidak ada pada span `anthropic.session.outcome_evaluation`.
`anthropic.usage.cache_creation.ephemeral_5m_input_tokens`	`int`	Token yang ditulis ke cache 5 menit. Hanya pada span untuk permintaan Messages API. Pada span SDK dari respons streaming, hanya token yang ditulis sebelum token output pertama.
`anthropic.usage.cache_creation.ephemeral_1h_input_tokens`	`int`	Token yang ditulis ke cache 1 jam. Hanya pada span untuk permintaan Messages API. Pada span SDK dari respons streaming, hanya token yang ditulis sebelum token output pertama.
`gen_ai.usage.cache_read.input_tokens`	`int`	Token yang dibaca dari cache prompt. Tidak ada pada span `anthropic.session.outcome_evaluation`.

Span

Sebuah span dapat berasal dari SDK di aplikasi atau dari API, sehingga setiap span dalam referensi ini mencantumkan sumbernya. Deskripsi yang diawali dengan Messages API: atau Managed Agents: berlaku untuk span dari produk tersebut. Deskripsi atribut yang diawali dengan sumber, seperti SDK: atau API:, berlaku untuk span dari sumber tersebut.

`anthropic.messages.create`

Sumber: SDK dan API.
Jenis: CLIENT dari SDK, SERVER dari API.
Induk dari span SDK: Span yang sedang aktif di aplikasi ketika aplikasi memanggil metode tersebut. Jika tidak ada span yang aktif, tidak ada induk.
Induk dari span API: Span dalam header traceparent dari permintaan, yang merupakan span SDK ketika permintaan berasal dari SDK. Tanpa header tersebut, span API tidak memiliki induk. Lihat cara mengirim header traceparent.
Anak dari span SDK: Span API untuk permintaan tersebut.
Anak dari span API: Span anthropic.model_request untuk setiap permintaan model, span alat untuk setiap penggunaan alat server atau alat MCP connector yang dijalankan API dalam permintaan tersebut, dan span anthropic.compaction untuk setiap compaction.

SDK memancarkan span ini untuk setiap permintaan Messages, baik di-stream maupun tidak.

API memancarkan span ini untuk setiap permintaan POST /v1/messages yang diautentikasinya. API tidak memancarkan span untuk permintaan ke endpoint yang kompatibel dengan OpenAI, POST /v1/chat/completions.

API memancarkan satu span untuk sebuah permintaan, bahkan ketika model fallback melayaninya.

Span ini memiliki atribut penggunaan token. Span SDK juga memiliki atribut dari setiap span SDK untuk permintaan.

Atribut	Tipe	Deskripsi
`gen_ai.operation.name`	`string`	`chat`
`gen_ai.request.model`	`string`	`model` dari permintaan.
`gen_ai.response.id`	`string`	`id` dari respons.
`gen_ai.response.model`	`string`	Model yang melayani permintaan. Berbeda dari model yang diminta ketika permintaan menggunakan alias model, atau ketika model fallback melayani permintaan.
`anthropic.message.stop_reason`	`string`	`stop_reason` dari respons, misalnya `end_turn`.
`anthropic.response.service_tier`	`string`	Tingkat layanan yang melayani permintaan: `usage.service_tier` dari respons. Lihat bagaimana permintaan ditetapkan ke tingkat layanan.
`error.type`	`string`	Tipe error dari permintaan yang gagal, misalnya `rate_limit_error`. SDK: Juga nilai-nilai lain dalam span SDK untuk permintaan. API: `api_error` ketika API mengakhiri permintaan tanpa respons error.
`gen_ai.response.time_to_first_chunk`	`double`	Hanya pada span SDK dari respons streaming. Jumlah detik sejak SDK pertama kali mengirim permintaan hingga event `content_block_delta` pertama dari stream, jika ada.
`gen_ai.usage.reasoning.output_tokens`	`int`	Token thinking dari respons. Token ini merupakan bagian dari token output. Tidak ada jika penggunaan dari respons tidak memiliki rincian untuk token output.
`anthropic.usage.compaction.input_tokens`	`int`	Token input dari compaction permintaan, termasuk pembacaan dan penulisan cache. Bukan bagian dari `gen_ai.usage.input_tokens`. Tidak ada jika respons tidak memiliki compaction.
`anthropic.usage.compaction.output_tokens`	`int`	Token output dari compaction permintaan. Bukan bagian dari `gen_ai.usage.output_tokens`. Tidak ada jika respons tidak memiliki compaction.
`gen_ai.request.max_tokens`	`int`	`max_tokens` dari permintaan.
`gen_ai.request.temperature`	`double`	`temperature` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`gen_ai.request.top_p`	`double`	`top_p` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`gen_ai.request.top_k`	`int`	`top_k` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`gen_ai.request.stream`	`boolean`	`true` ketika permintaan mengatur `stream: true`. Tidak ada jika sebaliknya.
`gen_ai.request.reasoning.level`	`string`	`effort` dalam `output_config` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`gen_ai.output.type`	`string`	`json` ketika permintaan mengatur format output ke JSON. Tidak ada jika sebaliknya.
`anthropic.request.service_tier`	`string`	`service_tier` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`anthropic.thinking.type`	`string`	`thinking.type` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`anthropic.thinking.budget_tokens`	`int`	`budget_tokens` dalam objek `thinking` dari permintaan. Tidak ada jika permintaan tidak mengaturnya.
`anthropic.beta`	`string[]`	Hanya pada span SDK. Nama-nama beta dalam header `anthropic-beta` dari permintaan.
`gen_ai.system_instructions`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `SystemInstructions`. Prompt `system` dari permintaan.
`gen_ai.input.messages`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `InputMessages`. `messages` dari permintaan.
`gen_ai.output.messages`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `OutputMessages`. `content` dari respons, sebagai satu pesan `assistant`. SDK: Pada stream, hanya ketika aplikasi membaca stream seperti yang dijelaskan dalam Penelusuran stream.
`gen_ai.request.stop_sequences`	`string[]`	Content `stop_sequences` dari permintaan.

Span untuk sebuah permintaan tidak memiliki jumlah penggunaan alat server dari respons, seperti web_search_requests. Sebagai gantinya, API memancarkan span alat untuk setiap penggunaan alat server.

`anthropic.messages.count_tokens`

Sumber: SDK. API tidak memancarkan span untuk POST /v1/messages/count_tokens.
Jenis: CLIENT.
Induk: Span yang sedang aktif di aplikasi ketika aplikasi memanggil metode tersebut, atau tidak ada jika tidak ada span yang aktif.
Anak: Tidak ada.

Atribut	Tipe	Deskripsi
`gen_ai.request.model`	`string`	Model dari permintaan.
`anthropic.message.count_tokens.input_tokens`	`int`	Jumlah token dalam respons. Jumlah ini bukan penggunaan. Jangan sertakan saat Anda menjumlahkan penggunaan token.

`anthropic.sessions.create`

Sama seperti anthropic.sessions.<method>, kecuali untuk anak dan atribut berikut:

Anak dari span SDK: Span API untuk permintaan tersebut.
Anak dari span API: Span anthropic.session.turn dari giliran pertama, ketika permintaan memiliki initial_events yang tidak kosong.

Atribut	Tipe	Deskripsi
`gen_ai.agent.id`	`string`	ID agen yang menjadi dasar pembuatan sesi.
`gen_ai.agent.name`	`string`	Nama agen tersebut. SDK: Tidak ada jika permintaan gagal.
`gen_ai.request.model`	`string`	Model dari agen tersebut, yang menjalankan thread utama. SDK: Tidak ada jika permintaan gagal.
`anthropic.session.environment.id`	`string`	ID environment dari sesi.

`anthropic.sessions.events.send`

Sama seperti anthropic.sessions.<method>, kecuali untuk anak dari span API.

Anak dari span SDK: Span API untuk permintaan tersebut.
Anak dari span API: Span anthropic.session.turn dari setiap giliran yang dimulai karena event dari permintaan tersebut.

`anthropic.sessions.update`

Sama seperti anthropic.sessions.<method>, kecuali untuk anak dari span API.

Anak dari span SDK: Span API untuk permintaan tersebut.
Anak dari span API: Span anthropic.session.turn dari setiap giliran yang dilanjutkan karena permintaan menaikkan atau menghapus anggaran sesi.

`anthropic.session.turn`

Sumber: API, untuk sesi Managed Agents.
Jenis: INTERNAL.
Induk: Bergantung pada alasan giliran dimulai:
- Span anthropic.sessions.create, untuk giliran pertama dari sesi yang dibuat dengan initial_events yang tidak kosong.
- Span anthropic.sessions.events.send untuk permintaan tempat event dikirim, untuk giliran yang dimulai karena sebuah event, misalnya event user.message.
- Span anthropic.sessions.update, untuk giliran yang dilanjutkan karena anggaran sesi dinaikkan atau dihapus melalui permintaan.
- Span anthropic.session.turn dari giliran agen yang dijalankan oleh sesi yang selama giliran tersebut agen itu memulai giliran ini, untuk giliran pada thread lain.
- Tidak ada, untuk giliran yang dimulai karena agen pada thread lain membalas atau menyelesaikan gilirannya, seperti agen yang dipanggil oleh agen utama.
Anak:
- Span anthropic.model_request untuk setiap permintaan model dalam giliran.
- Span alat setiap kali API menjalankan alat dalam giliran, kecuali dalam kasus yang tercantum di bagian span alat.
- Span anthropic.session.turn untuk setiap giliran yang dimulai oleh agen yang dijalankan oleh sesi pada thread lain selama giliran ini.
- Span anthropic.session.outcome_evaluation untuk setiap iterasi evaluasi hasil yang dimulai oleh giliran ini.

Sebuah giliran dimulai ketika thread-nya memasuki status running dan berakhir ketika thread meninggalkan status tersebut.

Atribut	Tipe	Deskripsi
`gen_ai.operation.name`	`string`	`invoke_agent`
`gen_ai.agent.id`	`string`	ID agen yang menjalankan thread dari giliran tersebut. Tidak ada pada thread advisor.
`gen_ai.agent.name`	`string`	Nama agen tersebut. `anthropic.advisor` pada thread advisor.
`gen_ai.request.model`	`string`	Model dari agen tersebut. Pada thread advisor, model dari advisor.
`anthropic.session.turn.stop_reason`	`string`	Alasan giliran berakhir: `stop_reason.type` dari event `session.thread_status_idle`, misalnya `requires_action`. Tidak ada jika thread tidak menjadi idle.
`error.type`	`string`	`error.type` dari event `session.error` yang mengakhiri giliran, jika giliran gagal.
`gen_ai.agent.description`	`string`	Deskripsi agen tersebut. Tidak ada pada thread advisor atau ketika agen tidak memilikinya.
`gen_ai.system_instructions`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `SystemInstructions`. Prompt sistem yang berlaku untuk giliran tersebut. Hanya ada pada giliran pertama sebuah thread. Tidak ada pada thread advisor.
`gen_ai.input.messages`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `InputMessages`. Event input dari giliran tersebut: pesan pengguna dan hasil alat, event `system.message`, dan pesan dari thread lain. Tidak ada pada thread advisor.
`gen_ai.output.messages`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `OutputMessages`. Event output dari giliran tersebut: pesan, penggunaan alat, dan hasil alat dari agen.

`anthropic.model_request`

Sumber: API, untuk permintaan Messages API dan sesi Managed Agents.
Jenis: INTERNAL.
Induk:
- Messages API: Span anthropic.messages.create untuk permintaan.
- Managed Agents: Span anthropic.session.turn dari giliran yang membuat permintaan.
Anak: Tidak ada.

Pada Messages API, setiap span adalah satu permintaan model dalam permintaan API.

Span ini memiliki atribut penggunaan token.

Atribut	Tipe	Deskripsi
`gen_ai.operation.name`	`string`	Hanya pada span dari sesi Managed Agents, dengan nilai `chat`. Pada Messages API, span `anthropic.messages.create` untuk permintaan adalah operasi `chat`.
`gen_ai.request.model`	`string`	Model dari permintaan.
`gen_ai.response.model`	`string`	Hanya pada span untuk permintaan Messages API. Model yang menjalankan permintaan model.
`error.type`	`string`	Messages API: `error.type` dari span `anthropic.messages.create`, jika permintaan gagal selama permintaan model ini. Managed Agents: Jika permintaan model gagal, tipe error-nya, misalnya `rate_limit_error`. `api_error` jika permintaan model gagal tanpa respons.

`anthropic.tool_use`, `anthropic.mcp_tool_use`, dan `anthropic.custom_tool_use`

Sumber: SDK dan API.
Nama: anthropic.tool_use <tool>, anthropic.mcp_tool_use <tool>, atau anthropic.custom_tool_use <tool>, dengan <tool> adalah nama alat.
Jenis: INTERNAL.
Induk dari span SDK: Span yang sedang aktif di aplikasi ketika alat dimulai, yang dalam Messages tool runner adalah span anthropic.messages.tool_runner. Jika tidak ada span yang aktif, tidak ada induk.
Induk dari span API:
- Messages API: Span anthropic.messages.create untuk permintaan tempat API menjalankan alat tersebut.
- Managed Agents: Span anthropic.session.turn dari giliran tempat alat dijalankan. Untuk penggunaan alat yang menunggu event user.tool_confirmation, itu adalah giliran yang dimulai karena konfirmasi tersebut.
- Untuk penggunaan alat dari kode yang dijalankan oleh alat lain, span alat dari alat tersebut. Pada Messages API, alat tersebut adalah alat eksekusi kode.
Anak dari span SDK: Span yang dimulai oleh kode alat tersebut.
Anak dari span API: Span alat untuk setiap penggunaan alat dari kode yang dijalankan oleh alat ini. Misalnya, kode yang dijalankan oleh alat eksekusi kode mungkin menggunakan web_search.

Awalan nama span bergantung pada jenis alat:

anthropic.tool_use <tool> adalah span dari setiap penggunaan alat server pada Messages API atau alat dari toolset agen Managed Agents. API menjalankan alat-alat toolset agen, kecuali dalam sandbox yang di-host sendiri, tempat environment worker menjalankannya.
anthropic.mcp_tool_use <tool> adalah span dari setiap penggunaan alat MCP, di SDK, pada Messages API, dan pada Managed Agents. Di SDK, ini adalah alat dari helper MCP yang dijalankan oleh Messages tool runner atau session tool runner. Pada Messages API, alat berasal dari konektor MCP. Pada Managed Agents, jika koneksi ke server MCP gagal, nama span tidak menyertakan nama alat.
anthropic.custom_tool_use <tool> adalah span dari setiap penggunaan alat yang didefinisikan oleh aplikasi dan dijalankan oleh tool runner. Hanya SDK yang memancarkan span ini.

API tidak memancarkan span alat dalam kasus berikut:

Model meminta untuk menggunakan alat yang dijalankan oleh aplikasi, seperti alat kustom. Jika tool runner di SDK menjalankan alat tersebut, tool runner yang memancarkan span-nya.
Managed Agents: Agen menggunakan alat yang berjalan di sandbox yang di-host sendiri. Worker di SDK, yang menjalankan alat tersebut, memancarkan span-nya. Lihat cara melacak sandbox yang di-host sendiri.
Managed Agents: Agen menggunakan alat multiagen atau alat advisor.
Managed Agents: Agen meminta untuk menggunakan alat, tetapi server menolak penggunaan tersebut berdasarkan kebijakan izin auto, atau aplikasi menolaknya dalam event user.tool_confirmation.

Atribut	Tipe	Deskripsi
`gen_ai.operation.name`	`string`	`execute_tool`
`gen_ai.tool.name`	`string`	Nama alat, misalnya `bash`. Pada span API, nama alat MCP tidak menyertakan nama server. Pada Managed Agents, jika koneksi ke server MCP gagal, nilainya adalah nama yang dihasilkan model dan hanya ada pada span dalam mode konten.
`gen_ai.tool.call.id`	`string`	Messages API: `id` dari blok tempat model meminta untuk menggunakan alat: blok `tool_use`, `server_tool_use`, atau `mcp_tool_use`. Managed Agents: ID event tempat agen meminta untuk menggunakan alat: event `agent.tool_use`, `agent.mcp_tool_use`, atau `agent.custom_tool_use`.
`anthropic.mcp.server.name`	`string`	Hanya pada span API dari alat MCP. Nama server MCP dari alat tersebut. Pada Messages API, `server_name` dari blok `mcp_tool_use`.
`gen_ai.conversation.id`	`string`	ID thread sesi, seperti yang dijelaskan dalam Atribut sesi. Dalam Messages tool runner, ID percakapan yang diteruskan dengan opsi `conversation_id`, dan tidak ada jika tidak diteruskan. Tidak ada pada span API untuk permintaan Messages API.
`anthropic.session.id`	`string`	ID sesi. Tidak ada untuk penggunaan alat di luar sesi Managed Agents, seperti pada Messages API atau dalam Messages tool runner.
`anthropic.session.thread.id`	`string`	Hanya pada span SDK dari session tool runner. ID thread sesi. Tidak ada untuk penggunaan alat pada thread utama.
`anthropic.tool.evaluated_permission`	`string`	Hanya pada span yang dipancarkan API dalam sesi Managed Agents. Hasil evaluasi kebijakan izin untuk penggunaan alat: `allow` atau `ask`.
`error.type`	`string`	Tipe error, jika penggunaan alat gagal: `tool_error` ketika kode alat memunculkan error atau ketika alat mengembalikan hasil error. API: Pada Messages API, hasil error dari alat server sebagai gantinya memiliki `error_code`-nya, misalnya `max_uses_exceeded`. Pada Managed Agents, jika koneksi ke server MCP gagal, `mcp_authentication_failed_error` ketika autentikasi gagal, selain itu `mcp_connection_failed_error`. Jika permintaan gagal selama penggunaan alat, tipe error dari permintaan tersebut.
`gen_ai.tool.description`	`string`	Hanya pada span SDK. Deskripsi dalam definisi alat. Tidak ada jika deskripsi kosong.
`gen_ai.tool.type`	`string`	Hanya pada span SDK. `function`
`gen_ai.tool.call.arguments`	`string`	Content String JSON yang mengikuti skema OpenTelemetry `ToolCallArguments`. `input` dari penggunaan alat.
`anthropic.tool_result.content`	`string`	Content String JSON dengan array blok konten atau dengan satu objek. `content` dari hasil alat yang dikembalikan ke model. Juga untuk hasil error, kecuali pada Managed Agents ketika koneksi ke server MCP gagal. API: Pada Messages API, `content` berupa string menjadi array dengan satu blok `text`.

`anthropic.compaction`

Sumber: API, untuk permintaan Messages API.
Jenis: INTERNAL.
Induk: Span anthropic.messages.create untuk permintaan tersebut.
Anak: Tidak ada.

Span ini memiliki atribut penggunaan token dari compaction. Pada anthropic.messages.create, penggunaan dari sebuah compaction berada di atribut anthropic.usage.compaction.*, bukan di total gen_ai.usage.*.

Atribut	Tipe	Deskripsi
`error.type`	`string`	Jenis error dari permintaan, jika permintaan gagal selama compaction.

`anthropic.session.outcome_evaluation`

Sumber: API, untuk sesi Managed Agents.
Jenis: INTERNAL.
Induk: Span anthropic.session.turn dari giliran yang memulai iterasi, bahkan jika giliran tersebut berakhir sebelum iterasi.
Anak: Tidak ada.

Status tidak diatur ketika hasilnya interrupted dan OK untuk hasil lainnya.

Span ini memiliki dua dari atribut penggunaan token: gen_ai.usage.input_tokens dan gen_ai.usage.output_tokens.

Atribut	Tipe	Deskripsi
`anthropic.session.outcome.id`	`string`	ID dari outcome yang dievaluasi oleh iterasi.
`anthropic.session.outcome_evaluation.result`	`string`	Hasil dari iterasi: `satisfied`, `needs_revision`, `max_iterations_reached`, `failed`, atau `interrupted`.
`anthropic.session.outcome_evaluation.iteration`	`int`	Nomor iterasi.
`anthropic.session.outcome_evaluation.explanation`	`string`	Content Penjelasan hasil dari grader, sebagai teks biasa.

`anthropic.messages.tool_runner`

Sumber: SDK.
Jenis: INTERNAL.
Induk: Span yang sedang aktif di aplikasi ketika loop dimulai, atau tidak ada jika tidak ada span yang aktif.
Anak: Span anthropic.messages.create untuk setiap permintaan dalam loop dan span alat dari setiap penggunaan alat yang dijalankan oleh runner.

Span berakhir bersama loop. Jika aplikasi menghentikan runner, status tidak diatur. Jika kode sebuah alat memunculkan error, span alatnya memiliki status ERROR dan loop berlanjut. Span ini tidak memiliki atribut penggunaan, jadi bacalah penggunaan dari anak-anak anthropic.messages.create-nya.

Atribut	Tipe	Deskripsi
`gen_ai.operation.name`	`string`	`invoke_agent`
`gen_ai.request.model`	`string`	Model dari permintaan pertama dalam loop.
`gen_ai.conversation.id`	`string`	ID percakapan yang diteruskan dengan opsi `conversation_id`. Tidak ada jika opsi tersebut tidak diberikan.
`error.type`	`string`	Jenis error dari permintaan yang mengakhiri loop, jika loop gagal. `client_error` ketika runner itu sendiri gagal.
`gen_ai.output.type`	`string`	`json` ketika permintaan mengatur format output ke JSON. Tidak ada jika sebaliknya.

`anthropic.messages.batches.<method>`

Sumber: SDK, untuk setiap metode Message Batches.
Jenis: CLIENT.
Induk: Span yang sedang aktif di aplikasi ketika aplikasi memanggil metode, atau tidak ada jika tidak ada span yang aktif.
Anak: Tidak ada.

Span ini juga memiliki atribut dari setiap span SDK untuk sebuah permintaan.

Atribut	Tipe	Deskripsi
`anthropic.message.batch.id`	`string`	ID dari batch yang ditangani oleh metode, atau untuk `create`, ID dari batch baru. Tidak ada pada `list` dan pada `create` yang gagal.
`anthropic.message.batch.request_count`	`int`	Hanya pada `create`. Jumlah item dalam array `requests`.

`anthropic.sessions.<method>`

Sumber: SDK dan API.
Jenis: CLIENT dari SDK, SERVER dari API.
Induk dari span SDK: Span yang sedang aktif di aplikasi ketika aplikasi memanggil metode, atau tidak ada jika tidak ada span yang aktif.
Induk dari span API: Span dalam header traceparent permintaan, yaitu span SDK ketika permintaan berasal dari SDK, atau tidak ada tanpa header tersebut.
Anak dari span SDK: Span API untuk permintaan tersebut.
Anak dari span API: Tidak ada.

API memancarkan span anthropic.sessions.<method> untuk setiap permintaan terautentikasi ke endpoint Sessions API. Permintaan yang dikirim platform atas nama pengguna, seperti pesan yang dikirim di Claude Console atau sesi yang dimulai oleh scheduled deployment, juga memiliki span, masing-masing dalam trace baru.

Span	Endpoint
`anthropic.sessions.create`	`POST /v1/sessions`
`anthropic.sessions.list`	`GET /v1/sessions`
`anthropic.sessions.retrieve`	`GET /v1/sessions/{session_id}`
`anthropic.sessions.update`	`POST /v1/sessions/{session_id}`
`anthropic.sessions.delete`	`DELETE /v1/sessions/{session_id}`
`anthropic.sessions.archive`	`POST /v1/sessions/{session_id}/archive`
`anthropic.sessions.events.send`	`POST /v1/sessions/{session_id}/events`
`anthropic.sessions.events.list`	`GET /v1/sessions/{session_id}/events`
`anthropic.sessions.events.stream`	`GET /v1/sessions/{session_id}/events/stream`
`anthropic.sessions.resources.add`	`POST /v1/sessions/{session_id}/resources`
`anthropic.sessions.resources.list`	`GET /v1/sessions/{session_id}/resources`
`anthropic.sessions.resources.retrieve`	`GET /v1/sessions/{session_id}/resources/{resource_id}`
`anthropic.sessions.resources.update`	`POST /v1/sessions/{session_id}/resources/{resource_id}`
`anthropic.sessions.resources.delete`	`DELETE /v1/sessions/{session_id}/resources/{resource_id}`
`anthropic.sessions.threads.list`	`GET /v1/sessions/{session_id}/threads`
`anthropic.sessions.threads.retrieve`	`GET /v1/sessions/{session_id}/threads/{thread_id}`
`anthropic.sessions.threads.archive`	`POST /v1/sessions/{session_id}/threads/{thread_id}/archive`
`anthropic.sessions.threads.events.list`	`GET /v1/sessions/{session_id}/threads/{thread_id}/events`
`anthropic.sessions.threads.events.stream`	`GET /v1/sessions/{session_id}/threads/{thread_id}/stream`

Span ini memiliki atribut sesi. Span SDK juga memiliki atribut dari setiap span SDK untuk sebuah permintaan.

Atribut	Tipe	Deskripsi
`error.type`	`string`	Jenis error dari permintaan yang gagal, misalnya `rate_limit_error`. SDK: Juga nilai-nilai lain dalam span SDK untuk permintaan. API: `api_error` ketika API menutup koneksi tanpa respons error, atau ketika stream berakhir karena kegagalan di API.

`anthropic.environment.work`

Sumber: CLI dan SDK dalam Python, TypeScript, dan Go.
Jenis: INTERNAL.
Induk: Span yang sedang aktif di aplikasi ketika environment worker atau work poller mendapatkan work item, atau tidak ada jika tidak ada span yang aktif. Dalam ant beta:worker poll, span ini adalah root span.
Anak: Span untuk permintaan yang dikirim environment worker saat menangani work item dan span alat dari setiap alat yang dijalankannya untuk work item.

Environment worker dan work poller adalah helper SDK yang mengklaim work item dalam sandbox yang di-host sendiri. Keduanya memancarkan satu span anthropic.environment.work untuk setiap work item, sejak poll mengembalikan work item hingga penanganannya berakhir.

Atribut	Tipe	Deskripsi
`anthropic.environment.id`	`string`	ID dari environment.
`anthropic.environment.work.id`	`string`	ID dari work item.
`anthropic.session.id`	`string`	ID dari sesi tempat work item berada.
`error.type`	`string`	`error.type` dari span untuk permintaan yang gagal, jika sebuah permintaan mengakhiri penanganan. `client_error` untuk kegagalan lainnya.

`anthropic.<resources>.<method>`

Sumber: SDK.
Jenis: CLIENT.
Induk: Span yang sedang aktif di aplikasi ketika aplikasi memanggil metode, atau tidak ada jika tidak ada span yang aktif.
Anak: Tidak ada.

Setiap metode SDK yang mengirim permintaan dan tidak memiliki bagian di halaman ini memancarkan span anthropic.<resources>.<method>, misalnya anthropic.models.list atau anthropic.files.upload. Permintaan untuk setiap halaman berikutnya dari sebuah list memiliki span tersendiri.

Sebuah span mencakup seluruh permintaannya, termasuk percobaan ulang, dan memiliki setiap atribut dari span API dengan nama yang sama ketika SDK memiliki nilainya. SDK mengatur http.request.method dan http.route ketika memulai span, sehingga sampler dapat menggunakannya.

Setiap span SDK untuk sebuah permintaan, termasuk anthropic.messages.create, anthropic.messages.count_tokens, dan anthropic.messages.batches.<method>, memiliki atribut berikut:

Atribut	Tipe	Deskripsi
`gen_ai.conversation.id`	`string`	ID percakapan yang diteruskan dengan opsi `conversation_id`. Tanpa opsi tersebut, ID thread sesi pada permintaan Managed Agents yang tercantum di Atribut sesi, dan tidak ada pada permintaan lainnya.
`anthropic.<resource>.id`	`string`	Satu atribut untuk setiap ID dalam path permintaan dan satu untuk ID objek yang dibuat oleh metode. Namanya berasal dari path, dalam bentuk tunggal, misalnya `anthropic.session.id` atau `anthropic.session.thread.id`.
`gen_ai.agent.id`	`string`	ID dari agent, pada metode agent.
`gen_ai.memory.store.id`	`string`	ID dari memory store, pada metode memory store.
`gen_ai.memory.record.id`	`string`	ID dari memori, pada metode memori.
`http.request.resend_count`	`int`	Berapa kali SDK mengirim ulang permintaan, karena alasan apa pun, seperti percobaan ulang. Tidak ada ketika SDK tidak mengirimnya ulang.
`error.type`	`string`	Jenis error dari panggilan yang gagal, misalnya `rate_limit_error`. Kode status HTTP, misalnya `502`, ketika respons error tidak memiliki jenis error. `connection_error`, `client_timeout_error`, atau `client_error` ketika panggilan gagal di SDK. `api_error` ketika server mengakhiri stream lebih awal.
`server.address`	`string`	Host dari base URL klien, `api.anthropic.com` secara default. Pada klien platform cloud, host dari platform tersebut.
`url.query`	`string`	Query string dari URL, hanya dengan parameter query yang didefinisikan oleh endpoint. Tidak ada ketika tidak ada parameter tersebut. Dalam mode metadata-only, tidak ada ketika query memiliki parameter sensitif, seperti `email`.
`url.full`	`string`	URL, yang tersusun dari `url.scheme`, `server.address`, port ketika base URL memilikinya, `url.path`, dan `url.query`. Dalam mode metadata-only, tidak ada setiap kali mode tersebut menghilangkan `url.query`.

Nama dan jenis span

Status span

Atribut

Atribut umum

Atribut sesi

Atribut konten

Penggunaan token

Span

anthropic.messages.create

anthropic.messages.count_tokens

anthropic.sessions.create

anthropic.sessions.events.send

anthropic.sessions.update

anthropic.session.turn

anthropic.model_request

anthropic.tool_use, anthropic.mcp_tool_use, dan anthropic.custom_tool_use

anthropic.compaction

anthropic.session.outcome_evaluation

anthropic.messages.tool_runner

anthropic.messages.batches.<method>

anthropic.sessions.<method>

Nama span dan endpoint

anthropic.environment.work

anthropic.<resources>.<method>