Monitoraggio - Claude Code Docs

Traccia l’utilizzo di Claude Code, i costi e l’attività degli strumenti in tutta l’organizzazione esportando i dati di telemetria tramite OpenTelemetry (OTel). Claude Code esporta le metriche come dati di serie temporali tramite il protocollo di metriche standard, gli eventi tramite il protocollo di log/eventi, e facoltativamente le tracce distribuite tramite il protocollo di tracce. Configura i tuoi backend di metriche, log e tracce per corrispondere ai tuoi requisiti di monitoraggio.

Avvio rapido

Configura OpenTelemetry utilizzando variabili di ambiente:

# 1. Abilita la telemetria
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. Scegli gli esportatori (entrambi sono facoltativi - configura solo ciò di cui hai bisogno)
export OTEL_METRICS_EXPORTER=otlp       # Opzioni: otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp          # Opzioni: otlp, console, none

# 3. Configura l'endpoint OTLP (per l'esportatore OTLP)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. Imposta l'autenticazione (se richiesta)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. Per il debug: riduci gli intervalli di esportazione
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 secondi (predefinito: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 secondi (predefinito: 5000ms)

# 6. Esegui Claude Code
claude

Gli intervalli di esportazione predefiniti sono 60 secondi per le metriche e 5 secondi per i log. Durante la configurazione, potresti voler utilizzare intervalli più brevi per scopi di debug. Ricordati di ripristinare questi valori per l’uso in produzione.

Per le opzioni di configurazione complete, consulta la specifica OpenTelemetry.

Configurazione dell’amministratore

Gli amministratori possono configurare le impostazioni di OpenTelemetry per tutti gli utenti tramite il file di impostazioni gestite. Ciò consente il controllo centralizzato delle impostazioni di telemetria in tutta l’organizzazione. Consulta la precedenza delle impostazioni per ulteriori informazioni su come vengono applicate le impostazioni. Esempio di configurazione delle impostazioni gestite:

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

Le impostazioni gestite possono essere distribuite tramite MDM (Mobile Device Management) o altre soluzioni di gestione dei dispositivi. Le variabili di ambiente definite nel file di impostazioni gestite hanno una precedenza elevata e non possono essere sovrascritte dagli utenti.

Claude Code non passa le variabili di ambiente OTEL_* ai sottoprocessi che genera, incluso lo strumento Bash, gli hooks, i server MCP e i language server. Un’applicazione strumentata con OpenTelemetry che esegui tramite lo strumento Bash non eredita l’endpoint dell’esportatore di Claude Code o le intestazioni, quindi imposta quelle variabili direttamente nel comando se quell’applicazione ha bisogno di esportare la propria telemetria.

Dettagli della configurazione

Variabili di configurazione comuni

Variabile di ambiente	Descrizione	Valori di esempio
`CLAUDE_CODE_ENABLE_TELEMETRY`	Abilita la raccolta della telemetria (obbligatorio)	`1`
`OTEL_METRICS_EXPORTER`	Tipi di esportatore di metriche, separati da virgola. Usa `none` per disabilitare	`console`, `otlp`, `prometheus`, `none`
`OTEL_LOGS_EXPORTER`	Tipi di esportatore di log/eventi, separati da virgola. Usa `none` per disabilitare	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_PROTOCOL`	Protocollo per l’esportatore OTLP, si applica a tutti i segnali	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_ENDPOINT`	Endpoint del collettore OTLP per tutti i segnali	`http://localhost:4317`
`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL`	Protocollo per le metriche, sostituisce l’impostazione generale	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`	Endpoint OTLP per le metriche, sostituisce l’impostazione generale	`http://localhost:4318/v1/metrics`
`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL`	Protocollo per i log, sostituisce l’impostazione generale	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	Endpoint OTLP per i log, sostituisce l’impostazione generale	`http://localhost:4318/v1/logs`
`OTEL_EXPORTER_OTLP_HEADERS`	Intestazioni di autenticazione per OTLP	`Authorization=Bearer token`
`OTEL_METRIC_EXPORT_INTERVAL`	Intervallo di esportazione in millisecondi (predefinito: 60000)	`5000`, `60000`
`OTEL_LOGS_EXPORT_INTERVAL`	Intervallo di esportazione dei log in millisecondi (predefinito: 5000)	`1000`, `10000`
`OTEL_LOG_USER_PROMPTS`	Abilita la registrazione del contenuto del prompt dell’utente (predefinito: disabilitato)	`1` per abilitare
`OTEL_LOG_TOOL_DETAILS`	Abilita la registrazione dei parametri dello strumento e degli argomenti di input negli eventi dello strumento e negli attributi di span di traccia: comandi Bash, nomi dei server MCP e dello strumento, nomi delle skill e input dello strumento. Abilita anche i nomi dei comandi personalizzati, plugin e MCP negli eventi `user_prompt` (predefinito: disabilitato)	`1` per abilitare
`OTEL_LOG_TOOL_CONTENT`	Abilita la registrazione del contenuto di input e output dello strumento negli eventi di span (predefinito: disabilitato). Richiede tracce. Il contenuto viene troncato a 60 KB	`1` per abilitare
`OTEL_LOG_RAW_API_BODIES`	Emetti il corpo completo della richiesta e della risposta JSON dell’API Anthropic Messages come eventi di log `api_request_body` / `api_response_body` (predefinito: disabilitato). I corpi includono l’intera cronologia della conversazione. L’abilitazione di questa opzione implica il consenso a tutto ciò che `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, e `OTEL_LOG_TOOL_CONTENT` rivelerebbero	`1` per corpi inline troncati a 60 KB, o `file:<dir>` per corpi non troncati su disco con un puntatore `body_ref` nell’evento
`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`	Preferenza di temporalità delle metriche (predefinito: `delta`). Imposta su `cumulative` se il tuo backend prevede temporalità cumulativa	`delta`, `cumulative`
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervallo per l’aggiornamento delle intestazioni dinamiche (predefinito: 1740000ms / 29 minuti)	`900000`

Autenticazione mTLS

Il modo in cui configuri i certificati client per l’esportatore OTLP dipende dal protocollo OTLP in uso per quel segnale, impostato tramite OTEL_EXPORTER_OTLP_PROTOCOL o l’override per segnale. La stessa configurazione si applica a metriche, log e tracce.

Protocollo	Variabili di certificato client	Fidati del CA del collettore con
`http/protobuf`, `http/json`	`CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY`, e facoltativamente `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Vedi Configurazione di rete	`NODE_EXTRA_CA_CERTS`
`grpc`	`OTEL_EXPORTER_OTLP_CLIENT_KEY` e `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, o le varianti per segnale come `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` per usare un certificato diverso per segnale	`OTEL_EXPORTER_OTLP_CERTIFICATE`

Per grpc, l’SDK OpenTelemetry legge direttamente le variabili OTLP standard, quindi le configurazioni esistenti che impostano le variabili di metriche per segnale continuano a funzionare.

Controllo della cardinalità delle metriche

Le seguenti variabili di ambiente controllano quali attributi sono inclusi nelle metriche per gestire la cardinalità:

Variabile di ambiente	Descrizione	Valore predefinito	Esempio per disabilitare
`OTEL_METRICS_INCLUDE_SESSION_ID`	Includi l’attributo session.id nelle metriche	`true`	`false`
`OTEL_METRICS_INCLUDE_VERSION`	Includi l’attributo app.version nelle metriche	`false`	`true`
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Includi gli attributi user.account_uuid e user.account_id nelle metriche	`true`	`false`

Queste variabili aiutano a controllare la cardinalità delle metriche, che influisce sui requisiti di archiviazione e sulle prestazioni delle query nel backend delle metriche. Una cardinalità inferiore generalmente significa prestazioni migliori e costi di archiviazione inferiori, ma dati meno granulari per l’analisi.

Tracce (beta)

Le tracce distribuite esportano span che collegano ogni prompt dell’utente alle richieste API e alle esecuzioni degli strumenti che attiva, in modo da poter visualizzare una richiesta completa come una singola traccia nel tuo backend di traccia. Le tracce sono disabilitate per impostazione predefinita. Per abilitarle, imposta sia CLAUDE_CODE_ENABLE_TELEMETRY=1 che CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1, quindi imposta OTEL_TRACES_EXPORTER per scegliere dove vengono inviati gli span. Le tracce riutilizzano la configurazione OTLP comune per endpoint, protocollo, intestazioni e mTLS.

Variabile di ambiente	Descrizione	Valori di esempio
`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA`	Abilita la traccia degli span (obbligatorio). `ENABLE_ENHANCED_TELEMETRY_BETA` è anche accettato	`1`
`OTEL_TRACES_EXPORTER`	Tipi di esportatore di tracce, separati da virgola. Usa `none` per disabilitare	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	Protocollo per le tracce, sostituisce `OTEL_EXPORTER_OTLP_PROTOCOL`	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Endpoint OTLP per le tracce, sostituisce `OTEL_EXPORTER_OTLP_ENDPOINT`	`http://localhost:4318/v1/traces`
`OTEL_TRACES_EXPORT_INTERVAL`	Intervallo di esportazione batch degli span in millisecondi (predefinito: 5000)	`1000`, `10000`

Gli span redattano il testo del prompt dell’utente, i dettagli di input dello strumento e il contenuto dello strumento per impostazione predefinita. Imposta OTEL_LOG_USER_PROMPTS=1, OTEL_LOG_TOOL_DETAILS=1, e OTEL_LOG_TOOL_CONTENT=1 per includerli. Quando la traccia è attiva, i sottoprocessi Bash e PowerShell ereditano automaticamente una variabile di ambiente TRACEPARENT contenente il contesto di traccia W3C dello span di esecuzione dello strumento attivo. Ciò consente a qualsiasi sottoprocesso che legge TRACEPARENT di far diventare i propri span figli della stessa traccia, abilitando la traccia distribuita end-to-end attraverso script e comandi che Claude esegue. In Agent SDK e sessioni non interattive avviate con -p, Claude Code legge anche TRACEPARENT e TRACESTATE dal proprio ambiente quando avvia ogni span di interazione. Ciò consente a un processo di incorporamento di passare il suo contesto di traccia W3C attivo nel sottoprocesso in modo che gli span di Claude Code appaiano come figli della traccia distribuita del chiamante. Le sessioni interattive ignorano TRACEPARENT in entrata per evitare di ereditare accidentalmente valori ambientali da ambienti CI o container.

Gerarchia degli span

Ogni prompt dell’utente avvia uno span radice claude_code.interaction. Le chiamate API, le chiamate agli strumenti e le esecuzioni degli hook vengono registrate come suoi figli. Gli span degli strumenti hanno due span figli propri: uno per il tempo trascorso in attesa di una decisione di autorizzazione e uno per l’esecuzione stessa. Quando lo strumento Task genera un subagent, gli span API e degli strumenti del subagent si annidano sotto lo span claude_code.tool del genitore.

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (richiede traccia beta dettagliata)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (Strumento Task) span claude_code.llm_request / claude_code.tool del subagent

In Agent SDK e sessioni claude -p, claude_code.interaction stesso diventa un figlio dello span del chiamante quando TRACEPARENT è impostato nell’ambiente.

Attributi degli span

Ogni span porta gli attributi standard più un attributo span.type che corrisponde al suo nome. Le tabelle seguenti elencano gli attributi aggiuntivi impostati su ogni span. Gli span llm_request, tool.execution, e hook impostano lo stato OpenTelemetry ERROR quando registrano un errore; gli altri span terminano sempre con stato UNSET. claude_code.interaction

Attributo	Descrizione	Controllato da
`user_prompt`	Testo del prompt. Il valore è `<REDACTED>` a meno che il gate non sia impostato	`OTEL_LOG_USER_PROMPTS`
`user_prompt_length`	Lunghezza del prompt in caratteri
`interaction.sequence`	Contatore basato su 1 delle interazioni in questa sessione
`interaction.duration_ms`	Durata wall-clock del turno

claude_code.llm_request

Attributo	Descrizione	Controllato da
`model`	Identificatore del modello
`gen_ai.system`	Sempre `anthropic`. Convenzione semantica OpenTelemetry GenAI
`gen_ai.request.model`	Stesso valore di `model`. Convenzione semantica OpenTelemetry GenAI
`query_source`	Sottosistema che ha emesso la richiesta, come `repl_main_thread` o un nome di subagent
`agent_id`	Identificatore del subagent o del collega che ha emesso la richiesta. Assente nella sessione principale
`parent_agent_id`	Identificatore dell’agente che ha generato questo. Assente per la sessione principale e per gli agenti generati direttamente da essa
`speed`	`fast` o `normal`
`llm_request.context`	`interaction`, `tool`, o `standalone` a seconda dello span genitore
`duration_ms`	Durata wall-clock inclusi i tentativi
`ttft_ms`	Tempo al primo token in millisecondi
`input_tokens`	Conteggio dei token di input dal blocco di utilizzo dell’API
`output_tokens`	Conteggio dei token di output
`cache_read_tokens`	Token letti dalla cache del prompt
`cache_creation_tokens`	Token scritti nella cache del prompt
`request_id`	ID della richiesta API Anthropic dall’intestazione della risposta `request-id`
`gen_ai.response.id`	Stesso valore di `request_id`. Convenzione semantica OpenTelemetry GenAI
`client_request_id`	`x-client-request-id` generato dal client del tentativo finale
`attempt`	Tentativi totali effettuati per questa richiesta
`success`	`true` o `false`
`status_code`	Codice di stato HTTP quando la richiesta non è riuscita
`error`	Messaggio di errore quando la richiesta non è riuscita
`response.has_tool_call`	`true` quando la risposta conteneva blocchi di tool-use
`stop_reason`	`stop_reason` della risposta API, come `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn`, o `refusal`
`gen_ai.response.finish_reasons`	Stesso valore di `stop_reason`, racchiuso in un array di stringhe. Convenzione semantica OpenTelemetry GenAI

Ogni tentativo di ripetizione viene anche registrato come evento di span gen_ai.request.attempt con attributi attempt e client_request_id. claude_code.tool

Attributo	Descrizione	Controllato da
`tool_name`	Nome dello strumento
`duration_ms`	Durata wall-clock inclusa l’attesa di autorizzazione e l’esecuzione
`result_tokens`	Dimensione approssimativa in token del risultato dello strumento
`file_path`	Percorso del file di destinazione per gli strumenti Read, Edit e Write	`OTEL_LOG_TOOL_DETAILS`
`full_command`	Stringa di comando per lo strumento Bash	`OTEL_LOG_TOOL_DETAILS`
`skill_name`	Nome della skill per lo strumento Skill	`OTEL_LOG_TOOL_DETAILS`
`subagent_type`	Tipo di subagent per lo strumento Task	`OTEL_LOG_TOOL_DETAILS`

Quando OTEL_LOG_TOOL_CONTENT=1, questo span registra anche un evento di span tool.output i cui attributi contengono i corpi di input e output dello strumento, troncati a 60 KB per attributo. claude_code.tool.blocked_on_user

Attributo	Descrizione	Controllato da
`duration_ms`	Tempo trascorso in attesa della decisione di autorizzazione
`decision`	`accept` o `reject`
`source`	Fonte della decisione, corrispondente all’evento Tool decision event

claude_code.tool.execution

Attributo	Descrizione	Controllato da
`duration_ms`	Tempo trascorso nell’esecuzione del corpo dello strumento
`success`	`true` o `false`
`error`	Stringa di categoria di errore quando l’esecuzione non è riuscita, come `Error:ENOENT` o `ShellError`. Contiene il messaggio di errore completo quando il gate è impostato	`OTEL_LOG_TOOL_DETAILS`

claude_code.hook Questo span viene emesso solo quando la traccia beta dettagliata è attiva, il che richiede ENABLE_BETA_TRACING_DETAILED=1 e BETA_TRACING_ENDPOINT oltre alla configurazione dell’esportatore di tracce sopra. Nelle sessioni CLI interattive, ciò richiede anche che la tua organizzazione sia nella lista di autorizzazione per la funzione. Le sessioni Agent SDK e non interattive -p non sono controllate. Non viene emesso quando è impostato solo CLAUDE_CODE_ENHANCED_TELEMETRY_BETA.

Attributo	Descrizione	Controllato da
`hook_event`	Tipo di evento hook, come `PreToolUse`
`hook_name`	Nome completo dell’hook, come `PreToolUse:Write`
`num_hooks`	Numero di comandi hook corrispondenti eseguiti
`hook_definitions`	Configurazione dell’hook serializzata in JSON	`OTEL_LOG_TOOL_DETAILS`
`duration_ms`	Durata wall-clock di tutti gli hook corrispondenti
`num_success`	Conteggio degli hook completati con successo
`num_blocking`	Conteggio degli hook che hanno restituito una decisione di blocco
`num_non_blocking_error`	Conteggio degli hook che non hanno avuto esito positivo senza bloccare
`num_cancelled`	Conteggio degli hook annullati prima del completamento

Attributi aggiuntivi che portano contenuto come new_context, system_prompt_preview, user_system_prompt, tool_input, e response.model_output vengono emessi solo quando la traccia beta dettagliata è attiva. Non fanno parte dello schema di span stabile. user_system_prompt richiede inoltre OTEL_LOG_USER_PROMPTS=1. Contiene solo il testo del prompt di sistema che fornisci tramite l’opzione SDK systemPrompt o i flag --system-prompt e --append-system-prompt, troncato a 60 KB, ed è emesso una volta per sessione piuttosto che per richiesta.

Intestazioni dinamiche

Per gli ambienti aziendali che richiedono autenticazione dinamica, puoi configurare uno script per generare intestazioni dinamicamente. Le intestazioni dinamiche si applicano solo ai protocolli http/protobuf e http/json. L’esportatore grpc utilizza solo il valore statico OTEL_EXPORTER_OTLP_HEADERS.

Configurazione delle impostazioni

Aggiungi al tuo .claude/settings.json:

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

Requisiti dello script

Lo script deve generare JSON valido con coppie chiave-valore di stringhe che rappresentano intestazioni HTTP:

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

Comportamento di aggiornamento

Lo script dell’helper di intestazioni viene eseguito all’avvio e periodicamente in seguito per supportare l’aggiornamento dei token. Per impostazione predefinita, lo script viene eseguito ogni 29 minuti. Personalizza l’intervallo con la variabile di ambiente CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS.

Supporto per organizzazioni multi-team

Le organizzazioni con più team o dipartimenti possono aggiungere attributi personalizzati per distinguere tra diversi gruppi utilizzando la variabile di ambiente OTEL_RESOURCE_ATTRIBUTES:

# Aggiungi attributi personalizzati per l'identificazione del team
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

Questi attributi personalizzati verranno inclusi in tutte le metriche e gli eventi, permettendoti di:

Filtrare le metriche per team o dipartimento
Tracciare i costi per centro di costo
Creare dashboard specifici per team
Configurare avvisi per team specifici

Requisiti di formattazione importanti per OTEL_RESOURCE_ATTRIBUTES:La variabile di ambiente OTEL_RESOURCE_ATTRIBUTES utilizza coppie chiave=valore separate da virgola con requisiti di formattazione rigorosi:

Nessuno spazio consentito: I valori non possono contenere spazi. Ad esempio, user.organizationName=My Company non è valido
Formato: Deve essere coppie chiave=valore separate da virgola: key1=value1,key2=value2
Caratteri consentiti: Solo caratteri US-ASCII escludendo caratteri di controllo, spazi bianchi, virgolette doppie, virgole, punti e virgola e barre rovesciate
Caratteri speciali: I caratteri al di fuori dell’intervallo consentito devono essere codificati in percentuale

Esempi:

# ❌ Non valido - contiene spazi
export OTEL_RESOURCE_ATTRIBUTES="org.name=John's Organization"

# ✅ Valido - usa sottolineature o camelCase invece
export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

# ✅ Valido - codifica in percentuale i caratteri speciali se necessario
export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

Nota: racchiudere i valori tra virgolette non sfugge agli spazi. Ad esempio, org.name="My Company" risulta nel valore letterale "My Company" (con virgolette incluse), non My Company.

Configurazioni di esempio

Imposta queste variabili di ambiente prima di eseguire claude. Ogni blocco mostra una configurazione completa per un diverso esportatore o scenario di distribuzione:

# Debug della console (intervalli di 1 secondo)
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

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

# Endpoint/backend diversi per metriche e 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

# Solo metriche (nessun evento/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

# Solo eventi/log (nessuna metrica)
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

Metriche e eventi disponibili

Attributi standard

Tutte le metriche e gli eventi condividono questi attributi standard:

Attributo	Descrizione	Controllato da
`session.id`	Identificatore di sessione univoco	`OTEL_METRICS_INCLUDE_SESSION_ID` (predefinito: true)
`app.version`	Versione corrente di Claude Code	`OTEL_METRICS_INCLUDE_VERSION` (predefinito: false)
`organization.id`	UUID dell’organizzazione (quando autenticato)	Sempre incluso quando disponibile
`user.account_uuid`	UUID dell’account (quando autenticato)	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (predefinito: true)
`user.account_id`	ID dell’account in formato taggato corrispondente alle API di amministrazione Anthropic (quando autenticato), come `user_01BWBeN28...`	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (predefinito: true)
`user.id`	Identificatore anonimo del dispositivo/installazione, generato per ogni installazione di Claude Code	Sempre incluso
`user.email`	Indirizzo email dell’utente (quando autenticato tramite OAuth)	Sempre incluso quando disponibile
`terminal.type`	Tipo di terminale, come `iTerm.app`, `vscode`, `cursor`, o `tmux`	Sempre incluso quando rilevato

Gli eventi includono inoltre i seguenti attributi. Questi non vengono mai allegati alle metriche perché causerebbero cardinalità illimitata:

prompt.id: UUID che correla un prompt dell’utente con tutti gli eventi successivi fino al prompt successivo. Vedi Attributi di correlazione degli eventi.
workspace.host_paths: directory dell’area di lavoro host selezionate nell’app desktop, come array di stringhe

Metriche

Claude Code esporta le seguenti metriche:

Nome della metrica	Descrizione	Unità
`claude_code.session.count`	Conteggio delle sessioni CLI avviate	count
`claude_code.lines_of_code.count`	Conteggio delle righe di codice modificate	count
`claude_code.pull_request.count`	Numero di pull request create	count
`claude_code.commit.count`	Numero di commit git creati	count
`claude_code.cost.usage`	Costo della sessione Claude Code	USD
`claude_code.token.usage`	Numero di token utilizzati	tokens
`claude_code.code_edit_tool.decision`	Conteggio delle decisioni di autorizzazione dello strumento di modifica del codice	count
`claude_code.active_time.total`	Tempo attivo totale in secondi	s

Dettagli delle metriche

Ogni metrica include gli attributi standard elencati sopra. Le metriche con attributi aggiuntivi specifici del contesto sono indicate di seguito.

Contatore di sessione

Incrementato all’inizio di ogni sessione. Attributi:

Tutti gli attributi standard
start_type: Come la sessione è stata avviata. Uno di "fresh", "resume", o "continue"

Contatore di righe di codice

Incrementato quando il codice viene aggiunto o rimosso. Attributi:

Tutti gli attributi standard
type: ("added", "removed")

Contatore di pull request

Incrementato quando Claude Code crea una pull request o merge request tramite un comando shell o uno strumento MCP. Attributi:

Tutti gli attributi standard

Contatore di commit

Incrementato quando si creano commit git tramite Claude Code. Attributi:

Tutti gli attributi standard

Contatore di costo

Incrementato dopo ogni richiesta API. Attributi:

Tutti gli attributi standard
model: Identificatore del modello (ad esempio, “claude-sonnet-4-6”)
query_source: Categoria del sottosistema che ha emesso la richiesta. Uno di "main", "subagent", o "auxiliary"
speed: "fast" quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti
effort: Livello di sforzo applicato alla richiesta: "low", "medium", "high", "xhigh", o "max". Assente quando il modello non supporta lo sforzo.
agent.name: Tipo di subagent che ha emesso la richiesta. I nomi degli agenti incorporati e i nomi degli agenti dai plugin del marketplace ufficiale vengono visualizzati così come sono. Gli altri nomi degli agenti definiti dall’utente vengono sostituiti con "custom". Assente quando la richiesta non è stata emessa da un tipo di subagent denominato.
skill.name: Skill attiva per la richiesta, impostata dallo strumento Skill, da un comando /, o ereditata da un subagent generato. I nomi delle skill incorporate, in bundle, definite dall’utente e dei plugin del marketplace ufficiale vengono visualizzati così come sono. I nomi delle skill dei plugin di terze parti vengono sostituiti con "third-party". Assente quando nessuna skill è attiva.
plugin.name: Plugin proprietario quando la skill attiva o il subagent è fornito da un plugin. I nomi dei plugin del marketplace ufficiale vengono visualizzati così come sono. I nomi dei plugin di terze parti vengono sostituiti con "third-party". Assente quando né la skill né il subagent hanno un plugin proprietario.
marketplace.name: Marketplace da cui è stato installato il plugin proprietario. Emesso solo per i plugin del marketplace ufficiale. Assente altrimenti.

Contatore di token

Incrementato dopo ogni richiesta API. Attributi:

Tutti gli attributi standard
type: ("input", "output", "cacheRead", "cacheCreation")
model: Identificatore del modello (ad esempio, “claude-sonnet-4-6”)
query_source: Categoria del sottosistema che ha emesso la richiesta. Uno di "main", "subagent", o "auxiliary"
speed: "fast" quando la richiesta ha utilizzato la modalità veloce. Assente altrimenti
effort: Livello di sforzo applicato alla richiesta. Vedi Contatore di costo per i dettagli.
agent.name, skill.name, plugin.name, marketplace.name: Attribuzione di skill, plugin e agente per la richiesta. Vedi Contatore di costo per le definizioni e il comportamento di redazione.

Contatore di decisione dello strumento di modifica del codice

Incrementato quando l’utente accetta o rifiuta l’utilizzo dello strumento Edit, Write o NotebookEdit. Attributi:

Tutti gli attributi standard
tool_name: Nome dello strumento ("Edit", "Write", "NotebookEdit")
decision: Decisione dell’utente ("accept", "reject")
source: Fonte della decisione. Uno di "config", "hook", "user_permanent", "user_temporary", "user_abort", o "user_reject". Vedi l’Evento di decisione dello strumento per il significato di ogni valore.
language: Linguaggio di programmazione del file modificato, come "TypeScript", "Python", "JavaScript", o "Markdown". Restituisce "unknown" per estensioni di file non riconosciute.

Contatore di tempo attivo

Traccia il tempo effettivo trascorso utilizzando attivamente Claude Code, escludendo il tempo di inattività. Questa metrica viene incrementata durante le interazioni dell’utente (digitazione, lettura delle risposte) e durante l’elaborazione CLI (esecuzione degli strumenti, generazione della risposta AI). Attributi:

Tutti gli attributi standard
type: "user" per le interazioni da tastiera, "cli" per l’esecuzione degli strumenti e le risposte AI

Eventi

Claude Code esporta i seguenti eventi tramite log/eventi OpenTelemetry (quando OTEL_LOGS_EXPORTER è configurato):

Attributi di correlazione degli eventi

Quando un utente invia un prompt, Claude Code potrebbe effettuare più chiamate API ed eseguire diversi strumenti. L’attributo prompt.id ti consente di collegare tutti questi eventi al singolo prompt che li ha attivati.

Attributo	Descrizione
`prompt.id`	Identificatore UUID v4 che collega tutti gli eventi prodotti durante l’elaborazione di un singolo prompt dell’utente

Per tracciare tutta l’attività attivata da un singolo prompt, filtra i tuoi eventi per un valore specifico di prompt.id. Questo restituisce l’evento user_prompt, eventuali eventi api_request, e eventuali eventi tool_result che si sono verificati durante l’elaborazione di quel prompt.

prompt.id è intenzionalmente escluso dalle metriche perché ogni prompt genera un ID univoco, il che creerebbe un numero sempre crescente di serie temporali. Usalo solo per l’analisi a livello di evento e i trail di audit.

Evento di prompt dell’utente

Registrato quando un utente invia un prompt. Nome evento: claude_code.user_prompt Attributi:

Tutti gli attributi standard
event.name: "user_prompt"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
prompt_length: Lunghezza del prompt
prompt: Contenuto del prompt (redatto per impostazione predefinita, abilita con OTEL_LOG_USER_PROMPTS=1)
command_name: Nome del comando quando il prompt ne invoca uno. I nomi dei comandi incorporati e in bundle come compact o debug vengono emessi così come sono; gli alias come reset vengono emessi come digitati piuttosto che il nome canonico. I nomi dei comandi personalizzati, plugin e MCP si riducono a custom o mcp a meno che OTEL_LOG_TOOL_DETAILS=1 non sia impostato
command_source: Origine del comando quando presente: builtin, custom, o mcp. I comandi forniti dai plugin vengono segnalati come custom

Evento di risultato dello strumento

Registrato quando uno strumento completa l’esecuzione. Nome evento: claude_code.tool_result Attributi:

Tutti gli attributi standard
event.name: "tool_result"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
tool_name: Nome dello strumento
tool_use_id: Identificatore univoco per questa invocazione dello strumento. Corrisponde al tool_use_id passato agli hooks, consentendo la correlazione tra gli eventi OTel e i dati acquisiti dagli hooks.
success: "true" o "false"
duration_ms: Tempo di esecuzione in millisecondi
error_type: Stringa di categoria di errore quando lo strumento non è riuscito, come "Error:ENOENT" o "ShellError"
error (quando OTEL_LOG_TOOL_DETAILS=1): Messaggio di errore completo quando lo strumento non è riuscito
decision_type: "accept" o "reject"
decision_source: Fonte della decisione. Uno di "config", "hook", "user_permanent", "user_temporary", "user_abort", o "user_reject". Vedi l’Evento di decisione dello strumento per il significato di ogni valore.
tool_input_size_bytes: Dimensione dell’input dello strumento serializzato in JSON in byte
tool_result_size_bytes: Dimensione del risultato dello strumento in byte
mcp_server_scope: Identificatore dell’ambito del server MCP (per gli strumenti MCP)
tool_parameters (quando OTEL_LOG_TOOL_DETAILS=1): Stringa JSON contenente parametri specifici dello strumento:
- Per lo strumento Bash: include bash_command, full_command, timeout, description, dangerouslyDisableSandbox, e git_commit_id (lo SHA del commit, quando un comando git commit ha successo)
- Per gli strumenti MCP: include mcp_server_name, mcp_tool_name
- Per lo strumento Skill: include skill_name
- Per lo strumento Task: include subagent_type
tool_input (quando OTEL_LOG_TOOL_DETAILS=1): Argomenti dello strumento serializzati in JSON. I singoli valori superiori a 512 caratteri vengono troncati, e il payload completo è limitato a circa 4 K caratteri. Si applica a tutti gli strumenti inclusi gli strumenti MCP.

Evento di richiesta API

Registrato per ogni richiesta API a Claude. Nome evento: claude_code.api_request Attributi:

Tutti gli attributi standard
event.name: "api_request"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
model: Modello utilizzato (ad esempio, “claude-sonnet-4-6”)
cost_usd: Costo stimato in USD
duration_ms: Durata della richiesta in millisecondi
input_tokens: Numero di token di input
output_tokens: Numero di token di output
cache_read_tokens: Numero di token letti dalla cache
cache_creation_tokens: Numero di token utilizzati per la creazione della cache
request_id: ID della richiesta API Anthropic dall’intestazione request-id della risposta, come "req_011...". Presente solo quando l’API ne restituisce uno.
speed: "fast" o "normal", indicando se la modalità veloce era attiva
query_source: Sottosistema che ha emesso la richiesta, come "repl_main_thread", "compact", o un nome di subagent
effort: Livello di sforzo applicato alla richiesta: "low", "medium", "high", "xhigh", o "max". Assente quando il modello non supporta lo sforzo.

Evento di errore API

Registrato quando una richiesta API a Claude non riesce. Nome evento: claude_code.api_error Attributi:

Tutti gli attributi standard
event.name: "api_error"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
model: Modello utilizzato (ad esempio, “claude-sonnet-4-6”)
error: Messaggio di errore
status_code: Codice di stato HTTP come numero. Assente per errori non-HTTP come i guasti di connessione.
duration_ms: Durata della richiesta in millisecondi
attempt: Numero totale di tentativi effettuati, inclusa la richiesta iniziale (1 significa che non si sono verificati tentativi)
request_id: ID della richiesta API Anthropic dall’intestazione request-id della risposta, come "req_011...". Presente solo quando l’API ne restituisce uno.
speed: "fast" o "normal", indicando se la modalità veloce era attiva
query_source: Sottosistema che ha emesso la richiesta, come "repl_main_thread", "compact", o un nome di subagent
effort: Livello di sforzo applicato alla richiesta. Assente quando il modello non supporta lo sforzo.

Evento di corpo della richiesta API

Registrato per ogni tentativo di richiesta API quando OTEL_LOG_RAW_API_BODIES è impostato. Un evento viene emesso per tentativo, quindi i tentativi con parametri regolati producono ciascuno il proprio evento. Nome evento: claude_code.api_request_body Attributi:

Tutti gli attributi standard
event.name: "api_request_body"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
body: Parametri della richiesta dell’API Messages serializzati in JSON (prompt di sistema, messaggi, strumenti, ecc.), troncati a 60 KB. Il contenuto del pensiero esteso nei turni dell’assistente precedenti viene redatto. Emesso solo in modalità inline (OTEL_LOG_RAW_API_BODIES=1).
body_ref: Percorso assoluto a un file <dir>/<uuid>.request.json contenente il corpo non troncato. Emesso solo in modalità file (OTEL_LOG_RAW_API_BODIES=file:<dir>).
body_length: Lunghezza del corpo non troncato. Byte UTF-8 quando OTEL_LOG_RAW_API_BODIES=file:<dir>, o unità di codice UTF-16 quando =1
body_truncated: "true" quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.
model: Identificatore del modello dai parametri della richiesta
query_source: Sottosistema che ha emesso la richiesta (ad esempio, "compact")

Evento di corpo della risposta API

Registrato per ogni risposta API riuscita quando OTEL_LOG_RAW_API_BODIES è impostato. Nome evento: claude_code.api_response_body Attributi:

Tutti gli attributi standard
event.name: "api_response_body"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
body: Risposta dell’API Messages serializzata in JSON (id, blocchi di contenuto, utilizzo, motivo di arresto), troncata a 60 KB. Il contenuto del pensiero esteso viene redatto. Emesso solo in modalità inline (OTEL_LOG_RAW_API_BODIES=1).
body_ref: Percorso assoluto a un file <dir>/<request_id>.response.json contenente il corpo non troncato. Emesso solo in modalità file (OTEL_LOG_RAW_API_BODIES=file:<dir>).
body_length: Lunghezza del corpo non troncato. Byte UTF-8 quando OTEL_LOG_RAW_API_BODIES=file:<dir>, o unità di codice UTF-16 quando =1
body_truncated: "true" quando si è verificato il troncamento inline. Assente in modalità file e quando non si è verificato alcun troncamento.
model: Identificatore del modello
query_source: Sottosistema che ha emesso la richiesta
request_id: ID della richiesta API Anthropic dall’intestazione request-id della risposta, come "req_011...". Presente solo quando l’API ne restituisce uno.

Evento di decisione dello strumento

Registrato quando viene presa una decisione di autorizzazione dello strumento (accetta/rifiuta). Nome evento: claude_code.tool_decision Attributi:

Tutti gli attributi standard
event.name: "tool_decision"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
tool_name: Nome dello strumento (ad esempio, “Read”, “Edit”, “Write”, “NotebookEdit”)
tool_use_id: Identificatore univoco per questa invocazione dello strumento. Corrisponde al tool_use_id passato agli hooks, consentendo la correlazione tra gli eventi OTel e i dati acquisiti dagli hooks.
decision: "accept" o "reject"
source: Fonte della decisione:
- "config": Deciso automaticamente senza richiedere, in base alle impostazioni del progetto, alle regole di autorizzazione nelle impostazioni personali dell’utente, alla politica gestita dall’azienda, ai flag --allowedTools o --disallowedTools, alla modalità di autorizzazione attiva, a una concessione con ambito di sessione da un prompt precedente nella stessa sessione CLI interattiva, o perché lo strumento è intrinsecamente sicuro. L’evento non indica quale di queste fonti corrisponde.
- "hook": Un hook PreToolUse o PermissionRequest ha restituito la decisione.
- "user_permanent": Emesso quando l’utente ha scelto “Sì, e non chiedere di nuovo per …” in un prompt di autorizzazione, il che salva una regola di autorizzazione alle sue impostazioni personali. Nella CLI interattiva questo viene emesso solo per quella scelta stessa; le chiamate successive che corrispondono alla regola salvata emettono "config" invece. Nelle sessioni Agent SDK o non interattive -p, sia la scelta iniziale che le corrispondenze di regole successive emettono "user_permanent". Trattato come un’accettazione.
- "user_temporary": Emesso quando l’utente ha scelto “Sì” in un prompt di autorizzazione per un’approvazione una tantum, o ha scelto una delle opzioni ”… durante questa sessione” in un prompt di modifica o lettura di file. Nella CLI interattiva questo viene emesso solo per la scelta stessa; le chiamate successive consentite da quella concessione con ambito di sessione emettono "config" invece. Nelle sessioni Agent SDK o non interattive -p, sia la scelta che le corrispondenze successive emettono "user_temporary". Trattato come un’accettazione.
- "user_abort": Emesso quando l’utente ha chiuso il prompt di autorizzazione senza rispondere. Trattato come un rifiuto.
- "user_reject": Emesso quando l’utente ha scelto “No” quando richiesto, o una chiamata ha corrisposto a una regola di negazione nelle sue impostazioni personali. Trattato come un rifiuto.

Evento di cambio della modalità di autorizzazione

Registrato quando la modalità di autorizzazione cambia, ad esempio da ciclo Shift+Tab, uscita dalla Plan Mode, o un controllo del gate della modalità automatica. Nome evento: claude_code.permission_mode_changed Attributi:

Tutti gli attributi standard
event.name: "permission_mode_changed"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
from_mode: La modalità di autorizzazione precedente, ad esempio "default", "plan", "acceptEdits", "auto", o "bypassPermissions"
to_mode: La nuova modalità di autorizzazione
trigger: Cosa ha causato il cambio. Uno di "shift_tab", "exit_plan_mode", "auto_gate_denied", o "auto_opt_in". Assente quando la transizione proviene dall’SDK o dal bridge

Evento di autenticazione

Registrato quando /login o /logout si completa. Nome evento: claude_code.auth Attributi:

Tutti gli attributi standard
event.name: "auth"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
action: "login" o "logout"
success: "true" o "false"
auth_method: Metodo di autenticazione, come "oauth"
error_category: Tipo di errore categorico quando l’azione non è riuscita. Il messaggio di errore grezzo non viene mai incluso
status_code: Codice di stato HTTP come stringa quando l’azione non è riuscita con un errore HTTP

Evento di connessione del server MCP

Registrato quando un server MCP si connette, si disconnette o non riesce a connettersi. Nome evento: claude_code.mcp_server_connection Attributi:

Tutti gli attributi standard
event.name: "mcp_server_connection"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
status: "connected", "failed", o "disconnected"
transport_type: Trasporto del server, come "stdio", "sse", o "http"
server_scope: Ambito in cui il server è configurato, come "user", "project", o "local"
duration_ms: Durata del tentativo di connessione in millisecondi
error_code: Codice di errore quando la connessione non è riuscita
server_name (quando OTEL_LOG_TOOL_DETAILS=1): Nome del server configurato
error (quando OTEL_LOG_TOOL_DETAILS=1): Messaggio di errore completo quando la connessione non è riuscita

Evento di errore interno

Registrato quando Claude Code cattura un errore interno inaspettato. Viene registrato solo il nome della classe di errore e un codice di stile errno. Il messaggio di errore e la traccia dello stack non vengono mai inclusi. Questo evento non viene emesso quando si esegue su Bedrock, Vertex, o Foundry, o quando DISABLE_ERROR_REPORTING è impostato. Nome evento: claude_code.internal_error Attributi:

Tutti gli attributi standard
event.name: "internal_error"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
error_name: Nome della classe di errore, come "TypeError" o "SyntaxError"
error_code: Codice errno di Node.js come "ENOENT" quando presente nell’errore

Evento di plugin installato

Registrato quando un plugin finisce di installarsi, sia dal comando CLI claude plugin install che dall’interfaccia utente interattiva /plugin. Nome evento: claude_code.plugin_installed Attributi:

Tutti gli attributi standard
event.name: "plugin_installed"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
marketplace.is_official: "true" se il marketplace è un marketplace ufficiale Anthropic, "false" altrimenti
install.trigger: "cli" o "ui"
plugin.name: Nome del plugin installato. Per i marketplace di terze parti questo è incluso solo quando OTEL_LOG_TOOL_DETAILS=1
plugin.version: Versione del plugin quando dichiarata nella voce del marketplace. Per i marketplace di terze parti questo è incluso solo quando OTEL_LOG_TOOL_DETAILS=1
marketplace.name: Marketplace da cui è stato installato il plugin. Per i marketplace di terze parti questo è incluso solo quando OTEL_LOG_TOOL_DETAILS=1

Evento di plugin caricato

Registrato una volta per ogni plugin abilitato all’avvio della sessione. Usa questo evento per inventariare quali plugin sono attivi nella tua flotta, come complemento a plugin_installed che registra l’azione di installazione stessa. Nome evento: claude_code.plugin_loaded Attributi:

Tutti gli attributi standard
event.name: "plugin_loaded"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
plugin.name: Nome del plugin. Per i plugin al di fuori del marketplace ufficiale e del bundle incorporato il valore è "third-party" a meno che OTEL_LOG_TOOL_DETAILS=1
marketplace.name: Marketplace da cui è stato installato il plugin, quando noto. Redatto a "third-party" nella stessa condizione di plugin.name
plugin.version: Versione dal manifesto del plugin. Incluso solo quando il nome non è redatto e il manifesto dichiara una versione
plugin.scope: Categoria di provenienza per il plugin: "official", "org", "user-local", o "default-bundle"
enabled_via: Come il plugin è stato abilitato: "default-enable", "org-policy", "seed-mount", o "user-install"
plugin_id_hash: Hash deterministico del nome del plugin e del marketplace, inviato solo al tuo esportatore configurato. Ti consente di contare quanti plugin di terze parti distinti sono caricati nella tua flotta senza registrare i loro nomi
has_hooks: Se il plugin contribuisce hooks
has_mcp: Se il plugin contribuisce server MCP
skill_path_count: Numero di directory di skill che il plugin dichiara
command_path_count: Numero di directory di comandi che il plugin dichiara
agent_path_count: Numero di directory di agenti che il plugin dichiara

Evento di skill attivata

Registrato quando una skill viene invocata, sia che Claude la chiami tramite lo strumento Skill sia che tu la esegua come comando /. Nome evento: claude_code.skill_activated Attributi:

Tutti gli attributi standard
event.name: "skill_activated"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
skill.name: Nome della skill. Per le skill definite dall’utente e di terze parti il valore è il placeholder "custom_skill" a meno che OTEL_LOG_TOOL_DETAILS=1
invocation_trigger: Come la skill è stata attivata ("user-slash", "claude-proactive", o "nested-skill")
skill.source: Da dove è stata caricata la skill (ad esempio, "bundled", "userSettings", "projectSettings", "plugin")
plugin.name (quando OTEL_LOG_TOOL_DETAILS=1 o il plugin è da un marketplace ufficiale): Nome del plugin proprietario quando la skill è fornita da un plugin
marketplace.name (quando OTEL_LOG_TOOL_DETAILS=1 o il plugin è da un marketplace ufficiale): Marketplace del plugin proprietario da cui è stato installato, quando la skill è fornita da un plugin

Evento di menzione @

Registrato quando Claude Code risolve una menzione @ in un prompt. Non ogni menzione emette un evento: i percorsi di uscita anticipata come i rifiuti di autorizzazione, i file di grandi dimensioni, gli allegati di riferimento PDF e i guasti dell’elenco delle directory vengono restituiti senza registrazione. Nome evento: claude_code.at_mention Attributi:

Tutti gli attributi standard
event.name: "at_mention"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
mention_type: Tipo di menzione ("file", "directory", "agent", "mcp_resource")
success: Se la menzione è stata risolta con successo ("true" o "false")

Evento di tentativi API esauriti

Registrato una volta quando una richiesta API non riesce dopo più di un tentativo. Emesso insieme all’evento api_error finale. Nome evento: claude_code.api_retries_exhausted Attributi:

Tutti gli attributi standard
event.name: "api_retries_exhausted"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
model: Modello utilizzato
error: Messaggio di errore finale
status_code: Codice di stato HTTP come numero. Assente per errori non-HTTP.
total_attempts: Numero totale di tentativi effettuati
total_retry_duration_ms: Tempo wall-clock totale tra tutti i tentativi
speed: "fast" o "normal"

Evento di hook registrato

Registrato una volta per ogni hook configurato all’avvio della sessione. Usa questo evento per inventariare quali hook sono attivi nella tua flotta, come complemento agli eventi per esecuzione hook_execution_start e hook_execution_complete. Nome evento: claude_code.hook_registered Attributi:

Tutti gli attributi standard
event.name: "hook_registered"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
hook_event: Tipo di evento hook, come "PreToolUse" o "PostToolUse"
hook_type: Tipo di implementazione dell’hook: "command", "prompt", "mcp_tool", "http", o "agent"
hook_source: Dove è definito l’hook: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings", o "pluginHook"
hook_matcher (quando OTEL_LOG_TOOL_DETAILS=1): La stringa matcher dalla configurazione dell’hook, quando è impostata
plugin.name (quando hook_source è "pluginHook"): Nome del plugin che contribuisce. Per i plugin al di fuori del marketplace ufficiale e del bundle incorporato il valore è "third-party" a meno che OTEL_LOG_TOOL_DETAILS=1
plugin_id_hash (quando hook_source è "pluginHook"): Hash deterministico del nome del plugin e del marketplace, inviato solo al tuo esportatore configurato. Ti consente di contare i plugin che contribuiscono distinti senza registrare i loro nomi

Evento di inizio esecuzione dell’hook

Registrato quando uno o più hook iniziano a eseguirsi per un evento hook. Nome evento: claude_code.hook_execution_start Attributi:

Tutti gli attributi standard
event.name: "hook_execution_start"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
hook_event: Tipo di evento hook, come "PreToolUse" o "PostToolUse"
hook_name: Nome completo dell’hook incluso il matcher, come "PreToolUse:Write"
num_hooks: Numero di comandi hook corrispondenti
managed_only: "true" quando sono consentiti solo gli hook della politica gestita
hook_source: "policySettings" o "merged"
hook_definitions: Configurazione dell’hook serializzata in JSON. Incluso solo quando sia la traccia beta dettagliata che OTEL_LOG_TOOL_DETAILS=1 sono abilitati

Evento di completamento esecuzione dell’hook

Registrato quando tutti gli hook per un evento hook hanno terminato. Nome evento: claude_code.hook_execution_complete Attributi:

Tutti gli attributi standard
event.name: "hook_execution_complete"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
hook_event: Tipo di evento hook
hook_name: Nome completo dell’hook incluso il matcher
num_hooks: Numero di comandi hook corrispondenti
num_success: Conteggio che ha completato con successo
num_blocking: Conteggio che ha restituito una decisione di blocco
num_non_blocking_error: Conteggio che non ha avuto esito positivo senza bloccare
num_cancelled: Conteggio annullato prima del completamento
total_duration_ms: Durata wall-clock di tutti gli hook corrispondenti
managed_only: "true" quando sono consentiti solo gli hook della politica gestita
hook_source: "policySettings" o "merged"
hook_definitions: Configurazione dell’hook serializzata in JSON. Incluso solo quando sia la traccia beta dettagliata che OTEL_LOG_TOOL_DETAILS=1 sono abilitati

Evento di compattazione

Registrato quando la compattazione della conversazione si completa. Nome evento: claude_code.compaction Attributi:

Tutti gli attributi standard
event.name: "compaction"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
trigger: "auto" o "manual"
success: "true" o "false"
duration_ms: Durata della compattazione
pre_tokens: Conteggio approssimativo dei token prima della compattazione
post_tokens: Conteggio approssimativo dei token dopo la compattazione
error: Messaggio di errore quando la compattazione non è riuscita

Evento di sondaggio di feedback

Registrato quando viene mostrato o risposto a un sondaggio sulla qualità della sessione. Vedi Sondaggi sulla qualità della sessione per sapere cosa raccolgono i sondaggi e come controllarli. Nome evento: claude_code.feedback_survey Attributi:

Tutti gli attributi standard
event.name: "feedback_survey"
event.timestamp: Timestamp ISO 8601
event.sequence: Contatore monotonicamente crescente per ordinare gli eventi all’interno di una sessione
event_type: Evento del ciclo di vita del sondaggio, ad esempio "appeared", "responded", o "transcript_prompt_appeared"
appearance_id: ID univoco che collega gli eventi emessi per un’istanza di sondaggio
survey_type: Quale sondaggio ha prodotto l’evento. "session" è il prompt di valutazione “Come sta andando Claude?”
response: La selezione dell’utente su eventi responded
enabled_via_override: true quando CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL è impostato. Emesso come booleano, non come stringa. Presente su eventi di sondaggio session. Filtra su questo attributo per confermare che l’override è applicato in tutta la flotta

Interpretazione dei dati di metriche e eventi

Le metriche e gli eventi esportati supportano una gamma di analisi:

Monitoraggio dell’utilizzo

Metrica	Opportunità di analisi
`claude_code.token.usage`	Suddividi per `type` (input/output), utente, team, modello, `skill.name`, `plugin.name`, o `agent.name`
`claude_code.session.count`	Traccia l’adozione e l’engagement nel tempo
`claude_code.lines_of_code.count`	Misura la produttività tracciando le aggiunte/rimozioni di codice
`claude_code.commit.count` & `claude_code.pull_request.count`	Comprendi l’impatto sui flussi di lavoro di sviluppo

Monitoraggio dei costi

La metrica claude_code.cost.usage aiuta con:

Tracciare i trend di utilizzo tra team o individui
Identificare sessioni ad alto utilizzo per l’ottimizzazione
Attribuire la spesa a skill, plugin, o tipi di subagent specifici tramite gli attributi skill.name, plugin.name, e agent.name

Le metriche di costo sono approssimazioni. Per i dati di fatturazione ufficiali, consulta il tuo provider API (Claude Console, Amazon Bedrock, o Google Cloud Vertex).

Avvisi e segmentazione

Avvisi comuni da considerare:

Picchi di costo
Consumo di token inusuale
Alto volume di sessioni da utenti specifici

Tutte le metriche possono essere segmentate per user.account_uuid, user.account_id, organization.id, session.id, model, e app.version.

Rilevare l’esaurimento dei tentativi

Claude Code ritenta internamente le richieste API non riuscite ed emette un singolo evento claude_code.api_error solo dopo che rinuncia, quindi l’evento stesso è il segnale terminale per quella richiesta. I tentativi di ripetizione intermedi non vengono registrati come eventi separati. L’attributo attempt sull’evento registra quanti tentativi sono stati effettuati in totale. Un valore maggiore di CLAUDE_CODE_MAX_RETRIES (predefinito 10) indica che la richiesta ha esaurito tutti i tentativi su un errore transitorio. Un valore inferiore indica un errore non ritentabile come una risposta 400. Per distinguere una sessione che si è ripresa da una che si è bloccata, raggruppa gli eventi per session.id e verifica se esiste un evento api_request successivo dopo l’errore.

Analisi degli eventi

I dati degli eventi forniscono informazioni dettagliate sulle interazioni di Claude Code: Modelli di utilizzo dello strumento: analizza gli eventi di risultato dello strumento per identificare:

Strumenti più frequentemente utilizzati
Tassi di successo dello strumento
Tempi di esecuzione medi dello strumento
Modelli di errore per tipo di strumento

Monitoraggio delle prestazioni: traccia le durate delle richieste API e i tempi di esecuzione dello strumento per identificare i colli di bottiglia delle prestazioni.

Audit degli eventi di sicurezza

Gli eventi OpenTelemetry sono la fonte di dati di audit per l’attività di Claude Code. Ogni evento porta attributi di identità che collegano le chiamate agli strumenti, l’attività MCP e le decisioni di autorizzazione all’utente che le ha attivate, e l’esportatore di log OTLP può fornire questi eventi a qualsiasi piattaforma SIEM (Security Information and Event Management) con un ricevitore OTLP o a un OpenTelemetry Collector che inoltra al tuo SIEM.

Attribuisci le azioni agli utenti

Gli attributi standard su ogni evento includono l’identità dell’utente autenticato: user.email, user.account_uuid, user.account_id, e organization.id quando accedi con un account Claude, più l’user.id con ambito di installazione e il session.id per sessione. Le chiamate agli strumenti MCP, i comandi Bash e le modifiche ai file sono quindi attribuite allo sviluppatore che ha avviato la sessione. Claude Code non agisce con un account di servizio separato; l’identità registrata su ogni evento è l’account Claude dello sviluppatore. Quando Claude Code si autentica con una chiave API diretta, o contro Bedrock, Vertex AI, o Microsoft Foundry, non c’è un account Claude nella sessione e solo user.id e session.id vengono popolati. In questi deployment, allega l’identità dell’utente tu stesso con OTEL_RESOURCE_ATTRIBUTES, impostato per utente tramite il file impostazioni gestite o un wrapper di avvio:

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

Audit dell’attività MCP

Per acquisire l’attività del server MCP con dettagli completi della chiamata, abilita l’esportatore di log e imposta OTEL_LOG_TOOL_DETAILS=1. Ogni operazione MCP produce quindi eventi strutturati che portano il nome del server, il nome dello strumento e gli argomenti della chiamata insieme agli attributi di identità standard:

Evento	Cosa registra per MCP
`mcp_server_connection`	Connessione del server, disconnessione e guasto di connessione con `server_name`, `transport_type`, `server_scope`, e dettagli dell’errore
`tool_result`	Ogni chiamata dello strumento MCP con `tool_name` e `mcp_server_scope`, un payload `tool_parameters` contenente `mcp_server_name` e `mcp_tool_name`, e un payload `tool_input` contenente gli argomenti della chiamata
`tool_decision`	Se la chiamata è stata consentita o negata, e se la decisione proveniva da config, un hook, o l’utente

Senza OTEL_LOG_TOOL_DETAILS, gli eventi tool_result portano comunque tool_name e mcp_server_scope ma omettono la suddivisione mcp_server_name/mcp_tool_name e gli argomenti, e gli eventi mcp_server_connection omettono server_name e il messaggio di errore.

Mappa le domande di sicurezza agli eventi

Quando costruisci regole di rilevamento, cerca il segnale che vuoi monitorare e interroga il tuo backend per l’evento corrispondente e gli attributi:

Segnale	Evento	Attributi chiave
Chiamata dello strumento consentita o negata, e da cosa	`tool_decision`	`decision`, `source`, `tool_name`
Escalation della modalità di autorizzazione	`permission_mode_changed`	`from_mode`, `to_mode`, `trigger`
Hook della politica ha bloccato un’azione	`hook_execution_complete`	`hook_event`, `num_blocking`
Login, logout e guasto di autenticazione	`auth`	`action`, `success`, `error_category`
Connessione del server MCP o guasto	`mcp_server_connection`	`status`, `server_name`, `error_code`
Plugin installato e la sua fonte	`plugin_installed`	`plugin.name`, `marketplace.name`, `marketplace.is_official`
Comandi eseguiti e file toccati	`tool_result` con `OTEL_LOG_TOOL_DETAILS=1`	`tool_parameters`, `tool_input`

Claude Code emette solo il flusso di eventi grezzo. Il rilevamento delle anomalie, il baselining, la correlazione tra sessioni e gli avvisi sono responsabilità del tuo SIEM o backend di osservabilità.

Invia gli eventi a un SIEM

Punta OTEL_EXPORTER_OTLP_LOGS_ENDPOINT al ricevitore OTLP del tuo SIEM, o a un OpenTelemetry Collector che inoltra all’API di ingestione nativa del tuo SIEM. Il seguente esempio di impostazioni gestite esporta solo gli eventi, con dettagli completi dello strumento abilitati per il controllo MCP e Bash:

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

Considerazioni sul backend

La scelta dei backend di metriche, log e tracce determina i tipi di analisi che puoi eseguire:

Per le metriche

Database di serie temporali (ad esempio, Prometheus): Calcoli di velocità, metriche aggregate
Archivi colonnari (ad esempio, ClickHouse): Query complesse, analisi di utenti univoci
Piattaforme di osservabilità complete (ad esempio, Honeycomb, Datadog): Query avanzate, visualizzazione, avvisi

Per eventi/log

Sistemi di aggregazione dei log (ad esempio, Elasticsearch, Loki): Ricerca full-text, analisi dei log
Archivi colonnari (ad esempio, ClickHouse): Analisi degli eventi strutturati
Piattaforme di osservabilità complete (ad esempio, Honeycomb, Datadog): Correlazione tra metriche e eventi

Per tracce

Scegli un backend che supporti l’archiviazione di tracce distribuite e la correlazione degli span:

Sistemi di traccia distribuita (ad esempio, Jaeger, Zipkin, Grafana Tempo): Visualizzazione degli span, waterfall delle richieste, analisi della latenza
Piattaforme di osservabilità complete (ad esempio, Honeycomb, Datadog): Ricerca di tracce e correlazione con metriche e log

Per le organizzazioni che richiedono metriche Daily/Weekly/Monthly Active User (DAU/WAU/MAU), considera backend che supportano query di valori univoci efficienti.

Informazioni sul servizio

Tutte le metriche e gli eventi vengono esportati con i seguenti attributi di risorsa:

service.name: claude-code
service.version: Versione corrente di Claude Code
os.type: Tipo di sistema operativo (ad esempio, linux, darwin, windows)
os.version: Stringa della versione del sistema operativo
host.arch: Architettura dell’host (ad esempio, amd64, arm64)
wsl.version: Numero di versione WSL (presente solo quando si esegue su Windows Subsystem for Linux)
Nome del contatore: com.anthropic.claude_code

Risorse di misurazione del ROI

Per una guida completa sulla misurazione del ritorno sull’investimento per Claude Code, inclusa la configurazione della telemetria, l’analisi dei costi, le metriche di produttività e i report automatizzati, consulta la Guida alla misurazione del ROI di Claude Code. Questo repository fornisce configurazioni Docker Compose pronte all’uso, configurazioni Prometheus e OpenTelemetry, e modelli per generare report di produttività integrati con strumenti come Linear.

Sicurezza e privacy

L’esportazione OpenTelemetry al tuo backend è opt-in e richiede una configurazione esplicita. Per la telemetria operazionale separata di Anthropic e come disabilitarla, vedi Data usage
I contenuti dei file grezzi e i frammenti di codice non sono inclusi nelle metriche o negli eventi. I percorsi di traccia degli span sono un percorso dati separato: vedi il punto OTEL_LOG_TOOL_CONTENT di seguito
Quando autenticato tramite OAuth, user.email è incluso negli attributi di telemetria. Se questo è una preoccupazione per la tua organizzazione, lavora con il tuo backend di telemetria per filtrare o redarre questo campo
Il contenuto del prompt dell’utente non viene raccolto per impostazione predefinita. Viene registrata solo la lunghezza del prompt. Per includere il contenuto del prompt, imposta OTEL_LOG_USER_PROMPTS=1
Gli argomenti di input dello strumento e i parametri non vengono registrati per impostazione predefinita. Per includerli, imposta OTEL_LOG_TOOL_DETAILS=1. Quando abilitato, gli eventi tool_result includono un attributo tool_parameters con comandi Bash, nomi dei server MCP e dello strumento, e nomi delle skill, più un attributo tool_input con percorsi di file, URL, modelli di ricerca e altri argomenti. Gli eventi user_prompt includono il command_name verbatim per i comandi personalizzati, plugin e MCP. Gli span di traccia includono lo stesso attributo tool_input e attributi derivati dall’input come file_path. I singoli valori superiori a 512 caratteri vengono troncati e il totale è limitato a circa 4 K caratteri, ma gli argomenti potrebbero comunque contenere valori sensibili. Configura il tuo backend di telemetria per filtrare o redarre questi attributi secondo necessità
Il contenuto di input e output dello strumento non viene registrato negli span di traccia per impostazione predefinita. Per includerlo, imposta OTEL_LOG_TOOL_CONTENT=1. Quando abilitato, gli eventi di span includono il contenuto completo di input e output dello strumento troncato a 60 KB per span. Questo può includere contenuti di file grezzi dai risultati dello strumento Read e output dei comandi Bash. Configura il tuo backend di telemetria per filtrare o redarre questi attributi secondo necessità
I corpi grezzi della richiesta e della risposta dell’API Anthropic Messages non vengono registrati per impostazione predefinita. Per includerli, imposta OTEL_LOG_RAW_API_BODIES. Con =1, ogni chiamata API emette eventi di log api_request_body e api_response_body il cui attributo body è il payload serializzato in JSON, troncato a 60 KB. Con =file:<dir>, i corpi non troncati vengono scritti in file .request.json e .response.json in quella directory e gli eventi portano un percorso body_ref invece del corpo inline. Spedisci la directory con un log collector o sidecar piuttosto che attraverso il flusso di telemetria. In entrambe le modalità, i corpi contengono l’intera cronologia della conversazione (prompt di sistema, ogni turno precedente dell’utente e dell’assistente, risultati degli strumenti), quindi l’abilitazione di questa opzione implica il consenso a tutto ciò che gli altri flag di contenuto OTEL_LOG_* rivelerebbero. Il contenuto del pensiero esteso di Claude viene sempre redatto da questi corpi indipendentemente da altre impostazioni

Monitoraggio di Claude Code su Amazon Bedrock

Per una guida dettagliata al monitoraggio dell’utilizzo di Claude Code per Amazon Bedrock, consulta Claude Code Monitoring Implementation (Bedrock).

Configurazione e accesso

Distribuzione

Utilizzo e costi

Distribuzione dei plugin

Sicurezza e dati

Adozione

Documentation Index

​Avvio rapido

​Configurazione dell’amministratore

​Dettagli della configurazione

​Variabili di configurazione comuni

​Autenticazione mTLS

​Controllo della cardinalità delle metriche

​Tracce (beta)

​Gerarchia degli span

​Attributi degli span

​Intestazioni dinamiche

​Configurazione delle impostazioni

​Requisiti dello script

​Comportamento di aggiornamento

​Supporto per organizzazioni multi-team

​Configurazioni di esempio

​Metriche e eventi disponibili

​Attributi standard

​Metriche

​Dettagli delle metriche

​Contatore di sessione

​Contatore di righe di codice

​Contatore di pull request

​Contatore di commit

​Contatore di costo

​Contatore di token

​Contatore di decisione dello strumento di modifica del codice

​Contatore di tempo attivo

​Eventi

​Attributi di correlazione degli eventi

​Evento di prompt dell’utente

​Evento di risultato dello strumento

​Evento di richiesta API

​Evento di errore API

​Evento di corpo della richiesta API

​Evento di corpo della risposta API

​Evento di decisione dello strumento

​Evento di cambio della modalità di autorizzazione

​Evento di autenticazione

​Evento di connessione del server MCP

​Evento di errore interno

​Evento di plugin installato

​Evento di plugin caricato

​Evento di skill attivata

​Evento di menzione @

​Evento di tentativi API esauriti

​Evento di hook registrato

​Evento di inizio esecuzione dell’hook

​Evento di completamento esecuzione dell’hook

​Evento di compattazione

​Evento di sondaggio di feedback

​Interpretazione dei dati di metriche e eventi

​Monitoraggio dell’utilizzo

​Monitoraggio dei costi

​Avvisi e segmentazione

​Rilevare l’esaurimento dei tentativi

​Analisi degli eventi

​Audit degli eventi di sicurezza

​Attribuisci le azioni agli utenti

​Audit dell’attività MCP

​Mappa le domande di sicurezza agli eventi

​Invia gli eventi a un SIEM

​Considerazioni sul backend

​Per le metriche

​Per eventi/log

​Per tracce

​Informazioni sul servizio

​Risorse di misurazione del ROI

​Sicurezza e privacy

​Monitoraggio di Claude Code su Amazon Bedrock

Avvio rapido

Configurazione dell’amministratore

Dettagli della configurazione

Variabili di configurazione comuni

Autenticazione mTLS

Controllo della cardinalità delle metriche

Tracce (beta)

Gerarchia degli span

Attributi degli span

Intestazioni dinamiche

Configurazione delle impostazioni

Requisiti dello script

Comportamento di aggiornamento

Supporto per organizzazioni multi-team

Configurazioni di esempio

Metriche e eventi disponibili

Attributi standard

Metriche

Dettagli delle metriche

Contatore di sessione

Contatore di righe di codice

Contatore di pull request

Contatore di commit

Contatore di costo

Contatore di token

Contatore di decisione dello strumento di modifica del codice

Contatore di tempo attivo

Eventi

Attributi di correlazione degli eventi

Evento di prompt dell’utente

Evento di risultato dello strumento

Evento di richiesta API

Evento di errore API

Evento di corpo della richiesta API

Evento di corpo della risposta API

Evento di decisione dello strumento

Evento di cambio della modalità di autorizzazione

Evento di autenticazione

Evento di connessione del server MCP

Evento di errore interno

Evento di plugin installato

Evento di plugin caricato

Evento di skill attivata

Evento di menzione @

Evento di tentativi API esauriti

Evento di hook registrato

Evento di inizio esecuzione dell’hook

Evento di completamento esecuzione dell’hook

Evento di compattazione

Evento di sondaggio di feedback

Interpretazione dei dati di metriche e eventi

Monitoraggio dell’utilizzo

Monitoraggio dei costi

Avvisi e segmentazione

Rilevare l’esaurimento dei tentativi

Analisi degli eventi

Audit degli eventi di sicurezza

Attribuisci le azioni agli utenti

Audit dell’attività MCP

Mappa le domande di sicurezza agli eventi

Invia gli eventi a un SIEM

Considerazioni sul backend

Per le metriche

Per eventi/log

Per tracce

Informazioni sul servizio

Risorse di misurazione del ROI

Sicurezza e privacy

Monitoraggio di Claude Code su Amazon Bedrock