Pemantauan

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

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

​

Detail konfigurasi

​

Variabel konfigurasi umum

​

Autentikasi mTLS

​

Kontrol kardinalitas metrik

​

Traces (beta)

​

Hierarki span

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

​

Atribut span

​

Header dinamis

​

Konfigurasi pengaturan

{
  "otelHeadersHelper": "/bin/generate_opentelemetry_headers.sh"
}

​

Persyaratan skrip

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

​

Perilaku penyegaran

​

Dukungan organisasi multi-tim

# Tambahkan atribut khusus 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 dasbor khusus tim
• Atur peringatan untuk tim tertentu

# ❌ Tidak valid - berisi spasi
export OTEL_RESOURCE_ATTRIBUTES="org.name=John's Organization"

# ✅ Valid - gunakan garis bawah atau camelCase sebagai gantinya
export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

# ✅ Valid - kodekan persen karakter khusus jika diperlukan
export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

Konfigurasi contoh

# Debugging konsol (interval 1 detik)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

# OTLP/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

# Prometheus
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

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

# Titik akhir/backend berbeda untuk metrik dan log
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

# Hanya metrik (tanpa acara/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

# Hanya acara/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

• 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

​

Metrik

​

Detail metrik

​

Penghitung sesi

• Semua atribut standar
• start_type: Bagaimana sesi dimulai. Salah satu dari "fresh", "resume", atau "continue"

​

Penghitung baris kode

• Semua atribut standar
• type: ("added", "removed")

​

Penghitung permintaan tarik

• Semua atribut standar

​

Penghitung komit

• Semua atribut standar

​

Penghitung biaya

• Semua atribut standar
• model: Pengidentifikasi model (misalnya, “claude-sonnet-4-6”)
• 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.

​

Penghitung token

• Semua atribut standar
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Pengidentifikasi model (misalnya, “claude-sonnet-4-6”)
• 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: Atribusi skill, plugin, dan agen untuk permintaan. Lihat Penghitung biaya untuk definisi dan perilaku redaksi.

​

Penghitung keputusan alat pengeditan kode

• 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

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

​

Acara

​

Atribut korelasi acara

​

Acara prompt pengguna

• Semua atribut standar
• event.name: "user_prompt"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• prompt_length: Panjang prompt
• prompt: Konten prompt (diredaksi secara default, aktifkan dengan OTEL_LOG_USER_PROMPTS=1)
• 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 hasil alat

• Semua atribut standar
• event.name: "tool_result"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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: Baik "accept" atau "reject"
• decision_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.
• 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)
• tool_parameters (saat OTEL_LOG_TOOL_DETAILS=1): String JSON yang berisi parameter khusus alat:
  • Untuk alat Bash: mencakup bash_command, full_command, timeout, description, dangerouslyDisableSandbox, dan git_commit_id (SHA komit, saat perintah git commit berhasil)
  • Untuk alat MCP: mencakup mcp_server_name, mcp_tool_name
  • Untuk alat Skill: mencakup skill_name
  • Untuk alat Task: 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

• Semua atribut standar
• event.name: "api_request"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• model: Model yang digunakan (misalnya, “claude-sonnet-4-6”)
• cost_usd: Biaya perkiraan dalam USD
• 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.
• 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.

​

Acara kesalahan API

• Semua atribut standar
• event.name: "api_error"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• model: Model yang digunakan (misalnya, “claude-sonnet-4-6”)
• 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.
• 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.

​

Acara badan permintaan API

• Semua atribut standar
• event.name: "api_request_body"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• body: Parameter permintaan Messages API yang diserialisasi JSON (system prompt, messages, tools, dll.), dipotong pada 60 KB. 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")

​

Acara badan respons API

• Semua atribut standar
• event.name: "api_response_body"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• body: Respons Messages API yang diserialisasi JSON (id, content blocks, usage, stop reason), dipotong pada 60 KB. 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.

​

Acara keputusan alat

• Semua atribut standar
• event.name: "tool_decision"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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"
• source: Sumber keputusan:
  • "config": Diputuskan secara otomatis tanpa diminta, berdasarkan pengaturan proyek, kebijakan terkelola perusahaan, flag --allowedTools atau --disallowedTools, mode izin aktif, atau karena alat itu aman secara inheren. Acara tidak menunjukkan sumber mana yang cocok.
  • "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 salah satu opsi ”… selama sesi ini” 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. Diperlakukan sebagai penolakan.
  • "user_reject": Dipancarkan saat pengguna memilih “Tidak” saat diminta, atau panggilan cocok dengan aturan penolakan dalam pengaturan pribadi mereka. Diperlakukan sebagai penolakan.

​

Acara mode izin berubah

• Semua atribut standar
• event.name: "permission_mode_changed"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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

• Semua atribut standar
• event.name: "auth"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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

• Semua atribut standar
• event.name: "mcp_server_connection"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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
• 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

• Semua atribut standar
• event.name: "internal_error"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• error_name: Nama kelas kesalahan, seperti "TypeError" atau "SyntaxError"
• error_code: Kode errno Node.js seperti "ENOENT" saat ada pada kesalahan

​

Acara plugin terinstal

• Semua atribut standar
• event.name: "plugin_installed"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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

• Semua atribut standar
• event.name: "plugin_loaded"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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", "org", "user-local", atau "default-bundle"
• enabled_via: bagaimana plugin menjadi diaktifkan: "default-enable", "org-policy", "seed-mount", atau "user-install"
• 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
• has_hooks: apakah plugin berkontribusi hooks
• has_mcp: apakah plugin berkontribusi server MCP
• 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

​

Acara skill diaktifkan

• Semua atribut standar
• event.name: "skill_activated"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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")
• 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 @

• Semua atribut standar
• event.name: "at_mention"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• mention_type: Jenis mention ("file", "directory", "agent", "mcp_resource")
• success: Apakah mention berhasil diselesaikan ("true" atau "false")

​

Acara retry API habis

• Semua atribut standar
• event.name: "api_retries_exhausted"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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

• Semua atribut standar
• event.name: "hook_registered"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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"
• 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

​

Acara mulai eksekusi hook

• Semua atribut standar
• event.name: "hook_execution_start"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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"
• 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

• Semua atribut standar
• event.name: "hook_execution_complete"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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
• managed_only: "true" saat hanya hooks kebijakan terkelola yang diizinkan
• hook_source: "policySettings" atau "merged"
• hook_definitions: Konfigurasi hook yang diserialisasi JSON. Disertakan hanya saat detailed beta tracing dan OTEL_LOG_TOOL_DETAILS=1 keduanya diaktifkan

​

Acara pemadatan

• Semua atribut standar
• event.name: "compaction"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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

​

Acara survei umpan balik

• Semua atribut standar
• event.name: "feedback_survey"
• event.timestamp: Stempel waktu ISO 8601
• event.sequence: penghitung yang meningkat secara monoton untuk mengurutkan acara dalam sesi
• 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

​

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

​

Pertimbangan backend

​

Untuk metrik

• Database deret waktu (misalnya, Prometheus): Perhitungan laju, metrik agregat
• Toko kolumnar (misalnya, ClickHouse): Kueri kompleks, analisis pengguna unik
• Platform observabilitas lengkap (misalnya, Honeycomb, Datadog): Kueri lanjutan, visualisasi, peringatan

​

Untuk acara/log

• Sistem agregasi log (misalnya, Elasticsearch, Loki): Pencarian teks lengkap, analisis log
• Toko kolumnar (misalnya, ClickHouse): Analisis acara terstruktur
• Platform observabilitas lengkap (misalnya, Honeycomb, Datadog): Korelasi antara metrik dan acara

​

Untuk traces

• Sistem distributed tracing (misalnya, Jaeger, Zipkin, Grafana Tempo): Visualisasi span, request waterfalls, analisis latensi
• Platform observabilitas lengkap (misalnya, Honeycomb, Datadog): Pencarian trace dan korelasi dengan metrik dan log

​

Informasi layanan

• service.name: claude-code
• service.version: Versi Claude Code saat ini
• 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. 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
• Argumen input alat dan parameter tidak dicatat secara default. Untuk menyertakannya, atur OTEL_LOG_TOOL_DETAILS=1. Saat diaktifkan, acara tool_result menyertakan atribut tool_parameters dengan perintah Bash, nama server MCP dan alat, dan nama skill, ditambah atribut tool_input dengan jalur file, URL, pola pencarian, dan argumen lainnya. 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. Nilai individual di atas 512 karakter dipotong dan total dibatasi hingga ~4 K karakter, tetapi argumen mungkin masih berisi nilai sensitif. Konfigurasikan backend telemetri Anda untuk memfilter atau menyunting atribut ini sesuai kebutuhan
• Konten input dan output alat tidak dicatat dalam trace spans secara default. Untuk menyertakannya, atur OTEL_LOG_TOOL_CONTENT=1. Saat diaktifkan, acara span menyertakan konten input dan output alat lengkap dipotong pada 60 KB per span. Ini dapat mencakup konten file mentah dari hasil alat Read dan output perintah Bash. 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. Dengan =1, setiap panggilan API memancarkan acara log api_request_body dan api_response_body yang atribut body-nya adalah muatan yang diserialisasi JSON, dipotong pada 60 KB. Dengan =file:<dir>, badan yang tidak dipotong ditulis 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. Dalam kedua mode, badan berisi riwayat percakapan lengkap (system prompt, setiap giliran pengguna dan asisten sebelumnya, hasil alat), jadi mengaktifkan ini menyiratkan persetujuan untuk semua yang akan diungkapkan oleh flag konten OTEL_LOG_* lainnya. Konten extended-thinking Claude selalu diredaksi dari badan ini terlepas dari pengaturan lain

​

Memantau Claude Code di Amazon Bedrock