Pemantauan

​

Mulai cepat

# 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

​

Konfigurasi administrator

{
  "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"
  }
}

​

Bagaimana pengaturan terkelola mengunci tujuan OTLP

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

​

Detail konfigurasi

​

Variabel konfigurasi umum

​

Autentikasi mTLS

​

Kontrol kardinalitas metrik

​

Traces (beta)

​

Hierarki span

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

​

Atribut span

• 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 saat berjalan agar pesan yang sedang menunggu dapat mencapai Claude. Hasil yang tiba kemudian juga tidak dicatat. Untuk mengetahui kapan Claude Code memindahkan panggilan, lihat Kapan Claude Code mengirim apa yang Anda antrekan untuk terminal dan field priority untuk sesi Agent SDK

​

Header dinamis

​

Konfigurasi pengaturan

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

​

Persyaratan skrip

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

• 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

​

Dukungan organisasi multi-tim

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

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

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

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

​

Atribusikan telemetri ke sesi SSH Desktop

{
  "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_RESOURCE_ATTRIBUTES": "host.name=build-7"
  }
}

• Anda menetapkannya di komputer yang menjalankan Desktop: Desktop tidak meneruskan nilai yang Anda tetapkan di sana ke sesi SSH
• Anda mengekspornya di file login: hanya login shell yang membaca file seperti /etc/profile. Nilai yang Anda export di sana mencapai Claude Code yang Anda mulai dari login shell. Nilai tersebut tidak mencapai sesi SSH Desktop, karena Desktop tidak memulai Claude Code melalui login shell.
• Sebuah nilai mengandung spasi: Claude Code kemudian tidak menyalin satu pun kunci ke event atau titik data dan tidak melaporkan error. Hapus spasi dari nilai tersebut.
• Sesuatu yang lain sudah menetapkan variabel tersebut: dalam sesi yang dimulai oleh aplikasi desktop, variabel yang sudah ditetapkan di lingkungan peluncuran diutamakan daripada file pengaturan. Log debug menyebutkan setiap variabel yang diabaikan. Ketika deployment Desktop pihak ketiga menyebutkan endpoint OTLP dalam lingkungan yang disediakannya, lingkungan tersebut membawa OTEL_RESOURCE_ATTRIBUTES milik Desktop sendiri.

​

Konfigurasi contoh

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

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

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

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

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

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

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

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

• 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

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

​

Metrik dan peristiwa yang tersedia

​

Atribut standar

• 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: pengidentifikasi run, dengan awalan wf_, pada event API dan tool yang dipancarkan oleh agent yang termasuk dalam run tool Workflow. Memfilter event berdasarkan satu workflow.run_id merekonstruksi permintaan API dan hasil tool dari run tersebut. Pengidentifikasi ini mencakup agent yang dibuat oleh skrip workflow dan agent apa pun yang selanjutnya dibuat oleh agent tersebut, seperti pemanggilan skill. Nilainya cocok dengan pengidentifikasi run yang dilaporkan dalam hasil tool Workflow. Tidak ada pada semua event lainnya.
• workflow.name: nama workflow, yaitu meta.name dari skripnya, dipancarkan bersama workflow.run_id. Nama workflow bawaan muncul apa adanya ketika run mengeksekusi skrip bawaan yang tidak dimodifikasi. Nama yang dibuat pengguna, termasuk salinan skrip bawaan yang telah diedit, diganti dengan custom kecuali OTEL_LOG_TOOL_DETAILS=1 ditetapkan.

​

Atribut repositori

​

Metrik

​

Detail metrik

​

Penghitung sesi

• 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

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

​

Penghitung pull request

• Semua atribut standar

​

Penghitung commit

• Semua atribut standar

​

Penghitung biaya

• 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

• Semua atribut standar
• type: ("input", "output", "cacheRead", "cacheCreation"). Jenis "input" tidak mencakup token yang dibaca dari atau ditulis ke prompt cache, yang dihitung di bawah "cacheRead" dan "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

• 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

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

​

Peristiwa

​

Atribut korelasi peristiwa

• 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

• 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
• prompt_text: Nilai yang sama dengan prompt, disamarkan dengan ketentuan yang sama. Backend yang menyimpan nama atribut bertitik sebagai objek bersarang membaca prompt.id sebagai id di dalam objek bernama prompt dan dapat kehilangan string prompt. Bacalah prompt_text pada backend tersebut. Memerlukan Claude Code v2.1.287 atau yang lebih baru
• 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

• 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

• 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

• 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, tidak termasuk token yang dibaca dari atau ditulis ke prompt cache
• 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

• 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 percobaan yang dilakukan, termasuk permintaan awal. Mendeteksi retry yang habis menjelaskan kapan hitungan dimulai lagi
• 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

• 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

• 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

• 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

• 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

• 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

• 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

• 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

• 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

• 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

• 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 pembacaan konfigurasi server MCP plugin, false jika tidak
• 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

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

• 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

• 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

• 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

• 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

• 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

• 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 berupa Boolean atau angka.

​

Peristiwa pemadatan

• 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 ditetapkan ketika trigger bernilai "manual" atau untuk idle compaction, yang melaporkan trigger sebagai "auto". Auto-compaction dapat menyiapkan ringkasan di latar belakang sebelum context window penuh, dan atribut ini mencatat apakah compaction menggunakan kembali ringkasan yang telah disiapkan tersebut. "hit" berarti ringkasan tersebut digunakan kembali; "miss_custom_instructions", "miss_hook", dan "miss_not_ready" memberikan alasan mengapa ringkasan baru dihitung sebagai gantinya

​

Peristiwa subagen selesai

• 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

• 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 saat CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL diatur. Dipancarkan sebagai Boolean, bukan string. Ada pada event survei session. Filter berdasarkan atribut ini untuk memastikan override diterapkan di seluruh armada

​

Peristiwa sapuan retensi

• 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 yang lebih lama dari periode retensi yang gagal dihapus oleh sapuan, misalnya karena kesalahan izin akses atau file yang sedang terbuka. Hitungan ini juga mencakup setiap folder usang yang ditemukan sapuan di bawah skills/synced/ atau plugins/synced/, baik dipindahkan ke tempat sampah maupun tidak. Selain folder-folder tersebut, nilai di atas nol berarti ada file yang bertahan melewati periode retensi yang dikonfigurasi; nol bukan bukti bahwa tidak ada, karena kegagalan menghapus seluruh direktori dihitung dalam error_count
• error_count: Jumlah kesalahan yang dihadapi sapuan saat mendaftar atau menghapus file

​

Peristiwa pengaturan yang dikelola diselesaikan

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

• 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 untuk alasan selain pembacaan yang ditolak, jadi Claude Code tidak dapat memeriksa penegakan login organisasi atau penyedia
  • "provider_not_allowed": sesi akan menggunakan penyedia API, atau mengirim lalu lintas penyedia ke host, yang daftar allowedProviders yang dikelola tidak izinkan. Memerlukan Claude Code v2.1.285 atau lebih baru
  • "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 (saat managed_settings.settings ada): true saat Claude Code memotong managed_settings.settings pada 8 KB, false jika tidak. Dipancarkan sebagai Boolean, bukan string

​

Menafsirkan data metrik dan acara

​

Pemantauan penggunaan

​

Pemantauan biaya

• 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

​

Peringatan dan segmentasi

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

​

Deteksi kelelahan retry

​

Analisis acara

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

​

Memetakan token input ke konvensi semantik OpenTelemetry GenAI

• input_tokens pada span claude_code.llm_request dan acara api_request
• Jenis "input" dari metrik claude_code.token.usage

• Dari span atau acara: jumlahkan input_tokens, cache_read_tokens, dan cache_creation_tokens
• Dari metrik claude_code.token.usage: jumlahkan jenis "input", "cacheRead", dan "cacheCreation"

• cache_read_tokens dipetakan ke gen_ai.usage.cache_read.input_tokens
• cache_creation_tokens dipetakan ke gen_ai.usage.cache_write.input_tokens. Versi konvensi yang lebih lama menamai atribut penulisan cache sebagai gen_ai.usage.cache_creation.input_tokens, jadi gunakan nama yang diharapkan oleh backend Anda.

​

Audit acara keamanan

​

Atribut tindakan untuk pengguna

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

​

Audit aktivitas MCP

• 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

​

Petakan jalur egress ke kontrol terkelola dan acara

• allowedHttpHookUrls: entri digabungkan di seluruh file pengaturan, sehingga pengembang dapat menambahkan ke daftar terkelola yang kosong. allowManagedHooksOnly menentukan hook mana yang dijalankan
• managed-mcp.json: untuk mematikan MCP, lihat Nonaktifkan MCP sepenuhnya. Untuk mengonfirmasi bahwa Claude Code membaca file tersebut, lihat Validasi konfigurasi
• Acara hook: Claude Code mencatat hook_execution_start dan hook_execution_complete satu kali per acara hook, mencakup setiap hook yang cocok. OTEL_LOG_TOOL_DETAILS=1 saja tidak mencatat URL hook HTTP. Konfigurasi hook hanya muncul di hook_definitions, yang juga memerlukan beta tracing terperinci

​

Periksa sapuan retensi

• Tidak ada yang memulai Claude Code: tidak ada sapuan yang berjalan, dan mesin menyimpan datanya hingga peluncuran berikutnya
• Sesi tetap terbuka: Claude Code menjalankan sapuan paling banyak satu kali per sesi
• Sesi berakhir lebih awal: sapuan yang belum selesai saat sesi keluar tidak memancarkan apa pun, begitu pula sapuan yang berhenti karena kesalahan tak terduga

​

Kirim acara ke SIEM

{
  "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"
  }
}

​

Pertimbangan backend

​

Backend untuk metrik

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

​

Backend untuk acara dan log

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

​

Backend untuk traces

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

​

Informasi layanan

• service.name: claude-code untuk sesi terminal, claude-code-desktop untuk sesi lokal yang dimulai dari tab Code di aplikasi Claude Desktop
• service.version: Versi Claude Code saat ini, atau versi aplikasi Desktop untuk sesi lokal 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

​

Sumber daya pengukuran ROI

​

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. Saat diaktifkan:
  • Acara user_prompt membawa teks prompt dalam dua atribut, prompt dan prompt_text. Jika Anda membuang atau menyamarkan teks prompt acara berdasarkan nama atribut di collector Anda, sebutkan kedua atribut dalam aturan tersebut Processor attributes OpenTelemetry Collector ini menghapus kedua atribut dalam pipeline yang mencantumkannya:
    processors:
      attributes/drop-prompt-text:
        actions:
          - key: prompt
            action: delete
          - key: prompt_text
            action: delete
    
  • Dengan tracing aktif, span claude_code.interaction membawa teks prompt dalam atribut user_prompt-nya
  • Di bawah detailed beta tracing, spans juga membawa pesan pengguna baru, hasil tool, dan system reminder yang dikirim bersama setiap permintaan, teks system prompt, serta output model. Atribut konten di bawah detailed beta tracing mencantumkan setiap atribut. Acara claude_code.system_prompt membawa system prompt lengkap
• 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 endpoint 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 dalam acara. Di bawah detailed beta tracing, span claude_code.llm_request tetap membawa output model dalam response.model_output, yang mengikuti OTEL_LOG_USER_PROMPTS alih-alih variabel ini
• Argumen input tool 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 endpoint 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 tool, 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 agent, skill, plugin, dan server MCP dan tool yang sebenarnya dalam atribut atribusi mereka
  • Span claude_code.tool membawa atribut yang diturunkan dari input seperti file_path. Di bawah detailed beta tracing, span ini juga membawa atribut 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