Header dinamis

Untuk 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.

Konfigurasi pengaturan

Tambahkan ke .claude/settings.json Anda, mengganti 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: Header ganda
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

Jika 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:

• Notifikasi peringatan dalam sesi interaktif, otelHeadersHelper failed; telemetry is not being exported, ditampilkan sekali per sesi saat pembantu 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 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.

Dukungan organisasi multi-tim

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

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

Atribut khusus ini akan disertakan dalam semua metrik dan acara, memungkinkan Anda untuk:

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

Claude 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, kunci khusus tidak pernah menimpa atribut standar seperti user.id atau session.id: saat kunci bertabrakan, Claude Code mempertahankan nilai built-in.

Setiap 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.

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 hanya-log dan apa yang harus diperiksa saat 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 over 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, di-scrape dari http://localhost:9464/metrics:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

Pada lingkungan self-hosted, 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.

Untuk mengirim metrik ke beberapa pengekspor:

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 titik akhir 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 hanya metrik, tanpa acara 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 hanya acara dan log, 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

Metrik dan acara yang tersedia

Atribut standar

Semua metrik dan acara berbagi atribut standar ini:

Saat Claude Code masuk ke gateway aplikasi Claude, 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.

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

• prompt.id: UUID yang menghubungkan prompt pengguna dengan semua acara berikutnya hingga prompt berikutnya. Lihat Atribut korelasi acara.
• workspace.host_paths: direktori ruang kerja host yang dipilih di aplikasi desktop, sebagai array string
• workflow.run_id: pengidentifikasi run, dengan awalan wf_, pada acara API dan alat yang dipancarkan oleh agen yang termasuk dalam run alat Workflow. 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 baru
• 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 baru

Atribut repositori

Atur 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.

Claude Code menurunkan atribut ini sekali per sesi dari remote origin repositori. Remote HTTPS dan SSH dari satu repositori menghasilkan nilai yang identik:

Nilai 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.

Kunci vcs.* yang Anda deklarasikan dalam OTEL_RESOURCE_ATTRIBUTES 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.

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

Metrik

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

Saat 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.

Detail metrik

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

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, antarmuka lokal yang diluncurkan pengguna daripada sesi percakapan. Filter pada nilai ini untuk memisahkan peluncuran proses UI dari sesi percakapan di dasbor Anda.

Penghitung baris kode

Ditingkatkan saat kode ditambahkan atau dihapus.

Atribut:

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

Penghitung permintaan tarik

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

Atribut:

• Semua atribut standar

Penghitung komit

Ditingkatkan saat membuat komit git melalui Claude Code.

Atribut:

• Semua atribut standar

Penghitung biaya

Ditingkatkan setelah setiap permintaan API.

Atribut:

• Semua atribut standar
• model: Pengidentifikasi model (misalnya, "claude-sonnet-5")
• query_source: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari "main", "subagent", atau "auxiliary"
• speed: "fast" saat permintaan menggunakan mode cepat. Tidak ada sebaliknya
• effort: Tingkat effort yang diterapkan pada permintaan: "low", "medium", "high", "xhigh", atau "max". Tidak ada saat model tidak mendukung effort.
• 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". Tidak ada saat permintaan tidak dikeluarkan oleh jenis subagent bernama.
• 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". Tidak ada saat tidak ada skill yang aktif.
• 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". Tidak ada saat skill atau subagent tidak memiliki plugin pemilik.
• marketplace.name: Marketplace tempat plugin pemilik diinstal. Hanya dipancarkan untuk plugin marketplace resmi. Tidak ada sebaliknya.
• 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". 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.
• 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.

Penghitung token

Ditingkatkan setelah setiap permintaan API.

Atribut:

• Semua atribut standar
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Pengidentifikasi model (misalnya, "claude-sonnet-5")
• query_source: Kategori subsistem yang mengeluarkan permintaan. Salah satu dari "main", "subagent", atau "auxiliary"
• speed: "fast" saat permintaan menggunakan mode cepat. Tidak ada sebaliknya
• effort: Tingkat effort 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 redaksi.

Penghitung keputusan alat pengeditan kode

Ditingkatkan saat 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: Sumber keputusan. Salah satu dari "config", "hook", "user_permanent", "user_temporary", "user_abort", atau "user_reject". Lihat Acara keputusan alat untuk mengetahui 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 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.

Atribut:

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

Acara

Claude Code mengekspor acara berikut melalui log/acara OpenTelemetry (saat OTEL_LOGS_EXPORTER dikonfigurasi):

Atribut korelasi acara

Saat 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.

Untuk 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.

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, 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.

Untuk rekonstruksi tingkat pesan, setiap kelas acara membawa kunci yang cocok dengan bidang dalam transkrip sesi. Format entri transkrip adalah internal untuk 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 acara API, disimpan sebagai requestId pada entri asisten transkrip
• tool_use_id pada acara tool_result dan tool_decision

Acara prompt pengguna

Dicatat saat pengguna mengirimkan prompt.

Nama Acara: claude_code.user_prompt

Atribut:

• Semua atribut standar
• event.name: "user_prompt"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• prompt_length: Panjang prompt
• prompt: Konten prompt. Diredaksi 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 command dispatches, yang dapat menghasilkan nol atau banyak pesan. Memerlukan Claude Code v2.1.214 atau lebih baru
• 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 diatur
• command_source: Asal perintah saat ada: builtin, custom, atau mcp. Perintah yang disediakan plugin melaporkan sebagai custom

Acara respons asisten

Dicatat 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.

Nama Acara: claude_code.assistant_response

Atribut:

• Semua atribut standar
• event.name: "assistant_response"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• response_length: Panjang teks respons dalam karakter
• 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 aktif
• model: Pengidentifikasi model (misalnya, "claude-sonnet-5")
• request_id: ID permintaan API Anthropic dari header request-id respons. Hadir hanya saat API mengembalikan satu
• 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 baru
• query_source: Subsistem yang mengeluarkan permintaan, seperti "repl_main_thread", "compact", atau nama subagent

Acara hasil alat

Dicatat saat alat menyelesaikan eksekusi. Tidak dipancarkan jika panggilan alat ditolak; lihat Acara keputusan alat untuk penolakan.

Nama Acara: claude_code.tool_result

Atribut:

• Semua atribut standar
• event.name: "tool_result"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• tool_name: Nama alat
• 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.
• success: "true" atau "false"
• duration_ms: Waktu eksekusi dalam milidetik
• error_type: String kategori kesalahan saat alat gagal, seperti "Error:ENOENT" atau "ShellError"
• error (saat OTEL_LOG_TOOL_DETAILS=1): Pesan kesalahan lengkap saat alat gagal
• decision_type: Selalu "accept", karena acara ini hanya dipancarkan setelah alat berjalan. Panggilan yang ditolak tidak menghasilkan hasil alat
• decision_source: Sumber keputusan izin. Salah satu dari "config", "hook", "user_permanent", atau "user_temporary". Lihat Acara keputusan alat untuk mengetahui apa arti setiap nilai. Sumber hanya-tolak "user_abort" dan "user_reject" tidak pernah muncul pada acara 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: Pengidentifikasi cakupan server MCP (untuk alat MCP)
• 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 baru
• 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, memerlukan Claude Code v2.1.214 atau lebih baru. Parameter bervariasi menurut alat:
  • 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 terlepas
  • Untuk alat Bash ruang kerja aplikasi desktop, yang juga melaporkan tool_name sebagai Bash: mencakup hanya bash_command, full_command, dan timeout
  • Untuk alat MCP: mencakup mcp_server_name, mcp_tool_name
  • Untuk alat Skill: mencakup skill_name
  • Untuk alat Agent atau alat Task legacy: mencakup subagent_type
• 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.

Acara permintaan API

Dicatat untuk setiap permintaan API ke Claude.

Nama Acara: claude_code.api_request

Atribut:

• Semua atribut standar
• event.name: "api_request"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 Anthropic dari header request-id respons, seperti "req_011...". Hadir hanya saat API mengembalikan satu.
• client_request_id: UUID yang dihasilkan klien dikirim sebagai header permintaan x-client-request-id; lihat tabel atribut korelasi acara untuk kapan itu 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 subagent
• effort: Tingkat effort yang diterapkan pada permintaan: "low", "medium", "high", "xhigh", atau "max". Tidak ada saat model tidak mendukung effort.
• 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 redaksi.

Acara kesalahan API

Dicatat saat permintaan API ke Claude gagal.

Nama Acara: claude_code.api_error

Atribut:

• Semua atribut standar
• event.name: "api_error"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 retry yang terjadi)
• request_id: ID permintaan API Anthropic dari header request-id respons, seperti "req_011...". Hadir hanya saat API mengembalikan satu.
• 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 untuk kapan itu 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 subagent
• effort: Tingkat effort yang diterapkan pada permintaan. Tidak ada saat model tidak mendukung effort.
• 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 redaksi.

Acara penolakan API

Dicatat 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.

Nama Acara: claude_code.api_refusal

Atribut:

• Semua atribut standar
• event.name: "api_refusal"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• model: Pengidentifikasi model dari permintaan
• request_id: ID permintaan API Anthropic dari header request-id respons, seperti "req_011...". Hadir hanya saat API mengembalikan satu.
• query_source: Subsistem yang mengeluarkan permintaan, seperti "repl_main_thread", "compact", atau nama subagent. Lihat api_request untuk definisi.
• speed: Baik "fast" saat Mode cepat aktif, atau "normal"
• attempt: Nomor upaya retry. Upaya pertama adalah 1.
• effort: Tingkat effort yang diterapkan pada permintaan. Tidak ada saat model tidak mendukung effort.
• 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.
• 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.
• has_explanation: true saat respons API membawa stop_details.explanation, sebaliknya false. Tidak ada saat 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 saat 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 redaksi.

Acara badan permintaan API

Dicatat 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.

Nama Acara: claude_code.api_request_body

Atribut:

• Semua atribut standar
• event.name: "api_request_body"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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).
• 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>).
• 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
• body_truncated: "true" saat pemotongan inline terjadi. Tidak ada dalam mode file dan saat tidak ada pemotongan yang terjadi.
• model: Pengidentifikasi model dari parameter permintaan
• query_source: Subsistem yang mengeluarkan permintaan (misalnya, "compact")
• request_body_id: UUID yang mengidentifikasi badan permintaan upaya ini. Acara api_response_body 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 baru

Acara badan respons API

Dicatat untuk setiap respons API yang berhasil saat 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 Acara: claude_code.api_response_body

Atribut:

• Semua atribut standar
• event.name: "api_response_body"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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).
• 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>).
• 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
• body_truncated: "true" saat pemotongan inline terjadi. Tidak ada dalam mode file dan saat tidak ada pemotongan yang terjadi.
• model: Pengidentifikasi model
• query_source: Subsistem yang mengeluarkan permintaan
• request_id: ID permintaan API Anthropic dari header request-id respons, seperti "req_011...". Hadir hanya saat API mengembalikan satu.
• request_body_id: request_body_id dari acara api_request_body yang dijawab respons ini. Memerlukan Claude Code v2.1.274 atau lebih baru
• message.id: ID pesan yang ditetapkan API ke 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, itu menghubungkan pesan transkrip ke badan permintaan dan respons di baliknya. Memerlukan Claude Code v2.1.274 atau lebih baru

Acara keputusan alat

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

Nama Acara: claude_code.tool_decision

Atribut:

• Semua atribut standar
• event.name: "tool_decision"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• tool_name: Nama alat (misalnya, "Read", "Edit", "Write", "NotebookEdit")
• 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.
• decision: Baik "accept" atau "reject"
• tool_source: Selalu ada. Provenance alat, sebagai set nilai yang ditulis CLI tertutup. Memerlukan Claude Code v2.1.214 atau lebih baru
  • "builtin": alat CLI sendiri
  • "mcp": server MCP secara umum
  • "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"
• source: Sumber keputusan:
  • "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 Agent SDK atau alat --permission-prompt-tool 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".
  • "hook": Hook PreToolUse atau PermissionRequest mengembalikan keputusan.
  • "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.
  • "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.
  • "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.
  • "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.
• tool_parameters (saat OTEL_LOG_TOOL_DETAILS=1): String JSON yang berisi parameter khusus alat. Bentuk yang sama dengan Acara hasil alat, 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".
  • 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 baru
  • 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
  • Untuk alat MCP: mencakup mcp_server_name, mcp_tool_name
  • Untuk alat Skill: mencakup skill_name
  • Untuk alat Agent atau alat Task legacy: mencakup subagent_type

Acara mode izin berubah

Dicatat saat mode izin berubah, misalnya dari siklus Shift+Tab, keluar dari plan mode, atau pemeriksaan gate mode otomatis.

Nama Acara: claude_code.permission_mode_changed

Atribut:

• Semua atribut standar
• event.name: "permission_mode_changed"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 saat transisi berasal dari SDK atau bridge

Acara auth

Dicatat saat /login atau /logout selesai.

Nama Acara: claude_code.auth

Atribut:

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

Acara koneksi server MCP

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

Nama Acara: claude_code.mcp_server_connection

Atribut:

• Semua atribut standar
• event.name: "mcp_server_connection"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 saat koneksi gagal
• is_plugin: true saat server disediakan oleh plugin, false sebaliknya
• 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.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 Anthropic
• server_name (saat OTEL_LOG_TOOL_DETAILS=1): Nama server yang dikonfigurasi
• error (saat OTEL_LOG_TOOL_DETAILS=1): Pesan kesalahan lengkap saat koneksi gagal

Acara kesalahan internal

Dicatat 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.

Nama Acara: claude_code.internal_error

Atribut:

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

Acara plugin terinstal

Dicatat saat plugin selesai menginstal, dari perintah CLI claude plugin install dan UI interaktif /plugin.

Nama Acara: claude_code.plugin_installed

Atribut:

• Semua atribut standar
• event.name: "plugin_installed"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 saat OTEL_LOG_TOOL_DETAILS=1
• plugin.version: Versi plugin saat dideklarasikan dalam entri marketplace. Untuk marketplace pihak ketiga ini disertakan hanya saat OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: Marketplace plugin diinstal dari. Untuk marketplace pihak ketiga ini disertakan hanya saat OTEL_LOG_TOOL_DETAILS=1

Acara plugin dimuat

Dicatat 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.

Nama Acara: claude_code.plugin_loaded

Atribut:

• Semua atribut standar
• event.name: "plugin_loaded"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• plugin.name: nama plugin. Untuk plugin di luar marketplace resmi dan bundel built-in nilainya adalah "third-party" kecuali OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: marketplace tempat plugin diinstal, saat diketahui. Diredaksi menjadi "third-party" di bawah kondisi yang sama dengan plugin.name
• plugin.version: versi dari manifest plugin. Disertakan hanya saat nama tidak diredaksi dan manifest mendeklarasikan versi
• plugin.scope: kategori provenance 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 sebagai required atau auto-install untuk organisasi Anda di Pengaturan Organisasi > Plugins. 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 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, 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 hash
• has_hooks: apakah plugin berkontribusi hooks
• has_mcp: apakah plugin berkontribusi server MCP
• 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 baru
• skill_path_count: jumlah direktori skill yang dideklarasikan plugin
• command_path_count: jumlah direktori perintah yang dideklarasikan plugin
• agent_path_count: jumlah direktori agen yang dideklarasikan plugin
• safe_mode: "true" saat sesi dimulai dengan --safe-mode, "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 baru

Acara skill diaktifkan

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

Nama Acara: claude_code.skill_activated

Atribut:

• Semua atribut standar
• event.name: "skill_activated"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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: Tempat skill dimuat dari (misalnya, "bundled", "userSettings", "projectSettings", "plugin")
• skill.kind: "workflow" saat skill adalah skill workflow. Tidak ada sebaliknya
• plugin.name (saat OTEL_LOG_TOOL_DETAILS=1 atau plugin dari marketplace resmi): Nama plugin pemilik saat skill disediakan oleh plugin
• marketplace.name (saat OTEL_LOG_TOOL_DETAILS=1 atau plugin dari marketplace resmi): Marketplace plugin pemilik diinstal dari, saat skill disediakan oleh plugin

Acara mention @

Dicatat 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.

Nama Acara: claude_code.at_mention

Atribut:

• Semua atribut standar
• event.name: "at_mention"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• mention_type: Jenis mention ("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 mention berhasil diselesaikan ("true" atau "false")

Acara retry API habis

Dicatat sekali saat permintaan API gagal setelah lebih dari satu upaya. Dipancarkan bersama acara api_error terakhir.

Nama Acara: claude_code.api_retries_exhausted

Atribut:

• Semua atribut standar
• event.name: "api_retries_exhausted"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• model: Model yang digunakan
• error: Pesan kesalahan terakhir
• 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 wall-clock di semua upaya
• speed: "fast" atau "normal"

Acara hook terdaftar

Dicatat 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.

Nama Acara: claude_code.hook_registered

Atribut:

• Semua atribut standar
• event.name: "hook_registered"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• hook_event: jenis acara hook, seperti "PreToolUse" atau "PostToolUse"
• hook_type: jenis implementasi hook: "command", "prompt", "mcp_tool", "http", atau "agent"
• hook_source: tempat hook didefinisikan: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings", atau "pluginHook"
• safe_mode: "true" saat sesi dimulai dengan --safe-mode, "false" sebaliknya. Memerlukan Claude Code v2.1.169 atau lebih baru
• hook_matcher (saat OTEL_LOG_TOOL_DETAILS=1): string matcher dari konfigurasi hook, saat satu diatur
• 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
• 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

Acara mulai eksekusi hook

Dicatat saat satu atau lebih hooks mulai dieksekusi untuk acara hook.

Nama Acara: claude_code.hook_execution_start

Atribut:

• Semua atribut standar
• event.name: "hook_execution_start"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• hook_event: Jenis acara 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" saat hanya hooks kebijakan terkelola yang diizinkan
• hook_source: "policySettings" atau "merged"
• safe_mode: "true" saat 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 saat detailed beta tracing dan OTEL_LOG_TOOL_DETAILS=1 keduanya diaktifkan

Acara eksekusi hook selesai

Dicatat saat semua hooks untuk acara hook selesai.

Nama Acara: claude_code.hook_execution_complete

Atribut:

• Semua atribut standar
• event.name: "hook_execution_complete"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• hook_event: Jenis acara hook
• hook_name: Nama hook lengkap termasuk matcher
• num_hooks: Jumlah perintah hook yang cocok
• num_success: Jumlah yang selesai dengan sukses
• num_blocking: Jumlah yang mengembalikan keputusan blocking
• num_non_blocking_error: Jumlah yang gagal tanpa blocking
• num_cancelled: Jumlah dibatalkan sebelum selesai
• total_duration_ms: Durasi wall-clock dari semua hooks yang cocok
• stdout_chars: Total karakter stdout di seluruh hooks yang cocok yang berhasil. Memerlukan Claude Code v2.1.280 atau lebih baru
• additional_context_chars: Total karakter additionalContext yang dikembalikan oleh hooks yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru
• system_message_chars: Total karakter systemMessage yang dikembalikan oleh hooks yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru
• initial_user_message_chars: Total karakter initialUserMessage yang dikembalikan oleh hooks yang cocok. Memerlukan Claude Code v2.1.280 atau lebih baru
• num_outputs_persisted: Jumlah output hook di atas batas 10.000 karakter yang disimpan Claude Code ke file. Memerlukan Claude Code v2.1.280 atau lebih baru
• managed_only: "true" saat hanya hooks kebijakan terkelola yang diizinkan
• hook_source: "policySettings" atau "merged"
• safe_mode: "true" saat 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 saat detailed beta tracing dan OTEL_LOG_TOOL_DETAILS=1 keduanya diaktifkan

Acara metrik plugin hook

Dicatat 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.

Nama Acara: claude_code.hook_plugin_metrics

Atribut:

• Semua atribut standar
• event.name: "hook_plugin_metrics"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• plugin_id: pengidentifikasi plugin dalam bentuk <name>@<marketplace>
• hook_event: jenis acara 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.

Acara pemadatan

Dicatat saat pemadatan percakapan selesai.

Nama Acara: claude_code.compaction

Atribut:

• Semua atribut standar
• event.name: "compaction"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 saat pemadatan gagal
• 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 baru

Acara subagent selesai

Dicatat saat subagent 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 dan penghitung biaya 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.

Nama Acara: claude_code.subagent_completed

Atribut:

• Semua atribut standar
• event.name: "subagent_completed"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• 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 diatur
• agent.source: Tempat definisi agen berasal: built-in, plugin, atau sumber pengaturan yang mendefinisikan agen khusus, seperti userSettings atau projectSettings
• is_built_in: Apakah subagent adalah jenis agen built-in
• is_async: Apakah subagent berjalan di latar belakang
• 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 run
• total_tool_uses: Jumlah panggilan alat yang dibuat subagent di seluruh run
• duration_ms: Waktu run dalam milidetik
• model: Model yang diselesaikan subagent untuk dijalankan
• 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 baru
• model_swapped: Apakah lebih dari satu model melayani permintaan subagent. 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

Acara survei umpan balik

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

Nama Acara: claude_code.feedback_survey

Atribut:

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

Acara penyapuan retensi

Dicatat sekali per run penyapuan pembersihan retensi, yang menghapus transkrip sesi dan data aplikasi lainnya yang lebih lama dari pengaturan 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.

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

Saat 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 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 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".

Nama Acara: claude_code.retention_sweep

Atribut:

• Semua atribut standar
• event.name: "retention_sweep"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara
• result: "complete" saat penyapuan berjalan, "skipped" saat Claude Code menghentikannya
• 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 Code
• used_default: "true" saat tidak ada sumber pengaturan yang dapat dibaca yang menetapkan cleanupPeriodDays, "false" sebaliknya. Pada acara lengkap, "true" berarti default 30 hari diterapkan
• skip_reason: Mengapa Claude Code menghentikan penyapuan. Ada hanya saat 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 fallback ke default dapat menghapus atau menyimpan file terhadap pengaturan itu
• transcripts_deleted: Jumlah transkrip sesi, file ~/.claude/projects/*/*.jsonl tingkat atas, yang dihapus penyapuan
• transcripts_exempted_desktop: Jumlah transkrip melewati periode retensi yang disimpan penyapuan 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 penyapuan file sesi: transkrip plus file pendamping per sesi seperti sidecars, recordings, dan hasil alat
• 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 tepat
• 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 normal
• 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 gantinya
• error_count: Jumlah kesalahan yang dihadapi penyapuan saat membuat daftar atau menghapus file

Acara pengaturan terkelola diselesaikan

Dicatat dengan pengaturan terkelola yang diselesaikan sesi: sekali saat startup sesi, lagi saat pengaturan terkelola atau helper kebijakan berubah selama sesi, dan saat Claude Code menolak untuk memulai atau mengakhiri sesi untuk salah satu alasan yang tercantum atribut error.type. Gunakan 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. Memerlukan Claude Code v2.1.274 atau lebih baru.

Secara 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:

• 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.
• Pengaturan terkelola server dapat mengaturnya tanpa menampilkan dialog persetujuan keamanan, karena variabel hanya menambahkan kebijakan terkelola organisasi Anda sendiri ke acara yang organisasi Anda sudah terima.

Dalam sesi interaktif dalam folder yang belum Anda percayai, Claude Code tidak mengekspor acara penolakan, karena pengaturan proyek dan lokal dapat mengarahkan ekspor ke kolektor yang berbeda sebelum kepercayaan.

Nama Acara: claude_code.managed_settings_resolved

Atribut:

• Semua atribut standar

• event.name: "managed_settings_resolved"

• event.timestamp: Stempel waktu ISO 8601

• event.sequence: penghitung per-proses untuk mengurutkan acara, dijelaskan di bawah Atribut korelasi acara

• 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 off

• error.type: mengapa Claude Code menghentikan sesi. Ada hanya pada acara refused:

  • "helper_failed": run helper kebijakan gagal
  • "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 organisasi
  • "consent_rejected": pengguna menolak dialog persetujuan keamanan untuk pengaturan terkelola server
  • "force_refresh_failed": pengambilan pengaturan yang forceRemoteSettingsRefresh perlukan gagal
  • "gateway_rejected": gateway aplikasi Claude menjawab beban pengaturan terkelola dengan HTTP 403
  • "version_below_minimum": versi Claude Code ini di bawah requiredMinimumVersion atau di atas requiredMaximumVersion
  • "_OTHER": beban pengaturan terkelola gateway aplikasi Claude gagal karena alasan lain

• managed_settings.sources: setiap sumber terkelola 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 terkelola dan drop-in, "parent" saat host embedding memasok pengaturan, dan "hkcu" untuk nilai registri Windows HKCU saat Claude Code membacanya. 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 kebijakan

• managed_settings.source_behavior: nilai managedSourcesBehavior yang dibaca Claude Code, "first-wins" atau "merge". "first-wins" saat tidak ada sumber yang menetapkan kunci

• managed_settings.helper.state: status helper kebijakan yang dikonfigurasi sumber MDM atau file yang dipilih:

  • "ok": output helper melayani sebagai pengaturan terkelola
  • "bad_path", "not_a_file", "exit_nonzero", "timed_out", "oversize", "parse_failed", "envelope_invalid", atau "schema_rejected": run terakhir helper gagal. Helper failures menjelaskan kasus-kasusnya
  • "none": tidak ada helper yang dikonfigurasi, atau sumber yang mengonfigurasinya bukan kebijakan MDM atau file pengaturan terkelola

• managed_settings.helper.applied: "output" saat output helper sendiri melayani sebagai pengaturan terkelola, "none" saat tidak

• managed_settings.helper.entry: "policyHelper" saat Claude Code memilih policyHelper. Tidak ada saat memilih tidak ada helper

• managed_settings.helper.path: path yang dikonfigurasi helper. Ada kapan pun Claude Code memilih helper, apakah atau tidak OTEL_LOG_MANAGED_SETTINGS diatur

• 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

• 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:

  • 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 jalurnya tanpa pola perintah
  • Daftar menyimpan panjangnya, dengan setiap entri diredaksi oleh aturan yang sama
  • 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]"
  • 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]"

  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])"]}}.

  Claude Code memotong nilai pada 8 KB UTF-8, dan nilai yang dipotong bukan JSON yang valid

• 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 string

Menafsirkan data metrik dan acara

Metrik dan acara yang diekspor mendukung berbagai analisis:

Pemantauan penggunaan

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.

Panggilan 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.

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:

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:

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 --debug dan periksa log debug 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
  • 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 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. 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).