Pemantauan

Pelajari cara mengaktifkan dan mengonfigurasi OpenTelemetry untuk Claude Code.

Lacak penggunaan Claude Code, biaya, dan aktivitas alat di seluruh organisasi Anda dengan mengekspor data telemetri melalui OpenTelemetry (OTel). Claude Code mengekspor metrik sebagai data deret waktu melalui protokol metrik standar, acara melalui protokol log/acara, dan secara opsional distributed traces melalui protokol traces.

Mulai cepat

Konfigurasikan OpenTelemetry menggunakan variabel lingkungan:

# 1. Aktifkan telemetri
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. Pilih pengekspor (keduanya bersifat opsional - konfigurasikan hanya yang Anda butuhkan)
export OTEL_METRICS_EXPORTER=otlp       # Opsi: otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp          # Opsi: otlp, console, none

# 3. Konfigurasikan titik akhir OTLP (untuk pengekspor OTLP)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. Atur autentikasi (jika diperlukan)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. Untuk debugging: kurangi interval ekspor, dan atur ulang untuk penggunaan produksi
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 detik (default: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 detik (default: 5000ms)

# 6. Jalankan Claude Code
claude

Untuk memverifikasi pengaturan yang mengekspor metrik, periksa backend Anda untuk metrik claude_code.session.count, yang Claude Code keluarkan saat sesi dimulai. Untuk memverifikasi pengaturan hanya log, kirimkan prompt dan periksa acara claude_code.user_prompt.

Jika tidak ada yang tiba, jalankan Claude Code dengan claude --debug-file <path> dan periksa log yang ditulisnya ke jalur tersebut. Claude Code melaporkan kegagalan dari pengekspor yang Anda konfigurasikan sebagai kesalahan [3P telemetry], di mana 3P berarti pihak ketiga. Baris yang diawali dengan [Anthropic telemetry] menjelaskan telemetri operasional terpisah Anthropic dan tidak menunjukkan masalah dengan pengaturan Anda.

Untuk opsi konfigurasi lengkap, lihat spesifikasi OpenTelemetry.

Konfigurasi administrator

Administrator dapat mengonfigurasi pengaturan OpenTelemetry untuk semua pengguna melalui file pengaturan terkelola. Lihat prioritas pengaturan untuk informasi lebih lanjut tentang bagaimana pengaturan diterapkan.

Contoh konfigurasi pengaturan terkelola:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer example-token"
  }
}

Claude Code mengabaikan variabel pengekspor OpenTelemetry dalam .claude/settings.json dan .claude/settings.local.json repositori, jadi repositori tidak dapat menggunakannya untuk menghidupkan telemetri, memilih ke mana telemetri pergi, atau menangkap konten. Atur variabel tersebut dalam pengaturan terkelola, atau biarkan setiap pengembang mengaturnya dalam shell atau ~/.claude/settings.json mereka. Repositori masih dapat mematikan sinyal dengan menetapkan pemilih pengekspor, seperti OTEL_LOGS_EXPORTER, ke none, kecuali pengaturan terkelola, file --settings, atau lingkungan tempat Anda memulai Claude Code menetapkan variabel tersebut.

Claude Code tidak meneruskan variabel lingkungan OTEL_* ke subproses yang dihasilkannya, termasuk alat Bash, hooks, server MCP, dan language servers. Aplikasi yang diinstrumentasi OpenTelemetry yang Anda jalankan melalui alat Bash tidak mewarisi titik akhir pengekspor atau header Claude Code, jadi atur variabel tersebut langsung dalam perintah jika aplikasi itu perlu mengekspor telemetrinya sendiri.

Bagaimana pengaturan terkelola mengunci tujuan OTLP

Ketika Anda menetapkan variabel OTEL_EXPORTER_OTLP_* dalam pengaturan terkelola, Claude Code menghapus variabel yang ditetapkan pengembang yang bertentangan saat startup dan mencatat peringatan dalam debug log. Apa yang dihapusnya tergantung pada variabel mana yang Anda tetapkan:

Endpoints: ketika Anda menetapkan OTEL_EXPORTER_OTLP_ENDPOINT, Claude Code menghapus setiap titik akhir per-sinyal yang ditetapkan pengembang. Pengembang tidak dapat mengarahkan satu sinyal ke kolektor yang berbeda, jadi Anda tidak perlu juga menetapkan variabel titik akhir per-sinyal dalam pengaturan terkelola.
Protokol: ketika Anda menetapkan OTEL_EXPORTER_OTLP_PROTOCOL, Claude Code menghapus setiap protokol per-sinyal yang ditetapkan pengembang.
Kredensial: ketika Anda menetapkan OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_CLIENT_KEY, atau OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, Claude Code menghapus versi per-sinyal dari variabel tersebut yang ditetapkan pengembang, ditambah setiap variabel titik akhir yang ditetapkan pengembang, generik atau per-sinyal, karena kredensial tersebut akan mencapai kolektor yang tidak dipilih pengaturan terkelola.
Pemilih pengekspor: OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, dan OTEL_TRACES_EXPORTER beta mengikuti prioritas per-kunci normal. Pengaturan pengembang masih dapat menonaktifkan sinyal atau mengalihkannya ke pengekspor konsol, jadi tetapkan pemilih dalam pengaturan terkelola juga jika Anda perlu menguncinya. Di seluruh sumber admin, OTEL_LOGS_EXPORTER mengikuti unit telemetri sementara dua pemilih lainnya digabungkan per kunci. Memerlukan Claude Code v2.1.223 atau lebih baru.
Titik akhir pelacakan beta: dengan pelacakan beta terperinci aktif, Claude Code mengekspor log dan jejak ke BETA_TRACING_ENDPOINT alih-alih melalui pengekspor log dan jejak. Claude Code oleh karena itu menghapus BETA_TRACING_ENDPOINT yang ditetapkan pengembang kapan pun salah satu pengaturan terkelola ini memutuskan tujuan sinyal:
- Titik akhir atau kredensial generik atau log/jejak
- Sebuah otelHeadersHelper
- Pemilih pengekspor log atau jejak yang ditetapkan ke none, console, atau kosong, nilai yang membuat sinyal tetap di luar kolektor
- CLAUDE_CODE_ENABLE_TELEMETRY dimatikan
Titik akhir atau kredensial khusus metrik tidak menghapusnya. Sebelum v2.1.251, BETA_TRACING_ENDPOINT yang ditetapkan pengembang mengarahkan ulang log dan jejak yang diekspor pelacakan beta terperinci bahkan ketika pengaturan terkelola menyematkan kolektor.

Claude Code tidak menghapus variabel per-sinyal yang Anda tetapkan dalam pengaturan terkelola itu sendiri, jadi Anda dapat merutekan satu sinyal ke kolektor yang berbeda dengan menetapkan variabelnya di sana, seperti yang dilakukan contoh SIEM. Jika Anda menetapkan kredensial per-sinyal di sana, Claude Code menghapus titik akhir yang ditetapkan pengembang untuk sinyal itu.

Perilaku penghapusan ini mengubah di mana telemetri dikirimkan, bukan apa yang dikumpulkan Claude Code.

Sebelum v2.1.217, setiap variabel mengikuti prioritas pengaturan per-kunci secara independen, jadi titik akhir khusus sinyal yang ditetapkan dalam pengaturan pengguna atau shell mengarahkan ulang sinyal itu dari kolektor terkelola.

Ketika aplikasi desktop atau pelari lingkungan yang di-host sendiri meluncurkan Claude Code dan menamai titik akhir OTLP dalam lingkungan yang disediakannya, Claude Code menyematkan tujuan dengan cara yang sama: variabel telemetri peluncur menghapus variabel yang ditetapkan pengembang persis seperti pengaturan terkelola. Claude Code tidak menghapus variabel yang ditetapkan peluncur itu sendiri. Memerlukan Claude Code v2.1.251 atau lebih baru.

Detail konfigurasi

Variabel konfigurasi umum

Variabel-variabel ini mengonfigurasi eksporter, endpoint, dan perilaku ekspor untuk semua deployment.

Jika Anda menetapkan variabel endpoint atau protokol per-sinyal, seperti OTEL_EXPORTER_OTLP_METRICS_ENDPOINT, Claude Code menggunakannya sebagai pengganti variabel generik untuk sinyal tersebut. Jika Anda menetapkan variabel header per-sinyal, seperti OTEL_EXPORTER_OTLP_METRICS_HEADERS, Claude Code menggabungkannya dengan OTEL_EXPORTER_OTLP_HEADERS generik untuk sinyal tersebut.

Pada mesin dengan pengaturan terkelola, lihat Bagaimana pengaturan terkelola mengunci tujuan OTLP untuk mengetahui apa yang Claude Code hapus.

Variabel Lingkungan	Deskripsi	Nilai Contoh
`CLAUDE_CODE_ENABLE_TELEMETRY`	Mengaktifkan pengumpulan telemetri (diperlukan)	`1`
`OTEL_METRICS_EXPORTER`	Jenis eksporter metrik, dipisahkan koma. Gunakan `none` untuk menonaktifkan	`console`, `otlp`, `prometheus`, `none`
`OTEL_LOGS_EXPORTER`	Jenis eksporter log/event, dipisahkan koma. Gunakan `none` untuk menonaktifkan	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_PROTOCOL`	Protokol untuk eksporter OTLP, berlaku untuk semua sinyal. Claude Code tidak memiliki protokol default, jadi atur ini atau variabel protokol spesifik sinyal untuk setiap eksporter `otlp` yang Anda aktifkan	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_ENDPOINT`	Endpoint kolektor OTLP untuk semua sinyal	`http://localhost:4317`
`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL`	Protokol untuk metrik, menimpa pengaturan umum	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`	Endpoint metrik OTLP, menimpa pengaturan umum	`http://localhost:4318/v1/metrics`
`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL`	Protokol untuk log, menimpa pengaturan umum	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	Endpoint log OTLP, menimpa pengaturan umum	`http://localhost:4318/v1/logs`
`OTEL_EXPORTER_OTLP_HEADERS`	Header autentikasi untuk OTLP	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_METRICS_HEADERS`	Header autentikasi untuk metrik, digabung dengan header umum	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_LOGS_HEADERS`	Header autentikasi untuk log, digabung dengan header umum	`Authorization=Bearer token`
`OTEL_METRIC_EXPORT_INTERVAL`	Interval ekspor dalam milidetik (default: 60000)	`5000`, `60000`
`OTEL_LOGS_EXPORT_INTERVAL`	Interval ekspor log dalam milidetik (default: 5000)	`1000`, `10000`
`OTEL_LOG_USER_PROMPTS`	Aktifkan pencatatan konten prompt pengguna (default: dinonaktifkan)	`1` untuk mengaktifkan
`OTEL_LOG_ASSISTANT_RESPONSES`	Aktifkan pencatatan teks respons asisten pada event `assistant_response` (default: dinonaktifkan). Ketika tidak diatur, kembali ke nilai `OTEL_LOG_USER_PROMPTS`. Memerlukan Claude Code v2.1.193 atau lebih baru	`1` untuk mengaktifkan, `0` untuk tetap disembunyikan
`OTEL_LOG_TOOL_DETAILS`	Aktifkan pencatatan parameter alat dan argumen input dalam event alat dan atribut span jejak: perintah Bash, nama server dan alat MCP, nama skill, nama workflow yang ditulis pengguna, dan input alat. Juga mengaktifkan nama perintah kustom, plugin, dan MCP pada event `user_prompt`, dan nama asli agen, skill, plugin, dan server serta nama alat MCP pada penghitung biaya dan token (default: dinonaktifkan). Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, `mcp_server_name`/`mcp_tool_name` dipancarkan pada `tool_decision`/`tool_result` bahkan dengan flag mati. Pengecualian memerlukan Claude Code v2.1.214 atau lebih baru	`1` untuk mengaktifkan
`OTEL_LOG_TOOL_CONTENT`	Aktifkan pencatatan konten alat dalam `tool.output` span event (default: dinonaktifkan). Atribut span membawa konten alat di bawah gerbang mereka sendiri. Memerlukan tracing. Konten dipotong pada batas konten (60 KB secara default)	`1` untuk mengaktifkan
`OTEL_LOG_MANAGED_SETTINGS`	Tambahkan pengaturan terkelola yang disembunyikan, dan digest SHA-256 dari pengaturan sebelum penyembunyian, ke event managed settings resolved (default: dinonaktifkan). Nilai dalam pengaturan proyek atau lokal tidak mengaktifkannya. Memerlukan Claude Code v2.1.274 atau lebih baru	`1` untuk mengaktifkan
`OTEL_LOG_RAW_API_BODIES`	Pancarkan permintaan dan respons JSON API Pesan Anthropic lengkap sebagai event log `api_request_body` / `api_response_body` (default: dinonaktifkan). Badan mencakup seluruh riwayat percakapan. Mengaktifkan ini menyiratkan persetujuan untuk semua yang `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, dan `OTEL_LOG_TOOL_CONTENT` akan ungkapkan	`1` untuk badan inline yang dipotong pada batas konten (60 KB secara default), atau `file:<dir>` untuk badan yang tidak dipotong di disk dengan pointer `body_ref` dalam event
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Batas konten: panjang maksimum atribut yang membawa konten seperti respons model, konten alat, prompt sistem, dan badan API mentah, termasuk penanda pemotongan, dalam unit kode UTF-16 (default: 61440, yaitu 60 KB). Default diukur untuk backend yang membatasi nilai atribut pada 64 KB; naikkan hanya jika backend Anda menerima nilai yang lebih besar, atau turunkan untuk mengurangi volume telemetri. Ketika batas atribut SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` atau salah satu varian logrecord dan span-nya, diatur lebih rendah, Claude Code memotong pada nilai yang lebih kecil itu sehingga penanda `[TRUNCATED ...]` tetap dalam batas SDK. Memerlukan Claude Code v2.1.214 atau lebih baru	`262144`
`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`	Preferensi temporalitas metrik (default: `delta`). Atur ke `cumulative` jika backend Anda mengharapkan temporalitas kumulatif	`delta`, `cumulative`
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Interval untuk menyegarkan header dinamis (default: 1740000ms / 29 menit)	`900000`

Untuk protokol http/protobuf dan http/json, Claude Code mengirim setiap permintaan ekspor dengan header Content-Length. Sebelum v2.1.212, versi Claude Code dari v2.1.191 ke depan mengirim permintaan ini dengan pengkodean transfer chunked; Azure Monitor dan endpoint lain yang memerlukan panjang yang dideklarasikan menolaknya dengan error 411 Length Required atau 400.

Autentikasi mTLS

Cara Anda mengonfigurasi sertifikat klien untuk eksporter OTLP tergantung pada protokol OTLP yang digunakan untuk sinyal tersebut, diatur melalui OTEL_EXPORTER_OTLP_PROTOCOL atau penggantian spesifik sinyal. Konfigurasi yang sama berlaku untuk metrik, log, dan jejak.

Protokol	Variabel sertifikat klien	Percayai CA kolektor dengan
`http/protobuf`, `http/json`	`CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY`, dan secara opsional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Lihat Konfigurasi Jaringan	`NODE_EXTRA_CA_CERTS`
`grpc`	`OTEL_EXPORTER_OTLP_CLIENT_KEY` dan `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, atau varian spesifik sinyal seperti `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` untuk menggunakan sertifikat berbeda per sinyal	`OTEL_EXPORTER_OTLP_CERTIFICATE`

Untuk grpc, SDK OpenTelemetry membaca variabel OTLP standar secara langsung, jadi konfigurasi yang ada yang menetapkan variabel metrik spesifik sinyal terus berfungsi. Pada mesin dengan pengaturan terkelola, Claude Code dapat menghapus kredensial dan endpoint spesifik sinyal yang ditetapkan pengembang saat startup.

Kontrol kardinalitas metrik

Variabel lingkungan berikut mengontrol atribut mana yang disertakan dalam metrik untuk mengelola kardinalitas:

Variabel Lingkungan	Deskripsi	Nilai Default	Contoh untuk Menonaktifkan
`OTEL_METRICS_INCLUDE_SESSION_ID`	Sertakan atribut session.id dan, pada sesi cloud, ccr.session.id dalam metrik	`true`	`false`
`OTEL_METRICS_INCLUDE_VERSION`	Sertakan atribut app.version dalam metrik	`false`	`true`
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Sertakan atribut user.account_uuid dan user.account_id dalam metrik	`true`	`false`
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Sertakan atribut app.entrypoint dalam metrik	`false`	`true`
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	Sertakan kunci dari `OTEL_RESOURCE_ATTRIBUTES` sebagai atribut pada titik data metrik	`true`	`false`
`OTEL_METRICS_INCLUDE_REPOSITORY`	Sertakan atribut identitas repositori `vcs.*` repository identity attributes pada metrik dan event. Memerlukan Claude Code v2.1.269 atau lebih baru	`false`	`true`

Kardinalitas yang lebih rendah umumnya berarti kinerja yang lebih baik dan biaya penyimpanan yang lebih rendah tetapi data yang kurang granular untuk analisis.

Traces (beta)

Distributed tracing mengekspor span yang menghubungkan setiap prompt pengguna ke permintaan API dan eksekusi alat yang dipicunya, sehingga Anda dapat melihat permintaan lengkap sebagai jejak tunggal di backend tracing Anda.

Tracing dimatikan secara default. Untuk mengaktifkannya, atur CLAUDE_CODE_ENABLE_TELEMETRY=1 dan CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1, kemudian atur OTEL_TRACES_EXPORTER untuk memilih tempat span dikirim. Traces menggunakan kembali konfigurasi OTLP umum untuk endpoint, protokol, header, dan mTLS. Pada mesin dengan pengaturan terkelola, Claude Code dapat menghapus kredensial dan endpoint spesifik sinyal yang ditetapkan pengembang saat startup.

Variabel Lingkungan	Deskripsi	Nilai Contoh
`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA`	Aktifkan span tracing (diperlukan). `ENABLE_ENHANCED_TELEMETRY_BETA` juga diterima	`1`
`OTEL_TRACES_EXPORTER`	Jenis eksporter jejak, dipisahkan koma. Gunakan `none` untuk menonaktifkan	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	Protokol untuk jejak, menimpa `OTEL_EXPORTER_OTLP_PROTOCOL`	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Endpoint jejak OTLP, menimpa `OTEL_EXPORTER_OTLP_ENDPOINT`	`http://localhost:4318/v1/traces`
`OTEL_EXPORTER_OTLP_TRACES_HEADERS`	Header autentikasi untuk jejak, digabung dengan `OTEL_EXPORTER_OTLP_HEADERS`	`Authorization=Bearer token`
`OTEL_TRACES_EXPORT_INTERVAL`	Interval ekspor batch span dalam milidetik (default: 5000)	`1000`, `10000`

Span menyembunyikan teks prompt pengguna, detail input alat, dan konten alat secara default. Atur OTEL_LOG_USER_PROMPTS=1, OTEL_LOG_TOOL_DETAILS=1, dan OTEL_LOG_TOOL_CONTENT=1 untuk menyertakannya.

Ketika tracing aktif, subproses Bash dan PowerShell secara otomatis mewarisi variabel lingkungan TRACEPARENT yang berisi konteks jejak W3C dari span eksekusi alat yang aktif. Ini memungkinkan subproses apa pun yang membaca TRACEPARENT untuk membuat span-nya sendiri sebagai anak dari jejak yang sama, memungkinkan distributed tracing end-to-end melalui skrip dan perintah yang Claude jalankan.

Ketika tracing aktif dan Claude Code terhubung langsung ke API Anthropic, setiap permintaan model membawa header W3C traceparent yang diatur ke konteks span claude_code.llm_request, dan header traceresponse API dicatat sebagai link span. Bersama-sama ini menghubungkan span sisi klien Claude Code ke jejak sisi server melalui perantara yang sesuai. Permintaan HTTP MCP keluar membawa traceparent dengan cara yang sama. Header tidak dikirim ke penyedia pihak ketiga.

Secara default, header traceparent pada permintaan model dan HTTP MCP dikirim hanya ketika ANTHROPIC_BASE_URL tidak diatur atau menunjuk ke API Anthropic, karena beberapa proxy menolak header yang tidak dikenali. Variabel TRACEPARENT subproses dikendalikan oleh switch yang sama untuk konsistensi. Jika Anda menjalankan Claude Code melalui proxy ANTHROPIC_BASE_URL kustom dan ingin konteks jejak dipropagasi, atur CLAUDE_CODE_PROPAGATE_TRACEPARENT=1.

Dalam sesi Agent SDK dan non-interaktif yang dimulai dengan -p, Claude Code juga membaca TRACEPARENT dan TRACESTATE dari lingkungannya sendiri saat memulai setiap span interaksi. Ini memungkinkan proses embedding melewatkan konteks jejak W3C aktifnya ke subproses sehingga span Claude Code muncul sebagai anak dari jejak distributed pemanggil. Sesi interaktif mengabaikan TRACEPARENT masuk untuk menghindari secara tidak sengaja mewarisi nilai ambient dari lingkungan CI atau kontainer.

Konteks jejak masuk juga berlaku untuk event. Dalam sesi Agent SDK dan -p dengan TRACEPARENT diatur, setiap catatan log event OTLP membawa nilai trace_id dan span_id yang menghubungkannya ke jejak aplikasi Anda, bahkan ketika eksporter jejak tidak dikonfigurasi, sehingga backend logging Anda dapat mengorelasikan event dengan sisa jejak.

Catatan yang dipancarkan saat interaksi aktif membawa ID span interaksi, bahkan ketika Claude Code memancarkannya di luar konteks async span, seperti dalam callback prompt izin atau untuk catatan yang di-buffer selama startup dan diekspor nanti. Catatan yang dipancarkan tanpa span interaksi aktif membawa ID TRACEPARENT masuk secara langsung. Sebelum v2.1.214, catatan yang dipancarkan di luar konteks async span membawa ID TRACEPARENT masuk sebagai gantinya. Sebelum v2.1.212, catatan event yang dipancarkan di luar span aktif tidak membawa trace_id atau span_id.

Hierarki span

Setiap prompt pengguna memulai span root claude_code.interaction. Panggilan API, panggilan alat, dan eksekusi hook dicatat sebagai anak-anaknya. Span alat memiliki dua span anak mereka sendiri: satu untuk waktu yang dihabiskan menunggu keputusan izin dan satu untuk eksekusi itu sendiri. Ketika alat Agent, atau alat Task warisan, memunculkan subagen, span API dan alat subagen bersarang di bawah span claude_code.tool induk.

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (requires detailed beta tracing)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (Agent tool) subagent claude_code.llm_request / claude_code.tool spans

Dalam sesi Agent SDK dan claude -p, claude_code.interaction itu sendiri menjadi anak dari span pemanggil ketika TRACEPARENT diatur dalam lingkungan.

Ketika hook PreToolUse menunda panggilan alat, Claude Code menyimpan konteks jejak dari giliran yang menundanya. Ketika Anda melanjutkan sesi dan alat berjalan kembali, span alat bergabung dengan jejak giliran sebelumnya sebagai anak dari span claude_code.interaction giliran.

Atribut span

Setiap span membawa atribut standar ditambah atribut span.type yang cocok dengan namanya. Tabel di bawah mencantumkan atribut tambahan yang diatur pada setiap span. Span llm_request, tool.execution, dan hook menetapkan status OpenTelemetry ERROR ketika mereka mencatat kegagalan; span lainnya selalu berakhir dengan status UNSET.

claude_code.interaction

Atribut	Deskripsi	Gerbang oleh
`user_prompt`	Teks prompt. Nilai adalah `<REDACTED>` kecuali gerbang diatur	`OTEL_LOG_USER_PROMPTS`
`user_prompt_length`	Panjang prompt dalam karakter
`interaction.sequence`	Penghitung berbasis 1 dari interaksi, dihitung per proses Claude Code daripada per sesi, seperti yang dijelaskan untuk `event.sequence`
`parent.source`	Bagaimana span mendapat induk jejak: `env` ketika itu induk di bawah `TRACEPARENT` masuk, `none` ketika itu memulai jejak sendiri. Memerlukan Claude Code v2.1.268 atau lebih baru
`interaction.duration_ms`	Durasi wall-clock dari giliran

claude_code.llm_request

Atribut	Deskripsi	Gerbang oleh
`model`	Pengenal model
`gen_ai.system`	Selalu `anthropic`. Konvensi semantik GenAI OpenTelemetry
`gen_ai.request.model`	Nilai yang sama dengan `model`. Konvensi semantik GenAI OpenTelemetry
`query_source`	Subsistem yang mengeluarkan permintaan, seperti `repl_main_thread` atau nama subagen	`ENABLE_BETA_TRACING_DETAILED`
`query_source_safe`	Bentuk terbatas dari `query_source`, dipancarkan apakah atau tidak tracing beta terperinci aktif, dengan nilai seperti `repl_main_thread` atau `agent.builtin.general-purpose`. `:` menjadi `.` dan agen bernama pengguna muncul sebagai `agent.custom`. Memerlukan Claude Code v2.1.268 atau lebih baru
`agent_id`	Pengenal subagen atau rekan kerja yang mengeluarkan permintaan. Tidak ada pada sesi utama
`parent_agent_id`	Pengenal agen yang memunculkan yang ini. Tidak ada untuk sesi utama dan untuk agen yang dimunculkan langsung darinya
`workflow.run_id`	Pengenal jalankan dari alat Workflow yang memunculkan agen ini, dengan awalan `wf_`. Tidak ada untuk agen yang tidak dimunculkan oleh workflow
`workflow.name`	Nama workflow yang memunculkan agen ini. Nama yang ditulis pengguna diganti dengan `custom` kecuali gerbang diatur	`OTEL_LOG_TOOL_DETAILS`
`speed`	`fast` atau `normal`
`effort`	Tingkat upaya yang diterapkan pada permintaan: `low`, `medium`, `high`, `xhigh`, atau `max`. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya. Memerlukan Claude Code v2.1.274 atau lebih baru
`llm_request.context`	`interaction`, `tool`, atau `standalone` tergantung pada span induk
`duration_ms`	Durasi wall-clock termasuk percobaan ulang
`ttft_ms`	Waktu ke token pertama dalam milidetik
`first_content_ms`	Waktu dari awal permintaan ke blok konten pertama dari upaya yang berhasil, dalam milidetik. Tidak ada pada permintaan yang kembali ke jalur non-streaming. Memerlukan Claude Code v2.1.268 atau lebih baru
`input_tokens`	Jumlah token input dari blok penggunaan API
`output_tokens`	Jumlah token output
`cache_read_tokens`	Token yang dibaca dari cache prompt
`cache_creation_tokens`	Token yang ditulis ke cache prompt
`request_id`	ID permintaan API. Nilai yang sama dengan atribut korelasi event `request_id` event correlation attribute
`gen_ai.response.id`	Nilai yang sama dengan `request_id`. Konvensi semantik GenAI OpenTelemetry
`client_request_id`	`x-client-request-id` yang dihasilkan klien dari upaya terakhir
`attempt`	Total upaya yang dilakukan untuk permintaan ini
`success`	`true` atau `false`
`status_code`	Kode status HTTP ketika permintaan gagal
`error`	Pesan kesalahan ketika permintaan gagal
`error_class`	Token kelas kesalahan pendek ketika permintaan gagal, seperti `api_timeout` atau `server_overload`. Memerlukan Claude Code v2.1.268 atau lebih baru
`response.has_tool_call`	`true` ketika respons berisi blok tool-use
`stop_reason`	API response `stop_reason`, seperti `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn`, atau `refusal`
`gen_ai.response.finish_reasons`	Nilai yang sama dengan `stop_reason`, dibungkus dalam array string. Konvensi semantik GenAI OpenTelemetry

Setiap upaya percobaan ulang juga dicatat sebagai event span gen_ai.request.attempt dengan atribut attempt dan client_request_id.

claude_code.tool

Atribut	Deskripsi	Gerbang oleh
`tool_name`	Nama alat
`tool_name_safe`	Bentuk `tool_name` yang tidak membawa nama yang dipilih pengguna. Nama alat bawaan lulus verbatim. Nama alat MCP muncul sebagai `mcp_other`, kecuali nama alat yang cocok dengan beberapa bentuk tetap, seperti alat `playwright` bernama `browser_*`, yang lulus verbatim. Memerlukan Claude Code v2.1.268 atau lebih baru
`bash_command_class`	Untuk alat Bash: kategori program pertama perintah dari daftar tetap, seperti `vcs` atau `package_manager`. `other` untuk program di luar daftar, `unparsed` ketika baris tidak dapat diuraikan. Memerlukan Claude Code v2.1.268 atau lebih baru
`bash_argv0`	Untuk alat Bash: program pertama perintah ketika itu ada di daftar tetap yang sama, seperti `git` atau `npm`. `other` untuk program apa pun di luar daftar. Memerlukan Claude Code v2.1.268 atau lebih baru
`duration_ms`	Durasi wall-clock termasuk tunggu izin dan eksekusi
`result_tokens`	Ukuran token perkiraan dari hasil alat
`agent_id`	Pengenal subagen atau rekan kerja yang menjalankan alat. Tidak ada pada sesi utama
`parent_agent_id`	Pengenal agen yang memunculkan yang ini. Tidak ada untuk sesi utama dan untuk agen yang dimunculkan langsung darinya
`workflow.run_id`	Pengenal jalankan dari alat Workflow yang memunculkan agen ini, dengan awalan `wf_`. Tidak ada untuk agen yang tidak dimunculkan oleh workflow
`workflow.name`	Nama workflow yang memunculkan agen ini. Nama yang ditulis pengguna diganti dengan `custom` kecuali gerbang diatur	`OTEL_LOG_TOOL_DETAILS`
`tool_use_id`	ID blok `tool_use` model untuk panggilan ini. Cocok dengan `tool_use_id` pada event tool_result dan tool_decision serta dalam payload hook, sehingga Anda dapat menghubungkan span ke catatan tersebut
`gen_ai.tool.call.id`	Nilai yang sama dengan `tool_use_id`. Konvensi semantik GenAI OpenTelemetry
`file_path`	Jalur file target untuk alat Read, Edit, dan Write	`OTEL_LOG_TOOL_DETAILS`
`full_command`	String perintah untuk alat Bash	`OTEL_LOG_TOOL_DETAILS`
`skill_name`	Nama skill untuk alat Skill	`OTEL_LOG_TOOL_DETAILS`
`subagent_type`	Jenis subagen untuk alat Agent atau alat Task warisan	`OTEL_LOG_TOOL_DETAILS`

tool.output span event pada claude_code.tool

Jika Anda menetapkan OTEL_LOG_TOOL_CONTENT=1, panggilan Read dan Bash dapat mencatat event span tool.output pada span claude_code.tool. Panggilan Edit dan Write mencatat satu hanya ketika Anda juga menetapkan OTEL_LOG_TOOL_DETAILS=1. Variabel itu tidak dibatasi pada kedua alat itu, jadi periksa barisnya dalam tabel konfigurasi untuk argumen yang ditambahkannya di tempat lain.

Alat MCP, WebFetch, dan WebSearch juga mencatat event ini, pada Claude Code v2.1.283 atau lebih baru.

Claude Code menulis event ini dari pengembalian sukses panggilan alat, jadi panggilan yang menimbulkan kesalahan tidak mencatat apa pun, apa pun alatnya. Di antara panggilan yang memang kembali, itu tidak mencatat event tool.output untuk:

Panggilan ke alat apa pun selain Read, Edit, Write, Bash, WebFetch, WebSearch, dan alat MCP
Read yang mengembalikan apa pun selain teks file, seperti gambar, PDF, atau pembacaan ulang file yang isinya belum berubah
Panggilan Edit atau Write, kecuali Anda juga menetapkan OTEL_LOG_TOOL_DETAILS=1
Panggilan WebFetch atau WebSearch yang Claude Code pindahkan ke latar belakang karena Anda mengganggu giliran untuk mengirim pesan antrian Anda segera saat panggilan berjalan. Claude menerima hasil itu nanti, setelah span alat berakhir

Event membawa atribut ini, masing-masing dipotong pada batas konten (60 KB secara default). Gerbang oleh menamai variabel yang atribut butuhkan di atas OTEL_LOG_TOOL_CONTENT=1, dan untuk Edit dan Write variabel itu membuka gerbang event itu sendiri daripada atribut.

Atribut	Deskripsi	Gerbang oleh
`content`	Teks yang dikembalikan alat Read, atau teks yang diminta panggilan Write untuk ditulis	`OTEL_LOG_TOOL_DETAILS` untuk alat Write
`output`	Untuk alat Bash, output gabungan perintah, dengan stderr yang disisipi ke stdout. Untuk alat MCP, WebFetch, atau WebSearch, hasil yang dikembalikan alat: blok teks digabung dengan baris baru, dengan gambar atau dokumen diganti dengan placeholder seperti `[image]`
`diff`	Patch terstruktur yang diterapkan alat Edit	`OTEL_LOG_TOOL_DETAILS`
`file_path`	Jalur file target untuk alat Read, Edit, dan Write, mengulangi atribut span dengan nama yang sama	`OTEL_LOG_TOOL_DETAILS`
`bash_command`	String perintah untuk alat Bash	`OTEL_LOG_TOOL_DETAILS`

Atribut tool_name span induk memberi tahu Anda alat mana yang berasal dari event. Atribut yang dipotong pada batas konten disertai dengan <attribute>_truncated dan <attribute>_original_length.

claude_code.tool.blocked_on_user

Atribut	Deskripsi	Gerbang oleh
`duration_ms`	Waktu yang dihabiskan menunggu keputusan izin
`decision`	`accept` atau `reject`
`source`	Sumber keputusan, cocok dengan Tool decision event

claude_code.tool.execution

Atribut	Deskripsi	Gerbang oleh
`duration_ms`	Waktu yang dihabiskan menjalankan badan alat
`tool_use_id`	Nilai yang sama dengan span `claude_code.tool` induk
`gen_ai.tool.call.id`	Nilai yang sama dengan `tool_use_id`. Konvensi semantik GenAI OpenTelemetry
`success`	`true` atau `false`
`error`	String kategori kesalahan ketika eksekusi gagal, seperti `Error:ENOENT` atau `ShellError`. Berisi pesan kesalahan lengkap sebagai gantinya ketika gerbang diatur	`OTEL_LOG_TOOL_DETAILS`
`error_class`	Kategori kesalahan dalam bentuk pengenal, dengan karakter di luar huruf, digit, dan garis bawah diganti dengan `_`, seperti `Error_ENOENT` atau `ShellError`. Membawa kategori bahkan ketika `error` membawa pesan lengkap. Memerlukan Claude Code v2.1.268 atau lebih baru

claude_code.hook

Span ini muncul hanya ketika tracing beta terperinci aktif, yang memerlukan ENABLE_BETA_TRACING_DETAILED=1 dan BETA_TRACING_ENDPOINT, pasangan yang juga mengubah tempat log dan jejak Anda pergi. Atur pasangan dalam shell, pengaturan pengguna, atau pengaturan terkelola; kedua variabel diabaikan dalam pengaturan proyek dan lokal. CLAUDE_CODE_ENHANCED_TELEMETRY_BETA saja tidak menghasilkannya.

Dalam sesi CLI interaktif, tracing beta terperinci juga memerlukan organisasi Anda untuk diizinkan untuk fitur tersebut. Sesi Agent SDK dan non-interaktif -p tidak memerlukan izin.

Atribut	Deskripsi	Gerbang oleh
`hook_event`	Jenis event hook, seperti `PreToolUse`
`hook_name`	Nama hook lengkap, seperti `PreToolUse:Write`
`num_hooks`	Jumlah perintah hook yang cocok dieksekusi
`hook_definitions`	Konfigurasi hook yang diserialisasi JSON	`OTEL_LOG_TOOL_DETAILS`
`duration_ms`	Durasi wall-clock dari semua hook yang cocok
`num_success`	Jumlah hook yang diselesaikan dengan sukses
`num_blocking`	Jumlah hook yang mengembalikan keputusan pemblokiran
`num_non_blocking_error`	Jumlah hook yang gagal tanpa memblokir
`num_cancelled`	Jumlah hook yang dibatalkan sebelum penyelesaian

Note

Atribut tambahan yang membawa konten seperti new_context, system_prompt_preview, user_system_prompt, tool_input, dan response.model_output dipancarkan hanya ketika tracing beta terperinci aktif. Mereka bukan bagian dari skema span yang stabil.

Gerbang pada new_context tergantung pada span mana yang membawanya, dan setiap salinan dipotong pada batas konten (60 KB secara default). Pada span claude_code.tool itu membawa hasil panggilan alat itu, apa pun alatnya, dan memerlukan OTEL_LOG_TOOL_CONTENT=1. Pada span claude_code.interaction itu membawa prompt pengguna, dan pada span claude_code.llm_request pesan pengguna baru dan hasil alat dari permintaan itu. Keduanya memerlukan OTEL_LOG_USER_PROMPTS=1.

user_system_prompt juga memerlukan OTEL_LOG_USER_PROMPTS=1. Itu membawa hanya teks prompt sistem yang Anda berikan melalui opsi SDK systemPrompt atau flag --system-prompt dan --append-system-prompt, dipotong pada batas konten (60 KB secara default), dan dipancarkan sekali per sesi daripada per permintaan.

Header dinamis

Untuk lingkungan perusahaan yang memerlukan autentikasi dinamis, Anda dapat mengonfigurasi skrip untuk menghasilkan header secara dinamis. Header dinamis berlaku hanya untuk protokol http/protobuf dan http/json. Dengan protokol grpc, Claude Code hanya menggunakan variabel header statis, OTEL_EXPORTER_OTLP_HEADERS dan varian spesifik sinyal-nya.

Konfigurasi pengaturan

Tambahkan ke .claude/settings.json Anda, ganti jalur dengan skrip Anda sendiri:

{
  "otelHeadersHelper": "/path/to/generate-otel-headers.sh"
}

Nilai dapat berupa jalur ke file yang dapat dieksekusi, termasuk jalur yang berisi spasi, atau baris perintah shell dengan argumen. Di Windows, nilai selalu berjalan melalui shell, jadi kutip jalur yang berisi spasi di dalam nilai JSON.

Persyaratan skrip

Skrip harus menampilkan JSON yang valid dengan pasangan kunci-nilai string yang mewakili header HTTP:

#!/bin/bash
# Contoh: Multiple headers
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

Jika helper gagal atau mencetak output yang tidak memenuhi persyaratan ini, ekspor gagal dan backend telemetri Anda tidak menerima apa pun dari sesi sampai helper berfungsi lagi. Claude Code melaporkan kegagalan dalam:

Notifikasi peringatan dalam sesi interaktif, otelHeadersHelper failed; telemetry is not being exported, ditampilkan sekali per sesi ketika helper pertama kali gagal
Output /status
Log debug, saat berjalan dengan --debug atau setelah menjalankan /debug dalam sesi
stderr, dalam sesi non-interaktif yang dimulai dengan -p

Perilaku penyegaran

Skrip helper header berjalan saat startup dan secara berkala setelahnya untuk mendukung penyegaran token. Secara default, skrip berjalan setiap 29 menit. Sesuaikan interval dengan variabel lingkungan CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS.

Dukungan organisasi multi-tim

Organisasi dengan beberapa tim atau departemen dapat menambahkan atribut kustom untuk membedakan antara kelompok yang berbeda menggunakan variabel lingkungan OTEL_RESOURCE_ATTRIBUTES:

# Tambahkan atribut kustom untuk identifikasi tim
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

Atribut kustom ini disertakan dalam semua metrik dan event, memungkinkan Anda untuk:

Filter metrik berdasarkan tim atau departemen
Lacak biaya per pusat biaya
Buat dashboard khusus tim
Atur peringatan untuk tim tertentu

Claude Code melampirkan nilai-nilai ini sebagai atribut pada setiap titik data metrik dan catatan event, selain mengirimkannya dalam blok sumber daya OTLP. Karena sebagian besar backend metrik mengekspos atribut titik data sebagai label yang dapat dipertanyakan, Anda dapat mengelompokkan dan memfilter metrik berdasarkan kunci kustom Anda secara langsung. Kecuali untuk atribut repositori vcs.* repository attributes, kunci kustom tidak pernah menimpa atribut standar seperti user.id atau session.id: ketika kunci bertabrakan, Claude Code menyimpan nilai bawaan.

Setiap kunci kustom menjadi label pada setiap seri metrik, jadi nilai kardinalitas tinggi meningkatkan biaya penyimpanan di backend metrik Anda. Untuk mengirim atribut kustom dalam blok sumber daya saja dan menghilangkannya dari label titik data, atur OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false. Lihat Kontrol kardinalitas metrik.

Warning

Variabel lingkungan OTEL_RESOURCE_ATTRIBUTES menggunakan pasangan kunci=nilai yang dipisahkan koma dengan persyaratan pemformatan yang ketat:

Tidak ada spasi yang diizinkan: nilai tidak dapat berisi spasi. Misalnya, user.organizationName=My Company tidak valid
Format: harus berupa pasangan kunci=nilai yang dipisahkan koma: key1=value1,key2=value2
Karakter yang diizinkan: hanya karakter US-ASCII yang mengecualikan karakter kontrol, spasi, tanda kutip ganda, koma, titik koma, dan garis miring terbalik
Karakter khusus: karakter di luar rentang yang diizinkan harus dikodekan persen

Untuk nilai yang memerlukan spasi, gunakan garis bawah atau camelCase sebagai gantinya. Contoh berikut menetapkan org.name dengan setiap bentuk:

export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

Anda dapat mengkodekan persen karakter apa pun, bukan hanya yang dikecualikan. Contoh ini mengkodekan spasi dan apostrof:

export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

Membungkus nilai dalam tanda kutip tidak menghindari spasi. Misalnya, org.name="My Company" menghasilkan nilai literal "My Company" dengan tanda kutip disertakan, bukan My Company.

Konfigurasi contoh

Atur variabel lingkungan ini sebelum menjalankan claude. Setiap skenario di bawah menunjukkan konfigurasi lengkap, dan setiap variabel dijelaskan di bawah Variabel konfigurasi umum. Untuk mengonfirmasi konfigurasi berlaku, periksa backend Anda untuk metrik claude_code.session.count setelah memulai sesi; Quick start mencakup verifikasi log saja dan apa yang harus diperiksa ketika tidak ada yang tiba.

Untuk debugging konsol dengan interval ekspor 1 detik:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

Untuk OTLP melalui gRPC:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Untuk Prometheus, yang discrape dari http://localhost:9464/metrics:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

Pada lingkungan yang di-host sendiri, sesi mengikat port 9464 hanya pada kapasitas default runner satu. Pada kapasitas yang lebih tinggi, runner kembali mengekspos penghitung dan gauge sesi pada endpoint /metrics miliknya sendiri sebagai gantinya.

Untuk mengirim metrik ke beberapa eksporter:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

Untuk mengirim metrik dan log ke endpoint atau backend yang berbeda:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

Untuk mengekspor metrik saja, tanpa event atau log:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Untuk mengekspor event dan log saja, tanpa metrik:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Telemetri dari sesi cloud dan Claude Tag

Sesi cloud, termasuk sesi saluran Claude Tag, berjalan di lingkungan cloud daripada di perangkat pengguna Anda, jadi file pengaturan terkelola atau profil shell di perangkat tersebut tidak mengonfigurasi telemetri mereka. Untuk sesi di lingkungan yang dihosting Anthropic, bagian ini mencakup tempat untuk menetapkan variabel telemetri, cara membuat kolektor Anda dapat diakses dari lingkungan, dan cara membedakan sesi cloud dan Claude Tag dalam data yang diekspor.

Untuk mengekspor telemetri dari sesi tersebut, atur CLAUDE_CODE_ENABLE_TELEMETRY dan variabel OTEL_*, menggunakan kunci yang sama seperti contoh konfigurasi administrator, di salah satu dari dua tempat:

Pengaturan yang dikelola server: tambahkan ke blok env dari pengaturan yang dikelola server organisasi Anda. Claude Code mengambil pengaturan tersebut saat startup di mana pun pengaturan yang dikelola server berlaku, yang mencakup mesin pengguna Anda dan sesi cloud selain sesi saluran Claude Tag. Sesi Claude Tag tidak menerima pengaturan yang dikelola server Anda, jadi rute ini tidak mengonfigurasinya.
Variabel lingkungan: tambahkan ke variabel lingkungan lingkungan cloud untuk mengonfigurasi hanya sesi yang berjalan di lingkungan tersebut. Ini adalah rute yang menjangkau sesi Claude Tag.

Siapa pun yang menggunakan lingkungan dapat membaca variabelnya, jadi jangan letakkan kredensial di sana, seperti token kolektor di OTEL_EXPORTER_OTLP_HEADERS. Kredensial API di lingkungan juga tidak membantu, karena ekspor telemetri Claude Code sendiri adalah salah satu dari permintaan yang tidak pernah mendapatkan kredensial. Jika kolektor Anda memerlukan kredensial, konfigurasikan seluruh ekspor melalui pengaturan yang dikelola server sebagai gantinya, karena ketika Anda menetapkan kredensial di sana, Claude Code menghapus variabel titik akhir yang ditetapkan di luar pengaturan terkelola.

Pertahankan batasan ini dalam pikiran ketika Anda mengonfigurasi telemetri untuk sesi cloud:

Biarkan sesi menjangkau kolektor: Claude Code mengirim ekspor melalui jaringan sesi, jadi apakah itu menjangkau host di OTEL_EXPORTER_OTLP_ENDPOINT Anda tergantung pada tingkat akses jaringan lingkungan. Jika sesi tidak dapat menjangkau domain kolektor pada tingkat yang Anda pilih, tambahkan domain ke daftar izin lingkungan, karena tidak ada pengaturan yang dikelola server yang menambahkan domain ke daftar izin jaringan lingkungan.
Saluran Claude Tag menggunakan lingkungan tingkat organisasi: sesi saluran berjalan di lingkungan tingkat organisasi daripada lingkungan pribadi anggota, jadi buat perubahan daftar izin dan variabel lingkungan apa pun di lingkungan bersama yang ditetapkan sebagai default organisasi Anda atau disematkan ke saluran.
Cowork dikonfigurasi secara terpisah: sesi Cowork tidak menerima pengaturan yang dikelola server, seperti yang ditunjukkan tabel cakupan permukaan, jadi blok env yang dikelola server tidak mengonfigurasi telemetri mereka.

Atribut telemetri ke sesi cloud

Secara default, metrik dan acara dari sesi cloud membawa atribut standar, termasuk session.id, ccr.session.id, dan organization.id, sehingga Anda dapat memfilter berdasarkan sesi atau organisasi tanpa konfigurasi tambahan. Nilai ccr.session.id adalah CLAUDE_CODE_REMOTE_SESSION_ID sesi. Untuk mengubahnya menjadi URL transkrip sesi, lihat Tautkan output kembali ke sesi.

Untuk mengatribusikan telemetri secara lebih detail, gunakan opsi berikut:

Identifikasi sesi Claude Tag: atur OTEL_METRICS_INCLUDE_ENTRYPOINT=true, seperti yang dijelaskan di bawah Kontrol kardinalitas metrik. Metrik kemudian membawa app.entrypoint, yang nilainya adalah claude-in-slack untuk sesi Claude Tag.
Tambahkan atribut kustom: atur OTEL_RESOURCE_ATTRIBUTES di tempat yang sama di mana Anda menetapkan variabel OTEL_* lainnya untuk sesi tersebut. Jika Anda export di skrip setup lingkungan sebagai gantinya, nilainya tidak mencapai Claude Code: skrip setup adalah skrip Bash terpisah yang berjalan sebelum Claude Code diluncurkan, dan variabel yang diekspor berakhir dengannya.

Dalam sesi saluran Claude Tag, Claude bekerja sebagai identitas bersama organisasi Anda daripada sebagai anggota apa pun, jadi jangan andalkan atribut user.* untuk mengidentifikasi siapa yang menandai Claude.

Metrik dan peristiwa yang tersedia

Atribut standar

Semua metrik dan peristiwa berbagi atribut standar ini:

Atribut	Deskripsi	Dikendalikan Oleh
`session.id`	Pengenal sesi unik	`OTEL_METRICS_INCLUDE_SESSION_ID` (default: true)
`ccr.session.id`	Pengenal sesi cloud, nilai dari `CLAUDE_CODE_REMOTE_SESSION_ID`, pada sesi yang berjalan di lingkungan cloud	`OTEL_METRICS_INCLUDE_SESSION_ID` (default: true)
`app.version`	Versi Claude Code saat ini	`OTEL_METRICS_INCLUDE_VERSION` (default: false)
`app.entrypoint`	Bagaimana sesi diluncurkan, seperti `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-vscode`, atau `claude-in-slack` untuk sesi Claude Tag	`OTEL_METRICS_INCLUDE_ENTRYPOINT` (default: false)
`organization.id`	UUID organisasi (saat diautentikasi)	Selalu disertakan saat tersedia
`user.account_uuid`	UUID akun (saat diautentikasi)	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (default: true)
`user.account_id`	ID akun dalam format tagged yang cocok dengan API admin Anthropic (saat diautentikasi), seperti `user_01BWBeN28...`	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (default: true)
`user.id`	Pengenal anonim acak yang dihasilkan pada run pertama dan disimpan di `~/.claude.json`. Tidak mengandung informasi pribadi dan tidak berasal dari akun Claude Anda. Menghapus file menghasilkan nilai yang tidak terkait pada run berikutnya.	Selalu disertakan
`user.email`	Alamat email pengguna, dari sign-in Anda atau, dalam sesi cloud, dari kredensial sesi itu sendiri	Selalu disertakan saat tersedia
`terminal.type`	Jenis terminal, seperti `iTerm.app`, `vscode`, `cursor`, atau `tmux`	Selalu disertakan saat terdeteksi
Kunci dari `OTEL_RESOURCE_ATTRIBUTES`	Atribut kustom yang Anda tetapkan, seperti `department` atau `team.id`. Lihat Dukungan organisasi multi-tim	`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (default: true)
`vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name`	Identitas repositori sesi, berasal dari remote `origin`-nya. Lihat Atribut repositori	`OTEL_METRICS_INCLUDE_REPOSITORY` (default: false). Memerlukan Claude Code v2.1.269 atau lebih baru

Ketika Claude Code masuk ke gateway aplikasi Claude, CLI memberi stempel ekspor dengan identitas terautentikasi dari sesi gateway: user.id adalah subjek IdP daripada pengenal instalasi anonim, user.email adalah email yang masuk, dan user.groups membawa keanggotaan grup IdP sebagai string yang dipisahkan koma. Setiap ekspor juga membawa identity.source: gateway-oidc. Identitas gateway diterapkan terakhir, jadi kunci user.* dan identity.* yang ditetapkan melalui OTEL_RESOURCE_ATTRIBUTES diabaikan pada sesi gateway.

Peristiwa juga menyertakan atribut berikut. Ini tidak pernah dilampirkan ke metrik karena akan menyebabkan kardinalitas tak terbatas:

prompt.id: UUID yang menghubungkan prompt pengguna dengan semua peristiwa berikutnya hingga prompt berikutnya. Lihat Atribut korelasi peristiwa.
workspace.host_paths: direktori workspace host yang dipilih di aplikasi desktop, sebagai array string
workflow.run_id: pengenal run, dengan awalan wf_, pada peristiwa API dan alat yang dipancarkan oleh agen yang termasuk dalam run alat Workflow. Memfilter peristiwa berdasarkan satu workflow.run_id merekonstruksi permintaan API dan hasil alat run tersebut. Pengenal mencakup agen yang dihasilkan skrip workflow dan agen apa pun yang dihasilkan agen tersebut, seperti invokasi skill. Ini cocok dengan pengenal run yang dilaporkan dalam hasil alat Workflow. Tidak ada pada semua peristiwa lainnya. Memerlukan Claude Code v2.1.202 atau lebih baru
workflow.name: nama workflow, meta.name skrip-nya, dipancarkan bersama workflow.run_id. Nama workflow bawaan muncul verbatim saat run mengeksekusi skrip bawaan yang tidak dimodifikasi. Nama yang ditulis pengguna, termasuk salinan yang diedit dari skrip bawaan, diganti dengan custom kecuali OTEL_LOG_TOOL_DETAILS=1 diatur. Memerlukan Claude Code v2.1.202 atau lebih baru

Atribut repositori

Atur OTEL_METRICS_INCLUDE_REPOSITORY=true untuk menandai metrik dan peristiwa dengan identitas repositori sesi, sehingga kolektor bersama dapat mengatribusikan penggunaan per repositori. Memerlukan Claude Code v2.1.269 atau lebih baru.

Claude Code menurunkan atribut ini sekali per sesi dari remote origin repositori. Ketika remote HTTPS dan SSH dari repositori menamai host dan path yang sama, seperti yang mereka lakukan di GitHub, GitLab, dan Bitbucket Cloud, keduanya menghasilkan nilai yang identik:

Atribut	Nilai
`vcs.repository.url.full`	URL browser repositori tanpa `.git`, seperti `https://github.com/example-org/example-repo`
`vcs.owner.name`	Path pemilik atau grup, seperti `example-org`; dihilangkan ketika path remote memiliki satu segmen
`vcs.repository.name`	Nama repositori bare, seperti `example-repo`
`vcs.provider.name`	`github`, `gitlab`, `bitbucket`, atau `gitea` ketika Claude Code mengenali host remote atau bentuk URL sebagai salah satu penyedia tersebut; dihilangkan sebaliknya

Nilai diubah menjadi huruf kecil, dan kredensial, string kueri, dan fragmen dari URL remote tidak pernah muncul di dalamnya. Atribut dihilangkan ketika sesi tidak memiliki remote origin, ketika remote tidak berbentuk URL, atau ketika satu-satunya repositori yang menutup adalah direktori home Anda.

Untuk mendapatkan atribut ini dari sesi cloud, atur variabel telemetri, termasuk OTEL_METRICS_INCLUDE_REPOSITORY, pada lingkungan cloud-nya. Juga izinkan domain kolektor Anda di akses jaringan lingkungan.

Kunci vcs.* yang Anda deklarasikan dalam OTEL_RESOURCE_ATTRIBUTES menggantikan nilai yang diturunkan untuk kunci tersebut. Jika Anda mendeklarasikan vcs.repository.url.full, Claude Code tidak pernah membaca remote dan hanya melaporkan kunci yang Anda deklarasikan.

Jika klon HTTPS dan SSH dari satu repositori melaporkan nilai yang berbeda, seperti pada instalasi yang di-host sendiri yang URL klon HTTPS-nya membawa awalan path yang URL SSH tidak memiliki, deklarasikan vcs.repository.url.full dalam OTEL_RESOURCE_ATTRIBUTES bersama dengan setiap kunci vcs.* lainnya yang ingin Anda laporkan. Setiap klon kemudian melaporkan identitas yang Anda deklarasikan.

Atribut hanya mengalir ke eksporter Anda sendiri; telemetri Anthropic menghilangkan setiap kunci vcs.*.

Metrik

Claude Code mengekspor metrik berikut. Kolom Unit menunjukkan string unit OpenTelemetry yang dilampirkan ke setiap metrik; metrik penghitung tidak membawa apa pun.

Nama Metrik	Deskripsi	Unit
`claude_code.session.count`	Jumlah sesi CLI yang dimulai	none
`claude_code.lines_of_code.count`	Jumlah baris kode yang dimodifikasi	none
`claude_code.pull_request.count`	Jumlah pull request yang dibuat	none
`claude_code.commit.count`	Jumlah git commit yang dibuat	none
`claude_code.cost.usage`	Biaya sesi Claude Code	USD
`claude_code.token.usage`	Jumlah token yang digunakan	tokens
`claude_code.code_edit_tool.decision`	Jumlah keputusan izin alat pengedit kode	none
`claude_code.active_time.total`	Total waktu aktif	s

Ketika prometheus adalah satu-satunya eksporter yang terdaftar dalam OTEL_METRICS_EXPORTER, Claude Code menghilangkan unit USD, tokens, dan s dari metrik yang diekspor sehingga scrape tetap format teks Prometheus yang valid. Nama metrik tidak berubah, dan konfigurasi yang menggabungkan eksporter, seperti otlp,prometheus, menyimpan unit. Sebelum v2.1.216, scrape Prometheus menyertakan baris # UNIT khusus OpenMetrics yang beberapa scraper menolak.

Detail metrik

Setiap metrik menyertakan atribut standar yang tercantum di atas. Metrik dengan atribut konteks tambahan dicatat di bawah.

Penghitung sesi

Ditingkatkan pada awal setiap sesi.

Atribut:

Semua atribut standar
start_type: Bagaimana sesi dimulai. Salah satu dari "fresh", "resume", "continue", atau "agents_view". Nilai "agents_view" mengidentifikasi proses dashboard claude agents, UI lokal yang diluncurkan pengguna daripada sesi percakapan. Filter pada nilai ini untuk memisahkan peluncuran proses UI dari sesi percakapan di dashboard Anda.

Penghitung baris kode

Ditingkatkan ketika kode ditambahkan atau dihapus.

Atribut:

Semua atribut standar
type: ("added", "removed")
model: Pengenal model untuk model yang membuat perubahan (misalnya, "claude-sonnet-5")

Penghitung pull request

Ditingkatkan ketika Claude Code membuat pull request atau merge request melalui perintah shell atau alat MCP.

Atribut:

Semua atribut standar

Penghitung commit

Ditingkatkan saat membuat git commit melalui Claude Code.

Atribut:

Semua atribut standar

Penghitung biaya

Ditingkatkan setelah setiap permintaan API.

Atribut agent.name, skill.name, plugin.name, mcp_server.name, dan mcp_tool.name masing-masing menyunting beberapa nama menjadi placeholder "custom" atau "third-party" secara default. Jika Anda mengatur OTEL_LOG_TOOL_DETAILS=1, mereka membawa nama asli sebagai gantinya. Sebelum v2.1.273, penghitung biaya dan token serta peristiwa api_request, api_error, dan api_refusal membawa nilai yang disunting bahkan dengan OTEL_LOG_TOOL_DETAILS=1 diatur.

Atribut:

Semua atribut standar
model: Pengenal model (misalnya, "claude-sonnet-5")
query_source: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari "main", "subagent", atau "auxiliary"
speed: "fast" ketika permintaan menggunakan mode cepat. Tidak ada sebaliknya
effort: Tingkat upaya yang diterapkan pada permintaan: "low", "medium", "high", "xhigh", atau "max". Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.
agent.name: Jenis subagen yang mengeluarkan permintaan. Nama agen bawaan dan agen dari plugin marketplace resmi muncul verbatim. Nama agen yang ditentukan pengguna lainnya diganti dengan "custom". Tidak ada ketika permintaan tidak dikeluarkan oleh jenis subagen bernama.
skill.name: Skill aktif untuk permintaan, diatur oleh alat Skill atau perintah /, atau diwarisi oleh subagen yang dihasilkan. Nama skill bawaan, bundel, yang ditentukan pengguna, dan plugin marketplace resmi muncul verbatim. Nama skill plugin pihak ketiga diganti dengan "third-party". Tidak ada ketika tidak ada skill yang aktif.
plugin.name: Plugin pemilik ketika skill aktif atau subagen disediakan oleh plugin. Nama plugin marketplace resmi muncul verbatim. Nama plugin pihak ketiga diganti dengan "third-party". Tidak ada ketika skill maupun subagen memiliki plugin pemilik.
marketplace.name: Marketplace tempat plugin pemilik diinstal. Hanya dipancarkan untuk plugin marketplace resmi, bahkan dengan OTEL_LOG_TOOL_DETAILS=1 diatur. Tidak ada sebaliknya.
mcp_server.name: Server MCP yang hasil alat ini dikonsumsi permintaan. Nama server bawaan, yang di-proxy claude.ai, dan registry resmi muncul verbatim. Nama server yang dikonfigurasi pengguna diganti dengan "custom". Tidak ada ketika permintaan tidak mengonsumsi hasil alat MCP. Sebelum v2.1.222, Claude Code menetapkan atribut ini pada setiap permintaan setelah panggilan alat MCP, bukan hanya pada permintaan yang mengonsumsi hasil alat, jadi dashboard yang mengagregasinya menunjukkan penurunan setelah Anda upgrade.
mcp_tool.name: Alat MCP yang hasil ini dikonsumsi permintaan, dengan perilaku penyuntingan dan versi yang sama dengan mcp_server.name. Tidak ada ketika permintaan tidak mengonsumsi hasil alat MCP.

Penghitung token

Ditingkatkan setelah setiap permintaan API.

Atribut:

Semua atribut standar
type: ("input", "output", "cacheRead", "cacheCreation")
model: Pengenal model (misalnya, "claude-sonnet-5")
query_source: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari "main", "subagent", atau "auxiliary"
speed: "fast" ketika permintaan menggunakan mode cepat. Tidak ada sebaliknya
effort: Tingkat upaya yang diterapkan pada permintaan. Lihat Penghitung biaya untuk detail.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat Penghitung biaya untuk definisi dan perilaku penyuntingan.

Penghitung keputusan alat pengedit kode

Ditingkatkan ketika pengguna menerima atau menolak penggunaan alat Edit, Write, atau NotebookEdit.

Atribut:

Semua atribut standar
tool_name: Nama alat ("Edit", "Write", "NotebookEdit")
decision: Keputusan pengguna ("accept", "reject")
source: Dari mana keputusan berasal. Salah satu dari "config", "hook", "user_permanent", "user_temporary", "user_abort", atau "user_reject". Lihat Peristiwa keputusan alat untuk apa arti setiap nilai.
language: Bahasa pemrograman file yang diedit, seperti "TypeScript", "Python", "JavaScript", atau "Markdown". Mengembalikan "unknown" untuk ekstensi file yang tidak dikenali.

Penghitung waktu aktif

Melacak waktu aktual yang dihabiskan untuk menggunakan Claude Code secara aktif, tidak termasuk waktu idle. Metrik ini ditingkatkan selama interaksi pengguna, seperti mengetik dan membaca respons, dan selama pemrosesan CLI, seperti eksekusi alat dan pembuatan respons AI.

Atribut:

Semua atribut standar
type: "user" untuk interaksi keyboard, "cli" untuk eksekusi alat dan respons AI

Peristiwa

Claude Code mengekspor peristiwa berikut melalui log/peristiwa OpenTelemetry (ketika OTEL_LOGS_EXPORTER dikonfigurasi):

Atribut korelasi peristiwa

Ketika pengguna mengirimkan prompt, Claude Code dapat membuat beberapa panggilan API dan menjalankan beberapa alat. Atribut prompt.id memungkinkan Anda menghubungkan semua peristiwa tersebut kembali ke prompt tunggal yang memicunya.

Atribut	Deskripsi
`prompt.id`	Pengenal UUID v4 yang menghubungkan semua peristiwa yang dihasilkan saat memproses prompt pengguna tunggal
`event.sequence`	Penghitung berbasis 0 untuk mengurutkan peristiwa, dihitung per proses Claude Code daripada per sesi
`message.uuid`	UUID pesan seperti yang disimpan dalam transkrip sesi, file `~/.claude/projects//.jsonl`. Hadir pada `assistant_response`, pada `api_response_body`, dan pada `user_prompt` kecuali untuk pengiriman perintah, yang dapat menghasilkan nol atau banyak pesan. Pada `assistant_response` dan `api_response_body`, ini adalah entri transkrip akhir respons, yang `parentUuid` giliran berikutnya rantai dari. Memerlukan Claude Code v2.1.214 atau lebih baru, atau v2.1.274 atau lebih baru pada `api_response_body`
`request_id`	ID yang ditetapkan server dari permintaan API, dibaca dari header respons `request-id`, seperti `req_011...`. Pada respons tanpa header `request-id`, seperti pada Amazon Bedrock, nilai berasal dari header `x-amzn-requestid` sebagai gantinya. Hadir pada `api_request`, `api_error`, `api_refusal`, `assistant_response`, dan `api_response_body` ketika respons membawa salah satu header. Cocok dengan atribut yang sama pada span trace `llm_request`. Sumber `x-amzn-requestid` memerlukan Claude Code v2.1.282 atau lebih baru
`client_request_id`	UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`. Hadir pada `api_request` dan `api_error` pada koneksi API pihak pertama; tidak ada pada backend penyedia pihak ketiga dan ketika permintaan diulang melalui fallback non-streaming. Memasangkan permintaan dengan responsnya dan tetap tersedia untuk kegagalan seperti timeout yang tidak pernah menghasilkan `request_id` server. Cocok dengan atribut yang sama pada span trace `llm_request`. Memerlukan Claude Code v2.1.214 atau lebih baru

Untuk melacak semua aktivitas yang dipicu oleh prompt tunggal, filter peristiwa Anda berdasarkan nilai prompt.id tertentu. Ini mengembalikan peristiwa user_prompt, peristiwa api_request apa pun, dan peristiwa tool_result apa pun yang terjadi saat memproses prompt tersebut.

event.sequence dimulai pada 0 setiap kali proses Claude Code dimulai dan menghitung untuk kehidupan proses tersebut. Terus menghitung di seluruh /clear, yang menetapkan session.id baru. Jika Anda melanjutkan sesi tanpa forking, sesi menyimpan session.id-nya tetapi mengambil nilai event.sequence-nya dari proses yang melanjutkannya, jadi dalam satu sesi peristiwa yang lebih baru dapat membawa nilai yang lebih rendah daripada yang lebih awal, atau mengulangi satu. Untuk mengurutkan peristiwa sesi, urutkan berdasarkan event.timestamp dan gunakan event.sequence untuk mengurutkan peristiwa yang berbagi timestamp.

Untuk rekonstruksi tingkat pesan, setiap kelas peristiwa membawa kunci yang cocok dengan bidang dalam transkrip sesi. Format entri transkrip adalah internal ke Claude Code dan berubah antar versi, jadi pipeline yang bergabung pada bidang ini dapat rusak pada rilis apa pun; perlakukan penggabungan sebagai spesifik versi daripada kontrak stabil:

message.uuid pada user_prompt, assistant_response, dan api_response_body
request_id pada peristiwa API, disimpan sebagai requestId pada entri asisten transkrip
tool_use_id pada peristiwa tool_result dan tool_decision

Peristiwa prompt pengguna

Dicatat ketika pengguna mengirimkan prompt.

Nama Peristiwa: claude_code.user_prompt

Atribut:

Semua atribut standar
event.name: "user_prompt"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
prompt_length: Panjang prompt
prompt: Konten prompt. Disunting secara default. Atur OTEL_LOG_USER_PROMPTS=1 untuk menyertakannya
message.uuid: UUID pesan pengguna yang dihasilkan, cocok dengan entri transkrip yang disimpan. Tidak ada pada pengiriman perintah, yang dapat menghasilkan nol atau banyak pesan. Memerlukan Claude Code v2.1.214 atau lebih baru
command_name: Nama perintah ketika prompt memanggil satu. Nama perintah bawaan dan bundel seperti compact atau debug dipancarkan apa adanya; alias seperti reset dipancarkan seperti yang diketik daripada nama kanonik. Nama perintah kustom, plugin, dan MCP runtuh menjadi custom atau mcp kecuali OTEL_LOG_TOOL_DETAILS=1 diatur
command_source: Asal perintah saat ada: builtin, custom, atau mcp. Perintah yang disediakan plugin melaporkan sebagai custom

Peristiwa respons asisten

Dicatat setelah setiap permintaan API yang mengembalikan konten teks dari model. Hanya blok teks respons yang disertakan; blok pemikiran dan blok penggunaan alat dikecualikan. Memerlukan Claude Code v2.1.193 atau lebih baru.

Nama Peristiwa: claude_code.assistant_response

Atribut:

Semua atribut standar
event.name: "assistant_response"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
response_length: Panjang teks respons dalam karakter
response: Teks respons, dipotong pada batas konten (60 KB secara default). Disunting menjadi <REDACTED> secara default. Atur OTEL_LOG_ASSISTANT_RESPONSES=1 untuk menyertakannya. Ketika OTEL_LOG_ASSISTANT_RESPONSES tidak diatur, OTEL_LOG_USER_PROMPTS mengontrolnya sebagai gantinya, jadi atur OTEL_LOG_ASSISTANT_RESPONSES=0 untuk menjaga respons disunting saat pencatatan prompt aktif
model: Pengenal model (misalnya, "claude-sonnet-5")
request_id: ID permintaan API, dijelaskan di bawah Atribut korelasi peristiwa
message.uuid: UUID entri transkrip akhir respons. Respons API disimpan sebagai satu entri transkrip per blok konten; ini adalah yang terakhir, yang parentUuid giliran berikutnya rantai dari. Memerlukan Claude Code v2.1.214 atau lebih baru
query_source: Subsistem yang mengeluarkan permintaan, seperti "repl_main_thread", "compact", atau nama subagen

Peristiwa hasil alat

Dicatat ketika alat menyelesaikan eksekusi. Tidak dipancarkan jika panggilan alat ditolak; lihat Peristiwa keputusan alat untuk penolakan.

Nama Peristiwa: claude_code.tool_result

Atribut:

Semua atribut standar
event.name: "tool_result"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
tool_name: Nama alat
tool_use_id: Pengenal unik untuk invokasi alat ini. Cocok dengan tool_use_id yang dilewatkan ke hooks, memungkinkan korelasi antara peristiwa OTel dan data yang ditangkap hook.
success: "true" atau "false"
duration_ms: Waktu eksekusi dalam milidetik
error_type: String kategori kesalahan ketika alat gagal, seperti "Error:ENOENT" atau "ShellError"
error (ketika OTEL_LOG_TOOL_DETAILS=1): Pesan kesalahan lengkap ketika alat gagal
decision_type: Selalu "accept", karena peristiwa ini hanya dipancarkan setelah alat berjalan. Panggilan yang ditolak tidak menghasilkan hasil alat
decision_source: Dari mana keputusan izin berasal. Salah satu dari "config", "hook", "user_permanent", atau "user_temporary". Lihat Peristiwa keputusan alat untuk apa arti setiap nilai. Sumber khusus penolakan "user_abort" dan "user_reject" tidak pernah muncul pada peristiwa ini.
tool_input_size_bytes: Ukuran input alat yang diserialisasi JSON dalam byte
tool_result_size_bytes: Ukuran hasil alat dalam byte
mcp_server_scope: Pengenal cakupan server MCP (untuk alat MCP)
vcs.ref.head.revision, vcs.ref.head.name, vcs.ref.head.type (ketika OTEL_LOG_TOOL_DETAILS=1): identitas commit dari run git commit yang berhasil oleh alat Bash atau PowerShell. vcs.ref.head.revision adalah SHA commit, vcs.ref.head.name adalah cabang tempat commit dilakukan, dan vcs.ref.head.type adalah branch. Nama dan jenis dihilangkan ketika commit dilakukan pada HEAD terlepas. Memerlukan Claude Code v2.1.269 atau lebih baru
tool_parameters (ketika OTEL_LOG_TOOL_DETAILS=1): String JSON yang berisi parameter khusus alat. Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, pasangan mcp_server_name/mcp_tool_name disertakan bahkan dengan flag off, pengecualian yang sama yang ditulis host seperti Peristiwa keputusan alat, memerlukan Claude Code v2.1.214 atau lebih baru. Parameter bervariasi menurut alat:
- Untuk alat Bash: menyertakan bash_command, full_command, timeout, description, dan dangerouslyDisableSandbox, ditambah git_commit_id dan git_branch ketika perintah git commit berhasil. git_commit_id adalah SHA commit lengkap ketika commit adalah HEAD dari direktori kerja sesi, dan SHA singkat git sebaliknya. git_branch adalah cabang tempat commit dilakukan, dihilangkan pada HEAD terlepas
- Untuk alat Bash workspace aplikasi desktop, yang juga melaporkan tool_name sebagai Bash: menyertakan hanya bash_command, full_command, dan timeout
- Untuk alat MCP: menyertakan mcp_server_name, mcp_tool_name
- Untuk alat Skill: menyertakan skill_name
- Untuk alat Agent atau alat Task warisan: menyertakan subagent_type
tool_input (ketika OTEL_LOG_TOOL_DETAILS=1): Argumen alat yang diserialisasi JSON. Nilai individual di atas 512 karakter dipotong, dan muatan lengkap dibatasi hingga ~4 K karakter. Berlaku untuk semua alat termasuk alat MCP.

Peristiwa permintaan API

Dicatat untuk setiap permintaan API ke Claude.

Nama Peristiwa: claude_code.api_request

Atribut:

Semua atribut standar
event.name: "api_request"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
model: Model yang digunakan (misalnya, "claude-sonnet-5")
cost_usd: Biaya perkiraan dalam USD
cost_usd_micros: Biaya perkiraan dalam jutaan dolar AS, dipancarkan sebagai integer
duration_ms: Durasi permintaan dalam milidetik
input_tokens: Jumlah token input
output_tokens: Jumlah token output
cache_read_tokens: Jumlah token yang dibaca dari cache
cache_creation_tokens: Jumlah token yang digunakan untuk pembuatan cache
request_id: ID permintaan API, seperti "req_011...", dijelaskan di bawah Atribut korelasi peristiwa.
client_request_id: UUID yang dihasilkan klien dikirim sebagai header permintaan x-client-request-id; lihat tabel atribut korelasi peristiwa untuk kapan ada. Memerlukan Claude Code v2.1.214 atau lebih baru
speed: "fast" atau "normal", menunjukkan apakah mode cepat aktif
query_source: Subsistem yang mengeluarkan permintaan, seperti "repl_main_thread", "compact", atau nama subagen
effort: Tingkat upaya yang diterapkan pada permintaan: "low", "medium", "high", "xhigh", atau "max". Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat Penghitung biaya untuk definisi dan perilaku penyuntingan.

Peristiwa kesalahan API

Dicatat ketika permintaan API ke Claude gagal.

Nama Peristiwa: claude_code.api_error

Atribut:

Semua atribut standar
event.name: "api_error"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
model: Model yang digunakan (misalnya, "claude-sonnet-5")
error: Pesan kesalahan
status_code: Kode status HTTP sebagai angka. Tidak ada untuk kesalahan non-HTTP seperti kegagalan koneksi.
duration_ms: Durasi permintaan dalam milidetik
attempt: Jumlah total upaya yang dilakukan, termasuk permintaan awal (1 berarti tidak ada pengulangan yang terjadi)
request_id: ID permintaan API, seperti "req_011...", dijelaskan di bawah Atribut korelasi peristiwa.
client_request_id: UUID yang dihasilkan klien dikirim sebagai header permintaan x-client-request-id. Tersedia bahkan ketika kegagalan seperti timeout atau kesalahan koneksi tidak pernah menghasilkan request_id server; lihat tabel atribut korelasi peristiwa untuk kapan ada. Memerlukan Claude Code v2.1.214 atau lebih baru
speed: "fast" atau "normal", menunjukkan apakah mode cepat aktif
query_source: Subsistem yang mengeluarkan permintaan, seperti "repl_main_thread", "compact", atau nama subagen
effort: Tingkat upaya yang diterapkan pada permintaan. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat Penghitung biaya untuk definisi dan perilaku penyuntingan.

Peristiwa penolakan API

Dicatat ketika permintaan API mengembalikan stop_reason: "refusal". Penolakan tiba pada aliran respons yang berhasil daripada sebagai kesalahan HTTP, jadi peristiwa api_error tidak terbangkitkan untuk mereka. Peristiwa ini memungkinkan Anda melacak frekuensi penolakan dan mengelompokkan penolakan menurut atribut yang sama dengan api_request dan api_error.

Nama Peristiwa: claude_code.api_refusal

Atribut:

Semua atribut standar
event.name: "api_refusal"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
model: Pengenal model dari permintaan
request_id: ID permintaan API, seperti "req_011...", dijelaskan di bawah Atribut korelasi peristiwa.
query_source: Subsistem yang mengeluarkan permintaan, seperti "repl_main_thread", "compact", atau nama subagen. Lihat api_request untuk definisi.
speed: Baik "fast" ketika Mode cepat aktif, atau "normal"
attempt: Nomor upaya pengulangan. Upaya pertama adalah 1.
effort: Tingkat upaya yang diterapkan pada permintaan. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.
server_fallback_hop: true ketika fallback model server-side API sudah mencoba ulang penolakan ini pada model yang berbeda, jadi pengguna tidak melihat penolakan khusus ini. false ketika permintaan berakhir dalam penolakan. Satu giliran dapat memancarkan peristiwa hop true dan peristiwa final false yang lebih baru ketika model fallback juga menolak.
has_category: true ketika respons API membawa stop_details.category dari "cyber", "bio", "frontier_llm", atau "reasoning_extraction". false ketika respons tidak membawa kategori atau nilai di luar set itu. Tidak ada ketika server_fallback_hop adalah true, karena blok hop tidak membawa stop_details.
has_explanation: true ketika respons API membawa stop_details.explanation, sebaliknya false. Tidak ada ketika server_fallback_hop adalah true.
category: Nilai stop_details.category dari respons API. Salah satu dari "cyber", "bio", "frontier_llm", atau "reasoning_extraction". Hanya ada ketika OTEL_LOG_TOOL_DETAILS=1 diatur dan has_category adalah true.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat Penghitung biaya untuk definisi dan perilaku penyuntingan.

Peristiwa badan permintaan API

Dicatat untuk setiap upaya permintaan API ketika OTEL_LOG_RAW_API_BODIES diatur. Satu peristiwa dipancarkan per upaya, jadi pengulangan dengan parameter yang disesuaikan masing-masing menghasilkan peristiwa mereka sendiri.

Nama Peristiwa: claude_code.api_request_body

Atribut:

Semua atribut standar
event.name: "api_request_body"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
body: Parameter permintaan Messages API yang diserialisasi JSON, seperti prompt sistem, pesan, dan alat, dipotong pada batas konten (60 KB secara default). Konten pemikiran yang diperpanjang dalam giliran asisten sebelumnya disunting. Hanya dipancarkan dalam mode inline (OTEL_LOG_RAW_API_BODIES=1).
body_ref: Jalur absolut ke file <dir>/<uuid>.request.json yang berisi badan yang tidak dipotong. Hanya dipancarkan dalam mode file (OTEL_LOG_RAW_API_BODIES=file:<dir>).
body_length: Panjang badan yang tidak dipotong. Byte UTF-8 ketika OTEL_LOG_RAW_API_BODIES=file:<dir>, atau unit kode UTF-16 ketika =1
body_truncated: "true" ketika pemotongan inline terjadi. Tidak ada dalam mode file dan ketika tidak ada pemotongan yang terjadi.
model: Pengenal model dari parameter permintaan
query_source: Subsistem yang mengeluarkan permintaan (misalnya, "compact")
request_body_id: UUID yang mengidentifikasi badan permintaan upaya ini. Peristiwa api_response_body untuk upaya yang berhasil membawa nilai yang sama, jadi Anda dapat memasangkan respons dengan permintaan yang tepat yang menghasilkannya. Memerlukan Claude Code v2.1.274 atau lebih baru

Peristiwa badan respons API

Dicatat untuk setiap respons API yang berhasil ketika OTEL_LOG_RAW_API_BODIES diatur.

Dalam mode file (OTEL_LOG_RAW_API_BODIES=file:<dir>), Claude Code juga menambahkan satu baris JSON ke <dir>/index.jsonl untuk setiap respons yang berhasil, dengan bidang timestamp, session_id, query_source, model, request_id, message_id, message_uuid, request_file, dan response_file. Bacanya untuk menemukan file permintaan dan respons di balik pesan transkrip tertentu tanpa menanyakan backend telemetri Anda. File indeks memerlukan Claude Code v2.1.274 atau lebih baru.

Nama Peristiwa: claude_code.api_response_body

Atribut:

Semua atribut standar
event.name: "api_response_body"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
body: Respons Messages API yang diserialisasi JSON, termasuk id, blok konten, penggunaan, dan alasan berhenti, dipotong pada batas konten (60 KB secara default). Konten pemikiran yang diperpanjang disunting. Hanya dipancarkan dalam mode inline (OTEL_LOG_RAW_API_BODIES=1).
body_ref: Jalur absolut ke file <dir>/<request_id>.response.json yang berisi badan yang tidak dipotong. Hanya dipancarkan dalam mode file (OTEL_LOG_RAW_API_BODIES=file:<dir>).
body_length: Panjang badan yang tidak dipotong. Byte UTF-8 ketika OTEL_LOG_RAW_API_BODIES=file:<dir>, atau unit kode UTF-16 ketika =1
body_truncated: "true" ketika pemotongan inline terjadi. Tidak ada dalam mode file dan ketika tidak ada pemotongan yang terjadi.
model: Pengenal model
query_source: Subsistem yang mengeluarkan permintaan
request_id: ID permintaan API, seperti "req_011...", dijelaskan di bawah Atribut korelasi peristiwa.
request_body_id: request_body_id dari peristiwa api_request_body yang respons ini jawab. Memerlukan Claude Code v2.1.274 atau lebih baru
message.id: ID pesan yang API tetapkan untuk respons, bidang id dari badan respons. Memerlukan Claude Code v2.1.274 atau lebih baru
message.uuid: UUID entri transkrip akhir respons. Bersama dengan request_body_id, ini menghubungkan pesan transkrip dengan badan permintaan dan respons di baliknya. Memerlukan Claude Code v2.1.274 atau lebih baru

Peristiwa keputusan alat

Dicatat ketika keputusan izin alat dibuat (terima/tolak).

Nama Peristiwa: claude_code.tool_decision

Atribut:

Semua atribut standar
event.name: "tool_decision"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
tool_name: Nama alat (misalnya, "Read", "Edit", "Write", "NotebookEdit")
tool_use_id: Pengenal unik untuk invokasi alat ini. Cocok dengan tool_use_id yang dilewatkan ke hooks, memungkinkan korelasi antara peristiwa OTel dan data yang ditangkap hook.
decision: Baik "accept" atau "reject"
tool_source: Selalu ada. Asal alat, sebagai set nilai yang ditulis CLI tertutup. Memerlukan Claude Code v2.1.214 atau lebih baru
- "builtin": alat CLI itu sendiri
- "mcp": server MCP secara umum
- "sdk_host_builtin_mcp": server in-process yang dibangun ke Claude Desktop itu sendiri, dalam sesi yang dimiliki Claude Desktop. Claude Desktop memiliki sesi yang diluncurkannya dari salah satu titik masuk miliknya sendiri, claude-desktop, claude-desktop-3p, atau local-agent, ketika sesi itu bukan anak bersarang; sesi bersarang, termasuk sesi yang Claude Code itu sendiri hasilkan, melaporkan server ini sebagai "mcp"
source: Dari mana keputusan berasal:
- "config": Diputuskan secara otomatis tanpa diminta, berdasarkan pengaturan proyek, aturan izin atau tolak dalam pengaturan pribadi pengguna, kebijakan yang dikelola perusahaan, flag --allowedTools atau --disallowedTools, mode izin aktif, hibah cakupan sesi dari prompt sebelumnya dalam sesi CLI interaktif yang sama, atau karena alat itu aman secara inheren. Peristiwa tidak menunjukkan sumber mana dari ini yang cocok. Claude Code juga melaporkan "config" ketika permintaan prompt izin itu sendiri gagal, misalnya ketika callback canUseTool SDK Agent atau alat --permission-prompt-tool mengembalikan hasil yang tidak valid, atau ketika aliran input ditutup saat permintaan tertunda. Sebelum v2.1.216, Claude Code melaporkan kegagalan ini sebagai "user_reject".
- "hook": Hook PreToolUse atau PermissionRequest mengembalikan keputusan.
- "user_permanent": Dipancarkan ketika pengguna memilih "Ya, dan jangan tanya lagi untuk ..." di prompt izin, yang menyimpan aturan izin ke pengaturan pribadi mereka. Dalam CLI interaktif ini hanya dipancarkan untuk pilihan itu sendiri; panggilan kemudian yang cocok dengan aturan yang disimpan memancarkan "config" sebagai gantinya. Dalam sesi SDK Agent atau non-interaktif -p, baik pilihan awal maupun kecocokan aturan kemudian memancarkan "user_permanent". Diperlakukan sebagai penerimaan.
- "user_temporary": Dipancarkan ketika pengguna memilih "Ya" di prompt izin untuk persetujuan satu kali, atau memilih opsi yang memberikan akses untuk sisa sesi pada prompt edit atau baca file. Dalam CLI interaktif ini hanya dipancarkan untuk pilihan itu sendiri; panggilan kemudian yang diizinkan oleh hibah cakupan sesi itu memancarkan "config" sebagai gantinya. Dalam sesi SDK Agent atau non-interaktif -p, baik pilihan maupun kecocokan kemudian memancarkan "user_temporary". Diperlakukan sebagai penerimaan.
- "user_abort": Dipancarkan ketika pengguna menutup prompt izin tanpa menjawab. Dalam sesi SDK Agent dan non-interaktif -p, ini termasuk mengganggu giliran saat permintaan izin canUseTool atau --permission-prompt-tool tertunda; sebelum v2.1.216, Claude Code melaporkan gangguan itu sebagai "user_reject". Diperlakukan sebagai penolakan.
- "user_reject": Dipancarkan ketika pengguna memilih "Tidak" saat diminta. Dalam CLI interaktif ini hanya dipancarkan untuk pilihan itu sendiri; panggilan yang cocok dengan aturan tolak dalam pengaturan pribadi pengguna memancarkan "config" sebagai gantinya. Dalam sesi SDK Agent atau non-interaktif -p, panggilan yang cocok dengan aturan tolak dalam pengaturan pribadi memancarkan "user_reject". Diperlakukan sebagai penolakan.
tool_parameters (ketika OTEL_LOG_TOOL_DETAILS=1): String JSON yang berisi parameter khusus alat. Bentuk yang sama dengan Peristiwa hasil alat, minus bidang pasca-eksekusi seperti git_commit_id. Nilai dapat berbeda dari tool_result untuk panggilan yang diterima jika keputusan izin menulis ulang input alat melalui updatedInput. Gunakan atribut ini untuk melihat perintah mana yang ditolak ketika decision adalah "reject".
- Untuk alat "sdk_host_builtin_mcp": mcp_server_name dan mcp_tool_name disertakan bahkan ketika OTEL_LOG_TOOL_DETAILS off, karena aplikasi host mendefinisikan nama ini; tanpanya, panggilan yang ditolak ke salah satu server bawaan ini tidak dapat dikaitkan pada aliran default. Untuk server MCP yang dikonfigurasi pengguna, tool_name peristiwa selalu literal "mcp_tool", dan nama server dan alat muncul hanya dalam tool_parameters dengan flag on; konten argumen memerlukan flag di mana-mana. Memerlukan Claude Code v2.1.214 atau lebih baru
- Untuk alat Bash: menyertakan bash_command, full_command, timeout, description, dangerouslyDisableSandbox. Alat bash workspace aplikasi desktop juga melaporkan tool_name sebagai Bash, tetapi hanya menyertakan bash_command, full_command, dan timeout
- Untuk alat MCP: menyertakan mcp_server_name, mcp_tool_name
- Untuk alat Skill: menyertakan skill_name
- Untuk alat Agent atau alat Task warisan: menyertakan subagent_type

Peristiwa mode izin berubah

Dicatat ketika mode izin berubah, misalnya dari siklus Shift+Tab, keluar dari mode rencana, atau pemeriksaan gerbang mode otomatis.

Nama Peristiwa: claude_code.permission_mode_changed

Atribut:

Semua atribut standar
event.name: "permission_mode_changed"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
from_mode: Mode izin sebelumnya, misalnya "default", "plan", "acceptEdits", "auto", atau "bypassPermissions"
to_mode: Mode izin baru
trigger: Apa yang menyebabkan perubahan. Salah satu dari "shift_tab", "exit_plan_mode", "auto_gate_denied", atau "auto_opt_in". Tidak ada ketika transisi berasal dari SDK atau bridge

Peristiwa auth

Dicatat ketika /login atau /logout selesai.

Nama Peristiwa: claude_code.auth

Atribut:

Semua atribut standar
event.name: "auth"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
action: "login" atau "logout"
success: "true" atau "false"
auth_method: Metode autentikasi, seperti "oauth"
error_category: Jenis kesalahan kategori ketika tindakan gagal. Pesan kesalahan mentah tidak pernah disertakan
status_code: Kode status HTTP sebagai string ketika tindakan gagal dengan kesalahan HTTP

Peristiwa koneksi server MCP

Dicatat ketika server MCP terhubung, terputus, atau gagal terhubung.

Nama Peristiwa: claude_code.mcp_server_connection

Atribut:

Semua atribut standar
event.name: "mcp_server_connection"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
status: "connected", "failed", atau "disconnected"
transport_type: Transport server, seperti "stdio", "sse", atau "http"
server_scope: Cakupan server dikonfigurasi di, seperti "user", "project", atau "local"
duration_ms: Durasi upaya koneksi dalam milidetik
error_code: Kode kesalahan ketika koneksi gagal
is_plugin: true ketika server disediakan oleh plugin, false sebaliknya
plugin_id_hash (ketika is_plugin adalah true): Hash stabil dari nama plugin dan marketplace, untuk mengelompokkan peristiwa menurut plugin tanpa mengekspos nama. Claude Code menghitungnya seperti dijelaskan di bawah peristiwa plugin dimuat
plugin.name (ketika is_plugin adalah true): Nama plugin yang menyediakan server. Untuk plugin pihak ketiga ini adalah string literal "third-party" kecuali OTEL_LOG_TOOL_DETAILS=1; ini melindungi nama plugin pihak ketiga dari muncul dalam log secara default. Plugin dari sumber Anthropic resmi selalu diidentifikasi menurut nama. Atribut plugin_id_hash dan plugin.name mengalir ke backend pemantauan Anda sendiri dan tidak dikirim ke Anthropic
server_name (ketika OTEL_LOG_TOOL_DETAILS=1): Nama server yang dikonfigurasi
error (ketika OTEL_LOG_TOOL_DETAILS=1): Pesan kesalahan lengkap ketika koneksi gagal

Peristiwa kesalahan internal

Dicatat ketika Claude Code menangkap kesalahan internal yang tidak terduga. Hanya nama kelas kesalahan dan kode gaya errno yang dicatat. Pesan kesalahan dan stack trace tidak pernah disertakan. Peristiwa ini tidak dipancarkan saat berjalan terhadap Amazon Bedrock, Agent Platform Google Cloud, atau Microsoft Foundry, atau ketika DISABLE_ERROR_REPORTING diatur.

Nama Peristiwa: claude_code.internal_error

Atribut:

Semua atribut standar
event.name: "internal_error"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
error_name: Nama kelas kesalahan, seperti "TypeError" atau "SyntaxError"
error_code: Kode errno Node.js seperti "ENOENT" saat ada pada kesalahan

Peristiwa plugin diinstal

Dicatat ketika plugin selesai diinstal, dari perintah CLI claude plugin install dan UI /plugin interaktif.

Nama Peristiwa: claude_code.plugin_installed

Atribut:

Semua atribut standar
event.name: "plugin_installed"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
marketplace.is_official: "true" jika marketplace adalah marketplace Anthropic resmi, "false" sebaliknya
install.trigger: "cli" atau "ui"
plugin.name: Nama plugin yang diinstal. Untuk marketplace pihak ketiga ini disertakan hanya ketika OTEL_LOG_TOOL_DETAILS=1
plugin.version: Versi plugin saat dideklarasikan dalam entri marketplace. Untuk marketplace pihak ketiga ini disertakan hanya ketika OTEL_LOG_TOOL_DETAILS=1
marketplace.name: Marketplace tempat plugin diinstal. Untuk marketplace pihak ketiga ini disertakan hanya ketika OTEL_LOG_TOOL_DETAILS=1

Peristiwa plugin dimuat

Dicatat sekali per plugin yang diaktifkan pada awal sesi. Gunakan peristiwa ini untuk menginventarisasi plugin mana yang aktif di seluruh armada Anda, sebagai pelengkap plugin_installed yang mencatat tindakan instalasi itu sendiri.

Nama Peristiwa: claude_code.plugin_loaded

Atribut:

Semua atribut standar
event.name: "plugin_loaded"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
plugin.name: nama plugin. Untuk plugin di luar marketplace resmi dan bundel bawaan nilainya adalah "third-party" kecuali OTEL_LOG_TOOL_DETAILS=1
marketplace.name: marketplace tempat plugin diinstal, saat diketahui. Disunting menjadi "third-party" di bawah kondisi yang sama dengan plugin.name
plugin.version: versi dari manifes plugin. Disertakan hanya ketika nama tidak disunting dan manifes mendeklarasikan versi
plugin.scope: kategori asal untuk plugin: "official", "community", "org", "user-local", atau "default-bundle"
enabled_via: bagaimana plugin menjadi diaktifkan: "default-enable", "org-policy", "admin-install", "seed-mount", atau "user-install". Nilai "admin-install" berarti plugin diatur ke wajib atau auto-install untuk organisasi Anda dalam Pengaturan Organisasi > Plugin & skill. Sebelum v2.1.246, Claude Code melaporkan plugin ini sebagai "user-install" atau "seed-mount"
plugin_id_hash: hash deterministik dari nama plugin dan marketplace, dikirim hanya ke eksporter yang dikonfigurasi. Memungkinkan Anda menghitung plugin pihak ketiga yang berbeda dimuat di seluruh armada tanpa merekam nama mereka. Untuk plugin yang disinkronkan dari claude.ai, Claude Code menghash nama plugin dengan nama marketplace yang claude.ai laporkan untuk plugin, atau dengan synced sebaliknya. Sebelum v2.1.246, Claude Code tidak menggunakan nama marketplace yang claude.ai laporkan dalam hash
has_hooks: apakah plugin berkontribusi hooks
has_mcp: apakah plugin berkontribusi server MCP
host_owned_mcp: true ketika host SDK mengelola koneksi MCP plugin ini dan Claude Code melewati membaca konfigurasi server MCP plugin, false sebaliknya. Memerlukan Claude Code v2.1.172 atau lebih baru
skill_path_count: jumlah direktori skill yang plugin deklarasikan
command_path_count: jumlah direktori perintah yang plugin deklarasikan
agent_path_count: jumlah direktori agen yang plugin deklarasikan
safe_mode: "true" ketika sesi dimulai dengan --safe-mode, "false" sebaliknya. Dalam mode aman peristiwa ini melaporkan inventaris yang dikonfigurasi hanya; perintah, skill, hooks, dan server MCP plugin tidak dimuat. Memerlukan Claude Code v2.1.169 atau lebih baru

Peristiwa skill diaktifkan

Dicatat ketika skill dipanggil, apakah Claude memanggilnya melalui alat Skill atau Anda menjalankannya sebagai perintah /.

Nama Peristiwa: claude_code.skill_activated

Atribut:

Semua atribut standar
event.name: "skill_activated"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
skill.name: Nama skill. Untuk skill yang ditentukan pengguna dan plugin pihak ketiga nilainya adalah placeholder "custom_skill" kecuali OTEL_LOG_TOOL_DETAILS=1
invocation_trigger: Bagaimana skill dipicu ("user-slash", "claude-proactive", atau "nested-skill")
skill.source: Dari mana skill dimuat (misalnya, "bundled", "userSettings", "projectSettings", "plugin")
skill.kind: "workflow" ketika skill adalah skill workflow. Tidak ada sebaliknya
plugin.name (ketika OTEL_LOG_TOOL_DETAILS=1 atau plugin dari marketplace resmi): Nama plugin pemilik ketika skill disediakan oleh plugin
marketplace.name (ketika OTEL_LOG_TOOL_DETAILS=1 atau plugin dari marketplace resmi): Marketplace tempat plugin pemilik diinstal, saat skill disediakan oleh plugin

Peristiwa penyebutan @

Dicatat ketika Claude Code menyelesaikan penyebutan @ dalam prompt. Tidak setiap penyebutan memancarkan peristiwa: jalur keluar awal seperti penolakan izin, file yang terlalu besar, lampiran referensi PDF, dan kegagalan daftar direktori kembali tanpa pencatatan.

Nama Peristiwa: claude_code.at_mention

Atribut:

Semua atribut standar
event.name: "at_mention"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
mention_type: Jenis penyebutan ("file", "directory", "agent", "mcp_resource", "peer"). Nilai "peer" berarti Anda menyebutkan salah satu sesi Claude Code lain Anda. Memerlukan Claude Code v2.1.232 atau lebih baru
success: Apakah penyebutan diselesaikan dengan berhasil ("true" atau "false")

Peristiwa pengulangan API habis

Dicatat sekali ketika permintaan API gagal setelah lebih dari satu upaya. Dipancarkan bersama peristiwa api_error akhir.

Nama Peristiwa: claude_code.api_retries_exhausted

Atribut:

Semua atribut standar
event.name: "api_retries_exhausted"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
model: Model yang digunakan
error: Pesan kesalahan akhir
status_code: Kode status HTTP sebagai angka. Tidak ada untuk kesalahan non-HTTP.
total_attempts: Jumlah total upaya yang dilakukan
total_retry_duration_ms: Total waktu dinding di seluruh upaya
speed: "fast" atau "normal"

Peristiwa hook terdaftar

Dicatat sekali per hook yang dikonfigurasi pada awal sesi. Gunakan peristiwa ini untuk menginventarisasi hook mana yang aktif di seluruh armada Anda, sebagai pelengkap peristiwa hook_execution_start dan hook_execution_complete per-eksekusi.

Nama Peristiwa: claude_code.hook_registered

Atribut:

Semua atribut standar
event.name: "hook_registered"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
hook_event: jenis peristiwa hook, seperti "PreToolUse" atau "PostToolUse"
hook_type: jenis implementasi hook: "command", "prompt", "mcp_tool", "http", atau "agent"
hook_source: di mana hook didefinisikan: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings", atau "pluginHook"
safe_mode: "true" ketika sesi dimulai dengan --safe-mode, "false" sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru
hook_matcher (ketika OTEL_LOG_TOOL_DETAILS=1): string matcher dari konfigurasi hook, saat satu diatur
plugin.name (ketika hook_source adalah "pluginHook"): nama plugin yang berkontribusi. Untuk plugin di luar marketplace resmi dan bundel bawaan nilainya adalah "third-party" kecuali OTEL_LOG_TOOL_DETAILS=1
plugin_id_hash (ketika hook_source adalah "pluginHook"): hash deterministik dari nama plugin dan marketplace, dikirim hanya ke eksporter yang dikonfigurasi. Memungkinkan Anda menghitung plugin yang berkontribusi berbeda tanpa merekam nama mereka. Claude Code menghitungnya seperti dijelaskan di bawah peristiwa plugin dimuat

Peristiwa awal eksekusi hook

Dicatat ketika satu atau lebih hook mulai mengeksekusi untuk peristiwa hook.

Nama Peristiwa: claude_code.hook_execution_start

Atribut:

Semua atribut standar
event.name: "hook_execution_start"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
hook_event: Jenis peristiwa hook, seperti "PreToolUse" atau "PostToolUse"
hook_name: Nama hook lengkap termasuk matcher, seperti "PreToolUse:Write"
num_hooks: Jumlah perintah hook yang cocok
managed_only: "true" ketika hanya hook kebijakan yang dikelola yang diizinkan
hook_source: "policySettings" atau "merged"
safe_mode: "true" ketika sesi dimulai dengan --safe-mode, "false" sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru
hook_definitions: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya ketika pelacakan beta terperinci dan OTEL_LOG_TOOL_DETAILS=1 keduanya diaktifkan

Peristiwa lengkap eksekusi hook

Dicatat ketika semua hook untuk peristiwa hook telah selesai.

Nama Peristiwa: claude_code.hook_execution_complete

Atribut:

Semua atribut standar
event.name: "hook_execution_complete"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
hook_event: Jenis peristiwa hook
hook_name: Nama hook lengkap termasuk matcher
num_hooks: Jumlah perintah hook yang cocok
num_success: Jumlah yang selesai dengan berhasil
num_blocking: Jumlah yang mengembalikan keputusan pemblokiran
num_non_blocking_error: Jumlah yang gagal tanpa memblokir
num_cancelled: Jumlah dibatalkan sebelum penyelesaian
total_duration_ms: Durasi dinding semua hook yang cocok
stdout_chars: Total karakter stdout di seluruh hook yang cocok yang berhasil. Memerlukan Claude Code v2.1.280 atau lebih baru
additional_context_chars: Total karakter additionalContext yang dikembalikan oleh hook yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru
system_message_chars: Total karakter systemMessage yang dikembalikan oleh hook yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru
initial_user_message_chars: Total karakter initialUserMessage yang dikembalikan oleh hook yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru
num_outputs_persisted: Jumlah output hook di atas batas 10.000 karakter yang Claude Code simpan ke file. Memerlukan Claude Code v2.1.280 atau lebih baru
managed_only: "true" ketika hanya hook kebijakan yang dikelola yang diizinkan
hook_source: "policySettings" atau "merged"
safe_mode: "true" ketika sesi dimulai dengan --safe-mode, "false" sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru
hook_definitions: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya ketika pelacakan beta terperinci dan OTEL_LOG_TOOL_DETAILS=1 keduanya diaktifkan

Peristiwa metrik plugin hook

Dicatat ketika hook plugin marketplace resmi memancarkan metrik per-invokasi. Hanya plugin yang diinstal dari marketplace Anthropic resmi yang dapat memancarkan ini. Plugin marketplace pihak ketiga dan hook yang dikonfigurasi pengguna tidak memancarkan ke peristiwa ini. Gunakan peristiwa ini untuk memantau perilaku plugin seperti tingkat penemuan, biaya, dan durasi dari stack observabilitas Anda sendiri.

Nama Peristiwa: claude_code.hook_plugin_metrics

Atribut:

Semua atribut standar
event.name: "hook_plugin_metrics"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
plugin_id: pengenal plugin dalam bentuk <name>@<marketplace>
hook_event: jenis peristiwa hook yang memancarkan metrik
Hingga 20 kunci metrik yang dipancarkan plugin. Nama cocok dengan ^[a-z][a-z0-9_]{0,39}$. Nilai adalah boolean atau angka.

Peristiwa pemadatan

Dicatat ketika pemadatan percakapan selesai.

Nama Peristiwa: claude_code.compaction

Atribut:

Semua atribut standar
event.name: "compaction"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
trigger: "auto" atau "manual"
success: "true" atau "false"
duration_ms: Durasi pemadatan
pre_tokens: Jumlah token perkiraan sebelum pemadatan
post_tokens: Jumlah token perkiraan setelah pemadatan
error: Pesan kesalahan ketika pemadatan gagal
precompute_reuse: Hanya diatur ketika trigger adalah "manual". Pemadatan otomatis dapat menyiapkan ringkasan di latar belakang sebelum jendela konteks penuh, dan atribut ini mencatat apakah /compact menggunakan kembali ringkasan yang disiapkan itu. "hit" berarti itu digunakan kembali; "miss_custom_instructions", "miss_hook", dan "miss_not_ready" memberikan alasan ringkasan segar dihitung sebagai gantinya. Memerlukan Claude Code v2.1.153 atau lebih baru

Peristiwa subagen selesai

Dicatat ketika subagen selesai dan mengembalikan hasilnya ke percakapan yang memulainya. Gunakan untuk menggabungkan penggunaan alat dan waktu run menurut jenis subagen; untuk penggabungan token atau biaya, gunakan penghitung token dan penghitung biaya yang disaring ke query_source "subagent", karena total_tokens peristiwa ini mencakup hanya permintaan akhir. Kategori "subagent" juga menghitung permintaan dari hook berbasis agen, yang tidak memancarkan peristiwa subagen.

Nama Peristiwa: claude_code.subagent_completed

Atribut:

Semua atribut standar
event.name: "subagent_completed"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
agent_type: Jenis subagen. Nama agen bawaan dan agen dari plugin marketplace resmi muncul verbatim; nama agen lainnya diganti dengan "custom" kecuali OTEL_LOG_TOOL_DETAILS=1 diatur
agent.source: Dari mana definisi agen berasal: built-in, plugin, atau sumber pengaturan yang mendefinisikan agen kustom, seperti userSettings atau projectSettings
is_built_in: Apakah subagen adalah jenis agen bawaan
is_async: Apakah subagen berjalan di latar belakang
total_tokens: Jejak token dari permintaan API akhir subagen: token input, pembuatan cache, pembacaan cache, dan output permintaan itu saja, kira-kira ukuran konteks subagen saat penyelesaian. Bukan jumlah di seluruh run
total_tool_uses: Jumlah panggilan alat yang dibuat subagen di seluruh run
duration_ms: Waktu run dalam milidetik
model: Model yang diselesaikan subagen untuk dijalankan
final_model: Model yang menghasilkan respons akhir subagen, yang berbeda dari model setelah switch mid-run seperti fallback. Memerlukan Claude Code v2.1.212 atau lebih baru
model_swapped: Apakah lebih dari satu model melayani permintaan subagen. Memerlukan Claude Code v2.1.212 atau lebih baru
plugin_id_hash, plugin.name: Ada untuk agen yang disediakan plugin. Nama plugin marketplace resmi muncul verbatim; nama plugin lainnya diganti dengan "third-party" kecuali OTEL_LOG_TOOL_DETAILS=1 diatur

Peristiwa survei umpan balik

Dicatat ketika survei kualitas sesi ditampilkan atau dijawab. Lihat Survei kualitas sesi untuk apa yang dikumpulkan survei dan cara mengontrolnya.

Nama Peristiwa: claude_code.feedback_survey

Atribut:

Semua atribut standar
event.name: "feedback_survey"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
event_type: Peristiwa siklus hidup survei, misalnya "appeared", "responded", atau "transcript_prompt_appeared"
appearance_id: ID unik yang menghubungkan peristiwa yang dipancarkan untuk satu instance survei
survey_type: Survei mana yang menghasilkan peristiwa. "session" adalah prompt rating "Bagaimana Claude melakukannya?"
response: Pilihan pengguna pada peristiwa responded
enabled_via_override: true ketika CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL diatur. Dipancarkan sebagai boolean, bukan string. Ada pada peristiwa survei session. Filter pada atribut ini untuk mengkonfirmasi override diterapkan di seluruh armada

Peristiwa sapuan retensi

Dicatat sekali per run sapuan pembersihan retensi, yang menghapus transkrip sesi dan data aplikasi lainnya lebih lama dari pengaturan cleanupPeriodDays. Claude Code menjalankan sapuan di latar belakang paling banyak sekali per sesi, dan run yang tidak menghapus apa pun masih memancarkan peristiwa. Jika Claude Code menjalankan sapuan dalam sesi apa pun pada mesin yang sama dalam 24 jam terakhir, itu menunda sapuan sesi ini setidaknya 10 menit, jadi sesi yang keluar lebih cepat tidak memancarkan apa pun. Ketika Anda menjalankan claude -p dengan --bare, Claude Code tidak menjalankan sapuan dan tidak memancarkan apa pun.

Seperti setiap peristiwa OTel di halaman ini, itu hanya pergi ke backend telemetri yang Anda konfigurasi. Memerlukan Claude Code v2.1.227 atau lebih baru.

Ketika Claude Code tidak dapat dengan aman menentukan periode retensi, itu menjeda sapuan dan memancarkan peristiwa dengan result diatur ke "skipped" dan skip_reason. Ketika pengaturan yang dikelola menetapkan cleanupPeriodDays, nilai yang dikelola menjepit periode retensi dan sapuan berjalan bahkan ketika file pengaturan dalam cakupan prioritas lebih rendah rusak atau tidak valid. Ketika managed-settings.json itu sendiri tidak dapat dibaca, Claude Code masih menjeda sapuan kecuali tingkat yang dikelola memasok cleanupPeriodDays dari tempat lain, seperti pengaturan yang dikelola server atau drop-in managed-settings.d/ di samping file yang rusak. Atribut penghitung penghapusan ada hanya ketika result adalah "complete".

Nama Peristiwa: claude_code.retention_sweep

Atribut:

Semua atribut standar
event.name: "retention_sweep"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
result: "complete" ketika sapuan berjalan, "skipped" ketika Claude Code menjeda itu
period_days: Nilai cleanupPeriodDays dari pengaturan yang digabungkan, dalam hari, atau 30 ketika tidak ada sumber yang menetapkannya. Pada peristiwa yang dilewati, nilai yang akan digunakan sapuan, dihitung dari sumber pengaturan yang dapat dibaca Claude Code
used_default: "true" ketika tidak ada sumber pengaturan yang dapat dibaca yang menetapkan cleanupPeriodDays, "false" sebaliknya. Pada peristiwa lengkap, "true" berarti default 30 hari diterapkan
skip_reason: Mengapa Claude Code menjeda sapuan. Ada hanya ketika result adalah "skipped":
- "user_source_disabled": Pengaturan pengguna dikecualikan, misalnya oleh flag --setting-sources atau opsi settingSources SDK, dan tidak ada sumber yang diaktifkan yang menyediakan cleanupPeriodDays
- "settings_unknowable": File pengaturan tidak dapat dibaca atau diuraikan, jadi cleanupPeriodDays atau desktopSessionCleanupPeriodDays mungkin diatur ke nilai yang tidak dapat dilihat Claude Code
- "settings_invalid_key_set": Pengaturan memiliki kesalahan validasi dan cleanupPeriodDays atau desktopSessionCleanupPeriodDays secara eksplisit diatur, jadi kembali ke default dapat menghapus atau menyimpan file terhadap pengaturan itu
transcripts_deleted: Jumlah transkrip sesi, file ~/.claude/projects/*/*.jsonl tingkat atas, yang dihapus sapuan
transcripts_exempted_desktop: Jumlah transkrip melewati periode retensi yang disimpan sapuan di bawah aturan Claude Desktop dan Cowork. Ini tidak dihitung menuju files_past_cutoff. Memerlukan Claude Code v2.1.248 atau lebih baru
session_files_deleted: Jumlah artefak yang dihapus sapuan file sesi: transkrip ditambah file pendamping per-sesi seperti sidecars, rekaman, dan hasil alat
artifacts_deleted: Total item yang dihapus sapuan di seluruh direktori data yang dicakupnya, termasuk file sesi. Beberapa sapuan menghitung pohon direktori yang dihapus seluruhnya sebagai satu item dan beberapa pass pembersihan tidak berkontribusi pada penghitung, jadi perlakukan nilai sebagai lantai daripada hitungan file yang tepat
files_retained_fresh: File yang diperiksa dan ditinggalkan di tempat karena masih dalam periode retensi. Hanya sapuan per-file yang menghitung ini, jadi nilainya adalah lantai; nilai bukan nol adalah keadaan stabil normal
files_past_cutoff: File lebih lama dari periode retensi yang gagal dihapus sapuan, misalnya karena kesalahan izin atau file yang dipegang terbuka. Nilai di atas nol berarti file melampaui periode retensi yang dikonfigurasi; nol bukan bukti bahwa tidak ada, karena penghapusan yang gagal dari seluruh direktori dihitung menuju error_count sebagai gantinya
error_count: Jumlah kesalahan yang dihadapi sapuan saat mendaftar atau menghapus file

Peristiwa pengaturan yang dikelola diselesaikan

Dicatat dengan pengaturan yang dikelola yang diselesaikan sesi: sekali pada awal sesi, lagi ketika pengaturan yang dikelola atau pembantu kebijakan berubah keadaannya selama sesi, dan ketika Claude Code menolak untuk memulai atau mengakhiri sesi untuk salah satu alasan yang tercantum atribut error.type. Gunakan peristiwa ini untuk menemukan mesin yang berjalan pada sumber yang dikelola yang tidak terduga, mesin yang pembantu kebijakan-nya gagal, dan alasan mesin menolak untuk memulai. Memerlukan Claude Code v2.1.274 atau lebih baru.

Secara default, peristiwa membawa sumber yang dikelola dan keadaan pembantu kebijakan tetapi bukan pengaturan itu sendiri. Untuk menambahkan atribut managed_settings.settings yang disunting dan digest managed_settings.resolved_sha256, atur OTEL_LOG_MANAGED_SETTINGS=1:

Aturnya dalam blok env pengaturan yang dikelola, pengaturan pengguna, atau --settings, atau dalam lingkungan tempat Anda meluncurkan Claude Code. Nilai dalam pengaturan proyek atau lokal tidak mengaktifkannya, karena repositori yang diklon dapat menulisnya.
Pengaturan yang dikelola server dapat menetapkannya tanpa menampilkan dialog persetujuan keamanan, karena variabel hanya menambahkan kebijakan yang disunting organisasi Anda ke peristiwa yang organisasi Anda sudah terima.

Dalam sesi interaktif dalam folder yang belum Anda percayai, Claude Code tidak mengekspor peristiwa penolakan.

Nama Peristiwa: claude_code.managed_settings_resolved

Atribut:

Semua atribut standar
event.name: "managed_settings_resolved"
event.timestamp: Timestamp ISO 8601
event.sequence: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah Atribut korelasi peristiwa
managed_settings.trigger: "startup" untuk peristiwa awal sesi, "change" ketika pengaturan yang dikelola atau keadaan pembantu kebijakan berubah nanti dalam sesi, atau "refused" ketika kebijakan pengaturan yang dikelola menghentikan sesi. Claude Code mengirim peristiwa change hanya ketika atribut berbeda dari peristiwa terakhir yang dikirimnya, dan nilai pengaturan yang berubah dihitung bahkan ketika OTEL_LOG_MANAGED_SETTINGS off
error.type: mengapa Claude Code menghentikan sesi. Ada hanya pada peristiwa refused:
- "helper_failed": run pembantu kebijakan gagal
- "policy_invalid": pengaturan yang dikelola berisi kesalahan yang menghentikan Claude Code dari memulai, atau sumber admin gagal dimuat, jadi Claude Code tidak dapat memeriksa penegakan login organisasi
- "consent_rejected": pengguna menolak dialog persetujuan keamanan untuk pengaturan yang dikelola server
- "force_refresh_failed": pengambilan pengaturan yang forceRemoteSettingsRefresh perlukan gagal
- "gateway_rejected": gateway aplikasi Claude menjawab beban pengaturan yang dikelola dengan HTTP 403
- "version_below_minimum": versi Claude Code ini di bawah requiredMinimumVersion atau di atas requiredMaximumVersion
- "_OTHER": beban pengaturan yang dikelola gateway aplikasi Claude gagal karena alasan lain
managed_settings.sources: setiap sumber yang dikelola yang memberikan setidaknya satu kunci kebijakan, prioritas tertinggi terlebih dahulu, termasuk sumber yang kuncinya tidak berlaku di bawah first-wins. Nilai adalah "remote", "plist" atau "hklm" untuk kebijakan MDM atau tingkat OS, "file" untuk file pengaturan yang dikelola dan drop-in, "parent" ketika host embedding memasok pengaturan, dan "hkcu" untuk nilai registri Windows HKCU ketika Claude Code membacanya. Sumber yang hanya membawa kunci kontrol, atau yang tidak dapat dibaca Claude Code, tidak terdaftar. Dipancarkan sebagai array string, kosong ketika tidak ada sumber yang dikelola memberikan kunci kebijakan
managed_settings.source_behavior: nilai managedSourcesBehavior yang dibaca Claude Code, "first-wins" atau "merge". "first-wins" ketika tidak ada sumber yang menetapkan kunci
managed_settings.helper.state: keadaan pembantu kebijakan yang sumber MDM atau file yang dipilih konfigurasi:
- "ok": output pembantu berfungsi sebagai pengaturan yang dikelola
- "bad_path", "not_a_file", "exit_nonzero", "timed_out", "oversize", "parse_failed", "envelope_invalid", atau "schema_rejected": run terakhir pembantu gagal. Kegagalan pembantu menjelaskan kasus
- "none": tidak ada pembantu yang dikonfigurasi, atau sumber yang mengonfigurasinya bukan kebijakan MDM atau file pengaturan yang dikelola
managed_settings.helper.applied: "output" sementara output pembantu itu sendiri berfungsi sebagai pengaturan yang dikelola, "none" ketika tidak
managed_settings.helper.entry: "policyHelper" ketika Claude Code memilih policyHelper. Tidak ada ketika tidak memilih pembantu
managed_settings.helper.path: path yang dikonfigurasi pembantu. Ada kapan pun Claude Code memilih pembantu, apakah atau tidak OTEL_LOG_MANAGED_SETTINGS diatur
managed_settings.resolved_sha256 (ketika OTEL_LOG_MANAGED_SETTINGS=1): SHA-256 dari pengaturan yang dikelola yang diselesaikan sebelum penyuntingan, diserialisasi sebagai JSON dengan kunci yang diurutkan secara rekursif dan tanpa spasi. Mesin dengan digest yang sama menjalankan kebijakan yang sama. Claude Code mengirim digest hanya dengan opt-in karena kebijakan pendek dapat dipulihkan dengan menghash tebakan. Tidak ada ketika tidak ada pengaturan yang dikelola yang diselesaikan, dan pada peristiwa refused
managed_settings.settings (ketika OTEL_LOG_MANAGED_SETTINGS=1): nama dan bentuk pengaturan yang dikelola yang diselesaikan sebagai string JSON, dengan nilai yang disunting. Tidak ada pada peristiwa refused. Claude Code membangunnya dari skema pengaturannya:
- Nama pengaturan yang skema deklarasikan diekspor, dan kunci yang tidak dideklarasikan ditinggalkan
- Boolean, angka, dan nilai string yang skema batasi ke set opsi tetap, seperti permissions.defaultMode, diekspor apa adanya. sandbox.network.httpProxyPort dan sandbox.network.socksProxyPort diekspor sebagai "[REDACTED]"
- Setiap string lainnya, seperti model, apiKeyHelper, setiap nilai env, setiap URL, dan setiap perintah, diekspor sebagai "[REDACTED]"
- Nama entri peta, seperti nama variabel env dan ID plugin, diekspor apa adanya. Pengaturan yang entri-nya skema tidak ketik, seperti vimInsertModeRemaps, diekspor sebagai "[REDACTED]" tunggal, dan sandbox.ignoreViolations diekspor sebagai daftar daftar path-nya tanpa pola perintah
- Daftar menyimpan panjangnya, dengan setiap entri disunting oleh aturan yang sama
- Aturan permissions.allow, permissions.deny, atau permissions.ask diekspor sebagai nama alat-nya dengan konten yang disunting, seperti Read([REDACTED]), ketika alat dibangun ke versi Claude Code ini atau merupakan referensi mcp__ seperti mcp__jira__create_issue. Aturan lainnya diekspor sebagai "[REDACTED]"
- Hook mengikuti aturan yang sama, jadi bidang opsi tetap dan numerik seperti type dan timeout menunjukkan, sementara setiap perintah, URL, matcher, dan kondisi if diekspor sebagai "[REDACTED]"
Misalnya, pengaturan yang dikelola dengan apiKeyHelper, dua variabel env, dan aturan tolak diekspor sebagai {"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}.

Claude Code memotong nilai pada 8 KB UTF-8, dan nilai yang dipotong bukan JSON yang valid
managed_settings.settings_truncated (ketika managed_settings.settings ada): true ketika Claude Code memotong managed_settings.settings pada 8 KB, false sebaliknya. Dipancarkan sebagai boolean, bukan string

Menafsirkan data metrik dan acara

Metrik dan acara yang diekspor mendukung berbagai analisis:

Pemantauan penggunaan

Metrik	Peluang Analisis
`claude_code.token.usage`	Pecahkan berdasarkan `type` (input/output), pengguna, tim, model, `skill.name`, `plugin.name`, atau `agent.name`
`claude_code.session.count`	Lacak adopsi dan keterlibatan dari waktu ke waktu
`claude_code.lines_of_code.count`	Ukur produktivitas dengan melacak penambahan dan penghapusan kode, dipecah berdasarkan model
`claude_code.commit.count` & `claude_code.pull_request.count`	Pahami dampak pada alur kerja pengembangan

Pemantauan biaya

Metrik claude_code.cost.usage membantu dengan:

Melacak tren penggunaan di seluruh tim atau individu
Mengidentifikasi sesi penggunaan tinggi untuk optimasi
Atribusi pengeluaran ke skill, plugin, atau jenis subagent tertentu melalui atribut skill.name, plugin.name, dan agent.name

Claude Code menghitung setiap respons streaming terhadap metrik biaya dan token tepat sekali, termasuk ketika gateway atau proxy di belakang ANTHROPIC_BASE_URL melakukan streaming penggunaan secara progresif di beberapa frame. Sebelum v2.1.214, stream yang membawa penggunaan di lebih dari satu frame menginflasi claude_code.cost.usage dan claude_code.token.usage dengan kira-kira satu permintaan penuh tambahan per frame tambahan.

Peringatan dan segmentasi

Peringatan umum untuk dipertimbangkan:

Lonjakan biaya
Konsumsi token yang tidak biasa
Volume sesi tinggi dari pengguna tertentu

Semua metrik dapat disegmentasikan berdasarkan atribut standar. Atribut model tersedia pada claude_code.token.usage, claude_code.cost.usage, dan dari v2.1.172, claude_code.lines_of_code.count.

Rincian per-model dari commit hanya dapat didekati dengan menggabungkan terhadap metrik token atau biaya pada session.id, karena satu sesi dapat mencakup beberapa model. Filter sisi token atau biaya ke baris di mana query_source adalah "main" sehingga permintaan auxiliary dan subagent tidak mengatribusikan commit sesi ke model yang tidak membuatnya.

Deteksi kelelahan retry

Claude Code mencoba ulang permintaan API yang gagal secara internal dan hanya memancarkan acara claude_code.api_error tunggal setelah menyerah, jadi acara itu sendiri adalah sinyal terminal untuk permintaan tersebut. Upaya retry perantara tidak dicatat sebagai acara terpisah.

Atribut attempt pada acara mencatat berapa banyak upaya yang dilakukan secara total. CLAUDE_CODE_MAX_RETRIES default ke 10 dan dibatasi pada 15. Pada v2.1.199 atau lebih baru, Anda dapat mengatur CLAUDE_CODE_RETRY_WATCHDOG untuk menaikkan default dan menghapus batas.

Ketika permintaan menghabiskan semua retry pada kesalahan transien, attempt sama dengan satu lebih dari batas efektif tersebut: 11 secara default, dan tidak pernah lebih dari 16 kecuali watchdog diatur. Nilai yang lebih rendah menunjukkan kesalahan yang tidak dapat dicoba ulang seperti respons 400, atau penyebab dengan anggaran retry yang lebih kecil. Misalnya, Claude Code mencoba ulang kegagalan untuk memuat kredensial AWS atau Google Cloud paling banyak dua kali.

Untuk membedakan sesi yang pulih dari sesi yang terhenti, kelompokkan acara berdasarkan session.id dan periksa apakah acara api_request yang lebih baru ada setelah kesalahan.

Analisis acara

Data acara memberikan wawasan terperinci tentang interaksi Claude Code:

Pola Penggunaan Alat: analisis acara hasil alat untuk mengidentifikasi:

Alat yang paling sering digunakan
Tingkat keberhasilan alat
Waktu eksekusi alat rata-rata
Pola kesalahan berdasarkan jenis alat

Pemantauan Kinerja: lacak durasi permintaan API dan waktu eksekusi alat untuk mengidentifikasi hambatan kinerja.

Audit acara keamanan

Acara OpenTelemetry adalah sumber data audit untuk aktivitas Claude Code. Setiap acara membawa atribut identitas yang menghubungkan panggilan alat, aktivitas MCP, dan keputusan izin kembali ke pengguna yang memicunya. Pengekspor log OTLP dapat mengirimkan acara ini ke platform Security Information and Event Management (SIEM) apa pun dengan penerima OTLP, atau ke OpenTelemetry Collector yang meneruskan ke SIEM Anda.

Atribut tindakan untuk pengguna

Atribut standar pada setiap acara mencakup identitas pengguna yang diautentikasi: user.email, user.account_uuid, user.account_id, dan organization.id saat masuk dengan akun Claude atau, dalam sesi cloud, ketika kredensial sesi itu sendiri membawanya, ditambah user.id dan session.id per-sesi. user.id adalah pengidentifikasi berskop instalasi, kecuali pada sesi Claude apps gateway, di mana ini adalah subjek IdP dari token yang dikeluarkan gateway.

Dalam sesi yang dimulai pengembang, panggilan alat MCP, perintah Bash, dan pengeditan file oleh karena itu dikaitkan dengan pengembang tersebut. Claude Code tidak bertindak di bawah akun layanan terpisah di sana; identitas yang dicatat pada setiap acara adalah akun Claude pengembang itu sendiri, atau identitas IdP pengembang pada sesi Claude apps gateway. Dalam sesi saluran Claude Tag, Claude bekerja sebagai identitas bersama organisasi Anda.

Saat Claude Code diautentikasi dengan kunci API langsung, atau terhadap Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, tidak ada akun Claude dalam sesi dan hanya user.id dan session.id yang diisi. Dalam penerapan ini, lampirkan identitas pengguna sendiri dengan OTEL_RESOURCE_ATTRIBUTES, atur per pengguna melalui file pengaturan terkelola atau pembungkus peluncuran. Sesi Claude apps gateway tidak memerlukan apa pun dari ini: CLI mencap identitas IdP secara otomatis, seperti yang dijelaskan dalam Atribut standar.

export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."

Audit aktivitas MCP

Untuk menangkap aktivitas server MCP dengan detail panggilan lengkap, aktifkan pengekspor log dan atur OTEL_LOG_TOOL_DETAILS=1. Setiap operasi MCP kemudian menghasilkan acara terstruktur yang membawa nama server, nama alat, dan argumen panggilan bersama atribut identitas standar:

Acara	Apa yang dicatat untuk MCP
`mcp_server_connection`	Server terhubung, terputus, dan kegagalan koneksi dengan `server_name`, `transport_type`, `server_scope`, dan detail kesalahan
`tool_result`	Setiap panggilan alat MCP dengan `tool_name` dan `mcp_server_scope`, muatan `tool_parameters` yang berisi `mcp_server_name` dan `mcp_tool_name`, dan muatan `tool_input` yang berisi argumen panggilan
`tool_decision`	Apakah panggilan diizinkan atau ditolak, apakah keputusan berasal dari config, hook, atau pengguna, dan muatan `tool_parameters` yang berisi `mcp_server_name` dan `mcp_tool_name`

Tanpa OTEL_LOG_TOOL_DETAILS, acara ini menghilangkan detail pengidentifikasi:

tool_result: menyimpan mcp_server_scope dan tool_name diredaksi ke literal "mcp_tool" untuk server yang dikonfigurasi pengguna, menghilangkan konten argumen. Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, ini juga menyimpan pasangan mcp_server_name/mcp_tool_name di dalam tool_parameters, pengecualian yang sama yang dipengaruhi host seperti tool_decision, memerlukan Claude Code v2.1.214 atau lebih baru
tool_decision: menyimpan tool_source dan tool_name diredaksi ke literal "mcp_tool" untuk server yang dikonfigurasi pengguna, menghilangkan konten argumen. Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, ini juga menyimpan pasangan mcp_server_name/mcp_tool_name di dalam tool_parameters; tool_source dan pasangan nama keduanya memerlukan Claude Code v2.1.214 atau lebih baru
mcp_server_connection: menghilangkan server_name dan pesan kesalahan, tetapi menyimpan is_plugin, plugin_id_hash, dan plugin.name, dengan nama plugin non-Anthropic diredaksi ke literal "third-party", sehingga server yang disediakan plugin tetap dapat dibedakan tanpa pencatatan terperinci

Peta pertanyaan keamanan ke acara

Saat membangun aturan deteksi, cari sinyal yang ingin Anda pantau dan kueri backend Anda untuk acara dan atribut yang sesuai:

Sinyal	Acara	Atribut Kunci
Panggilan alat diizinkan atau ditolak, dan oleh apa	`tool_decision`	`decision`, `source`, `tool_name`, `tool_parameters`
Eskalasi mode izin	`permission_mode_changed`	`from_mode`, `to_mode`, `trigger`
Hook kebijakan memblokir tindakan	`hook_execution_complete`	`hook_event`, `num_blocking`
Login, logout, dan kegagalan autentikasi	`auth`	`action`, `success`, `error_category`
Server MCP terhubung atau gagal	`mcp_server_connection`	`status`, `server_name`, `is_plugin`, `error_code`
Plugin diinstal dan sumbernya	`plugin_installed`	`plugin.name`, `marketplace.name`, `marketplace.is_official`
Perintah yang dijalankan dan file yang disentuh	`tool_result` (dieksekusi) atau `tool_decision` (ditolak) dengan `OTEL_LOG_TOOL_DETAILS=1`	`tool_parameters`; `tool_input` (`tool_result` saja)
Sumber pengaturan terkelola mana yang dijalankan mesin, apakah pembantu kebijakan sehat, dan mengapa mesin menolak untuk memulai	`managed_settings_resolved`	`managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type`; `managed_settings.settings` dan `managed_settings.resolved_sha256` dengan `OTEL_LOG_MANAGED_SETTINGS=1`

Claude Code memancarkan aliran acara mentah saja. Deteksi anomali, baselining, korelasi lintas sesi, dan peringatan adalah tanggung jawab backend SIEM atau observabilitas Anda.

Kirim acara ke SIEM

Arahkan OTEL_EXPORTER_OTLP_LOGS_ENDPOINT ke penerima OTLP SIEM Anda, atau ke OpenTelemetry Collector yang meneruskan ke API ingest asli SIEM Anda. Contoh pengaturan terkelola berikut mengekspor acara saja, dengan detail alat lengkap diaktifkan untuk audit MCP dan Bash:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_LOG_TOOL_DETAILS": "1",
    "OTEL_EXPORTER_OTLP_LOGS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://siem.example.com:4318/v1/logs",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer your-siem-token"
  }
}

Untuk mengonfirmasi acara tiba, kirimkan prompt dalam sesi yang berjalan di bawah konfigurasi ini dan periksa SIEM Anda untuk acara claude_code.user_prompt. Jika tidak ada yang tiba, jalankan Claude Code dengan claude --debug-file <path> dan periksa log itu untuk kesalahan ekspor [3P telemetry].

Pertimbangan backend

Pilihan backend metrik, log, dan traces Anda menentukan jenis analisis yang dapat Anda lakukan:

Untuk metrik

Database deret waktu: Perhitungan laju, metrik agregat
Toko kolumnar: Kueri kompleks, analisis pengguna unik
Platform observabilitas lengkap: Kueri lanjutan, visualisasi, peringatan

Untuk acara/log

Sistem agregasi log: Pencarian teks lengkap, analisis log
Toko kolumnar: Analisis acara terstruktur
Platform observabilitas lengkap: Korelasi antara metrik dan acara

Untuk traces

Pilih backend yang mendukung penyimpanan distributed trace dan korelasi span:

Sistem distributed tracing: Visualisasi span, request waterfalls, analisis latensi
Platform observabilitas lengkap: Pencarian trace dan korelasi dengan metrik dan log

Untuk organisasi yang memerlukan metrik Pengguna Aktif Harian/Mingguan/Bulanan (DAU/WAU/MAU), pertimbangkan backend yang mendukung kueri nilai unik yang efisien.

Informasi layanan

Semua metrik dan acara diekspor dengan atribut sumber daya berikut:

service.name: claude-code untuk sesi terminal, claude-code-desktop untuk sesi yang dimulai dari tab Code di aplikasi Claude Desktop
service.version: Versi Claude Code saat ini, atau versi aplikasi Desktop untuk sesi tab Code
os.type: Jenis sistem operasi (misalnya, linux, darwin, windows)
os.version: String versi sistem operasi
host.arch: Arsitektur host (misalnya, amd64, arm64)
wsl.version: Nomor versi WSL (hanya ada saat berjalan di Windows Subsystem for Linux)
Nama Meter: com.anthropic.claude_code

Jika pipeline pengumpul atau dasbor Anda memfilter pada service.name = claude-code, tambahkan claude-code-desktop ke filter untuk juga menangkap telemetri dari sesi tab Code.

Sumber daya pengukuran ROI

Untuk panduan komprehensif tentang mengukur pengembalian investasi untuk Claude Code, termasuk pengaturan telemetri, analisis biaya, metrik produktivitas, dan pelaporan otomatis, lihat Panduan Pengukuran ROI Claude Code. Repositori ini menyediakan konfigurasi Docker Compose siap pakai, pengaturan Prometheus dan OpenTelemetry, dan template untuk menghasilkan laporan produktivitas yang terintegrasi dengan alat seperti Linear.

Keamanan dan privasi

Ekspor OpenTelemetry ke backend Anda adalah opt-in dan memerlukan konfigurasi eksplisit. Untuk telemetri operasional terpisah Anthropic dan cara menonaktifkannya, lihat Penggunaan data
Konten file mentah dan cuplikan kode tidak disertakan dalam metrik atau acara. Trace spans adalah jalur data terpisah: lihat poin OTEL_LOG_TOOL_CONTENT di bawah
Saat diautentikasi melalui OAuth, user.email disertakan dalam atribut telemetri, dikirim hanya ke titik akhir OTel yang Anda konfigurasikan, tidak pernah ke Anthropic. Jika ini menjadi perhatian bagi organisasi Anda, bekerja dengan backend telemetri Anda untuk memfilter atau menyunting bidang ini
Konten prompt pengguna tidak dikumpulkan secara default. Hanya panjang prompt yang dicatat. Untuk menyertakan konten prompt, atur OTEL_LOG_USER_PROMPTS=1. Di bawah detailed beta tracing, variabel ini menjangkau lebih jauh daripada teks prompt: variabel ini juga mengontrol atribut span new_context, yang membawa hasil alat pada span claude_code.llm_request
Teks respons asisten tidak dikumpulkan secara default. Hanya panjang respons yang dicatat. Untuk menyertakan teks respons, atur OTEL_LOG_ASSISTANT_RESPONSES=1. Seperti semua data OpenTelemetry dari Claude Code, teks respons dikirim hanya ke titik akhir OTel yang Anda konfigurasikan, tidak pernah ke Anthropic. Ketika variabel ini tidak diatur, OTEL_LOG_USER_PROMPTS digunakan sebagai fallback, jadi atur OTEL_LOG_ASSISTANT_RESPONSES=0 jika Anda menginginkan konten prompt tanpa konten respons
Argumen input alat dan parameter tidak dicatat secara default. Untuk menyertakannya, atur OTEL_LOG_TOOL_DETAILS=1. Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, tool_decision dan tool_result membawa pasangan mcp_server_name/mcp_tool_name, nama yang ditulis host daripada konten argumen, bahkan dengan flag mati. Pengecualian memerlukan Claude Code v2.1.214 atau lebih baru. Data ini dikirim hanya ke titik akhir OTEL yang Anda konfigurasikan, tidak pernah ke Anthropic. Argumen mungkin masih berisi nilai sensitif, jadi konfigurasikan backend telemetri Anda untuk memfilter atau menyunting atribut ini sesuai kebutuhan. Saat diaktifkan:
- Acara tool_result dan tool_decision menyertakan atribut tool_parameters dengan perintah Bash, nama server MCP dan alat, dan nama skill. Bidang seperti full_command dipancarkan tanpa pemotongan
- Acara tool_result juga menyertakan atribut tool_input dengan jalur file, URL, pola pencarian, dan argumen lainnya. Nilai individual di atas 512 karakter dipotong dan total dibatasi hingga ~4 K karakter
- Acara user_prompt menyertakan command_name verbatim untuk perintah custom, plugin, dan MCP
- Penghitung biaya dan token dan acara api_request, api_error, dan api_refusal membawa nama agen, skill, plugin, dan server MCP dan alat yang sebenarnya dalam atribut atribusi mereka
- Trace spans menyertakan atribut tool_input yang sama dan atribut yang diturunkan dari input seperti file_path, dengan pemotongan yang sama dengan tool_input
Konten alat tidak dicatat dalam trace spans secara default. Untuk menyertakannya, atur OTEL_LOG_TOOL_CONTENT=1. Span claude_code.tool kemudian membawa acara span tool.output dengan konten file mentah, output perintah Bash, dan apa yang dikembalikan alat MCP, WebFetch, dan WebSearch, dipotong pada batas konten (60 KB secara default) per atribut. Hasil dari alat MCP, WebFetch, dan WebSearch memerlukan Claude Code v2.1.283 atau lebih baru. Konten alat juga menjangkau spans melalui new_context, yang gatenya berbeda per span. Konfigurasikan backend telemetri Anda untuk memfilter atau menyunting atribut ini sesuai kebutuhan
Badan permintaan dan respons API Anthropic Messages mentah tidak dicatat secara default. Untuk menyertakannya, atur OTEL_LOG_RAW_API_BODIES di shell, pengaturan pengguna, atau pengaturan terkelola Anda. Ini diabaikan dalam pengaturan proyek dan lokal. Badan berisi riwayat percakapan lengkap, termasuk system prompt, setiap giliran pengguna dan asisten sebelumnya, dan hasil alat, jadi mengaktifkan ini menyiratkan persetujuan untuk semua yang akan diungkapkan oleh flag konten OTEL_LOG_* lainnya. Claude Code selalu menyunting konten extended-thinking Claude dari badan ini, terlepas dari pengaturan lain. Nilai yang Anda atur menentukan bagaimana Claude Code mengirimkan badan:
- Dengan =1, Claude Code memancarkan acara log api_request_body dan api_response_body untuk setiap panggilan API. Atribut body acara membawa muatan yang diserialisasi JSON, dipotong pada batas konten (60 KB secara default)
- Dengan =file:<dir>, Claude Code menulis badan yang tidak dipotong ke file .request.json dan .response.json di bawah direktori tersebut, dan acara membawa jalur body_ref sebagai gantinya dari badan inline. Kirim direktori dengan pengumpul log atau sidecar daripada melalui aliran telemetri.
  
  Untuk setiap respons yang berhasil, Claude Code juga menambahkan satu baris ke index.jsonl di direktori tersebut, menghubungkan file respons ke file permintaan yang menghasilkannya dan ke pesan transkrip yang menjadi. Setiap baris tidak menyimpan konten pesan, dan bagian acara badan respons API mencantumkan bidangnya. File indeks memerlukan Claude Code v2.1.274 atau lebih baru

Memantau Claude Code di Amazon Bedrock

Untuk panduan pemantauan penggunaan Claude Code terperinci untuk Amazon Bedrock, lihat Claude Code Monitoring Implementation (Amazon Bedrock).

monitoring-usage.md +556 −512

39 39

40Untuk memverifikasi pengaturan yang mengekspor metrik, periksa backend Anda untuk metrik `claude_code.session.count`, yang Claude Code keluarkan saat sesi dimulai. Untuk memverifikasi pengaturan hanya log, kirimkan prompt dan periksa acara `claude_code.user_prompt`.40Untuk memverifikasi pengaturan yang mengekspor metrik, periksa backend Anda untuk metrik `claude_code.session.count`, yang Claude Code keluarkan saat sesi dimulai. Untuk memverifikasi pengaturan hanya log, kirimkan prompt dan periksa acara `claude_code.user_prompt`.

41 41

42Jika tidak ada yang tiba, jalankan `claude --debug` dan periksa log debug. Claude Code melaporkan kegagalan dari pengekspor yang Anda konfigurasikan sebagai kesalahan `[3P telemetry]`, di mana 3P berarti pihak ketiga. Baris yang diawali dengan `[Anthropic telemetry]` menjelaskan [telemetri operasional terpisah Anthropic](/docs/id/data-usage#telemetry-services) dan tidak menunjukkan masalah dengan pengaturan Anda.42Jika tidak ada yang tiba, jalankan Claude Code dengan `claude --debug-file <path>` dan periksa log yang ditulisnya ke jalur tersebut. Claude Code melaporkan kegagalan dari pengekspor yang Anda konfigurasikan sebagai kesalahan `[3P telemetry]`, di mana 3P berarti pihak ketiga. Baris yang diawali dengan `[Anthropic telemetry]` menjelaskan [telemetri operasional terpisah Anthropic](/docs/id/data-usage#telemetry-services) dan tidak menunjukkan masalah dengan pengaturan Anda.

43 43

44Untuk opsi konfigurasi lengkap, lihat [spesifikasi OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).44Untuk opsi konfigurasi lengkap, lihat [spesifikasi OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).

45 45

72 Bagaimana pengaturan terkelola mengunci tujuan OTLP72 Bagaimana pengaturan terkelola mengunci tujuan OTLP

73</h3>73</h3>

74 74

75Ketika Anda menetapkan variabel `OTEL_EXPORTER_OTLP_*` dalam pengaturan terkelola, Claude Code menghapus variabel yang ditetapkan pengembang yang bertentangan saat startup dan mencatat peringatan yang dapat Anda lihat dengan `claude --debug`. Apa yang dihapusnya tergantung pada variabel mana yang Anda tetapkan:75Ketika Anda menetapkan variabel `OTEL_EXPORTER_OTLP_*` dalam pengaturan terkelola, Claude Code menghapus variabel yang ditetapkan pengembang yang bertentangan saat startup dan mencatat peringatan dalam debug log. Apa yang dihapusnya tergantung pada variabel mana yang Anda tetapkan:

76 76

77* **Endpoints**: ketika Anda menetapkan `OTEL_EXPORTER_OTLP_ENDPOINT`, Claude Code menghapus setiap titik akhir per-sinyal yang ditetapkan pengembang. Pengembang tidak dapat mengarahkan satu sinyal ke kolektor yang berbeda, jadi Anda tidak perlu juga menetapkan variabel titik akhir per-sinyal dalam pengaturan terkelola.77* **Endpoints**: ketika Anda menetapkan `OTEL_EXPORTER_OTLP_ENDPOINT`, Claude Code menghapus setiap titik akhir per-sinyal yang ditetapkan pengembang. Pengembang tidak dapat mengarahkan satu sinyal ke kolektor yang berbeda, jadi Anda tidak perlu juga menetapkan variabel titik akhir per-sinyal dalam pengaturan terkelola.

78* **Protokol**: ketika Anda menetapkan `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code menghapus setiap protokol per-sinyal yang ditetapkan pengembang.78* **Protokol**: ketika Anda menetapkan `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code menghapus setiap protokol per-sinyal yang ditetapkan pengembang.

103 Variabel konfigurasi umum103 Variabel konfigurasi umum

104</h3>104</h3>

105 105

106Variabel-variabel ini mengonfigurasi pengekspor, titik akhir, dan perilaku ekspor untuk semua penerapan.106Variabel-variabel ini mengonfigurasi eksporter, endpoint, dan perilaku ekspor untuk semua deployment.

107 107

108Jika Anda menetapkan variabel titik akhir atau protokol per-sinyal, seperti `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code menggunakannya sebagai gantinya dari variabel generik untuk sinyal tersebut. Jika Anda menetapkan variabel header per-sinyal, seperti `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code menggabungkannya dengan `OTEL_EXPORTER_OTLP_HEADERS` generik untuk sinyal tersebut.108Jika Anda menetapkan variabel endpoint atau protokol per-sinyal, seperti `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code menggunakannya sebagai pengganti variabel generik untuk sinyal tersebut. Jika Anda menetapkan variabel header per-sinyal, seperti `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code menggabungkannya dengan `OTEL_EXPORTER_OTLP_HEADERS` generik untuk sinyal tersebut.

109 109

110Pada mesin dengan pengaturan terkelola, lihat [Bagaimana pengaturan terkelola mengunci tujuan OTLP](#how-managed-settings-lock-the-otlp-destination) untuk mengetahui apa yang Claude Code hapus.110Pada mesin dengan pengaturan terkelola, lihat [Bagaimana pengaturan terkelola mengunci tujuan OTLP](#how-managed-settings-lock-the-otlp-destination) untuk mengetahui apa yang Claude Code hapus.

111 111

113| - | - | - |113| - | - | - |

114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Mengaktifkan pengumpulan telemetri (diperlukan) | `1` |114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Mengaktifkan pengumpulan telemetri (diperlukan) | `1` |

117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Protokol untuk pengekspor OTLP, berlaku untuk semua sinyal. Claude Code tidak memiliki protokol default, jadi atur ini atau variabel protokol per-sinyal untuk setiap pengekspor `otlp` yang Anda aktifkan | `grpc`, `http/json`, `http/protobuf` |117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Protokol untuk eksporter OTLP, berlaku untuk semua sinyal. Claude Code tidak memiliki protokol default, jadi atur ini atau variabel protokol spesifik sinyal untuk setiap eksporter `otlp` yang Anda aktifkan | `grpc`, `http/json`, `http/protobuf` |

126| `OTEL_METRIC_EXPORT_INTERVAL` | Interval ekspor dalam milidetik (default: 60000) | `5000`, `60000` |126| `OTEL_METRIC_EXPORT_INTERVAL` | Interval ekspor dalam milidetik (default: 60000) | `5000`, `60000` |

127| `OTEL_LOGS_EXPORT_INTERVAL` | Interval ekspor log dalam milidetik (default: 5000) | `1000`, `10000` |127| `OTEL_LOGS_EXPORT_INTERVAL` | Interval ekspor log dalam milidetik (default: 5000) | `1000`, `10000` |

129| `OTEL_LOG_ASSISTANT_RESPONSES` | Aktifkan pencatatan teks respons asisten pada acara `assistant_response` (default: dinonaktifkan). Saat tidak diatur, kembali ke nilai `OTEL_LOG_USER_PROMPTS`. Memerlukan Claude Code v2.1.193 atau lebih baru | `1` untuk mengaktifkan, `0` untuk tetap disunting |129| `OTEL_LOG_ASSISTANT_RESPONSES` | Aktifkan pencatatan teks respons asisten pada event `assistant_response` (default: dinonaktifkan). Ketika tidak diatur, kembali ke nilai `OTEL_LOG_USER_PROMPTS`. Memerlukan Claude Code v2.1.193 atau lebih baru | `1` untuk mengaktifkan, `0` untuk tetap disembunyikan |

130| `OTEL_LOG_TOOL_DETAILS` | Aktifkan pencatatan parameter alat dan argumen input dalam acara alat dan atribut span trace: perintah Bash, nama server MCP dan alat, nama skill, nama workflow yang ditulis pengguna, dan input alat. Juga mengaktifkan nama perintah custom, plugin, dan MCP pada acara `user_prompt` (default: dinonaktifkan). Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, `mcp_server_name`/`mcp_tool_name` dipancarkan pada `tool_decision`/`tool_result` bahkan dengan flag mati. Pengecualian memerlukan Claude Code v2.1.214 atau lebih baru | `1` untuk mengaktifkan |130| `OTEL_LOG_TOOL_DETAILS` | Aktifkan pencatatan parameter alat dan argumen input dalam event alat dan atribut span jejak: perintah Bash, nama server dan alat MCP, nama skill, nama workflow yang ditulis pengguna, dan input alat. Juga mengaktifkan nama perintah kustom, plugin, dan MCP pada event `user_prompt`, dan nama asli agen, skill, plugin, dan server serta nama alat MCP pada [penghitung biaya dan token](#cost-counter) (default: dinonaktifkan). Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, `mcp_server_name`/`mcp_tool_name` dipancarkan pada `tool_decision`/`tool_result` bahkan dengan flag mati. Pengecualian memerlukan Claude Code v2.1.214 atau lebih baru | `1` untuk mengaktifkan |

131| `OTEL_LOG_TOOL_CONTENT` | Aktifkan pencatatan konten alat dalam acara span [`tool.output`](#tool-output-span-event) (default: dinonaktifkan). Atribut span membawa konten alat di bawah [gerbang mereka sendiri](#new-context-gates). Memerlukan [tracing](#traces-beta). Konten dipotong pada batas konten (60 KB secara default) | `1` untuk mengaktifkan |131| `OTEL_LOG_TOOL_CONTENT` | Aktifkan pencatatan konten alat dalam [`tool.output` span event](#tool-output-span-event) (default: dinonaktifkan). Atribut span membawa konten alat di bawah [gerbang mereka sendiri](#new-context-gates). Memerlukan [tracing](#traces-beta). Konten dipotong pada batas konten (60 KB secara default) | `1` untuk mengaktifkan |

132| `OTEL_LOG_MANAGED_SETTINGS` | Tambahkan pengaturan terkelola yang disunting, dan digest SHA-256 dari pengaturan sebelum penyuntingan, ke acara [managed settings resolved](#managed-settings-resolved-event) (default: dinonaktifkan). Nilai dalam pengaturan proyek atau lokal tidak mengaktifkannya. Memerlukan Claude Code v2.1.274 atau lebih baru | `1` untuk mengaktifkan |132| `OTEL_LOG_MANAGED_SETTINGS` | Tambahkan pengaturan terkelola yang disembunyikan, dan digest SHA-256 dari pengaturan sebelum penyembunyian, ke event [managed settings resolved](#managed-settings-resolved-event) (default: dinonaktifkan). Nilai dalam pengaturan proyek atau lokal tidak mengaktifkannya. Memerlukan Claude Code v2.1.274 atau lebih baru | `1` untuk mengaktifkan |

133| `OTEL_LOG_RAW_API_BODIES` | Emit badan permintaan dan respons JSON API Anthropic Messages lengkap sebagai acara log `api_request_body` / `api_response_body` (default: dinonaktifkan). Badan mencakup seluruh riwayat percakapan. Mengaktifkan ini menyiratkan persetujuan untuk semua yang akan diungkapkan oleh `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, dan `OTEL_LOG_TOOL_CONTENT` | `1` untuk badan inline dipotong pada batas konten (60 KB secara default), atau `file:<dir>` untuk badan tidak dipotong di disk dengan pointer `body_ref` dalam acara |133| `OTEL_LOG_RAW_API_BODIES` | Pancarkan permintaan dan respons JSON API Pesan Anthropic lengkap sebagai event log `api_request_body` / `api_response_body` (default: dinonaktifkan). Badan mencakup seluruh riwayat percakapan. Mengaktifkan ini menyiratkan persetujuan untuk semua yang `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, dan `OTEL_LOG_TOOL_CONTENT` akan ungkapkan | `1` untuk badan inline yang dipotong pada batas konten (60 KB secara default), atau `file:<dir>` untuk badan yang tidak dipotong di disk dengan pointer `body_ref` dalam event |

134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Batas konten: panjang maksimum atribut yang mengandung konten seperti respons model, konten alat, prompt sistem, dan badan API mentah, termasuk penanda pemotongan, dalam unit kode UTF-16 (default: 61440, yaitu 60 KB). Default diukur untuk backend yang membatasi nilai atribut pada 64 KB; naikkan hanya jika backend Anda menerima nilai yang lebih besar, atau turunkan untuk mengurangi volume telemetri. Saat batas atribut SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` atau salah satu varian logrecord dan span-nya, diatur lebih rendah, Claude Code memotong pada nilai yang lebih kecil itu sehingga penanda `[TRUNCATED ...]` tetap dalam batas SDK. Memerlukan Claude Code v2.1.214 atau lebih baru | `262144` |134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Batas konten: panjang maksimum atribut yang membawa konten seperti respons model, konten alat, prompt sistem, dan badan API mentah, termasuk penanda pemotongan, dalam unit kode UTF-16 (default: 61440, yaitu 60 KB). Default diukur untuk backend yang membatasi nilai atribut pada 64 KB; naikkan hanya jika backend Anda menerima nilai yang lebih besar, atau turunkan untuk mengurangi volume telemetri. Ketika batas atribut SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` atau salah satu varian logrecord dan span-nya, diatur lebih rendah, Claude Code memotong pada nilai yang lebih kecil itu sehingga penanda `[TRUNCATED ...]` tetap dalam batas SDK. Memerlukan Claude Code v2.1.214 atau lebih baru | `262144` |

135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferensi temporalitas metrik (default: `delta`). Atur ke `cumulative` jika backend Anda mengharapkan temporalitas kumulatif | `delta`, `cumulative` |135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferensi temporalitas metrik (default: `delta`). Atur ke `cumulative` jika backend Anda mengharapkan temporalitas kumulatif | `delta`, `cumulative` |

136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Interval untuk menyegarkan header dinamis (default: 1740000ms / 29 menit) | `900000` |136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Interval untuk menyegarkan header dinamis (default: 1740000ms / 29 menit) | `900000` |

137 137

138Untuk protokol `http/protobuf` dan `http/json`, Claude Code mengirim setiap permintaan ekspor dengan header `Content-Length`. Sebelum v2.1.212, versi Claude Code dari v2.1.191 ke depan mengirim permintaan ini dengan chunked transfer encoding; Azure Monitor dan titik akhir lain yang memerlukan panjang yang dideklarasikan menolaknya dengan kesalahan `411 Length Required` atau `400`.138Untuk protokol `http/protobuf` dan `http/json`, Claude Code mengirim setiap permintaan ekspor dengan header `Content-Length`. Sebelum v2.1.212, versi Claude Code dari v2.1.191 ke depan mengirim permintaan ini dengan pengkodean transfer chunked; Azure Monitor dan endpoint lain yang memerlukan panjang yang dideklarasikan menolaknya dengan error `411 Length Required` atau `400`.

139 139

140<h3 id="mtls-authentication">140<h3 id="mtls-authentication">

141 Autentikasi mTLS141 Autentikasi mTLS

142</h3>142</h3>

143 143

144Cara Anda mengonfigurasi sertifikat klien untuk pengekspor OTLP tergantung pada protokol OTLP yang digunakan untuk sinyal tersebut, diatur melalui `OTEL_EXPORTER_OTLP_PROTOCOL` atau override per-sinyal. Konfigurasi yang sama berlaku untuk metrik, log, dan traces.144Cara Anda mengonfigurasi sertifikat klien untuk eksporter OTLP tergantung pada protokol OTLP yang digunakan untuk sinyal tersebut, diatur melalui `OTEL_EXPORTER_OTLP_PROTOCOL` atau penggantian spesifik sinyal. Konfigurasi yang sama berlaku untuk metrik, log, dan jejak.

145 145

147| :- | :- | :- |147| :- | :- | :- |

148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY`, dan secara opsional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Lihat [Konfigurasi jaringan](/docs/id/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY`, dan secara opsional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Lihat [Konfigurasi Jaringan](/docs/id/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` dan `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, atau varian per-sinyal seperti `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` untuk menggunakan sertifikat berbeda per sinyal | `OTEL_EXPORTER_OTLP_CERTIFICATE` |149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` dan `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, atau varian spesifik sinyal seperti `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` untuk menggunakan sertifikat berbeda per sinyal | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

150 150

151Untuk `grpc`, SDK OpenTelemetry membaca variabel OTLP standar secara langsung, jadi konfigurasi yang ada yang menetapkan variabel metrik per-sinyal terus berfungsi. Pada mesin dengan pengaturan terkelola, Claude Code [mungkin menghapus kredensial dan titik akhir per-sinyal yang ditetapkan pengembang](#how-managed-settings-lock-the-otlp-destination) saat startup.151Untuk `grpc`, SDK OpenTelemetry membaca variabel OTLP standar secara langsung, jadi konfigurasi yang ada yang menetapkan variabel metrik spesifik sinyal terus berfungsi. Pada mesin dengan pengaturan terkelola, Claude Code [dapat menghapus kredensial dan endpoint spesifik sinyal yang ditetapkan pengembang](#how-managed-settings-lock-the-otlp-destination) saat startup.

152 152

153<h3 id="metrics-cardinality-control">153<h3 id="metrics-cardinality-control">

154 Kontrol kardinalitas metrik154 Kontrol kardinalitas metrik

158 158

160| - | - | - | - |160| - | - | - | - |

166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Sertakan atribut identitas repositori `vcs.*` [repository attributes](#repository-attributes) pada metrik dan acara. Memerlukan Claude Code v2.1.269 atau lebih baru | `false` | `true` |166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Sertakan atribut identitas repositori `vcs.*` [repository identity attributes](#repository-attributes) pada metrik dan event. Memerlukan Claude Code v2.1.269 atau lebih baru | `false` | `true` |

167 167

168Kardinalitas yang lebih rendah umumnya berarti kinerja yang lebih baik dan biaya penyimpanan yang lebih rendah tetapi data yang kurang granular untuk analisis.168Kardinalitas yang lebih rendah umumnya berarti kinerja yang lebih baik dan biaya penyimpanan yang lebih rendah tetapi data yang kurang granular untuk analisis.

169 169

171 Traces (beta)171 Traces (beta)

172</h3>172</h3>

173 173

174Distributed tracing mengekspor spans yang menghubungkan setiap prompt pengguna ke permintaan API dan eksekusi alat yang dipicunya, sehingga Anda dapat melihat permintaan lengkap sebagai satu trace di backend tracing Anda.174Distributed tracing mengekspor span yang menghubungkan setiap prompt pengguna ke permintaan API dan eksekusi alat yang dipicunya, sehingga Anda dapat melihat permintaan lengkap sebagai jejak tunggal di backend tracing Anda.

175 175

176Tracing dimatikan secara default. Untuk mengaktifkannya, atur `CLAUDE_CODE_ENABLE_TELEMETRY=1` dan `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, kemudian atur `OTEL_TRACES_EXPORTER` untuk memilih tempat spans dikirim. Traces menggunakan kembali [konfigurasi OTLP umum](#common-configuration-variables) untuk titik akhir, protokol, header, dan [mTLS](#mtls-authentication). Pada mesin dengan pengaturan terkelola, Claude Code [mungkin menghapus kredensial dan titik akhir per-sinyal yang ditetapkan pengembang](#how-managed-settings-lock-the-otlp-destination) saat startup.176Tracing dimatikan secara default. Untuk mengaktifkannya, atur `CLAUDE_CODE_ENABLE_TELEMETRY=1` dan `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, kemudian atur `OTEL_TRACES_EXPORTER` untuk memilih tempat span dikirim. Traces menggunakan kembali [konfigurasi OTLP umum](#common-configuration-variables) untuk endpoint, protokol, header, dan [mTLS](#mtls-authentication). Pada mesin dengan pengaturan terkelola, Claude Code [dapat menghapus kredensial dan endpoint spesifik sinyal yang ditetapkan pengembang](#how-managed-settings-lock-the-otlp-destination) saat startup.

177 177

179| - | - | - |179| - | - | - |

180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Aktifkan span tracing (diperlukan). `ENABLE_ENHANCED_TELEMETRY_BETA` juga diterima | `1` |180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Aktifkan span tracing (diperlukan). `ENABLE_ENHANCED_TELEMETRY_BETA` juga diterima | `1` |

185| `OTEL_TRACES_EXPORT_INTERVAL` | Interval ekspor batch span dalam milidetik (default: 5000) | `1000`, `10000` |185| `OTEL_TRACES_EXPORT_INTERVAL` | Interval ekspor batch span dalam milidetik (default: 5000) | `1000`, `10000` |

186 186

187Spans menyunting teks prompt pengguna, detail input alat, dan konten alat secara default. Atur `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1`, dan `OTEL_LOG_TOOL_CONTENT=1` untuk menyertakannya.187Span menyembunyikan teks prompt pengguna, detail input alat, dan konten alat secara default. Atur `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1`, dan `OTEL_LOG_TOOL_CONTENT=1` untuk menyertakannya.

188 188

189Saat tracing aktif, subproses Bash dan PowerShell secara otomatis mewarisi variabel lingkungan `TRACEPARENT` yang berisi konteks trace W3C dari span eksekusi alat yang aktif. Ini memungkinkan subproses apa pun yang membaca `TRACEPARENT` untuk membuat parent spans-nya di bawah trace yang sama, memungkinkan distributed tracing end-to-end melalui skrip dan perintah yang dijalankan Claude.189Ketika tracing aktif, subproses Bash dan PowerShell secara otomatis mewarisi variabel lingkungan `TRACEPARENT` yang berisi konteks jejak W3C dari span eksekusi alat yang aktif. Ini memungkinkan subproses apa pun yang membaca `TRACEPARENT` untuk membuat span-nya sendiri sebagai anak dari jejak yang sama, memungkinkan distributed tracing end-to-end melalui skrip dan perintah yang Claude jalankan.

190 190

191Saat tracing aktif dan Claude Code terhubung langsung ke API Anthropic, setiap permintaan model membawa header W3C `traceparent` yang diatur ke konteks span `claude_code.llm_request`, dan header `traceresponse` API dicatat sebagai link span. Bersama-sama ini menghubungkan spans sisi klien Claude Code ke trace sisi server melalui perantara yang sesuai. Outbound HTTP MCP requests membawa `traceparent` dengan cara yang sama. Header tidak dikirim ke penyedia pihak ketiga.191Ketika tracing aktif dan Claude Code terhubung langsung ke API Anthropic, setiap permintaan model membawa header W3C `traceparent` yang diatur ke konteks span `claude_code.llm_request`, dan header `traceresponse` API dicatat sebagai link span. Bersama-sama ini menghubungkan span sisi klien Claude Code ke jejak sisi server melalui perantara yang sesuai. Permintaan HTTP MCP keluar membawa `traceparent` dengan cara yang sama. Header tidak dikirim ke penyedia pihak ketiga.

192 192

193Secara default, header `traceparent` pada permintaan model dan HTTP MCP dikirim hanya saat `ANTHROPIC_BASE_URL` tidak diatur atau menunjuk ke API Anthropic, karena beberapa proxy menolak header yang tidak dikenali. Variabel `TRACEPARENT` subproses dikendalikan oleh switch yang sama untuk konsistensi. Jika Anda menjalankan Claude Code melalui proxy `ANTHROPIC_BASE_URL` kustom dan ingin konteks trace dipropagasi, atur `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.193Secara default, header `traceparent` pada permintaan model dan HTTP MCP dikirim hanya ketika `ANTHROPIC_BASE_URL` tidak diatur atau menunjuk ke API Anthropic, karena beberapa proxy menolak header yang tidak dikenali. Variabel `TRACEPARENT` subproses dikendalikan oleh switch yang sama untuk konsistensi. Jika Anda menjalankan Claude Code melalui proxy `ANTHROPIC_BASE_URL` kustom dan ingin konteks jejak dipropagasi, atur `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.

194 194

195Dalam sesi Agent SDK dan non-interaktif yang dimulai dengan `-p`, Claude Code juga membaca `TRACEPARENT` dan `TRACESTATE` dari lingkungannya sendiri saat memulai setiap span interaksi. Ini memungkinkan proses embedding untuk melewatkan konteks trace W3C aktifnya ke dalam subproses sehingga spans Claude Code muncul sebagai anak dari distributed trace pemanggil. Sesi interaktif mengabaikan `TRACEPARENT` inbound untuk menghindari secara tidak sengaja mewarisi nilai ambient dari lingkungan CI atau container.195Dalam sesi Agent SDK dan non-interaktif yang dimulai dengan `-p`, Claude Code juga membaca `TRACEPARENT` dan `TRACESTATE` dari lingkungannya sendiri saat memulai setiap span interaksi. Ini memungkinkan proses embedding melewatkan konteks jejak W3C aktifnya ke subproses sehingga span Claude Code muncul sebagai anak dari jejak distributed pemanggil. Sesi interaktif mengabaikan `TRACEPARENT` masuk untuk menghindari secara tidak sengaja mewarisi nilai ambient dari lingkungan CI atau kontainer.

196 196

197Konteks trace inbound juga berlaku untuk [events](#events). Dalam sesi Agent SDK dan `-p` dengan `TRACEPARENT` diatur, setiap catatan log acara OTLP membawa nilai `trace_id` dan `span_id` yang menghubungkannya ke trace aplikasi Anda, bahkan saat pengekspor traces tidak dikonfigurasi, sehingga backend logging Anda dapat mengorelasikan acara dengan sisa trace.197Konteks jejak masuk juga berlaku untuk [event](#events). Dalam sesi Agent SDK dan `-p` dengan `TRACEPARENT` diatur, setiap catatan log event OTLP membawa nilai `trace_id` dan `span_id` yang menghubungkannya ke jejak aplikasi Anda, bahkan ketika eksporter jejak tidak dikonfigurasi, sehingga backend logging Anda dapat mengorelasikan event dengan sisa jejak.

198 198

199Catatan yang dipancarkan saat interaksi aktif membawa ID span interaksi, bahkan saat Claude Code memancarkannya di luar konteks async span, seperti dalam callback prompt izin atau untuk catatan yang di-buffer selama startup dan diekspor nanti. Catatan yang dipancarkan tanpa span interaksi aktif membawa ID `TRACEPARENT` inbound secara langsung. Sebelum v2.1.214, catatan yang dipancarkan di luar konteks async span membawa ID `TRACEPARENT` inbound sebagai gantinya dari ID span. Sebelum v2.1.212, catatan acara yang dipancarkan di luar span aktif tidak membawa `trace_id` atau `span_id`.199Catatan yang dipancarkan saat interaksi aktif membawa ID span interaksi, bahkan ketika Claude Code memancarkannya di luar konteks async span, seperti dalam callback prompt izin atau untuk catatan yang di-buffer selama startup dan diekspor nanti. Catatan yang dipancarkan tanpa span interaksi aktif membawa ID `TRACEPARENT` masuk secara langsung. Sebelum v2.1.214, catatan yang dipancarkan di luar konteks async span membawa ID `TRACEPARENT` masuk sebagai gantinya. Sebelum v2.1.212, catatan event yang dipancarkan di luar span aktif tidak membawa `trace_id` atau `span_id`.

200 200

201<h4 id="span-hierarchy">201<h4 id="span-hierarchy">

202 Hierarki span202 Hierarki span

203</h4>203</h4>

204 204

205Setiap prompt pengguna memulai span root `claude_code.interaction`. Panggilan API, panggilan alat, dan eksekusi hook dicatat sebagai anak-anaknya. Spans alat memiliki dua span anak mereka sendiri: satu untuk waktu yang dihabiskan menunggu keputusan izin dan satu untuk eksekusi itu sendiri. Ketika alat Agent atau alat Task legacy menghasilkan subagent, spans API dan alat subagent bersarang di bawah span `claude_code.tool` induk.205Setiap prompt pengguna memulai span root `claude_code.interaction`. Panggilan API, panggilan alat, dan eksekusi hook dicatat sebagai anak-anaknya. Span alat memiliki dua span anak mereka sendiri: satu untuk waktu yang dihabiskan menunggu keputusan izin dan satu untuk eksekusi itu sendiri. Ketika alat Agent, atau alat Task warisan, memunculkan subagen, span API dan alat subagen bersarang di bawah span `claude_code.tool` induk.

206 206

207```text theme={null}207```text theme={null}

208claude_code.interaction208claude_code.interaction

209├── claude_code.llm_request209├── claude_code.llm_request

210├── claude_code.hook (memerlukan detailed beta tracing)210├── claude_code.hook (requires detailed beta tracing)

211└── claude_code.tool211└── claude_code.tool

212 ├── claude_code.tool.blocked_on_user212 ├── claude_code.tool.blocked_on_user

213 ├── claude_code.tool.execution213 ├── claude_code.tool.execution

214 └── (Agent tool) subagent claude_code.llm_request / claude_code.tool spans214 └── (Agent tool) subagent claude_code.llm_request / claude_code.tool spans

215```215```

216 216

217Dalam sesi Agent SDK dan `claude -p`, `claude_code.interaction` itu sendiri menjadi anak dari span pemanggil saat `TRACEPARENT` diatur dalam lingkungan.217Dalam sesi Agent SDK dan `claude -p`, `claude_code.interaction` itu sendiri menjadi anak dari span pemanggil ketika `TRACEPARENT` diatur dalam lingkungan.

218 218

219Saat hook `PreToolUse` [menunda panggilan alat](/docs/id/hooks#defer-a-tool-call-for-later), Claude Code menyimpan konteks trace dari giliran yang menundanya. Saat Anda melanjutkan sesi dan alat dijalankan kembali, spans alat bergabung dengan trace giliran sebelumnya sebagai anak dari span `claude_code.interaction` giliran.219Ketika hook `PreToolUse` [menunda panggilan alat](/docs/id/hooks#defer-a-tool-call-for-later), Claude Code menyimpan konteks jejak dari giliran yang menundanya. Ketika Anda melanjutkan sesi dan alat berjalan kembali, span alat bergabung dengan jejak giliran sebelumnya sebagai anak dari span `claude_code.interaction` giliran.

220 220

221<h4 id="span-attributes">221<h4 id="span-attributes">

222 Atribut span222 Atribut span

223</h4>223</h4>

224 224

225Setiap span membawa [atribut standar](#standard-attributes) ditambah atribut `span.type` yang cocok dengan namanya. Tabel di bawah mencantumkan atribut tambahan yang diatur pada setiap span. Spans `llm_request`, `tool.execution`, dan `hook` menetapkan status OpenTelemetry `ERROR` saat mereka mencatat kegagalan; span lainnya selalu berakhir dengan status `UNSET`.225Setiap span membawa [atribut standar](#standard-attributes) ditambah atribut `span.type` yang cocok dengan namanya. Tabel di bawah mencantumkan atribut tambahan yang diatur pada setiap span. Span `llm_request`, `tool.execution`, dan `hook` menetapkan status OpenTelemetry `ERROR` ketika mereka mencatat kegagalan; span lainnya selalu berakhir dengan status `UNSET`.

226 226

227**`claude_code.interaction`**227**`claude_code.interaction`**

228 228

230| - | - | - |230| - | - | - |

233| `interaction.sequence` | Penghitung berbasis 1 dari interaksi, dihitung per proses Claude Code daripada per sesi, seperti yang dijelaskan untuk [`event.sequence`](#event-correlation-attributes) | |233| `interaction.sequence` | Penghitung berbasis 1 dari interaksi, dihitung per proses Claude Code daripada per sesi, seperti yang dijelaskan untuk [`event.sequence`](#event-correlation-attributes) | |

234| `parent.source` | Bagaimana span mendapatkan parent trace-nya: `env` saat itu parent di bawah `TRACEPARENT` inbound, `none` saat itu memulai trace-nya sendiri. Memerlukan Claude Code v2.1.268 atau lebih baru | |234| `parent.source` | Bagaimana span mendapat induk jejak: `env` ketika itu induk di bawah `TRACEPARENT` masuk, `none` ketika itu memulai jejak sendiri. Memerlukan Claude Code v2.1.268 atau lebih baru | |

236 236

237**`claude_code.llm_request`**237**`claude_code.llm_request`**

238 238

240| - | - | - |240| - | - | - |

245| `query_source_safe` | Bentuk terbatas dari `query_source`, dipancarkan apakah atau tidak detailed beta tracing aktif, dengan nilai seperti `repl_main_thread` atau `agent.builtin.general-purpose`. `:` menjadi `.` dan agen yang dinamai pengguna muncul sebagai `agent.custom`. Memerlukan Claude Code v2.1.268 atau lebih baru | |245| `query_source_safe` | Bentuk terbatas dari `query_source`, dipancarkan apakah atau tidak tracing beta terperinci aktif, dengan nilai seperti `repl_main_thread` atau `agent.builtin.general-purpose`. `:` menjadi `.` dan agen bernama pengguna muncul sebagai `agent.custom`. Memerlukan Claude Code v2.1.268 atau lebih baru | |

247| `parent_agent_id` | Pengidentifikasi agen yang menghasilkan yang ini. Tidak ada untuk sesi utama dan untuk agen yang dihasilkan langsung darinya | |247| `parent_agent_id` | Pengenal agen yang memunculkan yang ini. Tidak ada untuk sesi utama dan untuk agen yang dimunculkan langsung darinya | |

248| `workflow.run_id` | Pengidentifikasi run dari run alat [Workflow](/docs/id/workflows) yang menghasilkan agen ini, dengan awalan `wf_`. Tidak ada untuk agen yang tidak dihasilkan oleh workflow | |248| `workflow.run_id` | Pengenal jalankan dari alat [Workflow](/docs/id/workflows) yang memunculkan agen ini, dengan awalan `wf_`. Tidak ada untuk agen yang tidak dimunculkan oleh workflow | |

251| `effort` | [Effort level](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan: `low`, `medium`, `high`, `xhigh`, atau `max`. Tidak ada saat Claude Code tidak mengirim effort level, misalnya pada model yang tidak mendukung effort. Memerlukan Claude Code v2.1.274 atau lebih baru | |251| `effort` | [Tingkat upaya](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan: `low`, `medium`, `high`, `xhigh`, atau `max`. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya. Memerlukan Claude Code v2.1.274 atau lebih baru | |

255| `first_content_ms` | Waktu dari awal permintaan ke blok konten pertama dari upaya yang berhasil, dalam milidetik. Tidak ada pada permintaan yang kembali ke jalur non-streaming. Memerlukan Claude Code v2.1.268 atau lebih baru | |255| `first_content_ms` | Waktu dari awal permintaan ke blok konten pertama dari upaya yang berhasil, dalam milidetik. Tidak ada pada permintaan yang kembali ke jalur non-streaming. Memerlukan Claude Code v2.1.268 atau lebih baru | |

267| `error_class` | Token kelas kesalahan pendek saat permintaan gagal, seperti `api_timeout` atau `server_overload`. Memerlukan Claude Code v2.1.268 atau lebih baru | |267| `error_class` | Token kelas kesalahan pendek ketika permintaan gagal, seperti `api_timeout` atau `server_overload`. Memerlukan Claude Code v2.1.268 atau lebih baru | |

269| `stop_reason` | API response `stop_reason`, seperti `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn`, atau `refusal` | |269| `stop_reason` | API response `stop_reason`, seperti `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn`, atau `refusal` | |

270| `gen_ai.response.finish_reasons` | Nilai yang sama dengan `stop_reason`, dibungkus dalam array string. Konvensi semantik GenAI OpenTelemetry | |270| `gen_ai.response.finish_reasons` | Nilai yang sama dengan `stop_reason`, dibungkus dalam array string. Konvensi semantik GenAI OpenTelemetry | |

271 271

272Setiap upaya retry juga dicatat sebagai acara span `gen_ai.request.attempt` dengan atribut `attempt` dan `client_request_id`.272Setiap upaya percobaan ulang juga dicatat sebagai event span `gen_ai.request.attempt` dengan atribut `attempt` dan `client_request_id`.

273 273

274**`claude_code.tool`**274**`claude_code.tool`**

275 275

277| - | - | - |277| - | - | - |

279| `tool_name_safe` | Bentuk `tool_name` yang tidak membawa nama yang dipilih pengguna. Nama alat bawaan lulus verbatim. Nama alat MCP muncul sebagai `mcp_other`, kecuali nama alat yang cocok dengan beberapa bentuk tetap, seperti alat `playwright` yang dinamai `browser_*`, yang lulus verbatim. Memerlukan Claude Code v2.1.268 atau lebih baru | |279| `tool_name_safe` | Bentuk `tool_name` yang tidak membawa nama yang dipilih pengguna. Nama alat bawaan lulus verbatim. Nama alat MCP muncul sebagai `mcp_other`, kecuali nama alat yang cocok dengan beberapa bentuk tetap, seperti alat `playwright` bernama `browser_*`, yang lulus verbatim. Memerlukan Claude Code v2.1.268 atau lebih baru | |

280| `bash_command_class` | Untuk alat Bash: kategori program pertama perintah dari daftar tetap, seperti `vcs` atau `package_manager`. `other` untuk program di luar daftar, `unparsed` saat baris tidak dapat diuraikan. Memerlukan Claude Code v2.1.268 atau lebih baru | |280| `bash_command_class` | Untuk alat Bash: kategori program pertama perintah dari daftar tetap, seperti `vcs` atau `package_manager`. `other` untuk program di luar daftar, `unparsed` ketika baris tidak dapat diuraikan. Memerlukan Claude Code v2.1.268 atau lebih baru | |

281| `bash_argv0` | Untuk alat Bash: program pertama perintah saat itu berada di daftar tetap yang sama, seperti `git` atau `npm`. `other` untuk program apa pun di luar daftar. Memerlukan Claude Code v2.1.268 atau lebih baru | |281| `bash_argv0` | Untuk alat Bash: program pertama perintah ketika itu ada di daftar tetap yang sama, seperti `git` atau `npm`. `other` untuk program apa pun di luar daftar. Memerlukan Claude Code v2.1.268 atau lebih baru | |

285| `parent_agent_id` | Pengidentifikasi agen yang menghasilkan yang ini. Tidak ada untuk sesi utama dan untuk agen yang dihasilkan langsung darinya | |285| `parent_agent_id` | Pengenal agen yang memunculkan yang ini. Tidak ada untuk sesi utama dan untuk agen yang dimunculkan langsung darinya | |

286| `workflow.run_id` | Pengidentifikasi run dari run alat Workflow yang menghasilkan agen ini, dengan awalan `wf_`. Tidak ada untuk agen yang tidak dihasilkan oleh workflow | |286| `workflow.run_id` | Pengenal jalankan dari alat Workflow yang memunculkan agen ini, dengan awalan `wf_`. Tidak ada untuk agen yang tidak dimunculkan oleh workflow | |

288| `tool_use_id` | ID blok `tool_use` model untuk panggilan ini. Cocok dengan `tool_use_id` pada acara [tool\_result](#tool-result-event) dan [tool\_decision](#tool-decision-event) serta dalam payload hook, sehingga Anda dapat menggabungkan span ke catatan tersebut | |288| `tool_use_id` | ID blok `tool_use` model untuk panggilan ini. Cocok dengan `tool_use_id` pada event [tool\_result](#tool-result-event) dan [tool\_decision](#tool-decision-event) serta dalam payload hook, sehingga Anda dapat menghubungkan span ke catatan tersebut | |

294 294

~~295<span id="tool-output-span-event" />**`tool.output` span event on `claude_code.tool`**~~295<span id="tool-output-span-event" />**`tool.output` span event pada `claude_code.tool`**

296 296

297Jika Anda menetapkan `OTEL_LOG_TOOL_CONTENT=1`, panggilan Read dan Bash dapat mencatat acara span `tool.output` pada span `claude_code.tool`. Panggilan Edit dan Write mencatat satu hanya saat Anda juga menetapkan `OTEL_LOG_TOOL_DETAILS=1`. Variabel itu tidak dibatasi pada kedua alat tersebut, jadi periksa [barisnya dalam tabel konfigurasi](#common-configuration-variables) untuk argumen yang ditambahkannya di tempat lain.297Jika Anda menetapkan `OTEL_LOG_TOOL_CONTENT=1`, panggilan Read dan Bash dapat mencatat event span `tool.output` pada span `claude_code.tool`. Panggilan Edit dan Write mencatat satu hanya ketika Anda juga menetapkan `OTEL_LOG_TOOL_DETAILS=1`. Variabel itu tidak dibatasi pada kedua alat itu, jadi periksa [barisnya dalam tabel konfigurasi](#common-configuration-variables) untuk argumen yang ditambahkannya di tempat lain.

298 298

299Claude Code menulis acara ini dari pengembalian yang berhasil dari panggilan alat, jadi panggilan yang menimbulkan kesalahan tidak mencatat apa pun, apa pun alatnya. Di antara panggilan yang memang kembali, itu tidak mencatat acara `tool.output` untuk:299Alat MCP, WebFetch, dan WebSearch juga mencatat event ini, pada Claude Code v2.1.283 atau lebih baru.

300 300

301* Panggilan ke alat apa pun selain Read, Edit, Write, dan Bash, termasuk alat MCP dan WebFetch301Claude Code menulis event ini dari pengembalian sukses panggilan alat, jadi panggilan yang menimbulkan kesalahan tidak mencatat apa pun, apa pun alatnya. Di antara panggilan yang memang kembali, itu tidak mencatat event `tool.output` untuk:

302

303* Panggilan ke alat apa pun selain Read, Edit, Write, Bash, WebFetch, WebSearch, dan alat MCP

302* Read yang mengembalikan apa pun selain teks file, seperti gambar, PDF, atau pembacaan ulang file yang isinya belum berubah304* Read yang mengembalikan apa pun selain teks file, seperti gambar, PDF, atau pembacaan ulang file yang isinya belum berubah

303* Panggilan Edit atau Write, kecuali Anda juga menetapkan `OTEL_LOG_TOOL_DETAILS=1`305* Panggilan Edit atau Write, kecuali Anda juga menetapkan `OTEL_LOG_TOOL_DETAILS=1`

306* Panggilan WebFetch atau WebSearch yang Claude Code pindahkan ke latar belakang karena Anda mengganggu giliran untuk [mengirim pesan antrian Anda segera](/docs/id/interactive-mode#when-claude-code-sends-what-you-queued) saat panggilan berjalan. Claude menerima hasil itu nanti, setelah span alat berakhir

304 307

305Acara membawa atribut-atribut ini, masing-masing dipotong pada batas konten (60 KB secara default). `Gated by` menamai variabel yang dibutuhkan atribut di atas `OTEL_LOG_TOOL_CONTENT=1`, dan untuk Edit dan Write variabel itu mengatur acara itu sendiri daripada atribut.308Event membawa atribut ini, masing-masing dipotong pada batas konten (60 KB secara default). `Gerbang oleh` menamai variabel yang atribut butuhkan di atas `OTEL_LOG_TOOL_CONTENT=1`, dan untuk Edit dan Write variabel itu membuka gerbang event itu sendiri daripada atribut.

306 309

308| - | - | - |311| - | - | - |

310| `output` | Output gabungan dari perintah Bash, dengan stderr yang diselipkan ke stdout | |313| `output` | Untuk alat Bash, output gabungan perintah, dengan stderr yang disisipi ke stdout. Untuk alat MCP, WebFetch, atau WebSearch, hasil yang dikembalikan alat: blok teks digabung dengan baris baru, dengan gambar atau dokumen diganti dengan placeholder seperti `[image]` | |

314 317

315Atribut `tool_name` span induk memberi tahu Anda alat mana yang berasal dari acara. Atribut yang dipotong pada batas konten disertai dengan `<attribute>_truncated` dan `<attribute>_original_length`.318Atribut `tool_name` span induk memberi tahu Anda alat mana yang berasal dari event. Atribut yang dipotong pada batas konten disertai dengan `<attribute>_truncated` dan `<attribute>_original_length`.

316 319

317**`claude_code.tool.blocked_on_user`**320**`claude_code.tool.blocked_on_user`**

318 321

320| - | - | - |323| - | - | - |

324 327

325**`claude_code.tool.execution`**328**`claude_code.tool.execution`**

326 329

328| - | - | - |331| - | - | - |

333| `error` | String kategori kesalahan saat eksekusi gagal, seperti `Error:ENOENT` atau `ShellError`. Berisi pesan kesalahan lengkap sebagai gantinya saat gate diatur | `OTEL_LOG_TOOL_DETAILS` |336| `error` | String kategori kesalahan ketika eksekusi gagal, seperti `Error:ENOENT` atau `ShellError`. Berisi pesan kesalahan lengkap sebagai gantinya ketika gerbang diatur | `OTEL_LOG_TOOL_DETAILS` |

334| `error_class` | Kategori kesalahan dalam bentuk pengidentifikasi, dengan karakter di luar huruf, digit, dan garis bawah diganti dengan `_`, seperti `Error_ENOENT` atau `ShellError`. Membawa kategori bahkan saat `error` membawa pesan lengkap. Memerlukan Claude Code v2.1.268 atau lebih baru | |337| `error_class` | Kategori kesalahan dalam bentuk pengenal, dengan karakter di luar huruf, digit, dan garis bawah diganti dengan `_`, seperti `Error_ENOENT` atau `ShellError`. Membawa kategori bahkan ketika `error` membawa pesan lengkap. Memerlukan Claude Code v2.1.268 atau lebih baru | |

335 338

336**`claude_code.hook`**339**`claude_code.hook`**

337 340

338Span ini muncul hanya saat detailed beta tracing aktif, yang memerlukan `ENABLE_BETA_TRACING_DETAILED=1` dan `BETA_TRACING_ENDPOINT`, sepasang yang juga [mengubah tempat log dan traces Anda pergi](/docs/id/env-vars#variables). Atur pasangan dalam shell, pengaturan pengguna, atau pengaturan terkelola; kedua variabel diabaikan dalam [pengaturan proyek dan lokal](/docs/id/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` saja tidak menghasilkannya.341Span ini muncul hanya ketika tracing beta terperinci aktif, yang memerlukan `ENABLE_BETA_TRACING_DETAILED=1` dan `BETA_TRACING_ENDPOINT`, pasangan yang juga [mengubah tempat log dan jejak Anda pergi](/docs/id/env-vars#variables). Atur pasangan dalam shell, pengaturan pengguna, atau pengaturan terkelola; kedua variabel diabaikan dalam [pengaturan proyek dan lokal](/docs/id/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` saja tidak menghasilkannya.

339 342

340Dalam sesi CLI interaktif, detailed beta tracing juga memerlukan organisasi Anda untuk berada dalam daftar putih untuk fitur ini. Sesi Agent SDK dan non-interaktif `-p` tidak memerlukan daftar putih.343Dalam sesi CLI interaktif, tracing beta terperinci juga memerlukan organisasi Anda untuk diizinkan untuk fitur tersebut. Sesi Agent SDK dan non-interaktif `-p` tidak memerlukan izin.

341 344

343| - | - | - |346| - | - | - |

353 356

354<span id="new-context-gates" />357<span id="new-context-gates" />

355 358

356<Note>359<Note>

357 Atribut tambahan yang mengandung konten seperti `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input`, dan `response.model_output` dipancarkan hanya saat detailed beta tracing aktif. Mereka bukan bagian dari skema span yang stabil.360 Atribut tambahan yang membawa konten seperti `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input`, dan `response.model_output` dipancarkan hanya ketika tracing beta terperinci aktif. Mereka bukan bagian dari skema span yang stabil.

358 361

359 Gate pada `new_context` tergantung pada span mana yang membawanya, dan setiap salinan dipotong pada batas konten (60 KB secara default). Pada span `claude_code.tool` itu membawa hasil panggilan alat itu, apa pun alatnya, dan memerlukan `OTEL_LOG_TOOL_CONTENT=1`. Pada span `claude_code.interaction` itu membawa prompt pengguna, dan pada span `claude_code.llm_request` pesan pengguna baru dan hasil alat dari permintaan itu. Keduanya memerlukan `OTEL_LOG_USER_PROMPTS=1`.362 Gerbang pada `new_context` tergantung pada span mana yang membawanya, dan setiap salinan dipotong pada batas konten (60 KB secara default). Pada span `claude_code.tool` itu membawa hasil panggilan alat itu, apa pun alatnya, dan memerlukan `OTEL_LOG_TOOL_CONTENT=1`. Pada span `claude_code.interaction` itu membawa prompt pengguna, dan pada span `claude_code.llm_request` pesan pengguna baru dan hasil alat dari permintaan itu. Keduanya memerlukan `OTEL_LOG_USER_PROMPTS=1`.

360 363

361 `user_system_prompt` juga memerlukan `OTEL_LOG_USER_PROMPTS=1`. Ini membawa hanya teks prompt sistem yang Anda berikan melalui opsi SDK `systemPrompt` atau flag `--system-prompt` dan `--append-system-prompt`, dipotong pada batas konten (60 KB secara default), dan dipancarkan sekali per sesi daripada per permintaan.364 `user_system_prompt` juga memerlukan `OTEL_LOG_USER_PROMPTS=1`. Itu membawa hanya teks prompt sistem yang Anda berikan melalui opsi SDK `systemPrompt` atau flag `--system-prompt` dan `--append-system-prompt`, dipotong pada batas konten (60 KB secara default), dan dipancarkan sekali per sesi daripada per permintaan.

362</Note>365</Note>

363 366

364<h3 id="dynamic-headers">367<h3 id="dynamic-headers">

365 Header dinamis368 Header dinamis

366</h3>369</h3>

367 370

368Untuk lingkungan perusahaan yang memerlukan autentikasi dinamis, Anda dapat mengonfigurasi skrip untuk menghasilkan header secara dinamis. Header dinamis hanya berlaku untuk protokol `http/protobuf` dan `http/json`. Dengan protokol `grpc`, Claude Code hanya menggunakan variabel header statis, `OTEL_EXPORTER_OTLP_HEADERS` dan varian per-sinyalnya.371Untuk lingkungan perusahaan yang memerlukan autentikasi dinamis, Anda dapat mengonfigurasi skrip untuk menghasilkan header secara dinamis. Header dinamis berlaku hanya untuk protokol `http/protobuf` dan `http/json`. Dengan protokol `grpc`, Claude Code hanya menggunakan variabel header statis, `OTEL_EXPORTER_OTLP_HEADERS` dan varian spesifik sinyal-nya.

369 372

370<h4 id="settings-configuration">373<h4 id="settings-configuration">

371 Konfigurasi pengaturan374 Konfigurasi pengaturan

372</h4>375</h4>

373 376

374Tambahkan ke `.claude/settings.json` Anda, mengganti jalur dengan skrip Anda sendiri:377Tambahkan ke `.claude/settings.json` Anda, ganti jalur dengan skrip Anda sendiri:

375 378

376```json theme={null}379```json theme={null}

377{380{

389 392

390```bash theme={null}393```bash theme={null}

391#!/bin/bash394#!/bin/bash

392# Contoh: Header ganda395# Contoh: Multiple headers

393echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"396echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

394```397```

395 398

396Jika pembantu gagal atau mencetak output yang tidak memenuhi persyaratan ini, ekspor gagal dan backend telemetri Anda tidak menerima apa pun dari sesi sampai pembantu berfungsi lagi. Claude Code melaporkan kegagalan dalam:399Jika helper gagal atau mencetak output yang tidak memenuhi persyaratan ini, ekspor gagal dan backend telemetri Anda tidak menerima apa pun dari sesi sampai helper berfungsi lagi. Claude Code melaporkan kegagalan dalam:

397 400

398* Notifikasi peringatan dalam sesi interaktif, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/id/errors#otelheadershelper-failed), ditampilkan sekali per sesi saat pembantu pertama kali gagal401* Notifikasi peringatan dalam sesi interaktif, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/id/errors#otelheadershelper-failed), ditampilkan sekali per sesi ketika helper pertama kali gagal

399* Output `/status`402* Output `/status`

400* Log debug, saat berjalan dengan [`--debug`](/docs/id/cli-reference#cli-flags) atau setelah menjalankan `/debug` dalam sesi403* Log debug, saat berjalan dengan [`--debug`](/docs/id/cli-reference#cli-flags) atau setelah menjalankan `/debug` dalam sesi

401* stderr, dalam sesi non-interaktif yang dimulai dengan `-p`404* stderr, dalam sesi non-interaktif yang dimulai dengan `-p`

404 Perilaku penyegaran407 Perilaku penyegaran

405</h4>408</h4>

406 409

407Skrip pembantu header berjalan saat startup dan secara berkala setelahnya untuk mendukung penyegaran token. Secara default, skrip berjalan setiap 29 menit. Sesuaikan interval dengan variabel lingkungan `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`.410Skrip helper header berjalan saat startup dan secara berkala setelahnya untuk mendukung penyegaran token. Secara default, skrip berjalan setiap 29 menit. Sesuaikan interval dengan variabel lingkungan `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`.

408 411

409<h3 id="multi-team-organization-support">412<h3 id="multi-team-organization-support">

410 Dukungan organisasi multi-tim413 Dukungan organisasi multi-tim

411</h3>414</h3>

412 415

413Organisasi dengan beberapa tim atau departemen dapat menambahkan atribut khusus untuk membedakan antara kelompok yang berbeda menggunakan variabel lingkungan `OTEL_RESOURCE_ATTRIBUTES`:416Organisasi dengan beberapa tim atau departemen dapat menambahkan atribut kustom untuk membedakan antara kelompok yang berbeda menggunakan variabel lingkungan `OTEL_RESOURCE_ATTRIBUTES`:

414 417

415```bash theme={null}418```bash theme={null}

416# Tambahkan atribut khusus untuk identifikasi tim419# Tambahkan atribut kustom untuk identifikasi tim

417export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"420export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

418```421```

419 422

420Atribut khusus ini akan disertakan dalam semua metrik dan acara, memungkinkan Anda untuk:423Atribut kustom ini disertakan dalam semua metrik dan event, memungkinkan Anda untuk:

421 424

422* Filter metrik berdasarkan tim atau departemen425* Filter metrik berdasarkan tim atau departemen

423* Lacak biaya per pusat biaya426* Lacak biaya per pusat biaya

424* Buat dasbor khusus tim427* Buat dashboard khusus tim

425* Atur peringatan untuk tim tertentu428* Atur peringatan untuk tim tertentu

426 429

427Claude Code melampirkan nilai-nilai ini sebagai atribut pada setiap titik data metrik dan catatan acara, selain mengirimkannya dalam blok sumber daya OTLP. Karena sebagian besar backend metrik mengekspos atribut titik data sebagai label yang dapat dikueri, Anda dapat mengelompokkan dan memfilter metrik berdasarkan kunci khusus Anda secara langsung. Kecuali untuk atribut repositori `vcs.*` [repository attributes](#repository-attributes), kunci khusus tidak pernah menimpa [atribut standar](#standard-attributes) seperti `user.id` atau `session.id`: saat kunci bertabrakan, Claude Code mempertahankan nilai built-in.430Claude Code melampirkan nilai-nilai ini sebagai atribut pada setiap titik data metrik dan catatan event, selain mengirimkannya dalam blok sumber daya OTLP. Karena sebagian besar backend metrik mengekspos atribut titik data sebagai label yang dapat dipertanyakan, Anda dapat mengelompokkan dan memfilter metrik berdasarkan kunci kustom Anda secara langsung. Kecuali untuk atribut repositori `vcs.*` [repository attributes](#repository-attributes), kunci kustom tidak pernah menimpa [atribut standar](#standard-attributes) seperti `user.id` atau `session.id`: ketika kunci bertabrakan, Claude Code menyimpan nilai bawaan.

428 431

429Setiap kunci khusus menjadi label pada setiap deret metrik, jadi nilai kardinalitas tinggi meningkatkan biaya penyimpanan di backend metrik Anda. Untuk mengirim atribut khusus dalam blok sumber daya saja dan menghilangkannya dari label titik data, atur `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Lihat [Kontrol kardinalitas metrik](#metrics-cardinality-control).432Setiap kunci kustom menjadi label pada setiap seri metrik, jadi nilai kardinalitas tinggi meningkatkan biaya penyimpanan di backend metrik Anda. Untuk mengirim atribut kustom dalam blok sumber daya saja dan menghilangkannya dari label titik data, atur `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Lihat [Kontrol kardinalitas metrik](#metrics-cardinality-control).

430 433

431<Warning>434<Warning>

432 Variabel lingkungan `OTEL_RESOURCE_ATTRIBUTES` menggunakan pasangan kunci=nilai yang dipisahkan koma dengan persyaratan pemformatan yang ketat:435 Variabel lingkungan `OTEL_RESOURCE_ATTRIBUTES` menggunakan pasangan kunci=nilai yang dipisahkan koma dengan persyaratan pemformatan yang ketat:

433 436

434 * **Tidak ada spasi yang diizinkan**: nilai tidak dapat berisi spasi. Misalnya, `user.organizationName=My Company` tidak valid437 * **Tidak ada spasi yang diizinkan**: nilai tidak dapat berisi spasi. Misalnya, `user.organizationName=My Company` tidak valid

435 * **Format**: harus berupa pasangan kunci=nilai yang dipisahkan koma: `key1=value1,key2=value2`438 * **Format**: harus berupa pasangan kunci=nilai yang dipisahkan koma: `key1=value1,key2=value2`

436 * **Karakter yang diizinkan**: hanya karakter US-ASCII yang tidak termasuk karakter kontrol, spasi, tanda kutip ganda, koma, titik koma, dan garis miring terbalik439 * **Karakter yang diizinkan**: hanya karakter US-ASCII yang mengecualikan karakter kontrol, spasi, tanda kutip ganda, koma, titik koma, dan garis miring terbalik

437 * **Karakter khusus**: karakter di luar rentang yang diizinkan harus dikodekan persen440 * **Karakter khusus**: karakter di luar rentang yang diizinkan harus dikodekan persen

438 441

439 Untuk nilai yang memerlukan spasi, gunakan garis bawah atau camelCase sebagai gantinya. Contoh berikut menetapkan `org.name` dengan setiap bentuk:442 Untuk nilai yang memerlukan spasi, gunakan garis bawah atau camelCase sebagai gantinya. Contoh berikut menetapkan `org.name` dengan setiap bentuk:

456 Konfigurasi contoh459 Konfigurasi contoh

457</h3>460</h3>

458 461

459Atur variabel lingkungan ini sebelum menjalankan `claude`. Setiap skenario di bawah menunjukkan konfigurasi lengkap, dan setiap variabel dijelaskan di bawah [Variabel konfigurasi umum](#common-configuration-variables). Untuk mengonfirmasi konfigurasi berlaku, periksa backend Anda untuk metrik `claude_code.session.count` setelah memulai sesi; [Quick start](#quick-start) mencakup verifikasi hanya-log dan apa yang harus diperiksa saat tidak ada yang tiba.462Atur variabel lingkungan ini sebelum menjalankan `claude`. Setiap skenario di bawah menunjukkan konfigurasi lengkap, dan setiap variabel dijelaskan di bawah [Variabel konfigurasi umum](#common-configuration-variables). Untuk mengonfirmasi konfigurasi berlaku, periksa backend Anda untuk metrik `claude_code.session.count` setelah memulai sesi; [Quick start](#quick-start) mencakup verifikasi log saja dan apa yang harus diperiksa ketika tidak ada yang tiba.

460 463

461Untuk debugging konsol dengan interval ekspor 1 detik:464Untuk debugging konsol dengan interval ekspor 1 detik:

462 465

466export OTEL_METRIC_EXPORT_INTERVAL=1000469export OTEL_METRIC_EXPORT_INTERVAL=1000

467```470```

468 471

469Untuk OTLP over gRPC:472Untuk OTLP melalui gRPC:

470 473

471```bash theme={null}474```bash theme={null}

472export CLAUDE_CODE_ENABLE_TELEMETRY=1475export CLAUDE_CODE_ENABLE_TELEMETRY=1

475export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317478export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

476```479```

477 480

478Untuk Prometheus, di-scrape dari `http://localhost:9464/metrics`:481Untuk Prometheus, yang discrape dari `http://localhost:9464/metrics`:

479 482

480```bash theme={null}483```bash theme={null}

481export CLAUDE_CODE_ENABLE_TELEMETRY=1484export CLAUDE_CODE_ENABLE_TELEMETRY=1

482export OTEL_METRICS_EXPORTER=prometheus485export OTEL_METRICS_EXPORTER=prometheus

483```486```

484 487

485Pada [lingkungan self-hosted](/docs/id/self-hosted-environments-reference#pass-through-session-child-metrics), sesi mengikat port 9464 hanya pada kapasitas default runner satu. Pada kapasitas yang lebih tinggi, runner kembali mengekspos penghitung sesi dan gauge pada titik akhir `/metrics` miliknya sendiri.488Pada [lingkungan yang di-host sendiri](/docs/id/self-hosted-environments-reference#pass-through-session-child-metrics), sesi mengikat port 9464 hanya pada kapasitas default runner satu. Pada kapasitas yang lebih tinggi, runner kembali mengekspos penghitung dan gauge sesi pada endpoint `/metrics` miliknya sendiri sebagai gantinya.

486 489

487Untuk mengirim metrik ke beberapa pengekspor:490Untuk mengirim metrik ke beberapa eksporter:

488 491

489```bash theme={null}492```bash theme={null}

490export CLAUDE_CODE_ENABLE_TELEMETRY=1493export CLAUDE_CODE_ENABLE_TELEMETRY=1

492export OTEL_EXPORTER_OTLP_PROTOCOL=http/json495export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

493```496```

494 497

495Untuk mengirim metrik dan log ke titik akhir atau backend yang berbeda:498Untuk mengirim metrik dan log ke endpoint atau backend yang berbeda:

496 499

497```bash theme={null}500```bash theme={null}

498export CLAUDE_CODE_ENABLE_TELEMETRY=1501export CLAUDE_CODE_ENABLE_TELEMETRY=1

504export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317507export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

505```508```

506 509

507Untuk mengekspor hanya metrik, tanpa acara atau log:510Untuk mengekspor metrik saja, tanpa event atau log:

508 511

509```bash theme={null}512```bash theme={null}

510export CLAUDE_CODE_ENABLE_TELEMETRY=1513export CLAUDE_CODE_ENABLE_TELEMETRY=1

513export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317516export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

514```517```

515 518

516Untuk mengekspor hanya acara dan log, tanpa metrik:519Untuk mengekspor event dan log saja, tanpa metrik:

517 520

518```bash theme={null}521```bash theme={null}

519export CLAUDE_CODE_ENABLE_TELEMETRY=1522export CLAUDE_CODE_ENABLE_TELEMETRY=1

522export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317525export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

523```526```

524 527

528<h2 id="telemetry-from-cloud-sessions-and-claude-tag">

529 Telemetri dari sesi cloud dan Claude Tag

530</h2>

531

532[Sesi cloud](/docs/id/claude-code-on-the-web), termasuk sesi saluran [Claude Tag](https://claude.com/docs/claude-tag/overview), berjalan di [lingkungan cloud](/docs/id/cloud-environments) daripada di perangkat pengguna Anda, jadi file pengaturan terkelola atau profil shell di perangkat tersebut tidak mengonfigurasi telemetri mereka. Untuk sesi di lingkungan yang dihosting Anthropic, bagian ini mencakup tempat untuk menetapkan variabel telemetri, cara membuat kolektor Anda dapat diakses dari lingkungan, dan cara membedakan sesi cloud dan Claude Tag dalam data yang diekspor.

533

534Untuk mengekspor telemetri dari sesi tersebut, atur `CLAUDE_CODE_ENABLE_TELEMETRY` dan variabel `OTEL_*`, menggunakan kunci yang sama seperti contoh [konfigurasi administrator](#administrator-configuration), di salah satu dari dua tempat:

535

536* **Pengaturan yang dikelola server**: tambahkan ke blok `env` dari [pengaturan yang dikelola server](/docs/id/server-managed-settings) organisasi Anda. Claude Code mengambil pengaturan tersebut saat startup di mana pun [pengaturan yang dikelola server berlaku](/docs/id/model-config#surface-coverage), yang mencakup mesin pengguna Anda dan sesi cloud selain sesi saluran Claude Tag. Sesi Claude Tag tidak menerima pengaturan yang dikelola server Anda, jadi rute ini tidak mengonfigurasinya.

537* **Variabel lingkungan**: tambahkan ke [variabel lingkungan](/docs/id/cloud-environments#set-environment-variables) lingkungan cloud untuk mengonfigurasi hanya sesi yang berjalan di lingkungan tersebut. Ini adalah rute yang menjangkau sesi Claude Tag.

538

539Siapa pun yang menggunakan lingkungan dapat membaca variabelnya, jadi jangan letakkan kredensial di sana, seperti token kolektor di `OTEL_EXPORTER_OTLP_HEADERS`. [Kredensial API](/docs/id/cloud-environments#add-api-credentials) di lingkungan juga tidak membantu, karena ekspor telemetri Claude Code sendiri adalah salah satu dari [permintaan yang tidak pernah mendapatkan kredensial](/docs/id/cloud-environments#requests-that-never-get-the-credential). Jika kolektor Anda memerlukan kredensial, konfigurasikan seluruh ekspor melalui pengaturan yang dikelola server sebagai gantinya, karena ketika Anda menetapkan kredensial di sana, [Claude Code menghapus variabel titik akhir yang ditetapkan di luar pengaturan terkelola](#how-managed-settings-lock-the-otlp-destination).

540

541Pertahankan batasan ini dalam pikiran ketika Anda mengonfigurasi telemetri untuk sesi cloud:

542

543* **Biarkan sesi menjangkau kolektor**: Claude Code mengirim ekspor melalui jaringan sesi, jadi apakah itu menjangkau host di `OTEL_EXPORTER_OTLP_ENDPOINT` Anda tergantung pada [tingkat akses jaringan](/docs/id/cloud-environments#access-levels) lingkungan. Jika sesi tidak dapat menjangkau domain kolektor pada tingkat yang Anda pilih, [tambahkan domain ke daftar izin lingkungan](/docs/id/cloud-environments#allow-specific-domains), karena tidak ada pengaturan yang dikelola server yang menambahkan domain ke daftar izin jaringan lingkungan.

544* **Saluran Claude Tag menggunakan lingkungan tingkat organisasi**: sesi saluran berjalan di lingkungan tingkat organisasi daripada lingkungan pribadi anggota, jadi buat perubahan daftar izin dan variabel lingkungan apa pun di [lingkungan bersama](/docs/id/cloud-environments#organization-shared-environments) yang ditetapkan sebagai default organisasi Anda atau disematkan ke saluran.

545* **Cowork dikonfigurasi secara terpisah**: sesi Cowork tidak menerima pengaturan yang dikelola server, seperti yang ditunjukkan [tabel cakupan permukaan](/docs/id/model-config#surface-coverage), jadi blok `env` yang dikelola server tidak mengonfigurasi telemetri mereka.

546

547<h3 id="attribute-telemetry-to-cloud-sessions">

548 Atribut telemetri ke sesi cloud

549</h3>

550

551Secara default, metrik dan acara dari sesi cloud membawa [atribut standar](#standard-attributes), termasuk `session.id`, `ccr.session.id`, dan `organization.id`, sehingga Anda dapat memfilter berdasarkan sesi atau organisasi tanpa konfigurasi tambahan. Nilai `ccr.session.id` adalah `CLAUDE_CODE_REMOTE_SESSION_ID` sesi. Untuk mengubahnya menjadi URL transkrip sesi, lihat [Tautkan output kembali ke sesi](/docs/id/cloud-environments#link-output-back-to-the-session).

552

553Untuk mengatribusikan telemetri secara lebih detail, gunakan opsi berikut:

554

555* **Identifikasi sesi Claude Tag**: atur `OTEL_METRICS_INCLUDE_ENTRYPOINT=true`, seperti yang dijelaskan di bawah [Kontrol kardinalitas metrik](#metrics-cardinality-control). Metrik kemudian membawa `app.entrypoint`, yang nilainya adalah `claude-in-slack` untuk sesi Claude Tag.

556* **Tambahkan atribut kustom**: atur [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) di tempat yang sama di mana Anda menetapkan variabel `OTEL_*` lainnya untuk sesi tersebut. Jika Anda `export` di [skrip setup](/docs/id/cloud-environments#setup-scripts) lingkungan sebagai gantinya, nilainya tidak mencapai Claude Code: skrip setup adalah skrip Bash terpisah yang berjalan sebelum Claude Code diluncurkan, dan variabel yang diekspor berakhir dengannya.

557

558Dalam sesi saluran Claude Tag, Claude bekerja sebagai [identitas bersama](/docs/id/cloud-environments#set-the-environment-a-claude-tag-channel-uses) organisasi Anda daripada sebagai anggota apa pun, jadi jangan andalkan atribut `user.*` untuk mengidentifikasi siapa yang menandai Claude.

559

525<h2 id="available-metrics-and-events">560<h2 id="available-metrics-and-events">

526 Metrik dan acara yang tersedia561 Metrik dan peristiwa yang tersedia

527</h2>562</h2>

528 563

529<h3 id="standard-attributes">564<h3 id="standard-attributes">

530 Atribut standar565 Atribut standar

531</h3>566</h3>

532 567

533Semua metrik dan acara berbagi atribut standar ini:568Semua metrik dan peristiwa berbagi atribut standar ini:

534 569

536| - | - | - |571| - | - | - |

573| `ccr.session.id` | Pengenal sesi cloud, nilai dari `CLAUDE_CODE_REMOTE_SESSION_ID`, pada sesi yang berjalan di [lingkungan cloud](/docs/id/cloud-environments) | `OTEL_METRICS_INCLUDE_SESSION_ID` (default: true) |

539| `app.entrypoint` | Bagaimana sesi diluncurkan, seperti `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, atau `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (default: false) |575| `app.entrypoint` | Bagaimana sesi diluncurkan, seperti `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-vscode`, atau `claude-in-slack` untuk sesi Claude Tag | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (default: false) |

542| `user.account_id` | ID akun dalam format yang ditandai sesuai dengan API admin Anthropic (saat diautentikasi), seperti `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (default: true) |578| `user.account_id` | ID akun dalam format tagged yang cocok dengan API admin Anthropic (saat diautentikasi), seperti `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (default: true) |

543| `user.id` | Pengidentifikasi anonim acak yang dihasilkan pada run pertama dan disimpan di `~/.claude.json`. Tidak mengandung informasi pribadi dan tidak berasal dari akun Claude Anda. Menghapus file menghasilkan nilai yang tidak terkait pada run berikutnya. | Selalu disertakan |579| `user.id` | Pengenal anonim acak yang dihasilkan pada run pertama dan disimpan di `~/.claude.json`. Tidak mengandung informasi pribadi dan tidak berasal dari akun Claude Anda. Menghapus file menghasilkan nilai yang tidak terkait pada run berikutnya. | Selalu disertakan |

544| `user.email` | Alamat email pengguna, dari sign-in Anda atau, dalam [sesi cloud](/docs/id/claude-code-on-the-web), dari kredensial sesi itu sendiri | Selalu disertakan saat tersedia |580| `user.email` | Alamat email pengguna, dari sign-in Anda atau, dalam [sesi cloud](/docs/id/claude-code-on-the-web), dari kredensial sesi itu sendiri | Selalu disertakan saat tersedia |

546| Kunci dari `OTEL_RESOURCE_ATTRIBUTES` | Atribut khusus yang Anda atur, seperti `department` atau `team.id`. Lihat [Dukungan organisasi multi-tim](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (default: true) |582| Kunci dari `OTEL_RESOURCE_ATTRIBUTES` | Atribut kustom yang Anda tetapkan, seperti `department` atau `team.id`. Lihat [Dukungan organisasi multi-tim](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (default: true) |

547| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Identitas repositori sesi, diturunkan dari remote `origin`-nya. Lihat [Atribut repositori](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (default: false). Memerlukan Claude Code v2.1.269 atau lebih baru |583| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Identitas repositori sesi, berasal dari remote `origin`-nya. Lihat [Atribut repositori](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (default: false). Memerlukan Claude Code v2.1.269 atau lebih baru |

548 584

549Saat Claude Code masuk ke [gateway aplikasi Claude](/docs/id/claude-apps-gateway), CLI memberi stempel ekspor dengan identitas yang diautentikasi dari sesi gateway: `user.id` adalah subjek IdP daripada pengidentifikasi instalasi anonim, `user.email` adalah email yang masuk, dan `user.groups` membawa keanggotaan grup IdP sebagai string yang dipisahkan koma. Setiap ekspor juga membawa `identity.source: gateway-oidc`. Identitas gateway diterapkan terakhir, jadi kunci `user.*` dan `identity.*` yang diatur melalui `OTEL_RESOURCE_ATTRIBUTES` diabaikan pada sesi gateway.585Ketika Claude Code masuk ke [gateway aplikasi Claude](/docs/id/claude-apps-gateway), CLI memberi stempel ekspor dengan identitas terautentikasi dari sesi gateway: `user.id` adalah subjek IdP daripada pengenal instalasi anonim, `user.email` adalah email yang masuk, dan `user.groups` membawa keanggotaan grup IdP sebagai string yang dipisahkan koma. Setiap ekspor juga membawa `identity.source: gateway-oidc`. Identitas gateway diterapkan terakhir, jadi kunci `user.*` dan `identity.*` yang ditetapkan melalui `OTEL_RESOURCE_ATTRIBUTES` diabaikan pada sesi gateway.

550 586

551Acara juga menyertakan atribut berikut. Ini tidak pernah dilampirkan pada metrik karena akan menyebabkan kardinalitas tak terbatas:587Peristiwa juga menyertakan atribut berikut. Ini tidak pernah dilampirkan ke metrik karena akan menyebabkan kardinalitas tak terbatas:

552 588

553* `prompt.id`: UUID yang menghubungkan prompt pengguna dengan semua acara berikutnya hingga prompt berikutnya. Lihat [Atribut korelasi acara](#event-correlation-attributes).589* `prompt.id`: UUID yang menghubungkan prompt pengguna dengan semua peristiwa berikutnya hingga prompt berikutnya. Lihat [Atribut korelasi peristiwa](#event-correlation-attributes).

554* `workspace.host_paths`: direktori ruang kerja host yang dipilih di aplikasi desktop, sebagai array string590* `workspace.host_paths`: direktori workspace host yang dipilih di aplikasi desktop, sebagai array string

555* `workflow.run_id`: pengidentifikasi run, dengan awalan `wf_`, pada acara API dan alat yang dipancarkan oleh agen yang termasuk dalam run alat [Workflow](/docs/id/workflows). Memfilter acara berdasarkan satu `workflow.run_id` merekonstruksi permintaan API dan hasil alat run tersebut. Pengidentifikasi mencakup agen yang dihasilkan skrip workflow dan agen apa pun yang dihasilkan agen tersebut pada gilirannya, seperti invokasi skill. Ini cocok dengan pengidentifikasi run yang dilaporkan dalam hasil alat Workflow. Tidak ada pada semua acara lainnya. Memerlukan Claude Code v2.1.202 atau lebih baru591* `workflow.run_id`: pengenal run, dengan awalan `wf_`, pada peristiwa API dan alat yang dipancarkan oleh agen yang termasuk dalam run alat [Workflow](/docs/id/workflows). Memfilter peristiwa berdasarkan satu `workflow.run_id` merekonstruksi permintaan API dan hasil alat run tersebut. Pengenal mencakup agen yang dihasilkan skrip workflow dan agen apa pun yang dihasilkan agen tersebut, seperti invokasi skill. Ini cocok dengan pengenal run yang dilaporkan dalam hasil alat Workflow. Tidak ada pada semua peristiwa lainnya. Memerlukan Claude Code v2.1.202 atau lebih baru

556* `workflow.name`: nama workflow, `meta.name` skrip-nya, dipancarkan bersama `workflow.run_id`. Nama workflow built-in muncul verbatim saat run mengeksekusi skrip built-in yang tidak dimodifikasi. Nama yang ditulis pengguna, termasuk salinan yang diedit dari skrip built-in, diganti dengan `custom` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur. Memerlukan Claude Code v2.1.202 atau lebih baru592* `workflow.name`: nama workflow, `meta.name` skrip-nya, dipancarkan bersama `workflow.run_id`. Nama workflow bawaan muncul verbatim saat run mengeksekusi skrip bawaan yang tidak dimodifikasi. Nama yang ditulis pengguna, termasuk salinan yang diedit dari skrip bawaan, diganti dengan `custom` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur. Memerlukan Claude Code v2.1.202 atau lebih baru

557 593

558<h4 id="repository-attributes">594<h4 id="repository-attributes">

559 Atribut repositori595 Atribut repositori

560</h4>596</h4>

561 597

562Atur `OTEL_METRICS_INCLUDE_REPOSITORY=true` untuk menandai metrik dan acara dengan identitas repositori sesi, sehingga kolektor bersama dapat mengaitkan penggunaan per repositori. Memerlukan Claude Code v2.1.269 atau lebih baru.598Atur `OTEL_METRICS_INCLUDE_REPOSITORY=true` untuk menandai metrik dan peristiwa dengan identitas repositori sesi, sehingga kolektor bersama dapat mengatribusikan penggunaan per repositori. Memerlukan Claude Code v2.1.269 atau lebih baru.

563 599

564Claude Code menurunkan atribut ini sekali per sesi dari remote `origin` repositori. Remote HTTPS dan SSH dari satu repositori menghasilkan nilai yang identik:600Claude Code menurunkan atribut ini sekali per sesi dari remote `origin` repositori. Ketika remote HTTPS dan SSH dari repositori menamai host dan path yang sama, seperti yang mereka lakukan di GitHub, GitLab, dan Bitbucket Cloud, keduanya menghasilkan nilai yang identik:

565 601

566| Atribut | Nilai |602| Atribut | Nilai |

567| - | - |603| - | - |

571| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, atau `gitea` saat Claude Code mengenali host remote atau bentuk URL sebagai salah satu penyedia tersebut; dihilangkan sebaliknya |607| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, atau `gitea` ketika Claude Code mengenali host remote atau bentuk URL sebagai salah satu penyedia tersebut; dihilangkan sebaliknya |

608

609Nilai diubah menjadi huruf kecil, dan kredensial, string kueri, dan fragmen dari URL remote tidak pernah muncul di dalamnya. Atribut dihilangkan ketika sesi tidak memiliki remote `origin`, ketika remote tidak berbentuk URL, atau ketika satu-satunya repositori yang menutup adalah direktori home Anda.

572 610

573Nilai diubah menjadi huruf kecil, dan kredensial, string kueri, dan fragmen dari URL remote tidak pernah muncul di dalamnya. Atribut dihilangkan saat sesi tidak memiliki remote `origin`, saat remote tidak berbentuk URL, atau saat satu-satunya repositori yang menutup adalah direktori home Anda.611Untuk mendapatkan atribut ini dari [sesi cloud](/docs/id/claude-code-on-the-web), atur variabel telemetri, termasuk `OTEL_METRICS_INCLUDE_REPOSITORY`, pada [lingkungan cloud](/docs/id/cloud-environments#set-environment-variables)-nya. Juga izinkan domain kolektor Anda di [akses jaringan](/docs/id/cloud-environments#network-access) lingkungan.

574 612

575Kunci `vcs.*` yang Anda deklarasikan dalam [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) menggantikan nilai yang diturunkan untuk kunci itu. Jika Anda mendeklarasikan `vcs.repository.url.full`, Claude Code tidak pernah membaca remote dan hanya melaporkan kunci yang Anda deklarasikan.613Kunci `vcs.*` yang Anda deklarasikan dalam [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) menggantikan nilai yang diturunkan untuk kunci tersebut. Jika Anda mendeklarasikan `vcs.repository.url.full`, Claude Code tidak pernah membaca remote dan hanya melaporkan kunci yang Anda deklarasikan.

576 614

577Atribut mengalir hanya ke pengekspor Anda sendiri; telemetri Anthropic menghilangkan setiap kunci `vcs.*`.615Jika klon HTTPS dan SSH dari satu repositori melaporkan nilai yang berbeda, seperti pada instalasi yang di-host sendiri yang URL klon HTTPS-nya membawa awalan path yang URL SSH tidak memiliki, deklarasikan `vcs.repository.url.full` dalam `OTEL_RESOURCE_ATTRIBUTES` bersama dengan setiap kunci `vcs.*` lainnya yang ingin Anda laporkan. Setiap klon kemudian melaporkan identitas yang Anda deklarasikan.

616

617Atribut hanya mengalir ke eksporter Anda sendiri; telemetri Anthropic menghilangkan setiap kunci `vcs.*`.

578 618

579<h3 id="metrics">619<h3 id="metrics">

580 Metrik620 Metrik

581</h3>621</h3>

582 622

583Claude Code mengekspor metrik berikut. Kolom Unit menunjukkan string unit OpenTelemetry yang dilampirkan pada setiap metrik; metrik count tidak membawa satuan apa pun.623Claude Code mengekspor metrik berikut. Kolom Unit menunjukkan string unit OpenTelemetry yang dilampirkan ke setiap metrik; metrik penghitung tidak membawa apa pun.

584 624

586| - | - | - |626| - | - | - |

591| `claude_code.cost.usage` | Biaya sesi Claude Code | USD |631| `claude_code.cost.usage` | Biaya sesi Claude Code | USD |

594| `claude_code.active_time.total` | Total waktu aktif | s |634| `claude_code.active_time.total` | Total waktu aktif | s |

595 635

596Saat `prometheus` adalah satu-satunya pengekspor yang tercantum dalam `OTEL_METRICS_EXPORTER`, Claude Code menghilangkan unit `USD`, `tokens`, dan `s` dari metrik yang diekspor sehingga scrape tetap dalam format teks Prometheus yang valid. Nama metrik tidak berubah, dan konfigurasi yang menggabungkan pengekspor, seperti `otlp,prometheus`, menyimpan unit. Sebelum v2.1.216, scrape Prometheus menyertakan baris `# UNIT` khusus OpenMetrics yang beberapa scraper menolak.636Ketika `prometheus` adalah satu-satunya eksporter yang terdaftar dalam `OTEL_METRICS_EXPORTER`, Claude Code menghilangkan unit `USD`, `tokens`, dan `s` dari metrik yang diekspor sehingga scrape tetap format teks Prometheus yang valid. Nama metrik tidak berubah, dan konfigurasi yang menggabungkan eksporter, seperti `otlp,prometheus`, menyimpan unit. Sebelum v2.1.216, scrape Prometheus menyertakan baris `# UNIT` khusus OpenMetrics yang beberapa scraper menolak.

597 637

598<h3 id="metric-details">638<h3 id="metric-details">

599 Detail metrik639 Detail metrik

600</h3>640</h3>

601 641

602Setiap metrik mencakup atribut standar yang tercantum di atas. Metrik dengan atribut khusus konteks tambahan dicatat di bawah ini.642Setiap metrik menyertakan atribut standar yang tercantum di atas. Metrik dengan atribut konteks tambahan dicatat di bawah.

603 643

604<h4 id="session-counter">644<h4 id="session-counter">

605 Penghitung sesi645 Penghitung sesi

610**Atribut**:650**Atribut**:

611 651

612* Semua [atribut standar](#standard-attributes)652* Semua [atribut standar](#standard-attributes)

613* `start_type`: Bagaimana sesi dimulai. Salah satu dari `"fresh"`, `"resume"`, `"continue"`, atau `"agents_view"`. Nilai `"agents_view"` mengidentifikasi proses dashboard `claude agents`, antarmuka lokal yang diluncurkan pengguna daripada sesi percakapan. Filter pada nilai ini untuk memisahkan peluncuran proses UI dari sesi percakapan di dasbor Anda.653* `start_type`: Bagaimana sesi dimulai. Salah satu dari `"fresh"`, `"resume"`, `"continue"`, atau `"agents_view"`. Nilai `"agents_view"` mengidentifikasi proses dashboard `claude agents`, UI lokal yang diluncurkan pengguna daripada sesi percakapan. Filter pada nilai ini untuk memisahkan peluncuran proses UI dari sesi percakapan di dashboard Anda.

614 654

615<h4 id="lines-of-code-counter">655<h4 id="lines-of-code-counter">

616 Penghitung baris kode656 Penghitung baris kode

617</h4>657</h4>

618 658

619Ditingkatkan saat kode ditambahkan atau dihapus.659Ditingkatkan ketika kode ditambahkan atau dihapus.

620 660

621**Atribut**:661**Atribut**:

622 662

623* Semua [atribut standar](#standard-attributes)663* Semua [atribut standar](#standard-attributes)

624* `type`: (`"added"`, `"removed"`)664* `type`: (`"added"`, `"removed"`)

625* `model`: Pengidentifikasi model untuk model yang membuat perubahan (misalnya, "claude-sonnet-5")665* `model`: Pengenal model untuk model yang membuat perubahan (misalnya, "claude-sonnet-5")

626 666

627<h4 id="pull-request-counter">667<h4 id="pull-request-counter">

628 Penghitung permintaan tarik668 Penghitung pull request

629</h4>669</h4>

630 670

631Ditingkatkan saat Claude Code membuat permintaan tarik atau merge request melalui perintah shell atau alat MCP.671Ditingkatkan ketika Claude Code membuat pull request atau merge request melalui perintah shell atau alat MCP.

632 672

633**Atribut**:673**Atribut**:

634 674

635* Semua [atribut standar](#standard-attributes)675* Semua [atribut standar](#standard-attributes)

636 676

637<h4 id="commit-counter">677<h4 id="commit-counter">

638 Penghitung komit678 Penghitung commit

639</h4>679</h4>

640 680

641Ditingkatkan saat membuat komit git melalui Claude Code.681Ditingkatkan saat membuat git commit melalui Claude Code.

642 682

643**Atribut**:683**Atribut**:

644 684

650 690

651Ditingkatkan setelah setiap permintaan API.691Ditingkatkan setelah setiap permintaan API.

652 692

693Atribut `agent.name`, `skill.name`, `plugin.name`, `mcp_server.name`, dan `mcp_tool.name` masing-masing menyunting beberapa nama menjadi placeholder `"custom"` atau `"third-party"` secara default. Jika Anda mengatur `OTEL_LOG_TOOL_DETAILS=1`, mereka membawa nama asli sebagai gantinya. Sebelum v2.1.273, penghitung biaya dan token serta peristiwa `api_request`, `api_error`, dan `api_refusal` membawa nilai yang disunting bahkan dengan `OTEL_LOG_TOOL_DETAILS=1` diatur.

694

653**Atribut**:695**Atribut**:

654 696

655* Semua [atribut standar](#standard-attributes)697* Semua [atribut standar](#standard-attributes)

656* `model`: Pengidentifikasi model (misalnya, "claude-sonnet-5")698* `model`: Pengenal model (misalnya, "claude-sonnet-5")

657* `query_source`: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari `"main"`, `"subagent"`, atau `"auxiliary"`699* `query_source`: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari `"main"`, `"subagent"`, atau `"auxiliary"`

658* `speed`: `"fast"` saat permintaan menggunakan mode cepat. Tidak ada sebaliknya700* `speed`: `"fast"` ketika permintaan menggunakan mode cepat. Tidak ada sebaliknya

659* `effort`: [Tingkat effort](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan: `"low"`, `"medium"`, `"high"`, `"xhigh"`, atau `"max"`. Tidak ada saat model tidak mendukung effort.701* `effort`: [Tingkat upaya](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan: `"low"`, `"medium"`, `"high"`, `"xhigh"`, atau `"max"`. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.

660* `agent.name`: Jenis subagent yang mengeluarkan permintaan. Nama agen built-in dan agen dari plugin marketplace resmi muncul verbatim. Nama agen yang ditentukan pengguna lainnya diganti dengan `"custom"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur. Tidak ada saat permintaan tidak dikeluarkan oleh jenis subagent bernama.702* `agent.name`: Jenis subagen yang mengeluarkan permintaan. Nama agen bawaan dan agen dari plugin marketplace resmi muncul verbatim. Nama agen yang ditentukan pengguna lainnya diganti dengan `"custom"`. Tidak ada ketika permintaan tidak dikeluarkan oleh jenis subagen bernama.

661* `skill.name`: Skill aktif untuk permintaan, diatur oleh alat Skill, perintah `/`, atau diwarisi oleh subagent yang dihasilkan. Nama skill built-in, bundled, yang ditentukan pengguna, dan plugin marketplace resmi muncul verbatim. Nama skill plugin pihak ketiga diganti dengan `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur. Tidak ada saat tidak ada skill yang aktif.703* `skill.name`: Skill aktif untuk permintaan, diatur oleh alat Skill atau perintah `/`, atau diwarisi oleh subagen yang dihasilkan. Nama skill bawaan, bundel, yang ditentukan pengguna, dan plugin marketplace resmi muncul verbatim. Nama skill plugin pihak ketiga diganti dengan `"third-party"`. Tidak ada ketika tidak ada skill yang aktif.

662* `plugin.name`: Plugin pemilik saat skill atau subagent aktif disediakan oleh plugin. Nama plugin marketplace resmi muncul verbatim. Nama plugin pihak ketiga diganti dengan `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur. Tidak ada saat skill atau subagent tidak memiliki plugin pemilik.704* `plugin.name`: Plugin pemilik ketika skill aktif atau subagen disediakan oleh plugin. Nama plugin marketplace resmi muncul verbatim. Nama plugin pihak ketiga diganti dengan `"third-party"`. Tidak ada ketika skill maupun subagen memiliki plugin pemilik.

663* `marketplace.name`: Marketplace tempat plugin pemilik diinstal. Hanya dipancarkan untuk plugin marketplace resmi. Tidak ada sebaliknya.705* `marketplace.name`: Marketplace tempat plugin pemilik diinstal. Hanya dipancarkan untuk plugin marketplace resmi, bahkan dengan `OTEL_LOG_TOOL_DETAILS=1` diatur. Tidak ada sebaliknya.

664* `mcp_server.name`: Server MCP yang alatnya berjalan dalam giliran yang menghasilkan permintaan ini. Nama server built-in, claude.ai-proxied, dan official-registry muncul verbatim. Nama server yang dikonfigurasi pengguna diganti dengan `"custom"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur. Tidak ada saat tidak ada alat MCP yang berjalan. Sebelum v2.1.222, Claude Code menetapkan atribut ini pada setiap permintaan setelah panggilan alat MCP, bukan hanya pada permintaan yang menggunakan hasil alat, jadi dasbor yang mengagregasinya menunjukkan penurunan setelah Anda upgrade.706* `mcp_server.name`: Server MCP yang hasil alat ini dikonsumsi permintaan. Nama server bawaan, yang di-proxy claude.ai, dan registry resmi muncul verbatim. Nama server yang dikonfigurasi pengguna diganti dengan `"custom"`. Tidak ada ketika permintaan tidak mengonsumsi hasil alat MCP. Sebelum v2.1.222, Claude Code menetapkan atribut ini pada setiap permintaan setelah panggilan alat MCP, bukan hanya pada permintaan yang mengonsumsi hasil alat, jadi dashboard yang mengagregasinya menunjukkan penurunan setelah Anda upgrade.

665* `mcp_tool.name`: Alat MCP yang berjalan dalam giliran yang menghasilkan permintaan ini, dengan redaksi yang sama dan perilaku versi sebagai `mcp_server.name`. Tidak ada saat tidak ada alat MCP yang berjalan.707* `mcp_tool.name`: Alat MCP yang hasil ini dikonsumsi permintaan, dengan perilaku penyuntingan dan versi yang sama dengan `mcp_server.name`. Tidak ada ketika permintaan tidak mengonsumsi hasil alat MCP.

666 708

667<h4 id="token-counter">709<h4 id="token-counter">

668 Penghitung token710 Penghitung token

674 716

675* Semua [atribut standar](#standard-attributes)717* Semua [atribut standar](#standard-attributes)

676* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)718* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)

677* `model`: Pengidentifikasi model (misalnya, "claude-sonnet-5")719* `model`: Pengenal model (misalnya, "claude-sonnet-5")

678* `query_source`: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari `"main"`, `"subagent"`, atau `"auxiliary"`720* `query_source`: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari `"main"`, `"subagent"`, atau `"auxiliary"`

679* `speed`: `"fast"` saat permintaan menggunakan mode cepat. Tidak ada sebaliknya721* `speed`: `"fast"` ketika permintaan menggunakan mode cepat. Tidak ada sebaliknya

680* `effort`: [Tingkat effort](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan. Lihat [Penghitung biaya](#cost-counter) untuk detail.722* `effort`: [Tingkat upaya](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan. Lihat [Penghitung biaya](#cost-counter) untuk detail.

681* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku redaksi.723* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku penyuntingan.

682 724

683<h4 id="code-edit-tool-decision-counter">725<h4 id="code-edit-tool-decision-counter">

684 Penghitung keputusan alat pengeditan kode726 Penghitung keputusan alat pengedit kode

685</h4>727</h4>

686 728

687Ditingkatkan saat pengguna menerima atau menolak penggunaan alat Edit, Write, atau NotebookEdit.729Ditingkatkan ketika pengguna menerima atau menolak penggunaan alat Edit, Write, atau NotebookEdit.

688 730

689**Atribut**:731**Atribut**:

690 732

691* Semua [atribut standar](#standard-attributes)733* Semua [atribut standar](#standard-attributes)

692* `tool_name`: Nama alat (`"Edit"`, `"Write"`, `"NotebookEdit"`)734* `tool_name`: Nama alat (`"Edit"`, `"Write"`, `"NotebookEdit"`)

693* `decision`: Keputusan pengguna (`"accept"`, `"reject"`)735* `decision`: Keputusan pengguna (`"accept"`, `"reject"`)

694* `source`: Sumber keputusan. Salah satu dari `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"`, atau `"user_reject"`. Lihat [Acara keputusan alat](#tool-decision-event) untuk mengetahui apa arti setiap nilai.736* `source`: Dari mana keputusan berasal. Salah satu dari `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"`, atau `"user_reject"`. Lihat [Peristiwa keputusan alat](#tool-decision-event) untuk apa arti setiap nilai.

695* `language`: Bahasa pemrograman file yang diedit, seperti `"TypeScript"`, `"Python"`, `"JavaScript"`, atau `"Markdown"`. Mengembalikan `"unknown"` untuk ekstensi file yang tidak dikenali.737* `language`: Bahasa pemrograman file yang diedit, seperti `"TypeScript"`, `"Python"`, `"JavaScript"`, atau `"Markdown"`. Mengembalikan `"unknown"` untuk ekstensi file yang tidak dikenali.

696 738

697<h4 id="active-time-counter">739<h4 id="active-time-counter">

698 Penghitung waktu aktif740 Penghitung waktu aktif

699</h4>741</h4>

700 742

701Melacak waktu aktual yang dihabiskan secara aktif menggunakan Claude Code, tidak termasuk waktu idle. Metrik ini ditingkatkan selama interaksi pengguna, seperti mengetik dan membaca respons, dan selama pemrosesan CLI, seperti eksekusi alat dan pembuatan respons AI.743Melacak waktu aktual yang dihabiskan untuk menggunakan Claude Code secara aktif, tidak termasuk waktu idle. Metrik ini ditingkatkan selama interaksi pengguna, seperti mengetik dan membaca respons, dan selama pemrosesan CLI, seperti eksekusi alat dan pembuatan respons AI.

702 744

703**Atribut**:745**Atribut**:

704 746

706* `type`: `"user"` untuk interaksi keyboard, `"cli"` untuk eksekusi alat dan respons AI748* `type`: `"user"` untuk interaksi keyboard, `"cli"` untuk eksekusi alat dan respons AI

707 749

708<h3 id="events">750<h3 id="events">

709 Acara751 Peristiwa

710</h3>752</h3>

711 753

712Claude Code mengekspor acara berikut melalui log/acara OpenTelemetry (saat `OTEL_LOGS_EXPORTER` dikonfigurasi):754Claude Code mengekspor peristiwa berikut melalui log/peristiwa OpenTelemetry (ketika `OTEL_LOGS_EXPORTER` dikonfigurasi):

713 755

714<h4 id="event-correlation-attributes">756<h4 id="event-correlation-attributes">

715 Atribut korelasi acara757 Atribut korelasi peristiwa

716</h4>758</h4>

717 759

718Saat pengguna mengirimkan prompt, Claude Code dapat membuat beberapa panggilan API dan menjalankan beberapa alat. Atribut `prompt.id` memungkinkan Anda menghubungkan semua acara tersebut kembali ke prompt tunggal yang memicunya.760Ketika pengguna mengirimkan prompt, Claude Code dapat membuat beberapa panggilan API dan menjalankan beberapa alat. Atribut `prompt.id` memungkinkan Anda menghubungkan semua peristiwa tersebut kembali ke prompt tunggal yang memicunya.

719 761

720| Atribut | Deskripsi |762| Atribut | Deskripsi |

721| - | - |763| - | - |

722| `prompt.id` | Pengidentifikasi UUID v4 yang menghubungkan semua acara yang dihasilkan saat memproses prompt pengguna tunggal |764| `prompt.id` | Pengenal UUID v4 yang menghubungkan semua peristiwa yang dihasilkan saat memproses prompt pengguna tunggal |

724| `message.uuid` | UUID pesan seperti yang disimpan dalam transkrip sesi, file `~/.claude/projects/*/*.jsonl`. Hadir pada `assistant_response`, pada `api_response_body`, dan pada `user_prompt` kecuali untuk command dispatches, yang dapat menghasilkan nol atau banyak pesan. Pada `assistant_response` dan `api_response_body`, ini adalah entri transkrip akhir respons, yang `parentUuid` giliran berikutnya berantai dari. Memerlukan Claude Code v2.1.214 atau lebih baru, atau v2.1.274 atau lebih baru pada `api_response_body` |766| `message.uuid` | UUID pesan seperti yang disimpan dalam transkrip sesi, file `~/.claude/projects/*/*.jsonl`. Hadir pada `assistant_response`, pada `api_response_body`, dan pada `user_prompt` kecuali untuk pengiriman perintah, yang dapat menghasilkan nol atau banyak pesan. Pada `assistant_response` dan `api_response_body`, ini adalah entri transkrip akhir respons, yang `parentUuid` giliran berikutnya rantai dari. Memerlukan Claude Code v2.1.214 atau lebih baru, atau v2.1.274 atau lebih baru pada `api_response_body` |

725| `client_request_id` | UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`. Hadir pada `api_request` dan `api_error` pada koneksi API pihak pertama; tidak ada pada backend penyedia pihak ketiga dan saat permintaan diulang melalui fallback non-streaming. Memasangkan permintaan dengan responsnya dan tetap tersedia untuk kegagalan seperti timeout yang tidak pernah menghasilkan `request_id` server. Cocok dengan atribut yang sama pada span trace `llm_request`. Memerlukan Claude Code v2.1.214 atau lebih baru |767| `request_id` | ID yang ditetapkan server dari permintaan API, dibaca dari header respons `request-id`, seperti `req_011...`. Pada respons tanpa header `request-id`, seperti pada [Amazon Bedrock](/docs/id/amazon-bedrock), nilai berasal dari header `x-amzn-requestid` sebagai gantinya. Hadir pada `api_request`, `api_error`, `api_refusal`, `assistant_response`, dan `api_response_body` ketika respons membawa salah satu header. Cocok dengan atribut yang sama pada span trace `llm_request`. Sumber `x-amzn-requestid` memerlukan Claude Code v2.1.282 atau lebih baru |

768| `client_request_id` | UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`. Hadir pada `api_request` dan `api_error` pada koneksi API pihak pertama; tidak ada pada backend penyedia pihak ketiga dan ketika permintaan diulang melalui fallback non-streaming. Memasangkan permintaan dengan responsnya dan tetap tersedia untuk kegagalan seperti timeout yang tidak pernah menghasilkan `request_id` server. Cocok dengan atribut yang sama pada span trace `llm_request`. Memerlukan Claude Code v2.1.214 atau lebih baru |

726 769

727Untuk melacak semua aktivitas yang dipicu oleh prompt tunggal, filter acara Anda berdasarkan nilai `prompt.id` tertentu. Ini mengembalikan acara user\_prompt, acara api\_request apa pun, dan acara tool\_result apa pun yang terjadi saat memproses prompt tersebut.770Untuk melacak semua aktivitas yang dipicu oleh prompt tunggal, filter peristiwa Anda berdasarkan nilai `prompt.id` tertentu. Ini mengembalikan peristiwa user\_prompt, peristiwa api\_request apa pun, dan peristiwa tool\_result apa pun yang terjadi saat memproses prompt tersebut.

728 771

729`event.sequence` dimulai pada 0 setiap kali proses Claude Code dimulai dan menghitung naik untuk kehidupan proses itu. Terus menghitung di seluruh `/clear`, yang menetapkan `session.id` baru. Jika Anda [melanjutkan sesi tanpa forking](/docs/id/how-claude-code-works#resume-or-fork-sessions), sesi menyimpan `session.id`-nya tetapi mengambil nilai `event.sequence`-nya dari proses yang melanjutkannya, jadi dalam satu sesi acara yang lebih baru dapat membawa nilai yang lebih rendah daripada acara yang lebih awal, atau mengulangi satu. Untuk mengurutkan acara sesi, urutkan berdasarkan `event.timestamp` dan gunakan `event.sequence` untuk mengurutkan acara yang berbagi stempel waktu.772`event.sequence` dimulai pada 0 setiap kali proses Claude Code dimulai dan menghitung untuk kehidupan proses tersebut. Terus menghitung di seluruh `/clear`, yang menetapkan `session.id` baru. Jika Anda [melanjutkan sesi tanpa forking](/docs/id/how-claude-code-works#resume-or-fork-sessions), sesi menyimpan `session.id`-nya tetapi mengambil nilai `event.sequence`-nya dari proses yang melanjutkannya, jadi dalam satu sesi peristiwa yang lebih baru dapat membawa nilai yang lebih rendah daripada yang lebih awal, atau mengulangi satu. Untuk mengurutkan peristiwa sesi, urutkan berdasarkan `event.timestamp` dan gunakan `event.sequence` untuk mengurutkan peristiwa yang berbagi timestamp.

730 773

731Untuk rekonstruksi tingkat pesan, setiap kelas acara membawa kunci yang cocok dengan bidang dalam transkrip sesi. Format entri transkrip adalah [internal untuk Claude Code](/docs/id/sessions#where-transcripts-are-stored) dan berubah antar versi, jadi pipeline yang bergabung pada bidang ini dapat rusak pada rilis apa pun; perlakukan penggabungan sebagai spesifik versi daripada kontrak stabil:774Untuk rekonstruksi tingkat pesan, setiap kelas peristiwa membawa kunci yang cocok dengan bidang dalam transkrip sesi. Format entri transkrip adalah [internal ke Claude Code](/docs/id/sessions#where-transcripts-are-stored) dan berubah antar versi, jadi pipeline yang bergabung pada bidang ini dapat rusak pada rilis apa pun; perlakukan penggabungan sebagai spesifik versi daripada kontrak stabil:

732 775

733* `message.uuid` pada `user_prompt`, `assistant_response`, dan `api_response_body`776* `message.uuid` pada `user_prompt`, `assistant_response`, dan `api_response_body`

734* `request_id` pada acara API, disimpan sebagai `requestId` pada entri asisten transkrip777* `request_id` pada peristiwa API, disimpan sebagai `requestId` pada entri asisten transkrip

735* `tool_use_id` pada acara `tool_result` dan `tool_decision`778* `tool_use_id` pada peristiwa `tool_result` dan `tool_decision`

736 779

737<h4 id="user-prompt-event">780<h4 id="user-prompt-event">

738 Acara prompt pengguna781 Peristiwa prompt pengguna

739</h4>782</h4>

740 783

741Dicatat saat pengguna mengirimkan prompt.784Dicatat ketika pengguna mengirimkan prompt.

742 785

743**Nama Acara**: `claude_code.user_prompt`786**Nama Peristiwa**: `claude_code.user_prompt`

744 787

745**Atribut**:788**Atribut**:

746 789

747* Semua [atribut standar](#standard-attributes)790* Semua [atribut standar](#standard-attributes)

748* `event.name`: `"user_prompt"`791* `event.name`: `"user_prompt"`

749* `event.timestamp`: Stempel waktu ISO 8601792* `event.timestamp`: Timestamp ISO 8601

750* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)793* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

751* `prompt_length`: Panjang prompt794* `prompt_length`: Panjang prompt

752* `prompt`: Konten prompt. Diredaksi secara default. Atur `OTEL_LOG_USER_PROMPTS=1` untuk menyertakannya795* `prompt`: Konten prompt. Disunting secara default. Atur `OTEL_LOG_USER_PROMPTS=1` untuk menyertakannya

753* `message.uuid`: UUID pesan pengguna yang dihasilkan, cocok dengan entri transkrip yang disimpan. Tidak ada pada command dispatches, yang dapat menghasilkan nol atau banyak pesan. Memerlukan Claude Code v2.1.214 atau lebih baru796* `message.uuid`: UUID pesan pengguna yang dihasilkan, cocok dengan entri transkrip yang disimpan. Tidak ada pada pengiriman perintah, yang dapat menghasilkan nol atau banyak pesan. Memerlukan Claude Code v2.1.214 atau lebih baru

754* `command_name`: Nama perintah saat prompt memanggil satu. Nama perintah built-in dan bundled seperti `compact` atau `debug` dipancarkan apa adanya; alias seperti `reset` dipancarkan sebagai yang diketik daripada nama kanonik. Nama perintah custom, plugin, dan MCP runtuh menjadi `custom` atau `mcp` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur797* `command_name`: Nama perintah ketika prompt memanggil satu. Nama perintah bawaan dan bundel seperti `compact` atau `debug` dipancarkan apa adanya; alias seperti `reset` dipancarkan seperti yang diketik daripada nama kanonik. Nama perintah kustom, plugin, dan MCP runtuh menjadi `custom` atau `mcp` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur

755* `command_source`: Asal perintah saat ada: `builtin`, `custom`, atau `mcp`. Perintah yang disediakan plugin melaporkan sebagai `custom`798* `command_source`: Asal perintah saat ada: `builtin`, `custom`, atau `mcp`. Perintah yang disediakan plugin melaporkan sebagai `custom`

756 799

757<h4 id="assistant-response-event">800<h4 id="assistant-response-event">

758 Acara respons asisten801 Peristiwa respons asisten

759</h4>802</h4>

760 803

761Dicatat setelah setiap permintaan API yang mengembalikan konten teks dari model. Hanya blok teks respons yang disertakan; blok thinking dan blok tool-use dikecualikan. Memerlukan Claude Code v2.1.193 atau lebih baru.804Dicatat setelah setiap permintaan API yang mengembalikan konten teks dari model. Hanya blok teks respons yang disertakan; blok pemikiran dan blok penggunaan alat dikecualikan. Memerlukan Claude Code v2.1.193 atau lebih baru.

762 805

763**Nama Acara**: `claude_code.assistant_response`806**Nama Peristiwa**: `claude_code.assistant_response`

764 807

765**Atribut**:808**Atribut**:

766 809

767* Semua [atribut standar](#standard-attributes)810* Semua [atribut standar](#standard-attributes)

768* `event.name`: `"assistant_response"`811* `event.name`: `"assistant_response"`

769* `event.timestamp`: Stempel waktu ISO 8601812* `event.timestamp`: Timestamp ISO 8601

770* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)813* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

771* `response_length`: Panjang teks respons dalam karakter814* `response_length`: Panjang teks respons dalam karakter

772* `response`: Teks respons, dipotong pada batas konten (60 KB secara default). Diredaksi menjadi `<REDACTED>` secara default. Atur `OTEL_LOG_ASSISTANT_RESPONSES=1` untuk menyertakannya. Saat `OTEL_LOG_ASSISTANT_RESPONSES` tidak diatur, `OTEL_LOG_USER_PROMPTS` mengontrolnya sebagai gantinya, jadi atur `OTEL_LOG_ASSISTANT_RESPONSES=0` untuk menjaga respons diredaksi saat logging prompt aktif815* `response`: Teks respons, dipotong pada batas konten (60 KB secara default). Disunting menjadi `<REDACTED>` secara default. Atur `OTEL_LOG_ASSISTANT_RESPONSES=1` untuk menyertakannya. Ketika `OTEL_LOG_ASSISTANT_RESPONSES` tidak diatur, `OTEL_LOG_USER_PROMPTS` mengontrolnya sebagai gantinya, jadi atur `OTEL_LOG_ASSISTANT_RESPONSES=0` untuk menjaga respons disunting saat pencatatan prompt aktif

773* `model`: Pengidentifikasi model (misalnya, "claude-sonnet-5")816* `model`: Pengenal model (misalnya, "claude-sonnet-5")

774* `request_id`: ID permintaan API Anthropic dari header `request-id` respons. Hadir hanya saat API mengembalikan satu817* `request_id`: ID permintaan API, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

775* `message.uuid`: UUID entri transkrip akhir respons. Respons API disimpan sebagai satu entri transkrip per blok konten; ini adalah yang terakhir, yang `parentUuid` giliran berikutnya berantai dari. Memerlukan Claude Code v2.1.214 atau lebih baru818* `message.uuid`: UUID entri transkrip akhir respons. Respons API disimpan sebagai satu entri transkrip per blok konten; ini adalah yang terakhir, yang `parentUuid` giliran berikutnya rantai dari. Memerlukan Claude Code v2.1.214 atau lebih baru

776* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagent819* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagen

777 820

778<h4 id="tool-result-event">821<h4 id="tool-result-event">

779 Acara hasil alat822 Peristiwa hasil alat

780</h4>823</h4>

781 824

782Dicatat saat alat menyelesaikan eksekusi. Tidak dipancarkan jika panggilan alat ditolak; lihat [Acara keputusan alat](#tool-decision-event) untuk penolakan.825Dicatat ketika alat menyelesaikan eksekusi. Tidak dipancarkan jika panggilan alat ditolak; lihat [Peristiwa keputusan alat](#tool-decision-event) untuk penolakan.

783 826

784**Nama Acara**: `claude_code.tool_result`827**Nama Peristiwa**: `claude_code.tool_result`

785 828

786**Atribut**:829**Atribut**:

787 830

788* Semua [atribut standar](#standard-attributes)831* Semua [atribut standar](#standard-attributes)

789* `event.name`: `"tool_result"`832* `event.name`: `"tool_result"`

790* `event.timestamp`: Stempel waktu ISO 8601833* `event.timestamp`: Timestamp ISO 8601

791* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)834* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

792* `tool_name`: Nama alat835* `tool_name`: Nama alat

793* `tool_use_id`: Pengidentifikasi unik untuk invokasi alat ini. Cocok dengan `tool_use_id` yang diteruskan ke hooks, memungkinkan korelasi antara acara OTel dan data yang ditangkap hook.836* `tool_use_id`: Pengenal unik untuk invokasi alat ini. Cocok dengan `tool_use_id` yang dilewatkan ke hooks, memungkinkan korelasi antara peristiwa OTel dan data yang ditangkap hook.

794* `success`: `"true"` atau `"false"`837* `success`: `"true"` atau `"false"`

795* `duration_ms`: Waktu eksekusi dalam milidetik838* `duration_ms`: Waktu eksekusi dalam milidetik

796* `error_type`: String kategori kesalahan saat alat gagal, seperti `"Error:ENOENT"` atau `"ShellError"`839* `error_type`: String kategori kesalahan ketika alat gagal, seperti `"Error:ENOENT"` atau `"ShellError"`

797* `error` (saat `OTEL_LOG_TOOL_DETAILS=1`): Pesan kesalahan lengkap saat alat gagal840* `error` (ketika `OTEL_LOG_TOOL_DETAILS=1`): Pesan kesalahan lengkap ketika alat gagal

798* `decision_type`: Selalu `"accept"`, karena acara ini hanya dipancarkan setelah alat berjalan. Panggilan yang ditolak tidak menghasilkan hasil alat841* `decision_type`: Selalu `"accept"`, karena peristiwa ini hanya dipancarkan setelah alat berjalan. Panggilan yang ditolak tidak menghasilkan hasil alat

799* `decision_source`: Sumber keputusan izin. Salah satu dari `"config"`, `"hook"`, `"user_permanent"`, atau `"user_temporary"`. Lihat [Acara keputusan alat](#tool-decision-event) untuk mengetahui apa arti setiap nilai. Sumber hanya-tolak `"user_abort"` dan `"user_reject"` tidak pernah muncul pada acara ini.842* `decision_source`: Dari mana keputusan izin berasal. Salah satu dari `"config"`, `"hook"`, `"user_permanent"`, atau `"user_temporary"`. Lihat [Peristiwa keputusan alat](#tool-decision-event) untuk apa arti setiap nilai. Sumber khusus penolakan `"user_abort"` dan `"user_reject"` tidak pernah muncul pada peristiwa ini.

800* `tool_input_size_bytes`: Ukuran input alat yang diserialisasi JSON dalam byte843* `tool_input_size_bytes`: Ukuran input alat yang diserialisasi JSON dalam byte

801* `tool_result_size_bytes`: Ukuran hasil alat dalam byte844* `tool_result_size_bytes`: Ukuran hasil alat dalam byte

802* `mcp_server_scope`: Pengidentifikasi cakupan server MCP (untuk alat MCP)845* `mcp_server_scope`: Pengenal cakupan server MCP (untuk alat MCP)

803* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (saat `OTEL_LOG_TOOL_DETAILS=1`): identitas komit dari run `git commit` yang berhasil oleh alat Bash atau PowerShell. `vcs.ref.head.revision` adalah SHA komit, `vcs.ref.head.name` adalah cabang tempat itu dikomit, dan `vcs.ref.head.type` adalah `branch`. Nama dan tipe dihilangkan saat komit dibuat pada HEAD terlepas. Memerlukan Claude Code v2.1.269 atau lebih baru846* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (ketika `OTEL_LOG_TOOL_DETAILS=1`): identitas commit dari run `git commit` yang berhasil oleh alat Bash atau PowerShell. `vcs.ref.head.revision` adalah SHA commit, `vcs.ref.head.name` adalah cabang tempat commit dilakukan, dan `vcs.ref.head.type` adalah `branch`. Nama dan jenis dihilangkan ketika commit dilakukan pada HEAD terlepas. Memerlukan Claude Code v2.1.269 atau lebih baru

804* `tool_parameters` (saat `OTEL_LOG_TOOL_DETAILS=1`): String JSON yang berisi parameter khusus alat. Untuk server built-in Claude Desktop, dalam sesi yang dimiliki Claude Desktop, pasangan `mcp_server_name`/`mcp_tool_name` disertakan bahkan dengan flag off, pengecualian yang sama yang ditulis host seperti [Acara keputusan alat](#tool-decision-event), memerlukan Claude Code v2.1.214 atau lebih baru. Parameter bervariasi menurut alat:847* `tool_parameters` (ketika `OTEL_LOG_TOOL_DETAILS=1`): String JSON yang berisi parameter khusus alat. Untuk server bawaan Claude Desktop, dalam sesi yang dimiliki Claude Desktop, pasangan `mcp_server_name`/`mcp_tool_name` disertakan bahkan dengan flag off, pengecualian yang sama yang ditulis host seperti [Peristiwa keputusan alat](#tool-decision-event), memerlukan Claude Code v2.1.214 atau lebih baru. Parameter bervariasi menurut alat:

805 * Untuk alat Bash: mencakup `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`, dan `git_commit_id` serta `git_branch` saat perintah `git commit` berhasil. `git_commit_id` adalah SHA komit penuh saat komit adalah HEAD dari direktori kerja sesi, dan SHA singkat git sebaliknya. `git_branch` adalah cabang tempat itu dikomit, dihilangkan pada HEAD terlepas848 * Untuk alat Bash: menyertakan `bash_command`, `full_command`, `timeout`, `description`, dan `dangerouslyDisableSandbox`, ditambah `git_commit_id` dan `git_branch` ketika perintah `git commit` berhasil. `git_commit_id` adalah SHA commit lengkap ketika commit adalah HEAD dari direktori kerja sesi, dan SHA singkat git sebaliknya. `git_branch` adalah cabang tempat commit dilakukan, dihilangkan pada HEAD terlepas

806 * Untuk alat Bash ruang kerja aplikasi desktop, yang juga melaporkan `tool_name` sebagai `Bash`: mencakup hanya `bash_command`, `full_command`, dan `timeout`849 * Untuk alat Bash workspace aplikasi desktop, yang juga melaporkan `tool_name` sebagai `Bash`: menyertakan hanya `bash_command`, `full_command`, dan `timeout`

807 * Untuk alat MCP: mencakup `mcp_server_name`, `mcp_tool_name`850 * Untuk alat MCP: menyertakan `mcp_server_name`, `mcp_tool_name`

808 * Untuk alat Skill: mencakup `skill_name`851 * Untuk alat Skill: menyertakan `skill_name`

809 * Untuk alat Agent atau alat Task legacy: mencakup `subagent_type`852 * Untuk alat Agent atau alat Task warisan: menyertakan `subagent_type`

810* `tool_input` (saat `OTEL_LOG_TOOL_DETAILS=1`): Argumen alat yang diserialisasi JSON. Nilai individual di atas 512 karakter dipotong, dan muatan penuh dibatasi hingga \~4 K karakter. Berlaku untuk semua alat termasuk alat MCP.853* `tool_input` (ketika `OTEL_LOG_TOOL_DETAILS=1`): Argumen alat yang diserialisasi JSON. Nilai individual di atas 512 karakter dipotong, dan muatan lengkap dibatasi hingga \~4 K karakter. Berlaku untuk semua alat termasuk alat MCP.

811 854

812<h4 id="api-request-event">855<h4 id="api-request-event">

813 Acara permintaan API856 Peristiwa permintaan API

814</h4>857</h4>

815 858

816Dicatat untuk setiap permintaan API ke Claude.859Dicatat untuk setiap permintaan API ke Claude.

817 860

818**Nama Acara**: `claude_code.api_request`861**Nama Peristiwa**: `claude_code.api_request`

819 862

820**Atribut**:863**Atribut**:

821 864

822* Semua [atribut standar](#standard-attributes)865* Semua [atribut standar](#standard-attributes)

823* `event.name`: `"api_request"`866* `event.name`: `"api_request"`

824* `event.timestamp`: Stempel waktu ISO 8601867* `event.timestamp`: Timestamp ISO 8601

825* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)868* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

826* `model`: Model yang digunakan (misalnya, "claude-sonnet-5")869* `model`: Model yang digunakan (misalnya, "claude-sonnet-5")

827* `cost_usd`: Biaya perkiraan dalam USD870* `cost_usd`: Biaya perkiraan dalam USD

828* `cost_usd_micros`: Biaya perkiraan dalam jutaan dolar AS, dipancarkan sebagai integer871* `cost_usd_micros`: Biaya perkiraan dalam jutaan dolar AS, dipancarkan sebagai integer

831* `output_tokens`: Jumlah token output874* `output_tokens`: Jumlah token output

832* `cache_read_tokens`: Jumlah token yang dibaca dari cache875* `cache_read_tokens`: Jumlah token yang dibaca dari cache

833* `cache_creation_tokens`: Jumlah token yang digunakan untuk pembuatan cache876* `cache_creation_tokens`: Jumlah token yang digunakan untuk pembuatan cache

834* `request_id`: ID permintaan API Anthropic dari header `request-id` respons, seperti `"req_011..."`. Hadir hanya saat API mengembalikan satu.877* `request_id`: ID permintaan API, seperti `"req_011..."`, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes).

835* `client_request_id`: UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`; lihat tabel [atribut korelasi acara](#event-correlation-attributes) untuk kapan itu ada. Memerlukan Claude Code v2.1.214 atau lebih baru878* `client_request_id`: UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`; lihat tabel [atribut korelasi peristiwa](#event-correlation-attributes) untuk kapan ada. Memerlukan Claude Code v2.1.214 atau lebih baru

836* `speed`: `"fast"` atau `"normal"`, menunjukkan apakah mode cepat aktif879* `speed`: `"fast"` atau `"normal"`, menunjukkan apakah mode cepat aktif

837* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagent880* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagen

838* `effort`: [Tingkat effort](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan: `"low"`, `"medium"`, `"high"`, `"xhigh"`, atau `"max"`. Tidak ada saat model tidak mendukung effort.881* `effort`: [Tingkat upaya](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan: `"low"`, `"medium"`, `"high"`, `"xhigh"`, atau `"max"`. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.

839* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku redaksi.882* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku penyuntingan.

840 883

841<h4 id="api-error-event">884<h4 id="api-error-event">

842 Acara kesalahan API885 Peristiwa kesalahan API

843</h4>886</h4>

844 887

845Dicatat saat permintaan API ke Claude gagal.888Dicatat ketika permintaan API ke Claude gagal.

846 889

847**Nama Acara**: `claude_code.api_error`890**Nama Peristiwa**: `claude_code.api_error`

848 891

849**Atribut**:892**Atribut**:

850 893

851* Semua [atribut standar](#standard-attributes)894* Semua [atribut standar](#standard-attributes)

852* `event.name`: `"api_error"`895* `event.name`: `"api_error"`

853* `event.timestamp`: Stempel waktu ISO 8601896* `event.timestamp`: Timestamp ISO 8601

854* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)897* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

855* `model`: Model yang digunakan (misalnya, "claude-sonnet-5")898* `model`: Model yang digunakan (misalnya, "claude-sonnet-5")

856* `error`: Pesan kesalahan899* `error`: Pesan kesalahan

857* `status_code`: Kode status HTTP sebagai angka. Tidak ada untuk kesalahan non-HTTP seperti kegagalan koneksi.900* `status_code`: Kode status HTTP sebagai angka. Tidak ada untuk kesalahan non-HTTP seperti kegagalan koneksi.

858* `duration_ms`: Durasi permintaan dalam milidetik901* `duration_ms`: Durasi permintaan dalam milidetik

859* `attempt`: Jumlah total upaya yang dilakukan, termasuk permintaan awal (`1` berarti tidak ada retry yang terjadi)902* `attempt`: Jumlah total upaya yang dilakukan, termasuk permintaan awal (`1` berarti tidak ada pengulangan yang terjadi)

860* `request_id`: ID permintaan API Anthropic dari header `request-id` respons, seperti `"req_011..."`. Hadir hanya saat API mengembalikan satu.903* `request_id`: ID permintaan API, seperti `"req_011..."`, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes).

861* `client_request_id`: UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`. Tersedia bahkan saat kegagalan seperti timeout atau kesalahan koneksi tidak pernah menghasilkan `request_id` server; lihat tabel [atribut korelasi acara](#event-correlation-attributes) untuk kapan itu ada. Memerlukan Claude Code v2.1.214 atau lebih baru904* `client_request_id`: UUID yang dihasilkan klien dikirim sebagai header permintaan `x-client-request-id`. Tersedia bahkan ketika kegagalan seperti timeout atau kesalahan koneksi tidak pernah menghasilkan `request_id` server; lihat tabel [atribut korelasi peristiwa](#event-correlation-attributes) untuk kapan ada. Memerlukan Claude Code v2.1.214 atau lebih baru

862* `speed`: `"fast"` atau `"normal"`, menunjukkan apakah mode cepat aktif905* `speed`: `"fast"` atau `"normal"`, menunjukkan apakah mode cepat aktif

863* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagent906* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagen

864* `effort`: [Tingkat effort](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan. Tidak ada saat model tidak mendukung effort.907* `effort`: [Tingkat upaya](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.

865* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku redaksi.908* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku penyuntingan.

866 909

867<h4 id="api-refusal-event">910<h4 id="api-refusal-event">

868 Acara penolakan API911 Peristiwa penolakan API

869</h4>912</h4>

870 913

871Dicatat saat permintaan API mengembalikan `stop_reason: "refusal"`. Penolakan tiba pada aliran respons yang berhasil daripada sebagai kesalahan HTTP, jadi acara `api_error` tidak terpicu untuk mereka. Acara ini memungkinkan Anda melacak frekuensi penolakan dan mengelompokkan penolakan berdasarkan atribut yang sama dengan `api_request` dan `api_error`.914Dicatat ketika permintaan API mengembalikan `stop_reason: "refusal"`. Penolakan tiba pada aliran respons yang berhasil daripada sebagai kesalahan HTTP, jadi peristiwa `api_error` tidak terbangkitkan untuk mereka. Peristiwa ini memungkinkan Anda melacak frekuensi penolakan dan mengelompokkan penolakan menurut atribut yang sama dengan `api_request` dan `api_error`.

872 915

873**Nama Acara**: `claude_code.api_refusal`916**Nama Peristiwa**: `claude_code.api_refusal`

874 917

875**Atribut**:918**Atribut**:

876 919

877* Semua [atribut standar](#standard-attributes)920* Semua [atribut standar](#standard-attributes)

878* `event.name`: `"api_refusal"`921* `event.name`: `"api_refusal"`

879* `event.timestamp`: Stempel waktu ISO 8601922* `event.timestamp`: Timestamp ISO 8601

880* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)923* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

881* `model`: Pengidentifikasi model dari permintaan924* `model`: Pengenal model dari permintaan

882* `request_id`: ID permintaan API Anthropic dari header `request-id` respons, seperti `"req_011..."`. Hadir hanya saat API mengembalikan satu.925* `request_id`: ID permintaan API, seperti `"req_011..."`, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes).

883* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagent. Lihat [`api_request`](#api-request-event) untuk definisi.926* `query_source`: Subsistem yang mengeluarkan permintaan, seperti `"repl_main_thread"`, `"compact"`, atau nama subagen. Lihat [`api_request`](#api-request-event) untuk definisi.

884* `speed`: Baik `"fast"` saat [Mode cepat](/docs/id/fast-mode) aktif, atau `"normal"`927* `speed`: Baik `"fast"` ketika [Mode cepat](/docs/id/fast-mode) aktif, atau `"normal"`

885* `attempt`: Nomor upaya retry. Upaya pertama adalah `1`.928* `attempt`: Nomor upaya pengulangan. Upaya pertama adalah `1`.

886* `effort`: [Tingkat effort](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan. Tidak ada saat model tidak mendukung effort.929* `effort`: [Tingkat upaya](/docs/id/model-config#adjust-effort-level) yang diterapkan pada permintaan. Tidak ada ketika Claude Code tidak mengirim tingkat upaya, misalnya pada model yang tidak mendukung upaya.

887* `server_fallback_hop`: `true` saat fallback model server-side API sudah mencoba ulang penolakan ini pada model yang berbeda, jadi pengguna tidak melihat penolakan khusus ini. `false` saat permintaan berakhir dalam penolakan. Satu giliran dapat memancarkan acara hop `true` dan acara akhir `false` yang lebih baru saat model fallback juga menolak.930* `server_fallback_hop`: `true` ketika fallback model server-side API sudah mencoba ulang penolakan ini pada model yang berbeda, jadi pengguna tidak melihat penolakan khusus ini. `false` ketika permintaan berakhir dalam penolakan. Satu giliran dapat memancarkan peristiwa hop `true` dan peristiwa final `false` yang lebih baru ketika model fallback juga menolak.

888* `has_category`: `true` saat respons API membawa `stop_details.category` dari `"cyber"`, `"bio"`, `"frontier_llm"`, atau `"reasoning_extraction"`. `false` saat respons tidak membawa kategori atau nilai di luar set itu. Tidak ada saat `server_fallback_hop` adalah `true`, karena blok hop tidak membawa `stop_details`.931* `has_category`: `true` ketika respons API membawa `stop_details.category` dari `"cyber"`, `"bio"`, `"frontier_llm"`, atau `"reasoning_extraction"`. `false` ketika respons tidak membawa kategori atau nilai di luar set itu. Tidak ada ketika `server_fallback_hop` adalah `true`, karena blok hop tidak membawa `stop_details`.

889* `has_explanation`: `true` saat respons API membawa `stop_details.explanation`, sebaliknya `false`. Tidak ada saat `server_fallback_hop` adalah `true`.932* `has_explanation`: `true` ketika respons API membawa `stop_details.explanation`, sebaliknya `false`. Tidak ada ketika `server_fallback_hop` adalah `true`.

890* `category`: Nilai `stop_details.category` dari respons API. Salah satu dari `"cyber"`, `"bio"`, `"frontier_llm"`, atau `"reasoning_extraction"`. Hanya ada saat `OTEL_LOG_TOOL_DETAILS=1` diatur dan `has_category` adalah `true`.933* `category`: Nilai `stop_details.category` dari respons API. Salah satu dari `"cyber"`, `"bio"`, `"frontier_llm"`, atau `"reasoning_extraction"`. Hanya ada ketika `OTEL_LOG_TOOL_DETAILS=1` diatur dan `has_category` adalah `true`.

891* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku redaksi.934* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribusi skill, plugin, agen, dan MCP untuk permintaan. Lihat [Penghitung biaya](#cost-counter) untuk definisi dan perilaku penyuntingan.

892 935

893<h4 id="api-request-body-event">936<h4 id="api-request-body-event">

894 Acara badan permintaan API937 Peristiwa badan permintaan API

895</h4>938</h4>

896 939

897Dicatat untuk setiap upaya permintaan API saat `OTEL_LOG_RAW_API_BODIES` diatur. Satu acara dipancarkan per upaya, jadi retry dengan parameter yang disesuaikan masing-masing menghasilkan acara mereka sendiri.940Dicatat untuk setiap upaya permintaan API ketika `OTEL_LOG_RAW_API_BODIES` diatur. Satu peristiwa dipancarkan per upaya, jadi pengulangan dengan parameter yang disesuaikan masing-masing menghasilkan peristiwa mereka sendiri.

898 941

899**Nama Acara**: `claude_code.api_request_body`942**Nama Peristiwa**: `claude_code.api_request_body`

900 943

901**Atribut**:944**Atribut**:

902 945

903* Semua [atribut standar](#standard-attributes)946* Semua [atribut standar](#standard-attributes)

904* `event.name`: `"api_request_body"`947* `event.name`: `"api_request_body"`

905* `event.timestamp`: Stempel waktu ISO 8601948* `event.timestamp`: Timestamp ISO 8601

906* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)949* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

907* `body`: Parameter permintaan Messages API yang diserialisasi JSON, seperti system prompt, messages, dan tools, dipotong pada batas konten (60 KB secara default). Konten extended-thinking dalam giliran asisten sebelumnya diredaksi. Dipancarkan hanya dalam mode inline (`OTEL_LOG_RAW_API_BODIES=1`).950* `body`: Parameter permintaan Messages API yang diserialisasi JSON, seperti prompt sistem, pesan, dan alat, dipotong pada batas konten (60 KB secara default). Konten pemikiran yang diperpanjang dalam giliran asisten sebelumnya disunting. Hanya dipancarkan dalam mode inline (`OTEL_LOG_RAW_API_BODIES=1`).

908* `body_ref`: Jalur absolut ke file `<dir>/<uuid>.request.json` yang berisi badan yang tidak dipotong. Dipancarkan hanya dalam mode file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).951* `body_ref`: Jalur absolut ke file `<dir>/<uuid>.request.json` yang berisi badan yang tidak dipotong. Hanya dipancarkan dalam mode file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

909* `body_length`: Panjang badan yang tidak dipotong. Byte UTF-8 saat `OTEL_LOG_RAW_API_BODIES=file:<dir>`, atau unit kode UTF-16 saat `=1`952* `body_length`: Panjang badan yang tidak dipotong. Byte UTF-8 ketika `OTEL_LOG_RAW_API_BODIES=file:<dir>`, atau unit kode UTF-16 ketika `=1`

910* `body_truncated`: `"true"` saat pemotongan inline terjadi. Tidak ada dalam mode file dan saat tidak ada pemotongan yang terjadi.953* `body_truncated`: `"true"` ketika pemotongan inline terjadi. Tidak ada dalam mode file dan ketika tidak ada pemotongan yang terjadi.

911* `model`: Pengidentifikasi model dari parameter permintaan954* `model`: Pengenal model dari parameter permintaan

912* `query_source`: Subsistem yang mengeluarkan permintaan (misalnya, `"compact"`)955* `query_source`: Subsistem yang mengeluarkan permintaan (misalnya, `"compact"`)

913* `request_body_id`: UUID yang mengidentifikasi badan permintaan upaya ini. Acara [`api_response_body`](#api-response-body-event) untuk upaya yang berhasil membawa nilai yang sama, sehingga Anda dapat memasangkan respons dengan permintaan yang tepat yang menghasilkannya. Memerlukan Claude Code v2.1.274 atau lebih baru956* `request_body_id`: UUID yang mengidentifikasi badan permintaan upaya ini. Peristiwa [`api_response_body`](#api-response-body-event) untuk upaya yang berhasil membawa nilai yang sama, jadi Anda dapat memasangkan respons dengan permintaan yang tepat yang menghasilkannya. Memerlukan Claude Code v2.1.274 atau lebih baru

914 957

915<h4 id="api-response-body-event">958<h4 id="api-response-body-event">

916 Acara badan respons API959 Peristiwa badan respons API

917</h4>960</h4>

918 961

919Dicatat untuk setiap respons API yang berhasil saat `OTEL_LOG_RAW_API_BODIES` diatur.962Dicatat untuk setiap respons API yang berhasil ketika `OTEL_LOG_RAW_API_BODIES` diatur.

920 963

921Dalam mode file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code juga menambahkan satu baris JSON ke `<dir>/index.jsonl` untuk setiap respons yang berhasil, dengan bidang `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, dan `response_file`. Bacanya untuk menemukan file permintaan dan respons di balik pesan transkrip tertentu tanpa menanyakan backend telemetri Anda. File indeks memerlukan Claude Code v2.1.274 atau lebih baru.964Dalam mode file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code juga menambahkan satu baris JSON ke `<dir>/index.jsonl` untuk setiap respons yang berhasil, dengan bidang `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, dan `response_file`. Bacanya untuk menemukan file permintaan dan respons di balik pesan transkrip tertentu tanpa menanyakan backend telemetri Anda. File indeks memerlukan Claude Code v2.1.274 atau lebih baru.

922 965

923**Nama Acara**: `claude_code.api_response_body`966**Nama Peristiwa**: `claude_code.api_response_body`

924 967

925**Atribut**:968**Atribut**:

926 969

927* Semua [atribut standar](#standard-attributes)970* Semua [atribut standar](#standard-attributes)

928* `event.name`: `"api_response_body"`971* `event.name`: `"api_response_body"`

929* `event.timestamp`: Stempel waktu ISO 8601972* `event.timestamp`: Timestamp ISO 8601

930* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)973* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

931* `body`: Respons Messages API yang diserialisasi JSON, termasuk id, content blocks, usage, dan stop reason, dipotong pada batas konten (60 KB secara default). Konten extended-thinking diredaksi. Dipancarkan hanya dalam mode inline (`OTEL_LOG_RAW_API_BODIES=1`).974* `body`: Respons Messages API yang diserialisasi JSON, termasuk id, blok konten, penggunaan, dan alasan berhenti, dipotong pada batas konten (60 KB secara default). Konten pemikiran yang diperpanjang disunting. Hanya dipancarkan dalam mode inline (`OTEL_LOG_RAW_API_BODIES=1`).

932* `body_ref`: Jalur absolut ke file `<dir>/<request_id>.response.json` yang berisi badan yang tidak dipotong. Dipancarkan hanya dalam mode file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).975* `body_ref`: Jalur absolut ke file `<dir>/<request_id>.response.json` yang berisi badan yang tidak dipotong. Hanya dipancarkan dalam mode file (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

933* `body_length`: Panjang badan yang tidak dipotong. Byte UTF-8 saat `OTEL_LOG_RAW_API_BODIES=file:<dir>`, atau unit kode UTF-16 saat `=1`976* `body_length`: Panjang badan yang tidak dipotong. Byte UTF-8 ketika `OTEL_LOG_RAW_API_BODIES=file:<dir>`, atau unit kode UTF-16 ketika `=1`

934* `body_truncated`: `"true"` saat pemotongan inline terjadi. Tidak ada dalam mode file dan saat tidak ada pemotongan yang terjadi.977* `body_truncated`: `"true"` ketika pemotongan inline terjadi. Tidak ada dalam mode file dan ketika tidak ada pemotongan yang terjadi.

935* `model`: Pengidentifikasi model978* `model`: Pengenal model

936* `query_source`: Subsistem yang mengeluarkan permintaan979* `query_source`: Subsistem yang mengeluarkan permintaan

937* `request_id`: ID permintaan API Anthropic dari header `request-id` respons, seperti `"req_011..."`. Hadir hanya saat API mengembalikan satu.980* `request_id`: ID permintaan API, seperti `"req_011..."`, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes).

938* `request_body_id`: `request_body_id` dari acara [`api_request_body`](#api-request-body-event) yang dijawab respons ini. Memerlukan Claude Code v2.1.274 atau lebih baru981* `request_body_id`: `request_body_id` dari peristiwa [`api_request_body`](#api-request-body-event) yang respons ini jawab. Memerlukan Claude Code v2.1.274 atau lebih baru

939* `message.id`: ID pesan yang ditetapkan API ke respons, bidang `id` dari badan respons. Memerlukan Claude Code v2.1.274 atau lebih baru982* `message.id`: ID pesan yang API tetapkan untuk respons, bidang `id` dari badan respons. Memerlukan Claude Code v2.1.274 atau lebih baru

940* `message.uuid`: UUID entri transkrip akhir respons. Bersama dengan `request_body_id`, itu menghubungkan pesan transkrip ke badan permintaan dan respons di baliknya. Memerlukan Claude Code v2.1.274 atau lebih baru983* `message.uuid`: UUID entri transkrip akhir respons. Bersama dengan `request_body_id`, ini menghubungkan pesan transkrip dengan badan permintaan dan respons di baliknya. Memerlukan Claude Code v2.1.274 atau lebih baru

941 984

942<h4 id="tool-decision-event">985<h4 id="tool-decision-event">

943 Acara keputusan alat986 Peristiwa keputusan alat

944</h4>987</h4>

945 988

946Dicatat saat keputusan izin alat dibuat (terima/tolak).989Dicatat ketika keputusan izin alat dibuat (terima/tolak).

947 990

948**Nama Acara**: `claude_code.tool_decision`991**Nama Peristiwa**: `claude_code.tool_decision`

949 992

950**Atribut**:993**Atribut**:

951 994

952* Semua [atribut standar](#standard-attributes)995* Semua [atribut standar](#standard-attributes)

953* `event.name`: `"tool_decision"`996* `event.name`: `"tool_decision"`

954* `event.timestamp`: Stempel waktu ISO 8601997* `event.timestamp`: Timestamp ISO 8601

955* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)998* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

956* `tool_name`: Nama alat (misalnya, "Read", "Edit", "Write", "NotebookEdit")999* `tool_name`: Nama alat (misalnya, "Read", "Edit", "Write", "NotebookEdit")

957* `tool_use_id`: Pengidentifikasi unik untuk invokasi alat ini. Cocok dengan `tool_use_id` yang diteruskan ke hooks, memungkinkan korelasi antara acara OTel dan data yang ditangkap hook.1000* `tool_use_id`: Pengenal unik untuk invokasi alat ini. Cocok dengan `tool_use_id` yang dilewatkan ke hooks, memungkinkan korelasi antara peristiwa OTel dan data yang ditangkap hook.

958* `decision`: Baik `"accept"` atau `"reject"`1001* `decision`: Baik `"accept"` atau `"reject"`

959* `tool_source`: Selalu ada. Provenance alat, sebagai set nilai yang ditulis CLI tertutup. Memerlukan Claude Code v2.1.214 atau lebih baru1002* `tool_source`: Selalu ada. Asal alat, sebagai set nilai yang ditulis CLI tertutup. Memerlukan Claude Code v2.1.214 atau lebih baru

960 * `"builtin"`: alat CLI sendiri1003 * `"builtin"`: alat CLI itu sendiri

961 * `"mcp"`: server MCP secara umum1004 * `"mcp"`: server MCP secara umum

962 * `"sdk_host_builtin_mcp"`: server in-process built-in ke Claude Desktop itu sendiri, dalam sesi yang dimiliki Claude Desktop. Claude Desktop memiliki sesi yang dimulai dari salah satu entrypoint-nya sendiri, `claude-desktop`, `claude-desktop-3p`, atau `local-agent`, saat sesi itu bukan anak bersarang; sesi bersarang, termasuk sesi yang Claude Code sendiri hasilkan, melaporkan server ini sebagai `"mcp"`1005 * `"sdk_host_builtin_mcp"`: server in-process yang dibangun ke Claude Desktop itu sendiri, dalam sesi yang dimiliki Claude Desktop. Claude Desktop memiliki sesi yang diluncurkannya dari salah satu titik masuk miliknya sendiri, `claude-desktop`, `claude-desktop-3p`, atau `local-agent`, ketika sesi itu bukan anak bersarang; sesi bersarang, termasuk sesi yang Claude Code itu sendiri hasilkan, melaporkan server ini sebagai `"mcp"`

963* `source`: Sumber keputusan:1006* `source`: Dari mana keputusan berasal:

964 * `"config"`: Diputuskan secara otomatis tanpa diminta, berdasarkan pengaturan proyek, aturan izin atau tolak dalam pengaturan pribadi pengguna, kebijakan terkelola perusahaan, flag `--allowedTools` atau `--disallowedTools`, mode izin aktif, hibah berskop sesi dari prompt sebelumnya dalam sesi CLI interaktif yang sama, atau karena alat itu aman secara inheren. Acara tidak menunjukkan sumber mana yang cocok. Claude Code juga melaporkan `"config"` saat permintaan prompt izin itu sendiri gagal, misalnya saat callback [`canUseTool`](/docs/id/agent-sdk/typescript#canusetool) Agent SDK atau alat [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) mengembalikan hasil yang tidak valid, atau saat aliran input ditutup saat permintaan tertunda. Sebelum v2.1.216, Claude Code melaporkan kegagalan ini sebagai `"user_reject"`.1007 * `"config"`: Diputuskan secara otomatis tanpa diminta, berdasarkan pengaturan proyek, aturan izin atau tolak dalam pengaturan pribadi pengguna, kebijakan yang dikelola perusahaan, flag `--allowedTools` atau `--disallowedTools`, mode izin aktif, hibah cakupan sesi dari prompt sebelumnya dalam sesi CLI interaktif yang sama, atau karena alat itu aman secara inheren. Peristiwa tidak menunjukkan sumber mana dari ini yang cocok. Claude Code juga melaporkan `"config"` ketika permintaan prompt izin itu sendiri gagal, misalnya ketika callback [`canUseTool`](/docs/id/agent-sdk/typescript#canusetool) SDK Agent atau alat [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) mengembalikan hasil yang tidak valid, atau ketika aliran input ditutup saat permintaan tertunda. Sebelum v2.1.216, Claude Code melaporkan kegagalan ini sebagai `"user_reject"`.

965 * `"hook"`: Hook `PreToolUse` atau `PermissionRequest` mengembalikan keputusan.1008 * `"hook"`: Hook `PreToolUse` atau `PermissionRequest` mengembalikan keputusan.

966 * `"user_permanent"`: Dipancarkan saat pengguna memilih "Ya, dan jangan tanya lagi untuk ..." saat diminta, yang menyimpan aturan izin ke pengaturan pribadi mereka. Dalam CLI interaktif ini dipancarkan hanya untuk pilihan itu sendiri; panggilan nanti yang cocok dengan aturan tersimpan memancarkan `"config"` sebagai gantinya. Dalam sesi Agent SDK atau non-interaktif `-p`, baik pilihan awal maupun kecocokan aturan nanti memancarkan `"user_permanent"`. Diperlakukan sebagai penerimaan.1009 * `"user_permanent"`: Dipancarkan ketika pengguna memilih "Ya, dan jangan tanya lagi untuk ..." di prompt izin, yang menyimpan aturan izin ke pengaturan pribadi mereka. Dalam CLI interaktif ini hanya dipancarkan untuk pilihan itu sendiri; panggilan kemudian yang cocok dengan aturan yang disimpan memancarkan `"config"` sebagai gantinya. Dalam sesi SDK Agent atau non-interaktif `-p`, baik pilihan awal maupun kecocokan aturan kemudian memancarkan `"user_permanent"`. Diperlakukan sebagai penerimaan.

967 * `"user_temporary"`: Dipancarkan saat pengguna memilih "Ya" saat diminta untuk persetujuan satu kali, atau memilih opsi yang memberikan akses untuk sisa sesi pada prompt pengeditan atau pembacaan file. Dalam CLI interaktif ini dipancarkan hanya untuk pilihan itu sendiri; panggilan nanti yang diizinkan oleh hibah berskop sesi itu memancarkan `"config"` sebagai gantinya. Dalam sesi Agent SDK atau non-interaktif `-p`, baik pilihan maupun kecocokan nanti memancarkan `"user_temporary"`. Diperlakukan sebagai penerimaan.1010 * `"user_temporary"`: Dipancarkan ketika pengguna memilih "Ya" di prompt izin untuk persetujuan satu kali, atau memilih opsi yang memberikan akses untuk sisa sesi pada prompt edit atau baca file. Dalam CLI interaktif ini hanya dipancarkan untuk pilihan itu sendiri; panggilan kemudian yang diizinkan oleh hibah cakupan sesi itu memancarkan `"config"` sebagai gantinya. Dalam sesi SDK Agent atau non-interaktif `-p`, baik pilihan maupun kecocokan kemudian memancarkan `"user_temporary"`. Diperlakukan sebagai penerimaan.

968 * `"user_abort"`: Dipancarkan saat pengguna menutup prompt izin tanpa menjawab. Dalam sesi Agent SDK dan non-interaktif `-p`, ini termasuk mengganggu giliran saat permintaan izin `canUseTool` atau `--permission-prompt-tool` tertunda; sebelum v2.1.216, Claude Code melaporkan gangguan itu sebagai `"user_reject"`. Diperlakukan sebagai penolakan.1011 * `"user_abort"`: Dipancarkan ketika pengguna menutup prompt izin tanpa menjawab. Dalam sesi SDK Agent dan non-interaktif `-p`, ini termasuk mengganggu giliran saat permintaan izin `canUseTool` atau `--permission-prompt-tool` tertunda; sebelum v2.1.216, Claude Code melaporkan gangguan itu sebagai `"user_reject"`. Diperlakukan sebagai penolakan.

969 * `"user_reject"`: Dipancarkan saat pengguna memilih "Tidak" saat diminta. Dalam CLI interaktif ini dipancarkan hanya untuk pilihan itu sendiri; panggilan yang cocok dengan aturan penolakan dalam pengaturan pribadi mereka memancarkan `"config"` sebagai gantinya. Dalam sesi Agent SDK atau non-interaktif `-p`, panggilan yang cocok dengan aturan penolakan dalam pengaturan pribadi memancarkan `"user_reject"`. Diperlakukan sebagai penolakan.1012 * `"user_reject"`: Dipancarkan ketika pengguna memilih "Tidak" saat diminta. Dalam CLI interaktif ini hanya dipancarkan untuk pilihan itu sendiri; panggilan yang cocok dengan aturan tolak dalam pengaturan pribadi pengguna memancarkan `"config"` sebagai gantinya. Dalam sesi SDK Agent atau non-interaktif `-p`, panggilan yang cocok dengan aturan tolak dalam pengaturan pribadi memancarkan `"user_reject"`. Diperlakukan sebagai penolakan.

970* `tool_parameters` (saat `OTEL_LOG_TOOL_DETAILS=1`): String JSON yang berisi parameter khusus alat. Bentuk yang sama dengan [Acara hasil alat](#tool-result-event), minus bidang pasca-eksekusi seperti `git_commit_id`. Nilai mungkin berbeda dari `tool_result` untuk panggilan yang diterima jika keputusan izin menulis ulang input alat melalui `updatedInput`. Gunakan atribut ini untuk melihat perintah mana yang ditolak saat `decision` adalah `"reject"`.1013* `tool_parameters` (ketika `OTEL_LOG_TOOL_DETAILS=1`): String JSON yang berisi parameter khusus alat. Bentuk yang sama dengan [Peristiwa hasil alat](#tool-result-event), minus bidang pasca-eksekusi seperti `git_commit_id`. Nilai dapat berbeda dari `tool_result` untuk panggilan yang diterima jika keputusan izin menulis ulang input alat melalui `updatedInput`. Gunakan atribut ini untuk melihat perintah mana yang ditolak ketika `decision` adalah `"reject"`.

971 * Untuk alat `"sdk_host_builtin_mcp"`: `mcp_server_name` dan `mcp_tool_name` disertakan bahkan saat `OTEL_LOG_TOOL_DETAILS` off, karena aplikasi host mendefinisikan nama ini; tanpanya, panggilan yang ditolak ke salah satu server built-in ini tidak dapat dikaitkan pada aliran default. Untuk server MCP yang dikonfigurasi pengguna, `tool_name` acara selalu literal `"mcp_tool"`, dan nama server dan alat muncul hanya dalam `tool_parameters` dengan flag on; konten argumen memerlukan flag di mana-mana. Memerlukan Claude Code v2.1.214 atau lebih baru1014 * Untuk alat `"sdk_host_builtin_mcp"`: `mcp_server_name` dan `mcp_tool_name` disertakan bahkan ketika `OTEL_LOG_TOOL_DETAILS` off, karena aplikasi host mendefinisikan nama ini; tanpanya, panggilan yang ditolak ke salah satu server bawaan ini tidak dapat dikaitkan pada aliran default. Untuk server MCP yang dikonfigurasi pengguna, `tool_name` peristiwa selalu literal `"mcp_tool"`, dan nama server dan alat muncul hanya dalam `tool_parameters` dengan flag on; konten argumen memerlukan flag di mana-mana. Memerlukan Claude Code v2.1.214 atau lebih baru

972 * Untuk alat Bash: mencakup `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Alat bash ruang kerja aplikasi desktop juga melaporkan `tool_name` sebagai `Bash`, tetapi hanya mencakup `bash_command`, `full_command`, dan `timeout`1015 * Untuk alat Bash: menyertakan `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Alat bash workspace aplikasi desktop juga melaporkan `tool_name` sebagai `Bash`, tetapi hanya menyertakan `bash_command`, `full_command`, dan `timeout`

973 * Untuk alat MCP: mencakup `mcp_server_name`, `mcp_tool_name`1016 * Untuk alat MCP: menyertakan `mcp_server_name`, `mcp_tool_name`

974 * Untuk alat Skill: mencakup `skill_name`1017 * Untuk alat Skill: menyertakan `skill_name`

975 * Untuk alat Agent atau alat Task legacy: mencakup `subagent_type`1018 * Untuk alat Agent atau alat Task warisan: menyertakan `subagent_type`

976 1019

977<h4 id="permission-mode-changed-event">1020<h4 id="permission-mode-changed-event">

978 Acara mode izin berubah1021 Peristiwa mode izin berubah

979</h4>1022</h4>

980 1023

981Dicatat saat mode izin berubah, misalnya dari siklus Shift+Tab, keluar dari plan mode, atau pemeriksaan gate mode otomatis.1024Dicatat ketika mode izin berubah, misalnya dari siklus Shift+Tab, keluar dari mode rencana, atau pemeriksaan gerbang mode otomatis.

982 1025

983**Nama Acara**: `claude_code.permission_mode_changed`1026**Nama Peristiwa**: `claude_code.permission_mode_changed`

984 1027

985**Atribut**:1028**Atribut**:

986 1029

987* Semua [atribut standar](#standard-attributes)1030* Semua [atribut standar](#standard-attributes)

988* `event.name`: `"permission_mode_changed"`1031* `event.name`: `"permission_mode_changed"`

989* `event.timestamp`: Stempel waktu ISO 86011032* `event.timestamp`: Timestamp ISO 8601

990* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1033* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

991* `from_mode`: Mode izin sebelumnya, misalnya `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, atau `"bypassPermissions"`1034* `from_mode`: Mode izin sebelumnya, misalnya `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, atau `"bypassPermissions"`

992* `to_mode`: Mode izin baru1035* `to_mode`: Mode izin baru

993* `trigger`: Apa yang menyebabkan perubahan. Salah satu dari `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, atau `"auto_opt_in"`. Tidak ada saat transisi berasal dari SDK atau bridge1036* `trigger`: Apa yang menyebabkan perubahan. Salah satu dari `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, atau `"auto_opt_in"`. Tidak ada ketika transisi berasal dari SDK atau bridge

994 1037

995<h4 id="auth-event">1038<h4 id="auth-event">

996 Acara auth1039 Peristiwa auth

997</h4>1040</h4>

998 1041

999Dicatat saat `/login` atau `/logout` selesai.1042Dicatat ketika `/login` atau `/logout` selesai.

1000 1043

1001**Nama Acara**: `claude_code.auth`1044**Nama Peristiwa**: `claude_code.auth`

1002 1045

1003**Atribut**:1046**Atribut**:

1004 1047

1005* Semua [atribut standar](#standard-attributes)1048* Semua [atribut standar](#standard-attributes)

1006* `event.name`: `"auth"`1049* `event.name`: `"auth"`

1007* `event.timestamp`: Stempel waktu ISO 86011050* `event.timestamp`: Timestamp ISO 8601

1008* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1051* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1009* `action`: `"login"` atau `"logout"`1052* `action`: `"login"` atau `"logout"`

1010* `success`: `"true"` atau `"false"`1053* `success`: `"true"` atau `"false"`

1011* `auth_method`: Metode autentikasi, seperti `"oauth"`1054* `auth_method`: Metode autentikasi, seperti `"oauth"`

1012* `error_category`: Jenis kesalahan kategori saat tindakan gagal. Pesan kesalahan mentah tidak pernah disertakan1055* `error_category`: Jenis kesalahan kategori ketika tindakan gagal. Pesan kesalahan mentah tidak pernah disertakan

1013* `status_code`: Kode status HTTP sebagai string saat tindakan gagal dengan kesalahan HTTP1056* `status_code`: Kode status HTTP sebagai string ketika tindakan gagal dengan kesalahan HTTP

1014 1057

1015<h4 id="mcp-server-connection-event">1058<h4 id="mcp-server-connection-event">

1016 Acara koneksi server MCP1059 Peristiwa koneksi server MCP

1017</h4>1060</h4>

1018 1061

1019Dicatat saat server MCP terhubung, terputus, atau gagal terhubung.1062Dicatat ketika server MCP terhubung, terputus, atau gagal terhubung.

1020 1063

1021**Nama Acara**: `claude_code.mcp_server_connection`1064**Nama Peristiwa**: `claude_code.mcp_server_connection`

1022 1065

1023**Atribut**:1066**Atribut**:

1024 1067

1025* Semua [atribut standar](#standard-attributes)1068* Semua [atribut standar](#standard-attributes)

1026* `event.name`: `"mcp_server_connection"`1069* `event.name`: `"mcp_server_connection"`

1027* `event.timestamp`: Stempel waktu ISO 86011070* `event.timestamp`: Timestamp ISO 8601

1028* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1071* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1029* `status`: `"connected"`, `"failed"`, atau `"disconnected"`1072* `status`: `"connected"`, `"failed"`, atau `"disconnected"`

1030* `transport_type`: Transport server, seperti `"stdio"`, `"sse"`, atau `"http"`1073* `transport_type`: Transport server, seperti `"stdio"`, `"sse"`, atau `"http"`

1031* `server_scope`: Cakupan server dikonfigurasi di, seperti `"user"`, `"project"`, atau `"local"`1074* `server_scope`: Cakupan server dikonfigurasi di, seperti `"user"`, `"project"`, atau `"local"`

1032* `duration_ms`: Durasi upaya koneksi dalam milidetik1075* `duration_ms`: Durasi upaya koneksi dalam milidetik

1033* `error_code`: Kode kesalahan saat koneksi gagal1076* `error_code`: Kode kesalahan ketika koneksi gagal

1034* `is_plugin`: `true` saat server disediakan oleh plugin, `false` sebaliknya1077* `is_plugin`: `true` ketika server disediakan oleh plugin, `false` sebaliknya

1035* `plugin_id_hash` (saat `is_plugin` adalah `true`): Hash stabil dari nama plugin dan marketplace, untuk mengelompokkan acara berdasarkan plugin tanpa mengekspos nama. Claude Code menghitungnya seperti yang dijelaskan di bawah [acara plugin dimuat](#plugin-loaded-event)1078* `plugin_id_hash` (ketika `is_plugin` adalah `true`): Hash stabil dari nama plugin dan marketplace, untuk mengelompokkan peristiwa menurut plugin tanpa mengekspos nama. Claude Code menghitungnya seperti dijelaskan di bawah [peristiwa plugin dimuat](#plugin-loaded-event)

1036* `plugin.name` (saat `is_plugin` adalah `true`): Nama plugin yang menyediakan server. Untuk plugin pihak ketiga ini adalah string literal `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1`; ini melindungi nama plugin pihak ketiga dari muncul dalam log secara default. Plugin dari sumber Anthropic resmi selalu diidentifikasi berdasarkan nama. Atribut `plugin_id_hash` dan `plugin.name` mengalir ke backend monitoring Anda sendiri dan tidak dikirim ke Anthropic1079* `plugin.name` (ketika `is_plugin` adalah `true`): Nama plugin yang menyediakan server. Untuk plugin pihak ketiga ini adalah string literal `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1`; ini melindungi nama plugin pihak ketiga dari muncul dalam log secara default. Plugin dari sumber Anthropic resmi selalu diidentifikasi menurut nama. Atribut `plugin_id_hash` dan `plugin.name` mengalir ke backend pemantauan Anda sendiri dan tidak dikirim ke Anthropic

1037* `server_name` (saat `OTEL_LOG_TOOL_DETAILS=1`): Nama server yang dikonfigurasi1080* `server_name` (ketika `OTEL_LOG_TOOL_DETAILS=1`): Nama server yang dikonfigurasi

1038* `error` (saat `OTEL_LOG_TOOL_DETAILS=1`): Pesan kesalahan lengkap saat koneksi gagal1081* `error` (ketika `OTEL_LOG_TOOL_DETAILS=1`): Pesan kesalahan lengkap ketika koneksi gagal

1039 1082

1040<h4 id="internal-error-event">1083<h4 id="internal-error-event">

1041 Acara kesalahan internal1084 Peristiwa kesalahan internal

1042</h4>1085</h4>

1043 1086

1044Dicatat saat Claude Code menangkap kesalahan internal yang tidak terduga. Hanya nama kelas kesalahan dan kode gaya errno yang dicatat. Pesan kesalahan dan stack trace tidak pernah disertakan. Acara ini tidak dipancarkan saat berjalan terhadap Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, atau saat `DISABLE_ERROR_REPORTING` diatur.1087Dicatat ketika Claude Code menangkap kesalahan internal yang tidak terduga. Hanya nama kelas kesalahan dan kode gaya errno yang dicatat. Pesan kesalahan dan stack trace tidak pernah disertakan. Peristiwa ini tidak dipancarkan saat berjalan terhadap Amazon Bedrock, Agent Platform Google Cloud, atau Microsoft Foundry, atau ketika `DISABLE_ERROR_REPORTING` diatur.

1045 1088

1046**Nama Acara**: `claude_code.internal_error`1089**Nama Peristiwa**: `claude_code.internal_error`

1047 1090

1048**Atribut**:1091**Atribut**:

1049 1092

1050* Semua [atribut standar](#standard-attributes)1093* Semua [atribut standar](#standard-attributes)

1051* `event.name`: `"internal_error"`1094* `event.name`: `"internal_error"`

1052* `event.timestamp`: Stempel waktu ISO 86011095* `event.timestamp`: Timestamp ISO 8601

1053* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1096* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1054* `error_name`: Nama kelas kesalahan, seperti `"TypeError"` atau `"SyntaxError"`1097* `error_name`: Nama kelas kesalahan, seperti `"TypeError"` atau `"SyntaxError"`

1055* `error_code`: Kode errno Node.js seperti `"ENOENT"` saat ada pada kesalahan1098* `error_code`: Kode errno Node.js seperti `"ENOENT"` saat ada pada kesalahan

1056 1099

1057<h4 id="plugin-installed-event">1100<h4 id="plugin-installed-event">

1058 Acara plugin terinstal1101 Peristiwa plugin diinstal

1059</h4>1102</h4>

1060 1103

1061Dicatat saat plugin selesai menginstal, dari perintah CLI `claude plugin install` dan UI interaktif `/plugin`.1104Dicatat ketika plugin selesai diinstal, dari perintah CLI `claude plugin install` dan UI `/plugin` interaktif.

1062 1105

1063**Nama Acara**: `claude_code.plugin_installed`1106**Nama Peristiwa**: `claude_code.plugin_installed`

1064 1107

1065**Atribut**:1108**Atribut**:

1066 1109

1067* Semua [atribut standar](#standard-attributes)1110* Semua [atribut standar](#standard-attributes)

1068* `event.name`: `"plugin_installed"`1111* `event.name`: `"plugin_installed"`

1069* `event.timestamp`: Stempel waktu ISO 86011112* `event.timestamp`: Timestamp ISO 8601

1070* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1113* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1071* `marketplace.is_official`: `"true"` jika marketplace adalah marketplace Anthropic resmi, `"false"` sebaliknya1114* `marketplace.is_official`: `"true"` jika marketplace adalah marketplace Anthropic resmi, `"false"` sebaliknya

1072* `install.trigger`: `"cli"` atau `"ui"`1115* `install.trigger`: `"cli"` atau `"ui"`

1073* `plugin.name`: Nama plugin yang diinstal. Untuk marketplace pihak ketiga ini disertakan hanya saat `OTEL_LOG_TOOL_DETAILS=1`1116* `plugin.name`: Nama plugin yang diinstal. Untuk marketplace pihak ketiga ini disertakan hanya ketika `OTEL_LOG_TOOL_DETAILS=1`

1074* `plugin.version`: Versi plugin saat dideklarasikan dalam entri marketplace. Untuk marketplace pihak ketiga ini disertakan hanya saat `OTEL_LOG_TOOL_DETAILS=1`1117* `plugin.version`: Versi plugin saat dideklarasikan dalam entri marketplace. Untuk marketplace pihak ketiga ini disertakan hanya ketika `OTEL_LOG_TOOL_DETAILS=1`

1075* `marketplace.name`: Marketplace plugin diinstal dari. Untuk marketplace pihak ketiga ini disertakan hanya saat `OTEL_LOG_TOOL_DETAILS=1`1118* `marketplace.name`: Marketplace tempat plugin diinstal. Untuk marketplace pihak ketiga ini disertakan hanya ketika `OTEL_LOG_TOOL_DETAILS=1`

1076 1119

1077<h4 id="plugin-loaded-event">1120<h4 id="plugin-loaded-event">

1078 Acara plugin dimuat1121 Peristiwa plugin dimuat

1079</h4>1122</h4>

1080 1123

1081Dicatat sekali per plugin yang diaktifkan saat startup sesi. Gunakan acara ini untuk menginventarisasi plugin mana yang aktif di seluruh armada Anda, sebagai pelengkap `plugin_installed` yang mencatat tindakan instalasi itu sendiri.1124Dicatat sekali per plugin yang diaktifkan pada awal sesi. Gunakan peristiwa ini untuk menginventarisasi plugin mana yang aktif di seluruh armada Anda, sebagai pelengkap `plugin_installed` yang mencatat tindakan instalasi itu sendiri.

1082 1125

1083**Nama Acara**: `claude_code.plugin_loaded`1126**Nama Peristiwa**: `claude_code.plugin_loaded`

1084 1127

1085**Atribut**:1128**Atribut**:

1086 1129

1087* Semua [atribut standar](#standard-attributes)1130* Semua [atribut standar](#standard-attributes)

1088* `event.name`: `"plugin_loaded"`1131* `event.name`: `"plugin_loaded"`

1089* `event.timestamp`: Stempel waktu ISO 86011132* `event.timestamp`: Timestamp ISO 8601

1090* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1133* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1091* `plugin.name`: nama plugin. Untuk plugin di luar marketplace resmi dan bundel built-in nilainya adalah `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1`1134* `plugin.name`: nama plugin. Untuk plugin di luar marketplace resmi dan bundel bawaan nilainya adalah `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1`

1092* `marketplace.name`: marketplace tempat plugin diinstal, saat diketahui. Diredaksi menjadi `"third-party"` di bawah kondisi yang sama dengan `plugin.name`1135* `marketplace.name`: marketplace tempat plugin diinstal, saat diketahui. Disunting menjadi `"third-party"` di bawah kondisi yang sama dengan `plugin.name`

1093* `plugin.version`: versi dari manifest plugin. Disertakan hanya saat nama tidak diredaksi dan manifest mendeklarasikan versi1136* `plugin.version`: versi dari manifes plugin. Disertakan hanya ketika nama tidak disunting dan manifes mendeklarasikan versi

1094* `plugin.scope`: kategori provenance untuk plugin: `"official"`, `"community"`, `"org"`, `"user-local"`, atau `"default-bundle"`1137* `plugin.scope`: kategori asal untuk plugin: `"official"`, `"community"`, `"org"`, `"user-local"`, atau `"default-bundle"`

1095* `enabled_via`: bagaimana plugin menjadi diaktifkan: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"`, atau `"user-install"`. Nilai `"admin-install"` berarti plugin diatur sebagai required atau auto-install untuk organisasi Anda di [**Pengaturan Organisasi > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory). Sebelum v2.1.246, Claude Code melaporkan plugin ini sebagai `"user-install"` atau `"seed-mount"`1138* `enabled_via`: bagaimana plugin menjadi diaktifkan: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"`, atau `"user-install"`. Nilai `"admin-install"` berarti plugin diatur ke wajib atau auto-install untuk organisasi Anda dalam [**Pengaturan Organisasi > Plugin & skill**](https://claude.ai/admin-settings/skills?tab=inventory). Sebelum v2.1.246, Claude Code melaporkan plugin ini sebagai `"user-install"` atau `"seed-mount"`

1096* `plugin_id_hash`: hash deterministik dari nama plugin dan marketplace, dikirim hanya ke pengekspor yang dikonfigurasi. Memungkinkan Anda menghitung berapa banyak plugin pihak ketiga yang berbeda dimuat di seluruh armada Anda tanpa merekam nama mereka. Untuk [plugin yang disinkronkan dari claude.ai](/docs/id/plugins/loading#synced-plugins), Claude Code menghash nama plugin dengan nama marketplace yang dilaporkan claude.ai untuk plugin, atau dengan `synced` sebaliknya. Sebelum v2.1.246, Claude Code tidak menggunakan nama marketplace yang dilaporkan claude.ai dalam hash1139* `plugin_id_hash`: hash deterministik dari nama plugin dan marketplace, dikirim hanya ke eksporter yang dikonfigurasi. Memungkinkan Anda menghitung plugin pihak ketiga yang berbeda dimuat di seluruh armada tanpa merekam nama mereka. Untuk [plugin yang disinkronkan dari claude.ai](/docs/id/plugins/loading#synced-plugins), Claude Code menghash nama plugin dengan nama marketplace yang claude.ai laporkan untuk plugin, atau dengan `synced` sebaliknya. Sebelum v2.1.246, Claude Code tidak menggunakan nama marketplace yang claude.ai laporkan dalam hash

1097* `has_hooks`: apakah plugin berkontribusi hooks1140* `has_hooks`: apakah plugin berkontribusi hooks

1098* `has_mcp`: apakah plugin berkontribusi server MCP1141* `has_mcp`: apakah plugin berkontribusi server MCP

1099* `host_owned_mcp`: `true` saat host SDK mengelola koneksi MCP plugin ini dan Claude Code melewati pembacaan konfigurasi server MCP plugin, `false` sebaliknya. Memerlukan Claude Code v2.1.172 atau lebih baru1142* `host_owned_mcp`: `true` ketika host SDK mengelola koneksi MCP plugin ini dan Claude Code melewati membaca konfigurasi server MCP plugin, `false` sebaliknya. Memerlukan Claude Code v2.1.172 atau lebih baru

1100* `skill_path_count`: jumlah direktori skill yang dideklarasikan plugin1143* `skill_path_count`: jumlah direktori skill yang plugin deklarasikan

1101* `command_path_count`: jumlah direktori perintah yang dideklarasikan plugin1144* `command_path_count`: jumlah direktori perintah yang plugin deklarasikan

1102* `agent_path_count`: jumlah direktori agen yang dideklarasikan plugin1145* `agent_path_count`: jumlah direktori agen yang plugin deklarasikan

1103* `safe_mode`: `"true"` saat sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Dalam mode aman acara ini melaporkan inventaris yang dikonfigurasi saja; perintah, skill, hooks, dan server MCP plugin tidak dimuat. Memerlukan Claude Code v2.1.169 atau lebih baru1146* `safe_mode`: `"true"` ketika sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Dalam mode aman peristiwa ini melaporkan inventaris yang dikonfigurasi hanya; perintah, skill, hooks, dan server MCP plugin tidak dimuat. Memerlukan Claude Code v2.1.169 atau lebih baru

1104 1147

1105<h4 id="skill-activated-event">1148<h4 id="skill-activated-event">

1106 Acara skill diaktifkan1149 Peristiwa skill diaktifkan

1107</h4>1150</h4>

1108 1151

1109Dicatat saat skill dipanggil, baik Claude memanggilnya melalui alat Skill atau Anda menjalankannya sebagai perintah `/`.1152Dicatat ketika skill dipanggil, apakah Claude memanggilnya melalui alat Skill atau Anda menjalankannya sebagai perintah `/`.

1110 1153

1111**Nama Acara**: `claude_code.skill_activated`1154**Nama Peristiwa**: `claude_code.skill_activated`

1112 1155

1113**Atribut**:1156**Atribut**:

1114 1157

1115* Semua [atribut standar](#standard-attributes)1158* Semua [atribut standar](#standard-attributes)

1116* `event.name`: `"skill_activated"`1159* `event.name`: `"skill_activated"`

1117* `event.timestamp`: Stempel waktu ISO 86011160* `event.timestamp`: Timestamp ISO 8601

1118* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1161* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1119* `skill.name`: Nama skill. Untuk skill yang ditentukan pengguna dan plugin pihak ketiga nilainya adalah placeholder `"custom_skill"` kecuali `OTEL_LOG_TOOL_DETAILS=1`1162* `skill.name`: Nama skill. Untuk skill yang ditentukan pengguna dan plugin pihak ketiga nilainya adalah placeholder `"custom_skill"` kecuali `OTEL_LOG_TOOL_DETAILS=1`

1120* `invocation_trigger`: Bagaimana skill dipicu (`"user-slash"`, `"claude-proactive"`, atau `"nested-skill"`)1163* `invocation_trigger`: Bagaimana skill dipicu (`"user-slash"`, `"claude-proactive"`, atau `"nested-skill"`)

1121* `skill.source`: Tempat skill dimuat dari (misalnya, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1164* `skill.source`: Dari mana skill dimuat (misalnya, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1122* `skill.kind`: `"workflow"` saat skill adalah skill workflow. Tidak ada sebaliknya1165* `skill.kind`: `"workflow"` ketika skill adalah skill workflow. Tidak ada sebaliknya

1123* `plugin.name` (saat `OTEL_LOG_TOOL_DETAILS=1` atau plugin dari marketplace resmi): Nama plugin pemilik saat skill disediakan oleh plugin1166* `plugin.name` (ketika `OTEL_LOG_TOOL_DETAILS=1` atau plugin dari marketplace resmi): Nama plugin pemilik ketika skill disediakan oleh plugin

1124* `marketplace.name` (saat `OTEL_LOG_TOOL_DETAILS=1` atau plugin dari marketplace resmi): Marketplace plugin pemilik diinstal dari, saat skill disediakan oleh plugin1167* `marketplace.name` (ketika `OTEL_LOG_TOOL_DETAILS=1` atau plugin dari marketplace resmi): Marketplace tempat plugin pemilik diinstal, saat skill disediakan oleh plugin

1125 1168

1126<h4 id="at-mention-event">1169<h4 id="at-mention-event">

1127 Acara mention @1170 Peristiwa penyebutan @

1128</h4>1171</h4>

1129 1172

1130Dicatat saat Claude Code menyelesaikan mention `@` dalam prompt. Tidak setiap mention memancarkan acara: jalur early-exit seperti penolakan izin, file berukuran besar, lampiran referensi PDF, dan kegagalan listing direktori kembali tanpa logging.1173Dicatat ketika Claude Code menyelesaikan penyebutan `@` dalam prompt. Tidak setiap penyebutan memancarkan peristiwa: jalur keluar awal seperti penolakan izin, file yang terlalu besar, lampiran referensi PDF, dan kegagalan daftar direktori kembali tanpa pencatatan.

1131 1174

1132**Nama Acara**: `claude_code.at_mention`1175**Nama Peristiwa**: `claude_code.at_mention`

1133 1176

1134**Atribut**:1177**Atribut**:

1135 1178

1136* Semua [atribut standar](#standard-attributes)1179* Semua [atribut standar](#standard-attributes)

1137* `event.name`: `"at_mention"`1180* `event.name`: `"at_mention"`

1138* `event.timestamp`: Stempel waktu ISO 86011181* `event.timestamp`: Timestamp ISO 8601

1139* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1182* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1140* `mention_type`: Jenis mention (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). Nilai `"peer"` berarti Anda menyebutkan [salah satu sesi Claude Code lain Anda](/docs/id/cross-session-messaging). Memerlukan Claude Code v2.1.232 atau lebih baru1183* `mention_type`: Jenis penyebutan (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). Nilai `"peer"` berarti Anda menyebutkan [salah satu sesi Claude Code lain Anda](/docs/id/cross-session-messaging). Memerlukan Claude Code v2.1.232 atau lebih baru

1141* `success`: Apakah mention berhasil diselesaikan (`"true"` atau `"false"`)1184* `success`: Apakah penyebutan diselesaikan dengan berhasil (`"true"` atau `"false"`)

1142 1185

1143<h4 id="api-retries-exhausted-event">1186<h4 id="api-retries-exhausted-event">

1144 Acara retry API habis1187 Peristiwa pengulangan API habis

1145</h4>1188</h4>

1146 1189

1147Dicatat sekali saat permintaan API gagal setelah lebih dari satu upaya. Dipancarkan bersama acara `api_error` terakhir.1190Dicatat sekali ketika permintaan API gagal setelah lebih dari satu upaya. Dipancarkan bersama peristiwa `api_error` akhir.

1148 1191

1149**Nama Acara**: `claude_code.api_retries_exhausted`1192**Nama Peristiwa**: `claude_code.api_retries_exhausted`

1150 1193

1151**Atribut**:1194**Atribut**:

1152 1195

1153* Semua [atribut standar](#standard-attributes)1196* Semua [atribut standar](#standard-attributes)

1154* `event.name`: `"api_retries_exhausted"`1197* `event.name`: `"api_retries_exhausted"`

1155* `event.timestamp`: Stempel waktu ISO 86011198* `event.timestamp`: Timestamp ISO 8601

1156* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1199* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1157* `model`: Model yang digunakan1200* `model`: Model yang digunakan

1158* `error`: Pesan kesalahan terakhir1201* `error`: Pesan kesalahan akhir

1159* `status_code`: Kode status HTTP sebagai angka. Tidak ada untuk kesalahan non-HTTP.1202* `status_code`: Kode status HTTP sebagai angka. Tidak ada untuk kesalahan non-HTTP.

1160* `total_attempts`: Jumlah total upaya yang dilakukan1203* `total_attempts`: Jumlah total upaya yang dilakukan

1161* `total_retry_duration_ms`: Total waktu wall-clock di semua upaya1204* `total_retry_duration_ms`: Total waktu dinding di seluruh upaya

1162* `speed`: `"fast"` atau `"normal"`1205* `speed`: `"fast"` atau `"normal"`

1163 1206

1164<h4 id="hook-registered-event">1207<h4 id="hook-registered-event">

1165 Acara hook terdaftar1208 Peristiwa hook terdaftar

1166</h4>1209</h4>

1167 1210

1168Dicatat sekali per hook yang dikonfigurasi saat startup sesi. Gunakan acara ini untuk menginventarisasi hook mana yang aktif di seluruh armada Anda, sebagai pelengkap acara `hook_execution_start` dan `hook_execution_complete` per eksekusi.1211Dicatat sekali per hook yang dikonfigurasi pada awal sesi. Gunakan peristiwa ini untuk menginventarisasi hook mana yang aktif di seluruh armada Anda, sebagai pelengkap peristiwa `hook_execution_start` dan `hook_execution_complete` per-eksekusi.

1169 1212

1170**Nama Acara**: `claude_code.hook_registered`1213**Nama Peristiwa**: `claude_code.hook_registered`

1171 1214

1172**Atribut**:1215**Atribut**:

1173 1216

1174* Semua [atribut standar](#standard-attributes)1217* Semua [atribut standar](#standard-attributes)

1175* `event.name`: `"hook_registered"`1218* `event.name`: `"hook_registered"`

1176* `event.timestamp`: Stempel waktu ISO 86011219* `event.timestamp`: Timestamp ISO 8601

1177* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1220* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1178* `hook_event`: jenis acara hook, seperti `"PreToolUse"` atau `"PostToolUse"`1221* `hook_event`: jenis peristiwa hook, seperti `"PreToolUse"` atau `"PostToolUse"`

1179* `hook_type`: jenis implementasi hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, atau `"agent"`1222* `hook_type`: jenis implementasi hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, atau `"agent"`

1180* `hook_source`: tempat hook didefinisikan: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, atau `"pluginHook"`1223* `hook_source`: di mana hook didefinisikan: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, atau `"pluginHook"`

1181* `safe_mode`: `"true"` saat sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru1224* `safe_mode`: `"true"` ketika sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru

1182* `hook_matcher` (saat `OTEL_LOG_TOOL_DETAILS=1`): string matcher dari konfigurasi hook, saat satu diatur1225* `hook_matcher` (ketika `OTEL_LOG_TOOL_DETAILS=1`): string matcher dari konfigurasi hook, saat satu diatur

1183* `plugin.name` (saat `hook_source` adalah `"pluginHook"`): nama plugin yang berkontribusi. Untuk plugin di luar marketplace resmi dan bundel built-in nilainya adalah `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1`1226* `plugin.name` (ketika `hook_source` adalah `"pluginHook"`): nama plugin yang berkontribusi. Untuk plugin di luar marketplace resmi dan bundel bawaan nilainya adalah `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1`

1184* `plugin_id_hash` (saat `hook_source` adalah `"pluginHook"`): hash deterministik dari nama plugin dan marketplace, dikirim hanya ke pengekspor yang dikonfigurasi. Memungkinkan Anda menghitung plugin yang berkontribusi berbeda tanpa merekam nama mereka. Claude Code menghitungnya seperti yang dijelaskan di bawah [acara plugin dimuat](#plugin-loaded-event)1227* `plugin_id_hash` (ketika `hook_source` adalah `"pluginHook"`): hash deterministik dari nama plugin dan marketplace, dikirim hanya ke eksporter yang dikonfigurasi. Memungkinkan Anda menghitung plugin yang berkontribusi berbeda tanpa merekam nama mereka. Claude Code menghitungnya seperti dijelaskan di bawah [peristiwa plugin dimuat](#plugin-loaded-event)

1185 1228

1186<h4 id="hook-execution-start-event">1229<h4 id="hook-execution-start-event">

1187 Acara mulai eksekusi hook1230 Peristiwa awal eksekusi hook

1188</h4>1231</h4>

1189 1232

1190Dicatat saat satu atau lebih hooks mulai dieksekusi untuk acara hook.1233Dicatat ketika satu atau lebih hook mulai mengeksekusi untuk peristiwa hook.

1191 1234

1192**Nama Acara**: `claude_code.hook_execution_start`1235**Nama Peristiwa**: `claude_code.hook_execution_start`

1193 1236

1194**Atribut**:1237**Atribut**:

1195 1238

1196* Semua [atribut standar](#standard-attributes)1239* Semua [atribut standar](#standard-attributes)

1197* `event.name`: `"hook_execution_start"`1240* `event.name`: `"hook_execution_start"`

1198* `event.timestamp`: Stempel waktu ISO 86011241* `event.timestamp`: Timestamp ISO 8601

1199* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1242* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1200* `hook_event`: Jenis acara hook, seperti `"PreToolUse"` atau `"PostToolUse"`1243* `hook_event`: Jenis peristiwa hook, seperti `"PreToolUse"` atau `"PostToolUse"`

1201* `hook_name`: Nama hook lengkap termasuk matcher, seperti `"PreToolUse:Write"`1244* `hook_name`: Nama hook lengkap termasuk matcher, seperti `"PreToolUse:Write"`

1202* `num_hooks`: Jumlah perintah hook yang cocok1245* `num_hooks`: Jumlah perintah hook yang cocok

1203* `managed_only`: `"true"` saat hanya hooks kebijakan terkelola yang diizinkan1246* `managed_only`: `"true"` ketika hanya hook kebijakan yang dikelola yang diizinkan

1204* `hook_source`: `"policySettings"` atau `"merged"`1247* `hook_source`: `"policySettings"` atau `"merged"`

1205* `safe_mode`: `"true"` saat sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru1248* `safe_mode`: `"true"` ketika sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru

1206* `hook_definitions`: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya saat detailed beta tracing dan `OTEL_LOG_TOOL_DETAILS=1` keduanya diaktifkan1249* `hook_definitions`: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya ketika pelacakan beta terperinci dan `OTEL_LOG_TOOL_DETAILS=1` keduanya diaktifkan

1207 1250

1208<h4 id="hook-execution-complete-event">1251<h4 id="hook-execution-complete-event">

1209 Acara eksekusi hook selesai1252 Peristiwa lengkap eksekusi hook

1210</h4>1253</h4>

1211 1254

1212Dicatat saat semua hooks untuk acara hook selesai.1255Dicatat ketika semua hook untuk peristiwa hook telah selesai.

1213 1256

1214**Nama Acara**: `claude_code.hook_execution_complete`1257**Nama Peristiwa**: `claude_code.hook_execution_complete`

1215 1258

1216**Atribut**:1259**Atribut**:

1217 1260

1218* Semua [atribut standar](#standard-attributes)1261* Semua [atribut standar](#standard-attributes)

1219* `event.name`: `"hook_execution_complete"`1262* `event.name`: `"hook_execution_complete"`

1220* `event.timestamp`: Stempel waktu ISO 86011263* `event.timestamp`: Timestamp ISO 8601

1221* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1264* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1222* `hook_event`: Jenis acara hook1265* `hook_event`: Jenis peristiwa hook

1223* `hook_name`: Nama hook lengkap termasuk matcher1266* `hook_name`: Nama hook lengkap termasuk matcher

1224* `num_hooks`: Jumlah perintah hook yang cocok1267* `num_hooks`: Jumlah perintah hook yang cocok

1225* `num_success`: Jumlah yang selesai dengan sukses1268* `num_success`: Jumlah yang selesai dengan berhasil

1226* `num_blocking`: Jumlah yang mengembalikan keputusan blocking1269* `num_blocking`: Jumlah yang mengembalikan keputusan pemblokiran

1227* `num_non_blocking_error`: Jumlah yang gagal tanpa blocking1270* `num_non_blocking_error`: Jumlah yang gagal tanpa memblokir

1228* `num_cancelled`: Jumlah dibatalkan sebelum selesai1271* `num_cancelled`: Jumlah dibatalkan sebelum penyelesaian

1229* `total_duration_ms`: Durasi wall-clock dari semua hooks yang cocok1272* `total_duration_ms`: Durasi dinding semua hook yang cocok

1230* `stdout_chars`: Total karakter stdout di seluruh hooks yang cocok yang berhasil. Memerlukan Claude Code v2.1.280 atau lebih baru1273* `stdout_chars`: Total karakter stdout di seluruh hook yang cocok yang berhasil. Memerlukan Claude Code v2.1.280 atau lebih baru

1231* `additional_context_chars`: Total karakter `additionalContext` yang dikembalikan oleh hooks yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru1274* `additional_context_chars`: Total karakter `additionalContext` yang dikembalikan oleh hook yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru

1232* `system_message_chars`: Total karakter `systemMessage` yang dikembalikan oleh hooks yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru1275* `system_message_chars`: Total karakter `systemMessage` yang dikembalikan oleh hook yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru

1233* `initial_user_message_chars`: Total karakter `initialUserMessage` yang dikembalikan oleh hooks yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru1276* `initial_user_message_chars`: Total karakter `initialUserMessage` yang dikembalikan oleh hook yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru

1234* `num_outputs_persisted`: Jumlah output hook di atas [batas 10.000 karakter](/docs/id/hooks#json-output) yang disimpan Claude Code ke file. Memerlukan Claude Code v2.1.280 atau lebih baru1277* `num_outputs_persisted`: Jumlah output hook di atas [batas 10.000 karakter](/docs/id/hooks#json-output) yang Claude Code simpan ke file. Memerlukan Claude Code v2.1.280 atau lebih baru

1235* `managed_only`: `"true"` saat hanya hooks kebijakan terkelola yang diizinkan1278* `managed_only`: `"true"` ketika hanya hook kebijakan yang dikelola yang diizinkan

1236* `hook_source`: `"policySettings"` atau `"merged"`1279* `hook_source`: `"policySettings"` atau `"merged"`

1237* `safe_mode`: `"true"` saat sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru1280* `safe_mode`: `"true"` ketika sesi dimulai dengan [`--safe-mode`](/docs/id/cli-reference), `"false"` sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru

1238* `hook_definitions`: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya saat detailed beta tracing dan `OTEL_LOG_TOOL_DETAILS=1` keduanya diaktifkan1281* `hook_definitions`: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya ketika pelacakan beta terperinci dan `OTEL_LOG_TOOL_DETAILS=1` keduanya diaktifkan

1239 1282

1240<h4 id="hook-plugin-metrics-event">1283<h4 id="hook-plugin-metrics-event">

1241 Acara metrik plugin hook1284 Peristiwa metrik plugin hook

1242</h4>1285</h4>

1243 1286

1244Dicatat saat hook plugin marketplace resmi memancarkan metrik per-invokasi. Hanya plugin yang diinstal dari marketplace Anthropic resmi yang dapat memancarkan ini. Plugin marketplace pihak ketiga dan hook yang dikonfigurasi pengguna tidak memancarkan ke acara ini. Gunakan acara ini untuk memantau perilaku plugin seperti tingkat penemuan, biaya, dan durasi dari stack observabilitas Anda sendiri.1287Dicatat ketika hook plugin marketplace resmi memancarkan metrik per-invokasi. Hanya plugin yang diinstal dari marketplace Anthropic resmi yang dapat memancarkan ini. Plugin marketplace pihak ketiga dan hook yang dikonfigurasi pengguna tidak memancarkan ke peristiwa ini. Gunakan peristiwa ini untuk memantau perilaku plugin seperti tingkat penemuan, biaya, dan durasi dari stack observabilitas Anda sendiri.

1245 1288

1246**Nama Acara**: `claude_code.hook_plugin_metrics`1289**Nama Peristiwa**: `claude_code.hook_plugin_metrics`

1247 1290

1248**Atribut**:1291**Atribut**:

1249 1292

1250* Semua [atribut standar](#standard-attributes)1293* Semua [atribut standar](#standard-attributes)

1251* `event.name`: `"hook_plugin_metrics"`1294* `event.name`: `"hook_plugin_metrics"`

1252* `event.timestamp`: Stempel waktu ISO 86011295* `event.timestamp`: Timestamp ISO 8601

1253* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1296* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1254* `plugin_id`: pengidentifikasi plugin dalam bentuk `<name>@<marketplace>`1297* `plugin_id`: pengenal plugin dalam bentuk `<name>@<marketplace>`

1255* `hook_event`: jenis acara hook yang memancarkan metrik1298* `hook_event`: jenis peristiwa hook yang memancarkan metrik

1256* Hingga 20 kunci metrik yang dipancarkan plugin. Nama cocok dengan `^[a-z][a-z0-9_]{0,39}$`. Nilai adalah boolean atau angka.1299* Hingga 20 kunci metrik yang dipancarkan plugin. Nama cocok dengan `^[a-z][a-z0-9_]{0,39}$`. Nilai adalah boolean atau angka.

1257 1300

1258<h4 id="compaction-event">1301<h4 id="compaction-event">

1259 Acara pemadatan1302 Peristiwa pemadatan

1260</h4>1303</h4>

1261 1304

1262Dicatat saat pemadatan percakapan selesai.1305Dicatat ketika pemadatan percakapan selesai.

1263 1306

1264**Nama Acara**: `claude_code.compaction`1307**Nama Peristiwa**: `claude_code.compaction`

1265 1308

1266**Atribut**:1309**Atribut**:

1267 1310

1268* Semua [atribut standar](#standard-attributes)1311* Semua [atribut standar](#standard-attributes)

1269* `event.name`: `"compaction"`1312* `event.name`: `"compaction"`

1270* `event.timestamp`: Stempel waktu ISO 86011313* `event.timestamp`: Timestamp ISO 8601

1271* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1314* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1272* `trigger`: `"auto"` atau `"manual"`1315* `trigger`: `"auto"` atau `"manual"`

1273* `success`: `"true"` atau `"false"`1316* `success`: `"true"` atau `"false"`

1274* `duration_ms`: Durasi pemadatan1317* `duration_ms`: Durasi pemadatan

1275* `pre_tokens`: Jumlah token perkiraan sebelum pemadatan1318* `pre_tokens`: Jumlah token perkiraan sebelum pemadatan

1276* `post_tokens`: Jumlah token perkiraan setelah pemadatan1319* `post_tokens`: Jumlah token perkiraan setelah pemadatan

1277* `error`: Pesan kesalahan saat pemadatan gagal1320* `error`: Pesan kesalahan ketika pemadatan gagal

1278* `precompute_reuse`: Hanya diatur saat `trigger` adalah `"manual"`. Auto-compaction dapat menyiapkan ringkasan di latar belakang sebelum jendela konteks penuh, dan atribut ini mencatat apakah `/compact` menggunakan kembali ringkasan yang disiapkan itu. `"hit"` berarti itu digunakan kembali; `"miss_custom_instructions"`, `"miss_hook"`, dan `"miss_not_ready"` memberikan alasan ringkasan segar dihitung sebagai gantinya. Memerlukan Claude Code v2.1.153 atau lebih baru1321* `precompute_reuse`: Hanya diatur ketika `trigger` adalah `"manual"`. Pemadatan otomatis dapat menyiapkan ringkasan di latar belakang sebelum jendela konteks penuh, dan atribut ini mencatat apakah `/compact` menggunakan kembali ringkasan yang disiapkan itu. `"hit"` berarti itu digunakan kembali; `"miss_custom_instructions"`, `"miss_hook"`, dan `"miss_not_ready"` memberikan alasan ringkasan segar dihitung sebagai gantinya. Memerlukan Claude Code v2.1.153 atau lebih baru

1279 1322

1280<h4 id="subagent-completed-event">1323<h4 id="subagent-completed-event">

1281 Acara subagent selesai1324 Peristiwa subagen selesai

1282</h4>1325</h4>

1283 1326

1284Dicatat saat [subagent](/docs/id/sub-agents) selesai dan mengembalikan hasilnya ke percakapan yang memulainya. Gunakan untuk menggabungkan penggunaan alat dan waktu run berdasarkan jenis subagent; untuk rollup token atau biaya, gunakan [penghitung token](#token-counter) dan [penghitung biaya](#cost-counter) yang disaring ke `query_source` `"subagent"`, karena `total_tokens` acara ini hanya mencakup permintaan akhir. Kategori `"subagent"` juga menghitung permintaan dari hooks berbasis agen, yang tidak memancarkan acara subagent.1327Dicatat ketika [subagen](/docs/id/sub-agents) selesai dan mengembalikan hasilnya ke percakapan yang memulainya. Gunakan untuk menggabungkan penggunaan alat dan waktu run menurut jenis subagen; untuk penggabungan token atau biaya, gunakan [penghitung token](#token-counter) dan [penghitung biaya](#cost-counter) yang disaring ke `query_source` `"subagent"`, karena `total_tokens` peristiwa ini mencakup hanya permintaan akhir. Kategori `"subagent"` juga menghitung permintaan dari hook berbasis agen, yang tidak memancarkan peristiwa subagen.

1285 1328

1286**Nama Acara**: `claude_code.subagent_completed`1329**Nama Peristiwa**: `claude_code.subagent_completed`

1287 1330

1288**Atribut**:1331**Atribut**:

1289 1332

1290* Semua [atribut standar](#standard-attributes)1333* Semua [atribut standar](#standard-attributes)

1291* `event.name`: `"subagent_completed"`1334* `event.name`: `"subagent_completed"`

1292* `event.timestamp`: Stempel waktu ISO 86011335* `event.timestamp`: Timestamp ISO 8601

1293* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1336* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1294* `agent_type`: Jenis subagent. Nama agen built-in dan agen dari plugin marketplace resmi muncul verbatim; nama agen lainnya diganti dengan `"custom"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur1337* `agent_type`: Jenis subagen. Nama agen bawaan dan agen dari plugin marketplace resmi muncul verbatim; nama agen lainnya diganti dengan `"custom"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur

1295* `agent.source`: Tempat definisi agen berasal: `built-in`, `plugin`, atau sumber pengaturan yang mendefinisikan agen khusus, seperti `userSettings` atau `projectSettings`1338* `agent.source`: Dari mana definisi agen berasal: `built-in`, `plugin`, atau sumber pengaturan yang mendefinisikan agen kustom, seperti `userSettings` atau `projectSettings`

1296* `is_built_in`: Apakah subagent adalah jenis agen built-in1339* `is_built_in`: Apakah subagen adalah jenis agen bawaan

1297* `is_async`: Apakah subagent berjalan di [latar belakang](/docs/id/sub-agents#run-subagents-in-foreground-or-background)1340* `is_async`: Apakah subagen berjalan di [latar belakang](/docs/id/sub-agents#run-subagents-in-foreground-or-background)

1298* `total_tokens`: Jejak token permintaan API akhir subagent: token input, pembuatan cache, pembacaan cache, dan output permintaan itu, kira-kira ukuran konteks subagent saat selesai. Bukan jumlah di seluruh run1341* `total_tokens`: Jejak token dari permintaan API akhir subagen: token input, pembuatan cache, pembacaan cache, dan output permintaan itu saja, kira-kira ukuran konteks subagen saat penyelesaian. Bukan jumlah di seluruh run

1299* `total_tool_uses`: Jumlah panggilan alat yang dibuat subagent di seluruh run1342* `total_tool_uses`: Jumlah panggilan alat yang dibuat subagen di seluruh run

1300* `duration_ms`: Waktu run dalam milidetik1343* `duration_ms`: Waktu run dalam milidetik

1301* `model`: Model yang diselesaikan subagent untuk dijalankan1344* `model`: Model yang diselesaikan subagen untuk dijalankan

1302* `final_model`: Model yang menghasilkan respons akhir subagent, yang berbeda dari `model` setelah switch mid-run seperti fallback. Memerlukan Claude Code v2.1.212 atau lebih baru1345* `final_model`: Model yang menghasilkan respons akhir subagen, yang berbeda dari `model` setelah switch mid-run seperti fallback. Memerlukan Claude Code v2.1.212 atau lebih baru

1303* `model_swapped`: Apakah lebih dari satu model melayani permintaan subagent. Memerlukan Claude Code v2.1.212 atau lebih baru1346* `model_swapped`: Apakah lebih dari satu model melayani permintaan subagen. Memerlukan Claude Code v2.1.212 atau lebih baru

1304* `plugin_id_hash`, `plugin.name`: Ada untuk agen yang disediakan plugin. Nama plugin marketplace resmi muncul verbatim; nama plugin lainnya diganti dengan `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur1347* `plugin_id_hash`, `plugin.name`: Ada untuk agen yang disediakan plugin. Nama plugin marketplace resmi muncul verbatim; nama plugin lainnya diganti dengan `"third-party"` kecuali `OTEL_LOG_TOOL_DETAILS=1` diatur

1305 1348

1306<h4 id="feedback-survey-event">1349<h4 id="feedback-survey-event">

1307 Acara survei umpan balik1350 Peristiwa survei umpan balik

1308</h4>1351</h4>

1309 1352

1310Dicatat saat survei kualitas sesi ditampilkan atau dijawab. Lihat [Survei kualitas sesi](/docs/id/data-usage#session-quality-surveys) untuk mengetahui apa yang dikumpulkan survei dan cara mengontrolnya.1353Dicatat ketika survei kualitas sesi ditampilkan atau dijawab. Lihat [Survei kualitas sesi](/docs/id/data-usage#session-quality-surveys) untuk apa yang dikumpulkan survei dan cara mengontrolnya.

1311 1354

1312**Nama Acara**: `claude_code.feedback_survey`1355**Nama Peristiwa**: `claude_code.feedback_survey`

1313 1356

1314**Atribut**:1357**Atribut**:

1315 1358

1316* Semua [atribut standar](#standard-attributes)1359* Semua [atribut standar](#standard-attributes)

1317* `event.name`: `"feedback_survey"`1360* `event.name`: `"feedback_survey"`

1318* `event.timestamp`: Stempel waktu ISO 86011361* `event.timestamp`: Timestamp ISO 8601

1319* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1362* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1320* `event_type`: Acara siklus hidup survei, misalnya `"appeared"`, `"responded"`, atau `"transcript_prompt_appeared"`1363* `event_type`: Peristiwa siklus hidup survei, misalnya `"appeared"`, `"responded"`, atau `"transcript_prompt_appeared"`

1321* `appearance_id`: ID unik yang menghubungkan acara yang dipancarkan untuk satu instance survei1364* `appearance_id`: ID unik yang menghubungkan peristiwa yang dipancarkan untuk satu instance survei

1322* `survey_type`: Survei mana yang menghasilkan acara. `"session"` adalah prompt rating "Bagaimana Claude melakukannya?"1365* `survey_type`: Survei mana yang menghasilkan peristiwa. `"session"` adalah prompt rating "Bagaimana Claude melakukannya?"

1323* `response`: Pilihan pengguna pada acara `responded`1366* `response`: Pilihan pengguna pada peristiwa `responded`

1324* `enabled_via_override`: `true` saat [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/id/env-vars) diatur. Dipancarkan sebagai boolean, bukan string. Hadir pada acara survei `session`. Filter pada atribut ini untuk mengkonfirmasi override diterapkan di seluruh armada1367* `enabled_via_override`: `true` ketika [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/id/env-vars) diatur. Dipancarkan sebagai boolean, bukan string. Ada pada peristiwa survei `session`. Filter pada atribut ini untuk mengkonfirmasi override diterapkan di seluruh armada

1325 1368

1326<h4 id="retention-sweep-event">1369<h4 id="retention-sweep-event">

1327 Acara penyapuan retensi1370 Peristiwa sapuan retensi

1328</h4>1371</h4>

1329 1372

1330Dicatat sekali per run penyapuan pembersihan retensi, yang menghapus [transkrip sesi dan data aplikasi lainnya](/docs/id/claude-directory#cleaned-up-automatically) yang lebih lama dari pengaturan [`cleanupPeriodDays`](/docs/id/settings-reference#cleanupperioddays). Claude Code menjalankan penyapuan di latar belakang paling banyak sekali per sesi, dan run yang tidak menghapus apa pun masih memancarkan acara. Jika Claude Code menjalankan penyapuan dalam sesi apa pun di mesin yang sama dalam 24 jam terakhir, itu menunda penyapuan sesi ini setidaknya 10 menit, jadi sesi yang keluar lebih cepat tidak memancarkan apa pun. Saat Anda menjalankan `claude -p` dengan `--bare`, Claude Code tidak menjalankan penyapuan dan tidak memancarkan apa pun.1373Dicatat sekali per run sapuan pembersihan retensi, yang menghapus [transkrip sesi dan data aplikasi lainnya](/docs/id/claude-directory#cleaned-up-automatically) lebih lama dari pengaturan [`cleanupPeriodDays`](/docs/id/settings-reference#cleanupperioddays). Claude Code menjalankan sapuan di latar belakang paling banyak sekali per sesi, dan run yang tidak menghapus apa pun masih memancarkan peristiwa. Jika Claude Code menjalankan sapuan dalam sesi apa pun pada mesin yang sama dalam 24 jam terakhir, itu menunda sapuan sesi ini setidaknya 10 menit, jadi sesi yang keluar lebih cepat tidak memancarkan apa pun. Ketika Anda menjalankan `claude -p` dengan `--bare`, Claude Code tidak menjalankan sapuan dan tidak memancarkan apa pun.

1331 1374

1332Seperti setiap acara OTel di halaman ini, itu hanya pergi ke backend telemetri yang Anda konfigurasi. Memerlukan Claude Code v2.1.227 atau lebih baru.1375Seperti setiap peristiwa OTel di halaman ini, itu hanya pergi ke backend telemetri yang Anda konfigurasi. Memerlukan Claude Code v2.1.227 atau lebih baru.

1333 1376

1334Saat Claude Code tidak dapat dengan aman menentukan periode retensi, itu menghentikan penyapuan dan memancarkan acara dengan `result` diatur ke `"skipped"` dan `skip_reason`. Saat [pengaturan terkelola](/docs/id/server-managed-settings) menetapkan `cleanupPeriodDays`, nilai terkelola menjepit periode retensi dan penyapuan berjalan bahkan saat file pengaturan dalam cakupan prioritas lebih rendah rusak atau tidak valid. Saat `managed-settings.json` itu sendiri tidak dapat dibaca, Claude Code masih menghentikan penyapuan kecuali [tingkat terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) memasok `cleanupPeriodDays` dari tempat lain, seperti pengaturan terkelola server atau drop-in `managed-settings.d/` di samping file yang rusak. Atribut penghitung penghapusan ada hanya saat `result` adalah `"complete"`.1377Ketika Claude Code tidak dapat dengan aman menentukan periode retensi, itu menjeda sapuan dan memancarkan peristiwa dengan `result` diatur ke `"skipped"` dan `skip_reason`. Ketika [pengaturan yang dikelola](/docs/id/server-managed-settings) menetapkan `cleanupPeriodDays`, nilai yang dikelola menjepit periode retensi dan sapuan berjalan bahkan ketika file pengaturan dalam cakupan prioritas lebih rendah rusak atau tidak valid. Ketika `managed-settings.json` itu sendiri tidak dapat dibaca, Claude Code masih menjeda sapuan kecuali [tingkat yang dikelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) memasok `cleanupPeriodDays` dari tempat lain, seperti pengaturan yang dikelola server atau drop-in `managed-settings.d/` di samping file yang rusak. Atribut penghitung penghapusan ada hanya ketika `result` adalah `"complete"`.

1335 1378

1336**Nama Acara**: `claude_code.retention_sweep`1379**Nama Peristiwa**: `claude_code.retention_sweep`

1337 1380

1338**Atribut**:1381**Atribut**:

1339 1382

1340* Semua [atribut standar](#standard-attributes)1383* Semua [atribut standar](#standard-attributes)

1341* `event.name`: `"retention_sweep"`1384* `event.name`: `"retention_sweep"`

1342* `event.timestamp`: Stempel waktu ISO 86011385* `event.timestamp`: Timestamp ISO 8601

1343* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1386* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1344* `result`: `"complete"` saat penyapuan berjalan, `"skipped"` saat Claude Code menghentikannya1387* `result`: `"complete"` ketika sapuan berjalan, `"skipped"` ketika Claude Code menjeda itu

1345* `period_days`: Nilai `cleanupPeriodDays` dari pengaturan yang digabungkan, dalam hari, atau `30` saat tidak ada sumber yang menetapkannya. Pada acara yang dilewati, nilai yang akan digunakan penyapuan, dihitung dari sumber pengaturan yang dapat dibaca Claude Code1388* `period_days`: Nilai `cleanupPeriodDays` dari pengaturan yang digabungkan, dalam hari, atau `30` ketika tidak ada sumber yang menetapkannya. Pada peristiwa yang dilewati, nilai yang akan digunakan sapuan, dihitung dari sumber pengaturan yang dapat dibaca Claude Code

1346* `used_default`: `"true"` saat tidak ada sumber pengaturan yang dapat dibaca yang menetapkan `cleanupPeriodDays`, `"false"` sebaliknya. Pada acara lengkap, `"true"` berarti default 30 hari diterapkan1389* `used_default`: `"true"` ketika tidak ada sumber pengaturan yang dapat dibaca yang menetapkan `cleanupPeriodDays`, `"false"` sebaliknya. Pada peristiwa lengkap, `"true"` berarti default 30 hari diterapkan

1347* `skip_reason`: Mengapa Claude Code menghentikan penyapuan. Ada hanya saat `result` adalah `"skipped"`:1390* `skip_reason`: Mengapa Claude Code menjeda sapuan. Ada hanya ketika `result` adalah `"skipped"`:

1348 * `"user_source_disabled"`: Pengaturan pengguna dikecualikan, misalnya oleh flag [`--setting-sources`](/docs/id/cli-reference#cli-flags) atau opsi [`settingSources`](/docs/id/agent-sdk/typescript#options) SDK, dan tidak ada sumber yang diaktifkan yang menyediakan `cleanupPeriodDays`1391 * `"user_source_disabled"`: Pengaturan pengguna dikecualikan, misalnya oleh flag [`--setting-sources`](/docs/id/cli-reference#cli-flags) atau opsi [`settingSources`](/docs/id/agent-sdk/typescript#options) SDK, dan tidak ada sumber yang diaktifkan yang menyediakan `cleanupPeriodDays`

1349 * `"settings_unknowable"`: File pengaturan tidak dapat dibaca atau diuraikan, jadi `cleanupPeriodDays` atau `desktopSessionCleanupPeriodDays` mungkin diatur ke nilai yang tidak dapat dilihat Claude Code1392 * `"settings_unknowable"`: File pengaturan tidak dapat dibaca atau diuraikan, jadi `cleanupPeriodDays` atau `desktopSessionCleanupPeriodDays` mungkin diatur ke nilai yang tidak dapat dilihat Claude Code

1350 * `"settings_invalid_key_set"`: Pengaturan memiliki kesalahan validasi dan `cleanupPeriodDays` atau `desktopSessionCleanupPeriodDays` secara eksplisit diatur, jadi fallback ke default dapat menghapus atau menyimpan file terhadap pengaturan itu1393 * `"settings_invalid_key_set"`: Pengaturan memiliki kesalahan validasi dan `cleanupPeriodDays` atau `desktopSessionCleanupPeriodDays` secara eksplisit diatur, jadi kembali ke default dapat menghapus atau menyimpan file terhadap pengaturan itu

1351* `transcripts_deleted`: Jumlah transkrip sesi, file `~/.claude/projects/*/*.jsonl` tingkat atas, yang dihapus penyapuan1394* `transcripts_deleted`: Jumlah transkrip sesi, file `~/.claude/projects/*/*.jsonl` tingkat atas, yang dihapus sapuan

1352* `transcripts_exempted_desktop`: Jumlah transkrip melewati periode retensi yang disimpan penyapuan di bawah [aturan Claude Desktop dan Cowork](/docs/id/claude-directory#cleaned-up-automatically). Ini tidak dihitung menuju `files_past_cutoff`. Memerlukan Claude Code v2.1.248 atau lebih baru1395* `transcripts_exempted_desktop`: Jumlah transkrip melewati periode retensi yang disimpan sapuan di bawah [aturan Claude Desktop dan Cowork](/docs/id/claude-directory#cleaned-up-automatically). Ini tidak dihitung menuju `files_past_cutoff`. Memerlukan Claude Code v2.1.248 atau lebih baru

1353* `session_files_deleted`: Jumlah artefak yang dihapus penyapuan file sesi: transkrip plus file pendamping per sesi seperti sidecars, recordings, dan hasil alat1396* `session_files_deleted`: Jumlah artefak yang dihapus sapuan file sesi: transkrip ditambah file pendamping per-sesi seperti sidecars, rekaman, dan hasil alat

1354* `artifacts_deleted`: Total item yang dihapus penyapuan di seluruh direktori data yang dicakupnya, termasuk file sesi. Beberapa penyapuan menghitung pohon direktori yang dihapus seluruhnya sebagai satu item dan beberapa pass pembersihan tidak berkontribusi pada penghitung, jadi perlakukan nilai sebagai lantai daripada hitungan file yang tepat1397* `artifacts_deleted`: Total item yang dihapus sapuan di seluruh direktori data yang dicakupnya, termasuk file sesi. Beberapa sapuan menghitung pohon direktori yang dihapus seluruhnya sebagai satu item dan beberapa pass pembersihan tidak berkontribusi pada penghitung, jadi perlakukan nilai sebagai lantai daripada hitungan file yang tepat

1355* `files_retained_fresh`: File yang diperiksa dan ditinggalkan di tempat karena masih dalam periode retensi. Hanya penyapuan per-file yang menghitung ini, jadi nilainya adalah lantai; nilai bukan nol adalah keadaan tunak normal1398* `files_retained_fresh`: File yang diperiksa dan ditinggalkan di tempat karena masih dalam periode retensi. Hanya sapuan per-file yang menghitung ini, jadi nilainya adalah lantai; nilai bukan nol adalah keadaan stabil normal

1356* `files_past_cutoff`: File yang lebih lama dari periode retensi yang gagal dihapus penyapuan, misalnya karena kesalahan izin atau file yang dipegang terbuka. Nilai di atas nol berarti file melampaui periode retensi yang dikonfigurasi; nol bukan bukti bahwa tidak ada, karena penghapusan yang gagal dari seluruh direktori dihitung menuju `error_count` sebagai gantinya1399* `files_past_cutoff`: File lebih lama dari periode retensi yang gagal dihapus sapuan, misalnya karena kesalahan izin atau file yang dipegang terbuka. Nilai di atas nol berarti file melampaui periode retensi yang dikonfigurasi; nol bukan bukti bahwa tidak ada, karena penghapusan yang gagal dari seluruh direktori dihitung menuju `error_count` sebagai gantinya

1357* `error_count`: Jumlah kesalahan yang dihadapi penyapuan saat membuat daftar atau menghapus file1400* `error_count`: Jumlah kesalahan yang dihadapi sapuan saat mendaftar atau menghapus file

1358 1401

1359<h4 id="managed-settings-resolved-event">1402<h4 id="managed-settings-resolved-event">

1360 Acara pengaturan terkelola diselesaikan1403 Peristiwa pengaturan yang dikelola diselesaikan

1361</h4>1404</h4>

1362 1405

1363Dicatat dengan [pengaturan terkelola](/docs/id/server-managed-settings) yang diselesaikan sesi: sekali saat startup sesi, lagi saat pengaturan terkelola atau [helper kebijakan](/docs/id/settings-reference#policyhelper) berubah selama sesi, dan saat Claude Code menolak untuk memulai atau mengakhiri sesi untuk salah satu alasan yang tercantum atribut `error.type`.1406Dicatat dengan [pengaturan yang dikelola](/docs/id/managed-settings) yang diselesaikan sesi: sekali pada awal sesi, lagi ketika pengaturan yang dikelola atau [pembantu kebijakan](/docs/id/managed-settings#compute-the-policy-with-a-helper-program) berubah keadaannya selama sesi, dan ketika Claude Code menolak untuk memulai atau mengakhiri sesi untuk salah satu alasan yang tercantum atribut `error.type`.

1364Gunakan acara ini untuk menemukan mesin yang berjalan pada sumber terkelola yang tidak terduga, mesin yang policy helper-nya gagal, dan alasan mesin menolak untuk memulai.1407Gunakan peristiwa ini untuk menemukan mesin yang berjalan pada sumber yang dikelola yang tidak terduga, mesin yang pembantu kebijakan-nya gagal, dan alasan mesin menolak untuk memulai.

1365Memerlukan Claude Code v2.1.274 atau lebih baru.1408Memerlukan Claude Code v2.1.274 atau lebih baru.

1366 1409

1367Secara default, acara membawa sumber terkelola dan status helper kebijakan tetapi bukan pengaturan itu sendiri. Untuk menambahkan atribut `managed_settings.settings` yang diredaksi dan digest `managed_settings.resolved_sha256`, atur `OTEL_LOG_MANAGED_SETTINGS=1`:1410Secara default, peristiwa membawa sumber yang dikelola dan keadaan pembantu kebijakan tetapi bukan pengaturan itu sendiri. Untuk menambahkan atribut `managed_settings.settings` yang disunting dan digest `managed_settings.resolved_sha256`, atur `OTEL_LOG_MANAGED_SETTINGS=1`:

1368 1411

1369* Atur dalam blok `env` pengaturan terkelola, pengaturan pengguna, atau `--settings`, atau dalam lingkungan tempat Anda meluncurkan Claude Code. Nilai dalam pengaturan proyek atau lokal tidak mengaktifkannya, karena repositori yang dikloning dapat menulisnya.1412* Aturnya dalam blok `env` pengaturan yang dikelola, pengaturan pengguna, atau `--settings`, atau dalam lingkungan tempat Anda meluncurkan Claude Code. Nilai dalam pengaturan proyek atau lokal tidak mengaktifkannya, karena repositori yang diklon dapat menulisnya.

1370* Pengaturan terkelola server dapat mengaturnya tanpa menampilkan [dialog persetujuan keamanan](/docs/id/server-managed-settings#security-approval-dialogs), karena variabel hanya menambahkan kebijakan terkelola organisasi Anda sendiri ke acara yang organisasi Anda sudah terima.1413* Pengaturan yang dikelola server dapat menetapkannya tanpa menampilkan [dialog persetujuan keamanan](/docs/id/server-managed-settings#security-approval-dialogs), karena variabel hanya menambahkan kebijakan yang disunting organisasi Anda ke peristiwa yang organisasi Anda sudah terima.

1371 1414

1372Dalam sesi interaktif dalam folder yang belum Anda [percayai](/docs/id/permissions#what-runs-before-you-trust-a-folder), Claude Code tidak mengekspor acara penolakan.1415Dalam sesi interaktif dalam folder yang belum Anda [percayai](/docs/id/permissions#what-runs-before-you-trust-a-folder), Claude Code tidak mengekspor peristiwa penolakan.

1373 1416

1374**Nama Acara**: `claude_code.managed_settings_resolved`1417**Nama Peristiwa**: `claude_code.managed_settings_resolved`

1375 1418

1376**Atribut**:1419**Atribut**:

1377 1420

1378* Semua [atribut standar](#standard-attributes)1421* Semua [atribut standar](#standard-attributes)

1379* `event.name`: `"managed_settings_resolved"`1422* `event.name`: `"managed_settings_resolved"`

1380* `event.timestamp`: Stempel waktu ISO 86011423* `event.timestamp`: Timestamp ISO 8601

1381* `event.sequence`: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah [Atribut korelasi acara](#event-correlation-attributes)1424* `event.sequence`: penghitung per-proses untuk mengurutkan peristiwa, dijelaskan di bawah [Atribut korelasi peristiwa](#event-correlation-attributes)

1382* `managed_settings.trigger`: `"startup"` untuk acara startup sesi, `"change"` saat pengaturan terkelola atau status helper kebijakan berubah nanti dalam sesi, atau `"refused"` saat kebijakan pengaturan terkelola menghentikan sesi. Claude Code mengirim acara `change` hanya saat atribut berbeda dari acara terakhir yang dikirimnya, dan nilai pengaturan yang berubah dihitung bahkan saat `OTEL_LOG_MANAGED_SETTINGS` off1425* `managed_settings.trigger`: `"startup"` untuk peristiwa awal sesi, `"change"` ketika pengaturan yang dikelola atau keadaan pembantu kebijakan berubah nanti dalam sesi, atau `"refused"` ketika kebijakan pengaturan yang dikelola menghentikan sesi. Claude Code mengirim peristiwa `change` hanya ketika atribut berbeda dari peristiwa terakhir yang dikirimnya, dan nilai pengaturan yang berubah dihitung bahkan ketika `OTEL_LOG_MANAGED_SETTINGS` off

1383* `error.type`: mengapa Claude Code menghentikan sesi. Ada hanya pada acara `refused`:1426* `error.type`: mengapa Claude Code menghentikan sesi. Ada hanya pada peristiwa `refused`:

1384 * `"helper_failed"`: [run helper kebijakan gagal](/docs/id/settings-reference#helper-failures)1427 * `"helper_failed"`: [run pembantu kebijakan gagal](/docs/id/settings-reference#helper-failures)

1385 * `"policy_invalid"`: pengaturan terkelola berisi kesalahan yang menghentikan Claude Code dari memulai, atau sumber admin gagal dimuat, jadi Claude Code tidak dapat memeriksa penegakan login organisasi1428 * `"policy_invalid"`: pengaturan yang dikelola berisi kesalahan yang menghentikan Claude Code dari memulai, atau sumber admin gagal dimuat, jadi Claude Code tidak dapat memeriksa penegakan login organisasi

1386 * `"consent_rejected"`: pengguna menolak [dialog persetujuan keamanan](/docs/id/server-managed-settings#security-approval-dialogs) untuk pengaturan terkelola server1429 * `"consent_rejected"`: pengguna menolak [dialog persetujuan keamanan](/docs/id/server-managed-settings#security-approval-dialogs) untuk pengaturan yang dikelola server

1387 * `"force_refresh_failed"`: pengambilan pengaturan yang [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh) perlukan gagal1430 * `"force_refresh_failed"`: pengambilan pengaturan yang [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh) perlukan gagal

1388 * `"gateway_rejected"`: [gateway aplikasi Claude](/docs/id/claude-apps-gateway) menjawab beban pengaturan terkelola dengan HTTP 4031431 * `"gateway_rejected"`: [gateway aplikasi Claude](/docs/id/claude-apps-gateway) menjawab beban pengaturan yang dikelola dengan HTTP 403

1389 * `"version_below_minimum"`: versi Claude Code ini di bawah [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion) atau di atas [`requiredMaximumVersion`](/docs/id/settings-reference#requiredmaximumversion)1432 * `"version_below_minimum"`: versi Claude Code ini di bawah [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion) atau di atas [`requiredMaximumVersion`](/docs/id/settings-reference#requiredmaximumversion)

1390 * `"_OTHER"`: beban pengaturan terkelola gateway aplikasi Claude gagal karena alasan lain1433 * `"_OTHER"`: beban pengaturan yang dikelola gateway aplikasi Claude gagal karena alasan lain

1391* `managed_settings.sources`: setiap sumber terkelola yang memberikan setidaknya satu [kunci kebijakan](/docs/id/managed-settings#how-claude-code-combines-managed-sources), prioritas tertinggi terlebih dahulu, termasuk sumber yang kuncinya tidak berlaku di bawah `first-wins`. Nilai adalah `"remote"`, `"plist"` atau `"hklm"` untuk kebijakan MDM atau tingkat OS, `"file"` untuk file pengaturan terkelola dan drop-in, `"parent"` saat [host embedding](/docs/id/managed-settings#let-an-embedding-host-add-policy) memasok pengaturan, dan `"hkcu"` untuk [nilai registri Windows HKCU](/docs/id/managed-settings#where-each-mechanism-stores-the-policy) saat Claude Code [membacanya](/docs/id/managed-settings#how-claude-code-combines-managed-sources). Sumber yang hanya membawa kunci kontrol, atau yang Claude Code tidak dapat dibaca, tidak tercantum. Dipancarkan sebagai array string, kosong saat tidak ada sumber terkelola yang memberikan kunci kebijakan1434* `managed_settings.sources`: setiap sumber yang dikelola yang memberikan setidaknya satu [kunci kebijakan](/docs/id/managed-settings#how-claude-code-combines-managed-sources), prioritas tertinggi terlebih dahulu, termasuk sumber yang kuncinya tidak berlaku di bawah `first-wins`. Nilai adalah `"remote"`, `"plist"` atau `"hklm"` untuk kebijakan MDM atau tingkat OS, `"file"` untuk file pengaturan yang dikelola dan drop-in, `"parent"` ketika [host embedding](/docs/id/managed-settings#let-an-embedding-host-add-policy) memasok pengaturan, dan `"hkcu"` untuk [nilai registri Windows HKCU](/docs/id/managed-settings#where-each-mechanism-stores-the-policy) ketika Claude Code [membacanya](/docs/id/managed-settings#how-claude-code-combines-managed-sources). Sumber yang hanya membawa kunci kontrol, atau yang tidak dapat dibaca Claude Code, tidak terdaftar. Dipancarkan sebagai array string, kosong ketika tidak ada sumber yang dikelola memberikan kunci kebijakan

1392* `managed_settings.source_behavior`: nilai [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) yang dibaca Claude Code, `"first-wins"` atau `"merge"`. `"first-wins"` saat tidak ada sumber yang menetapkan kunci1435* `managed_settings.source_behavior`: nilai [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) yang dibaca Claude Code, `"first-wins"` atau `"merge"`. `"first-wins"` ketika tidak ada sumber yang menetapkan kunci

1393* `managed_settings.helper.state`: status helper kebijakan yang dikonfigurasi sumber MDM atau file yang dipilih:1436* `managed_settings.helper.state`: keadaan pembantu kebijakan yang sumber MDM atau file yang dipilih konfigurasi:

1394 * `"ok"`: output helper melayani sebagai pengaturan terkelola1437 * `"ok"`: output pembantu berfungsi sebagai pengaturan yang dikelola

1395 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"`, atau `"schema_rejected"`: run terakhir helper gagal. [Helper failures](/docs/id/settings-reference#helper-failures) menjelaskan kasus-kasusnya1438 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"`, atau `"schema_rejected"`: run terakhir pembantu gagal. [Kegagalan pembantu](/docs/id/settings-reference#helper-failures) menjelaskan kasus

1396 * `"none"`: tidak ada helper yang dikonfigurasi, atau sumber yang mengonfigurasinya bukan kebijakan MDM atau file pengaturan terkelola1439 * `"none"`: tidak ada pembantu yang dikonfigurasi, atau sumber yang mengonfigurasinya bukan kebijakan MDM atau file pengaturan yang dikelola

1397* `managed_settings.helper.applied`: `"output"` saat output helper sendiri melayani sebagai pengaturan terkelola, `"none"` saat tidak1440* `managed_settings.helper.applied`: `"output"` sementara output pembantu itu sendiri berfungsi sebagai pengaturan yang dikelola, `"none"` ketika tidak

1398* `managed_settings.helper.entry`: `"policyHelper"` saat Claude Code memilih [`policyHelper`](/docs/id/settings-reference#policyhelper). Tidak ada saat memilih tidak ada helper1441* `managed_settings.helper.entry`: `"policyHelper"` ketika Claude Code memilih [`policyHelper`](/docs/id/settings-reference#policyhelper). Tidak ada ketika tidak memilih pembantu

1399* `managed_settings.helper.path`: [`path`](/docs/id/settings-reference#policyhelper-path) yang dikonfigurasi helper. Ada kapan pun Claude Code memilih helper, apakah atau tidak `OTEL_LOG_MANAGED_SETTINGS` diatur1442* `managed_settings.helper.path`: [`path`](/docs/id/settings-reference#policyhelper-path) yang dikonfigurasi pembantu. Ada kapan pun Claude Code memilih pembantu, apakah atau tidak `OTEL_LOG_MANAGED_SETTINGS` diatur

1400* `managed_settings.resolved_sha256` (saat `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 dari pengaturan terkelola yang diselesaikan sebelum redaksi, diserialisasi sebagai JSON dengan kunci diurutkan secara rekursif dan tanpa whitespace. Mesin dengan digest yang sama menjalankan kebijakan yang sama. Claude Code mengirim digest hanya dengan opt-in karena kebijakan pendek dapat dipulihkan dengan menghash tebakan. Tidak ada saat tidak ada pengaturan terkelola yang diselesaikan, dan pada acara `refused`1443* `managed_settings.resolved_sha256` (ketika `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 dari pengaturan yang dikelola yang diselesaikan sebelum penyuntingan, diserialisasi sebagai JSON dengan kunci yang diurutkan secara rekursif dan tanpa spasi. Mesin dengan digest yang sama menjalankan kebijakan yang sama. Claude Code mengirim digest hanya dengan opt-in karena kebijakan pendek dapat dipulihkan dengan menghash tebakan. Tidak ada ketika tidak ada pengaturan yang dikelola yang diselesaikan, dan pada peristiwa `refused`

1401* `managed_settings.settings` (saat `OTEL_LOG_MANAGED_SETTINGS=1`): nama dan bentuk pengaturan terkelola yang diselesaikan sebagai string JSON, dengan nilai diredaksi. Tidak ada pada acara `refused`. Claude Code membangunnya dari skema pengaturannya:1444* `managed_settings.settings` (ketika `OTEL_LOG_MANAGED_SETTINGS=1`): nama dan bentuk pengaturan yang dikelola yang diselesaikan sebagai string JSON, dengan nilai yang disunting. Tidak ada pada peristiwa `refused`. Claude Code membangunnya dari skema pengaturannya:

1402 1445

1403 * Nama pengaturan yang skema deklarasikan diekspor, dan kunci yang tidak dideklarasikan ditinggalkan1446 * Nama pengaturan yang skema deklarasikan diekspor, dan kunci yang tidak dideklarasikan ditinggalkan

1404 * Boolean, angka, dan nilai string yang skema batasi ke set opsi tetap, seperti `permissions.defaultMode`, diekspor apa adanya. `sandbox.network.httpProxyPort` dan `sandbox.network.socksProxyPort` diekspor sebagai `"[REDACTED]"`1447 * Boolean, angka, dan nilai string yang skema batasi ke set opsi tetap, seperti `permissions.defaultMode`, diekspor apa adanya. `sandbox.network.httpProxyPort` dan `sandbox.network.socksProxyPort` diekspor sebagai `"[REDACTED]"`

1405 * Setiap string lainnya, seperti `model`, `apiKeyHelper`, setiap nilai `env`, setiap URL, dan setiap perintah, diekspor sebagai `"[REDACTED]"`1448 * Setiap string lainnya, seperti `model`, `apiKeyHelper`, setiap nilai `env`, setiap URL, dan setiap perintah, diekspor sebagai `"[REDACTED]"`

1406 * Nama entri peta, seperti nama variabel `env` dan ID plugin, diekspor apa adanya. Pengaturan yang entri-nya skema tidak ketik, seperti `vimInsertModeRemaps`, diekspor sebagai `"[REDACTED]"` tunggal, dan `sandbox.ignoreViolations` diekspor sebagai daftar daftar jalurnya tanpa pola perintah1449 * Nama entri peta, seperti nama variabel `env` dan ID plugin, diekspor apa adanya. Pengaturan yang entri-nya skema tidak ketik, seperti `vimInsertModeRemaps`, diekspor sebagai `"[REDACTED]"` tunggal, dan `sandbox.ignoreViolations` diekspor sebagai daftar daftar path-nya tanpa pola perintah

1407 * Daftar menyimpan panjangnya, dengan setiap entri diredaksi oleh aturan yang sama1450 * Daftar menyimpan panjangnya, dengan setiap entri disunting oleh aturan yang sama

1408 * Aturan `permissions.allow`, `permissions.deny`, atau `permissions.ask` diekspor sebagai nama alatnya dengan konten diredaksi, seperti `Read([REDACTED])`, saat alat built-in ke versi Claude Code ini atau referensi `mcp__` seperti `mcp__jira__create_issue`. Aturan lainnya diekspor sebagai `"[REDACTED]"`1451 * Aturan `permissions.allow`, `permissions.deny`, atau `permissions.ask` diekspor sebagai nama alat-nya dengan konten yang disunting, seperti `Read([REDACTED])`, ketika alat dibangun ke versi Claude Code ini atau merupakan referensi `mcp__` seperti `mcp__jira__create_issue`. Aturan lainnya diekspor sebagai `"[REDACTED]"`

1409 * Hooks mengikuti aturan yang sama, jadi bidang opsi tetap dan numerik seperti `type` dan `timeout` menunjukkan, sementara setiap perintah, URL, `matcher`, dan kondisi `if` diekspor sebagai `"[REDACTED]"`1452 * Hook mengikuti aturan yang sama, jadi bidang opsi tetap dan numerik seperti `type` dan `timeout` menunjukkan, sementara setiap perintah, URL, `matcher`, dan kondisi `if` diekspor sebagai `"[REDACTED]"`

1410 1453

1411 Misalnya, pengaturan terkelola dengan `apiKeyHelper`, dua variabel `env`, dan aturan tolak diekspor sebagai `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.1454 Misalnya, pengaturan yang dikelola dengan `apiKeyHelper`, dua variabel `env`, dan aturan tolak diekspor sebagai `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1412 1455

1413 Claude Code memotong nilai pada 8 KB UTF-8, dan nilai yang dipotong bukan JSON yang valid1456 Claude Code memotong nilai pada 8 KB UTF-8, dan nilai yang dipotong bukan JSON yang valid

1414* `managed_settings.settings_truncated` (saat `managed_settings.settings` ada): `true` saat Claude Code memotong `managed_settings.settings` pada 8 KB, `false` sebaliknya. Dipancarkan sebagai boolean, bukan string1457* `managed_settings.settings_truncated` (ketika `managed_settings.settings` ada): `true` ketika Claude Code memotong `managed_settings.settings` pada 8 KB, `false` sebaliknya. Dipancarkan sebagai boolean, bukan string

1415 1458

1416<h2 id="interpret-metrics-and-events-data">1459<h2 id="interpret-metrics-and-events-data">

1417 Menafsirkan data metrik dan acara1460 Menafsirkan data metrik dan acara

1499 1542

1500[Atribut standar](#standard-attributes) pada setiap acara mencakup identitas pengguna yang diautentikasi: `user.email`, `user.account_uuid`, `user.account_id`, dan `organization.id` saat masuk dengan akun Claude atau, dalam [sesi cloud](/docs/id/claude-code-on-the-web), ketika kredensial sesi itu sendiri membawanya, ditambah `user.id` dan `session.id` per-sesi. `user.id` adalah pengidentifikasi berskop instalasi, kecuali pada sesi [Claude apps gateway](/docs/id/claude-apps-gateway), di mana ini adalah subjek IdP dari token yang dikeluarkan gateway.1543[Atribut standar](#standard-attributes) pada setiap acara mencakup identitas pengguna yang diautentikasi: `user.email`, `user.account_uuid`, `user.account_id`, dan `organization.id` saat masuk dengan akun Claude atau, dalam [sesi cloud](/docs/id/claude-code-on-the-web), ketika kredensial sesi itu sendiri membawanya, ditambah `user.id` dan `session.id` per-sesi. `user.id` adalah pengidentifikasi berskop instalasi, kecuali pada sesi [Claude apps gateway](/docs/id/claude-apps-gateway), di mana ini adalah subjek IdP dari token yang dikeluarkan gateway.

1501 1544

1502Panggilan alat MCP, perintah Bash, dan pengeditan file oleh karena itu dikaitkan dengan pengembang yang memulai sesi. Claude Code tidak bertindak di bawah akun layanan terpisah; identitas yang dicatat pada setiap acara adalah akun Claude pengembang itu sendiri, atau identitas IdP pengembang pada sesi [Claude apps gateway](/docs/id/claude-apps-gateway).1545Dalam sesi yang dimulai pengembang, panggilan alat MCP, perintah Bash, dan pengeditan file oleh karena itu dikaitkan dengan pengembang tersebut. Claude Code tidak bertindak di bawah akun layanan terpisah di sana; identitas yang dicatat pada setiap acara adalah akun Claude pengembang itu sendiri, atau identitas IdP pengembang pada sesi [Claude apps gateway](/docs/id/claude-apps-gateway). Dalam sesi saluran Claude Tag, Claude bekerja sebagai [identitas bersama](/docs/id/cloud-environments#set-the-environment-a-claude-tag-channel-uses) organisasi Anda.

1503 1546

1504Saat Claude Code diautentikasi dengan kunci API langsung, atau terhadap Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, tidak ada akun Claude dalam sesi dan hanya `user.id` dan `session.id` yang diisi. Dalam penerapan ini, lampirkan identitas pengguna sendiri dengan `OTEL_RESOURCE_ATTRIBUTES`, atur per pengguna melalui file [pengaturan terkelola](#administrator-configuration) atau pembungkus peluncuran. Sesi Claude apps gateway tidak memerlukan apa pun dari ini: CLI mencap identitas IdP secara otomatis, seperti yang dijelaskan dalam [Atribut standar](#standard-attributes).1547Saat Claude Code diautentikasi dengan kunci API langsung, atau terhadap Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, tidak ada akun Claude dalam sesi dan hanya `user.id` dan `session.id` yang diisi. Dalam penerapan ini, lampirkan identitas pengguna sendiri dengan `OTEL_RESOURCE_ATTRIBUTES`, atur per pengguna melalui file [pengaturan terkelola](#administrator-configuration) atau pembungkus peluncuran. Sesi Claude apps gateway tidak memerlukan apa pun dari ini: CLI mencap identitas IdP secara otomatis, seperti yang dijelaskan dalam [Atribut standar](#standard-attributes).

1505 1548

1563}1606}

1564```1607```

1565 1608

1566Untuk mengonfirmasi acara tiba, kirimkan prompt dalam sesi yang berjalan di bawah konfigurasi ini dan periksa SIEM Anda untuk acara `claude_code.user_prompt`. Jika tidak ada yang tiba, jalankan `claude --debug` dan periksa log debug untuk kesalahan ekspor `[3P telemetry]`.1609Untuk mengonfirmasi acara tiba, kirimkan prompt dalam sesi yang berjalan di bawah konfigurasi ini dan periksa SIEM Anda untuk acara `claude_code.user_prompt`. Jika tidak ada yang tiba, jalankan Claude Code dengan `claude --debug-file <path>` dan periksa log itu untuk kesalahan ekspor `[3P telemetry]`.

1567 1610

1568<h2 id="backend-considerations">1611<h2 id="backend-considerations">

1569 Pertimbangan backend1612 Pertimbangan backend

1633 * Acara `tool_result` dan `tool_decision` menyertakan atribut `tool_parameters` dengan perintah Bash, nama server MCP dan alat, dan nama skill. Bidang seperti `full_command` dipancarkan tanpa pemotongan1676 * Acara `tool_result` dan `tool_decision` menyertakan atribut `tool_parameters` dengan perintah Bash, nama server MCP dan alat, dan nama skill. Bidang seperti `full_command` dipancarkan tanpa pemotongan

1634 * Acara `tool_result` juga menyertakan atribut `tool_input` dengan jalur file, URL, pola pencarian, dan argumen lainnya. Nilai individual di atas 512 karakter dipotong dan total dibatasi hingga \~4 K karakter1677 * Acara `tool_result` juga menyertakan atribut `tool_input` dengan jalur file, URL, pola pencarian, dan argumen lainnya. Nilai individual di atas 512 karakter dipotong dan total dibatasi hingga \~4 K karakter

1635 * Acara `user_prompt` menyertakan `command_name` verbatim untuk perintah custom, plugin, dan MCP1678 * Acara `user_prompt` menyertakan `command_name` verbatim untuk perintah custom, plugin, dan MCP

1679 * [Penghitung biaya dan token](#cost-counter) dan acara `api_request`, `api_error`, dan `api_refusal` membawa nama agen, skill, plugin, dan server MCP dan alat yang sebenarnya dalam atribut atribusi mereka

1636 * Trace spans menyertakan atribut `tool_input` yang sama dan atribut yang diturunkan dari input seperti `file_path`, dengan pemotongan yang sama dengan `tool_input`1680 * Trace spans menyertakan atribut `tool_input` yang sama dan atribut yang diturunkan dari input seperti `file_path`, dengan pemotongan yang sama dengan `tool_input`

1637* Konten alat tidak dicatat dalam trace spans secara default. Untuk menyertakannya, atur `OTEL_LOG_TOOL_CONTENT=1`. Span `claude_code.tool` kemudian membawa acara span [`tool.output`](#tool-output-span-event) dengan konten file mentah dan output perintah Bash, dipotong pada batas konten (60 KB secara default) per atribut. Konten alat juga menjangkau spans melalui [`new_context`, yang gatenya berbeda per span](#new-context-gates). Konfigurasikan backend telemetri Anda untuk memfilter atau menyunting atribut ini sesuai kebutuhan1681* Konten alat tidak dicatat dalam trace spans secara default. Untuk menyertakannya, atur `OTEL_LOG_TOOL_CONTENT=1`. Span `claude_code.tool` kemudian membawa acara span [`tool.output`](#tool-output-span-event) dengan konten file mentah, output perintah Bash, dan apa yang dikembalikan alat MCP, WebFetch, dan WebSearch, dipotong pada batas konten (60 KB secara default) per atribut. Hasil dari alat MCP, WebFetch, dan WebSearch memerlukan Claude Code v2.1.283 atau lebih baru. Konten alat juga menjangkau spans melalui [`new_context`, yang gatenya berbeda per span](#new-context-gates). Konfigurasikan backend telemetri Anda untuk memfilter atau menyunting atribut ini sesuai kebutuhan

1638* Badan permintaan dan respons API Anthropic Messages mentah tidak dicatat secara default. Untuk menyertakannya, atur `OTEL_LOG_RAW_API_BODIES` di shell, pengaturan pengguna, atau pengaturan terkelola Anda. Ini diabaikan dalam [pengaturan proyek dan lokal](/docs/id/settings-reference#variables-claude-code-ignores-in-env). Badan berisi riwayat percakapan lengkap, termasuk system prompt, setiap giliran pengguna dan asisten sebelumnya, dan hasil alat, jadi mengaktifkan ini menyiratkan persetujuan untuk semua yang akan diungkapkan oleh flag konten `OTEL_LOG_*` lainnya. Claude Code selalu menyunting konten extended-thinking Claude dari badan ini, terlepas dari pengaturan lain. Nilai yang Anda atur menentukan bagaimana Claude Code mengirimkan badan:1682* Badan permintaan dan respons API Anthropic Messages mentah tidak dicatat secara default. Untuk menyertakannya, atur `OTEL_LOG_RAW_API_BODIES` di shell, pengaturan pengguna, atau pengaturan terkelola Anda. Ini diabaikan dalam [pengaturan proyek dan lokal](/docs/id/settings-reference#variables-claude-code-ignores-in-env). Badan berisi riwayat percakapan lengkap, termasuk system prompt, setiap giliran pengguna dan asisten sebelumnya, dan hasil alat, jadi mengaktifkan ini menyiratkan persetujuan untuk semua yang akan diungkapkan oleh flag konten `OTEL_LOG_*` lainnya. Claude Code selalu menyunting konten extended-thinking Claude dari badan ini, terlepas dari pengaturan lain. Nilai yang Anda atur menentukan bagaimana Claude Code mengirimkan badan:

1639 * Dengan `=1`, Claude Code memancarkan acara log `api_request_body` dan `api_response_body` untuk setiap panggilan API. Atribut `body` acara membawa muatan yang diserialisasi JSON, dipotong pada batas konten (60 KB secara default)1683 * Dengan `=1`, Claude Code memancarkan acara log `api_request_body` dan `api_response_body` untuk setiap panggilan API. Atribut `body` acara membawa muatan yang diserialisasi JSON, dipotong pada batas konten (60 KB secara default)

1640 * Dengan `=file:<dir>`, Claude Code menulis badan yang tidak dipotong ke file `.request.json` dan `.response.json` di bawah direktori tersebut, dan acara membawa jalur `body_ref` sebagai gantinya dari badan inline. Kirim direktori dengan pengumpul log atau sidecar daripada melalui aliran telemetri.1684 * Dengan `=file:<dir>`, Claude Code menulis badan yang tidak dipotong ke file `.request.json` dan `.response.json` di bawah direktori tersebut, dan acara membawa jalur `body_ref` sebagai gantinya dari badan inline. Kirim direktori dengan pengumpul log atau sidecar daripada melalui aliran telemetri.

monitoring-usage.md 2026-09-28 22:59 UTC to 2026-09-29 21:59 UTC

Pemantauan

Mulai cepat

Konfigurasi administrator

Bagaimana pengaturan terkelola mengunci tujuan OTLP

Detail konfigurasi

Variabel konfigurasi umum

Autentikasi mTLS

Kontrol kardinalitas metrik

Traces (beta)

Hierarki span

Atribut span

Header dinamis

Konfigurasi pengaturan

Persyaratan skrip

Perilaku penyegaran

Dukungan organisasi multi-tim

Konfigurasi contoh

Telemetri dari sesi cloud dan Claude Tag

Atribut telemetri ke sesi cloud

Metrik dan peristiwa yang tersedia

Atribut standar

Atribut repositori

Metrik

Detail metrik

Penghitung sesi

Penghitung baris kode

Penghitung pull request

Penghitung commit

Penghitung biaya

Penghitung token

Penghitung keputusan alat pengedit kode

Penghitung waktu aktif

Peristiwa

Atribut korelasi peristiwa

Peristiwa prompt pengguna

Peristiwa respons asisten

Peristiwa hasil alat

Peristiwa permintaan API

Peristiwa kesalahan API

Peristiwa penolakan API

Peristiwa badan permintaan API

Peristiwa badan respons API

Peristiwa keputusan alat

Peristiwa mode izin berubah

Peristiwa auth

Peristiwa koneksi server MCP

Peristiwa kesalahan internal

Peristiwa plugin diinstal

Peristiwa plugin dimuat

Peristiwa skill diaktifkan

Peristiwa penyebutan @

Peristiwa pengulangan API habis

Peristiwa hook terdaftar

Peristiwa awal eksekusi hook

Peristiwa lengkap eksekusi hook

Peristiwa metrik plugin hook

Peristiwa pemadatan

Peristiwa subagen selesai

Peristiwa survei umpan balik

Peristiwa sapuan retensi

Peristiwa pengaturan yang dikelola diselesaikan

Menafsirkan data metrik dan acara

Pemantauan penggunaan

Pemantauan biaya

Peringatan dan segmentasi

Deteksi kelelahan retry

Analisis acara

Audit acara keamanan

Atribut tindakan untuk pengguna

Audit aktivitas MCP

Peta pertanyaan keamanan ke acara

Kirim acara ke SIEM

Pertimbangan backend

Untuk metrik

Untuk acara/log

Untuk traces

Informasi layanan

Sumber daya pengukuran ROI

Keamanan dan privasi