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
export OTEL_LOGS_EXPORTER=otlp          # Opsi: otlp, console

# 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

​

Kontrol kardinalitas metrik

​

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

​

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”)

​

Penghitung token

• Semua atribut standar
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Pengidentifikasi model (misalnya, “claude-sonnet-4-6”)

​

Penghitung keputusan alat pengeditan kode

• Semua atribut standar
• tool_name: Nama alat ("Edit", "Write", "NotebookEdit")
• decision: Keputusan pengguna ("accept", "reject")
• source: Sumber keputusan - "config", "hook", "user_permanent", "user_temporary", "user_abort", atau "user_reject"
• 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)

​

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
• success: "true" atau "false"
• duration_ms: Waktu eksekusi dalam milidetik
• error: Pesan kesalahan (jika gagal)
• decision_type: Baik "accept" atau "reject"
• decision_source: Sumber keputusan - "config", "hook", "user_permanent", "user_temporary", "user_abort", atau "user_reject"
• tool_result_size_bytes: Ukuran hasil alat dalam byte
• mcp_server_scope: Pengidentifikasi cakupan server MCP (untuk alat MCP)
• tool_parameters: String JSON yang berisi parameter khusus alat (saat tersedia)
  • 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 (saat OTEL_LOG_TOOL_DETAILS=1): mencakup mcp_server_name, mcp_tool_name
  • Untuk alat Skill (saat OTEL_LOG_TOOL_DETAILS=1): mencakup skill_name
• 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
• speed: "fast" atau "normal", menunjukkan apakah mode cepat aktif

​

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 string, atau "undefined" untuk kesalahan non-HTTP
• duration_ms: Durasi permintaan dalam milidetik
• attempt: Nomor upaya (untuk permintaan yang dicoba ulang)
• speed: "fast" atau "normal", menunjukkan apakah mode cepat aktif

​

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”)
• decision: Baik "accept" atau "reject"
• source: Sumber keputusan - "config", "hook", "user_permanent", "user_temporary", "user_abort", atau "user_reject"

​

Menafsirkan data metrik dan acara

​

Pemantauan penggunaan

​

Pemantauan biaya

• Melacak tren penggunaan di seluruh tim atau individu
• Mengidentifikasi sesi penggunaan tinggi untuk optimasi

​

Peringatan dan segmentasi

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

​

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

​

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

• Telemetri adalah opt-in dan memerlukan konfigurasi eksplisit
• Konten file mentah dan cuplikan kode tidak disertakan dalam metrik atau acara. Acara eksekusi alat mencakup perintah bash dan jalur file di bidang tool_parameters, yang mungkin berisi nilai sensitif. Jika perintah Anda mungkin menyertakan rahasia, konfigurasikan backend telemetri Anda untuk memfilter atau menyunting tool_parameters
• 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 tidak dicatat secara default. Untuk menyertakannya, atur OTEL_LOG_TOOL_DETAILS=1. Saat diaktifkan, acara tool_result menyertakan nama server MCP/alat dan nama skill ditambah 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, tetapi argumen mungkin masih berisi nilai sensitif. Konfigurasikan backend telemetri Anda untuk memfilter atau menyunting tool_input sesuai kebutuhan

​

Memantau Claude Code di Amazon Bedrock