Monitoramento

Saiba como ativar e configurar OpenTelemetry para Claude Code.

Rastreie o uso, custos e atividade de ferramentas do Claude Code em toda a sua organização exportando dados de telemetria através do OpenTelemetry (OTel). Claude Code exporta métricas como dados de série temporal via protocolo de métricas padrão, eventos via protocolo de logs/eventos e, opcionalmente, rastreamentos distribuídos via protocolo de rastreamentos.

Início rápido

Configure OpenTelemetry usando variáveis de ambiente:

# 1. Ativar telemetria
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. Escolher exportadores (ambos são opcionais - configure apenas o que você precisa)
export OTEL_METRICS_EXPORTER=otlp       # Opções: otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp          # Opções: otlp, console, none

# 3. Configurar endpoint OTLP (para exportador OTLP)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. Definir autenticação (se necessário)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. Para depuração: reduzir intervalos de exportação e redefini-los para uso em produção
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 segundos (padrão: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 segundos (padrão: 5000ms)

# 6. Executar Claude Code
claude

Para verificar uma configuração que exporta métricas, verifique seu backend para a métrica claude_code.session.count, que Claude Code emite quando uma sessão é iniciada. Para verificar uma configuração apenas de logs, envie um prompt e verifique o evento claude_code.user_prompt.

Se nada chegar, execute claude --debug e verifique o log de depuração. Claude Code relata falhas dos exportadores que você configura como erros [3P telemetry], onde 3P significa third-party. As linhas prefixadas com [Anthropic telemetry] descrevem a telemetria operacional separada da Anthropic e não indicam um problema com sua configuração.

Para opções de configuração completas, consulte a especificação OpenTelemetry.

Configuração do administrador

Os administradores podem configurar as definições de OpenTelemetry para todos os usuários através do arquivo de configurações gerenciadas. Consulte a precedência de configurações para obter mais informações sobre como as configurações são aplicadas.

Exemplo de configuração de configurações gerenciadas:

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

Claude Code não passa variáveis de ambiente OTEL_* para os subprocessos que ele gera, incluindo a ferramenta Bash, hooks, servidores MCP e servidores de linguagem. Um aplicativo instrumentado com OpenTelemetry que você executa através da ferramenta Bash não herda o endpoint do exportador ou cabeçalhos do Claude Code, então defina essas variáveis diretamente no comando se esse aplicativo precisar exportar sua própria telemetria.

Como as configurações gerenciadas bloqueiam o destino OTLP

Quando você define uma variável OTEL_EXPORTER_OTLP_* nas configurações gerenciadas, Claude Code remove variáveis conflitantes definidas pelo desenvolvedor na inicialização e registra um aviso que você pode ver com claude --debug. O que ele remove depende de qual variável você define:

Endpoints: quando você define OTEL_EXPORTER_OTLP_ENDPOINT, Claude Code remove todos os endpoints por sinal definidos pelo desenvolvedor. Os desenvolvedores não podem apontar um sinal para um coletor diferente, portanto você não precisa também definir as variáveis de endpoint por sinal nas configurações gerenciadas.
Protocolos: quando você define OTEL_EXPORTER_OTLP_PROTOCOL, Claude Code remove todos os protocolos por sinal definidos pelo desenvolvedor.
Credenciais: quando você define OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_CLIENT_KEY ou OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, Claude Code remove as versões por sinal definidas pelo desenvolvedor dessa variável, além de todas as variáveis de endpoint definidas pelo desenvolvedor, genéricas ou por sinal, já que essas credenciais de outra forma alcançariam um coletor que as configurações gerenciadas não escolheram.
Seletores de exportador: OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER e o OTEL_TRACES_EXPORTER beta seguem a precedência normal por chave. Uma configuração do desenvolvedor ainda pode desabilitar um sinal ou alterá-lo para o exportador de console, portanto defina os seletores nas configurações gerenciadas também se você precisar que eles sejam bloqueados. Através de fontes de administrador, OTEL_LOGS_EXPORTER segue a unidade de telemetria enquanto os outros dois seletores se mesclam por chave. Requer Claude Code v2.1.223 ou posterior.
Endpoints de rastreamento beta: com rastreamento beta detalhado ativo, Claude Code exporta logs e rastreamentos para BETA_TRACING_ENDPOINT em vez de através dos exportadores de logs e rastreamentos. Claude Code portanto remove um BETA_TRACING_ENDPOINT definido pelo desenvolvedor sempre que qualquer uma dessas configurações gerenciadas decide o destino de qualquer sinal:
- Um endpoint genérico ou de logs/rastreamentos ou credencial
- Um otelHeadersHelper
- Um seletor de exportador de logs ou rastreamentos definido como none, console ou vazio, valores que mantêm o sinal fora de um coletor
- CLAUDE_CODE_ENABLE_TELEMETRY desativado
Um endpoint ou credencial apenas de métricas não o remove. Antes da v2.1.251, um BETA_TRACING_ENDPOINT definido pelo desenvolvedor redirecionava os logs e rastreamentos que o rastreamento beta detalhado exporta mesmo quando as configurações gerenciadas fixavam o coletor.

Claude Code não remove variáveis por sinal que você define nas configurações gerenciadas em si, portanto você pode rotear um sinal para um coletor diferente definindo sua variável lá, como o exemplo SIEM faz. Se você definir uma credencial por sinal lá, Claude Code remove o endpoint definido pelo desenvolvedor para esse sinal.

Este comportamento de remoção muda para onde a telemetria é entregue, não o que Claude Code coleta.

Antes da v2.1.217, cada variável seguia a precedência de configurações por chave independentemente, portanto um endpoint específico de sinal definido nas configurações do usuário ou no shell redirecionava esse sinal para longe do coletor gerenciado.

Quando o aplicativo de desktop ou um executor de ambiente auto-hospedado inicia Claude Code e nomeia um endpoint OTLP no ambiente que fornece, Claude Code fixa o destino da mesma forma: as variáveis de telemetria do iniciador removem variáveis definidas pelo desenvolvedor exatamente como as configurações gerenciadas fazem. Claude Code não remove variáveis que o próprio iniciador definiu. Requer Claude Code v2.1.251 ou posterior.

Detalhes de configuração

Variáveis de configuração comuns

Essas variáveis configuram exportadores, endpoints e comportamento de exportação para todas as implantações. Se você definir uma variável de endpoint ou protocolo por sinal, como OTEL_EXPORTER_OTLP_METRICS_ENDPOINT, Claude Code a usa em vez da variável genérica para esse sinal. Se você definir uma variável de cabeçalhos por sinal, como OTEL_EXPORTER_OTLP_METRICS_HEADERS, Claude Code a mescla com a genérica OTEL_EXPORTER_OTLP_HEADERS para esse sinal. Em máquinas com configurações gerenciadas, veja Como as configurações gerenciadas bloqueiam o destino OTLP para saber o que Claude Code remove.

Variável de Ambiente	Descrição	Valores de Exemplo
`CLAUDE_CODE_ENABLE_TELEMETRY`	Ativa coleta de telemetria (obrigatório)	`1`
`OTEL_METRICS_EXPORTER`	Tipos de exportador de métricas, separados por vírgula. Use `none` para desativar	`console`, `otlp`, `prometheus`, `none`
`OTEL_LOGS_EXPORTER`	Tipos de exportador de logs/eventos, separados por vírgula. Use `none` para desativar	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_PROTOCOL`	Protocolo para exportador OTLP, aplica-se a todos os sinais. Claude Code não tem protocolo padrão, então defina isso ou a variável de protocolo específica do sinal para cada exportador `otlp` que você ativar	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_ENDPOINT`	Endpoint do coletor OTLP para todos os sinais	`http://localhost:4317`
`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL`	Protocolo para métricas, substitui configuração geral	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`	Endpoint de métricas OTLP, substitui configuração geral	`http://localhost:4318/v1/metrics`
`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL`	Protocolo para logs, substitui configuração geral	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	Endpoint de logs OTLP, substitui configuração geral	`http://localhost:4318/v1/logs`
`OTEL_EXPORTER_OTLP_HEADERS`	Cabeçalhos de autenticação para OTLP	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_METRICS_HEADERS`	Cabeçalhos de autenticação para métricas, mesclados com os cabeçalhos gerais	`Authorization=Bearer token`
`OTEL_EXPORTER_OTLP_LOGS_HEADERS`	Cabeçalhos de autenticação para logs, mesclados com os cabeçalhos gerais	`Authorization=Bearer token`
`OTEL_METRIC_EXPORT_INTERVAL`	Intervalo de exportação em milissegundos (padrão: 60000)	`5000`, `60000`
`OTEL_LOGS_EXPORT_INTERVAL`	Intervalo de exportação de logs em milissegundos (padrão: 5000)	`1000`, `10000`
`OTEL_LOG_USER_PROMPTS`	Ativar registro de conteúdo de prompt do usuário (padrão: desativado)	`1` para ativar
`OTEL_LOG_ASSISTANT_RESPONSES`	Ativar registro de texto de resposta do assistente em eventos `assistant_response` (padrão: desativado). Quando não definido, volta para o valor de `OTEL_LOG_USER_PROMPTS`. Requer Claude Code v2.1.193 ou posterior	`1` para ativar, `0` para manter reduzido
`OTEL_LOG_TOOL_DETAILS`	Ativar registro de parâmetros de ferramenta e argumentos de entrada em eventos de ferramenta e atributos de span de rastreamento: comandos Bash, nomes de servidor MCP e ferramenta, nomes de skill, nomes de workflow criados pelo usuário e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado). Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com o sinalizador desativado. A exceção requer Claude Code v2.1.214 ou posterior	`1` para ativar
`OTEL_LOG_TOOL_CONTENT`	Ativar registro de conteúdo de ferramenta no evento de span `tool.output` (padrão: desativado). Os atributos de span carregam conteúdo de ferramenta sob seus próprios gates. Requer rastreamento. O conteúdo é truncado no limite de conteúdo (60 KB por padrão)	`1` para ativar
`OTEL_LOG_MANAGED_SETTINGS`	Adicionar as configurações gerenciadas reduzidas e um resumo SHA-256 das configurações antes da redução aos eventos managed settings resolved (padrão: desativado). Um valor em configurações de projeto ou local não o ativa. Requer Claude Code v2.1.274 ou posterior	`1` para ativar
`OTEL_LOG_RAW_API_BODIES`	Emitir o corpo JSON completo da solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body` (padrão: desativado). Os corpos incluem todo o histórico de conversa. Ativar isso implica consentimento para tudo que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` e `OTEL_LOG_TOOL_CONTENT` revelariam	`1` para corpos inline truncados no limite de conteúdo (60 KB por padrão), ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Limite de conteúdo: o comprimento máximo de atributos que contêm conteúdo, como respostas de modelo, conteúdo de ferramenta, prompts do sistema e corpos de API brutos, marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). O padrão é dimensionado para backends que limitam valores de atributo a 64 KB; aumente-o apenas se seu backend aceitar valores maiores, ou diminua-o para reduzir o volume de telemetria. Quando um limite de atributo do SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou uma de suas variantes de logrecord e span, é definido como menor, Claude Code trunca nesse valor menor para que o marcador `[TRUNCATED ...]` permaneça dentro do limite do SDK. Requer Claude Code v2.1.214 ou posterior	`262144`
`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`	Preferência de temporalidade de métricas (padrão: `delta`). Defina como `cumulative` se seu backend espera temporalidade cumulativa	`delta`, `cumulative`
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalo para atualizar cabeçalhos dinâmicos (padrão: 1740000ms / 29 minutos)	`900000`

Para os protocolos http/protobuf e http/json, Claude Code envia cada solicitação de exportação com um cabeçalho Content-Length. Antes da v2.1.212, versões do Claude Code a partir da v2.1.191 enviavam essas solicitações com codificação de transferência em chunks; Azure Monitor e outros endpoints que exigem um comprimento declarado as rejeitavam com erros 411 Length Required ou 400.

Autenticação mTLS

Como você configura certificados de cliente para o exportador OTLP depende do protocolo OTLP em uso para esse sinal, definido via OTEL_EXPORTER_OTLP_PROTOCOL ou a substituição por sinal. A mesma configuração se aplica a métricas, logs e rastreamentos.

Protocolo	Variáveis de certificado do cliente	Confiar na CA do coletor com
`http/protobuf`, `http/json`	`CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` e opcionalmente `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Veja Configuração de rede	`NODE_EXTRA_CA_CERTS`
`grpc`	`OTEL_EXPORTER_OTLP_CLIENT_KEY` e `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, ou as variantes por sinal como `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` para usar um certificado diferente por sinal	`OTEL_EXPORTER_OTLP_CERTIFICATE`

Para grpc, o SDK OpenTelemetry lê as variáveis OTLP padrão diretamente, então as configurações existentes que definem as variáveis de métricas por sinal continuam funcionando. Em máquinas com configurações gerenciadas, Claude Code pode remover credenciais e endpoints por sinal definidos pelo desenvolvedor na inicialização.

Controle de cardinalidade de métricas

As seguintes variáveis de ambiente controlam quais atributos são incluídos nas métricas para gerenciar a cardinalidade:

Variável de Ambiente	Descrição	Valor Padrão	Exemplo para Desativar
`OTEL_METRICS_INCLUDE_SESSION_ID`	Incluir atributo session.id em métricas	`true`	`false`
`OTEL_METRICS_INCLUDE_VERSION`	Incluir atributo app.version em métricas	`false`	`true`
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Incluir atributos user.account_uuid e user.account_id em métricas	`true`	`false`
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Incluir atributo app.entrypoint em métricas	`false`	`true`
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	Incluir chaves de `OTEL_RESOURCE_ATTRIBUTES` como atributos em pontos de dados de métrica	`true`	`false`
`OTEL_METRICS_INCLUDE_REPOSITORY`	Incluir atributos de identidade de repositório `vcs.*` repository attributes em métricas e eventos. Requer Claude Code v2.1.269 ou posterior	`false`	`true`

Cardinalidade mais baixa geralmente significa melhor desempenho e custos de armazenamento mais baixos, mas dados menos granulares para análise.

Rastreamentos (beta)

O rastreamento distribuído exporta spans que vinculam cada prompt do usuário às solicitações de API e execuções de ferramentas que ele dispara, para que você possa visualizar uma solicitação completa como um único rastreamento no seu backend de rastreamento.

O rastreamento está desativado por padrão. Para ativá-lo, defina tanto CLAUDE_CODE_ENABLE_TELEMETRY=1 quanto CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1, depois defina OTEL_TRACES_EXPORTER para escolher para onde os spans são enviados. Os rastreamentos reutilizam a configuração OTLP comum para endpoint, protocolo, cabeçalhos e mTLS. Em máquinas com configurações gerenciadas, Claude Code pode remover credenciais e endpoints por sinal definidos pelo desenvolvedor na inicialização.

Variável de Ambiente	Descrição	Valores de Exemplo
`CLAUDE_CODE_ENHANCED_TELEMETRY_BETA`	Ativar rastreamento de span (obrigatório). `ENABLE_ENHANCED_TELEMETRY_BETA` também é aceito	`1`
`OTEL_TRACES_EXPORTER`	Tipos de exportador de rastreamentos, separados por vírgula. Use `none` para desativar	`console`, `otlp`, `none`
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	Protocolo para rastreamentos, substitui `OTEL_EXPORTER_OTLP_PROTOCOL`	`grpc`, `http/json`, `http/protobuf`
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Endpoint de rastreamentos OTLP, substitui `OTEL_EXPORTER_OTLP_ENDPOINT`	`http://localhost:4318/v1/traces`
`OTEL_EXPORTER_OTLP_TRACES_HEADERS`	Cabeçalhos de autenticação para rastreamentos, mesclados com `OTEL_EXPORTER_OTLP_HEADERS`	`Authorization=Bearer token`
`OTEL_TRACES_EXPORT_INTERVAL`	Intervalo de exportação de lote de span em milissegundos (padrão: 5000)	`1000`, `10000`

Os spans reduzem o texto do prompt do usuário, detalhes de entrada de ferramenta e conteúdo de ferramenta por padrão. Defina OTEL_LOG_USER_PROMPTS=1, OTEL_LOG_TOOL_DETAILS=1 e OTEL_LOG_TOOL_CONTENT=1 para incluí-los.

Quando o rastreamento está ativo, subprocessos Bash e PowerShell herdam automaticamente uma variável de ambiente TRACEPARENT contendo o contexto de rastreamento W3C do span de execução de ferramenta ativo. Isso permite que qualquer subprocesso que leia TRACEPARENT coloque seus próprios spans sob o mesmo rastreamento, permitindo rastreamento distribuído de ponta a ponta através de scripts e comandos que Claude executa.

Quando o rastreamento está ativo e Claude Code está conectado diretamente à API Anthropic, cada solicitação de modelo carrega um cabeçalho W3C traceparent definido para o contexto do span claude_code.llm_request, e o cabeçalho traceresponse da API é registrado como um link de span. Juntos, esses conectam os spans do lado do cliente do Claude Code ao rastreamento do lado do servidor através de qualquer intermediário compatível. As solicitações HTTP MCP de saída carregam traceparent da mesma forma. O cabeçalho não é enviado para provedores terceirizados.

Por padrão, o cabeçalho traceparent em solicitações de modelo e HTTP MCP é enviado apenas quando ANTHROPIC_BASE_URL não está definido ou aponta para a API Anthropic, já que alguns proxies rejeitam cabeçalhos não reconhecidos. A variável TRACEPARENT do subprocesso é controlada pelo mesmo switch para consistência. Se você executar Claude Code através de um proxy ANTHROPIC_BASE_URL customizado e quiser que o contexto de rastreamento seja propagado, defina CLAUDE_CODE_PROPAGATE_TRACEPARENT=1.

No Agent SDK e sessões não-interativas iniciadas com -p, Claude Code também lê TRACEPARENT e TRACESTATE de seu próprio ambiente ao iniciar cada span de interação. Isso permite que um processo de incorporação passe seu contexto de rastreamento W3C ativo para o subprocesso para que os spans do Claude Code apareçam como filhos do rastreamento distribuído do chamador. Sessões interativas ignoram TRACEPARENT de entrada para evitar herdar acidentalmente valores ambientes de CI ou ambientes de contêiner.

O contexto de rastreamento de entrada também se aplica a eventos. No Agent SDK e sessões -p com TRACEPARENT definido, cada registro de log de evento OTLP carrega valores trace_id e span_id que o unem ao rastreamento da sua aplicação, mesmo quando o exportador de rastreamentos não está configurado, para que seu backend de logging possa correlacionar eventos com o resto do rastreamento.

Um registro emitido enquanto uma interação está ativa carrega os IDs do span de interação, mesmo quando Claude Code o emite fora do contexto assíncrono do span, como em um callback de prompt de permissão ou para um registro armazenado em buffer durante a inicialização e exportado posteriormente. Um registro emitido sem nenhum span de interação ativo carrega os IDs TRACEPARENT de entrada diretamente. Antes da v2.1.214, registros emitidos fora do contexto assíncrono do span carregavam os IDs TRACEPARENT de entrada em vez dos IDs do span. Antes da v2.1.212, registros de eventos emitidos fora de um span ativo não carregavam trace_id ou span_id.

Hierarquia de span

Cada prompt do usuário inicia um span raiz claude_code.interaction. Chamadas de API, chamadas de ferramenta e execuções de hook são registradas como seus filhos. Os spans de ferramenta têm dois spans filhos próprios: um para o tempo gasto esperando uma decisão de permissão e outro para a execução em si. Quando a ferramenta Agent ou a ferramenta Task legada gera um subagente, os spans de API e ferramenta do subagente se aninham sob o span claude_code.tool do pai.

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (requer rastreamento beta detalhado)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (ferramenta Agent) spans claude_code.llm_request / claude_code.tool do subagente

No Agent SDK e sessões claude -p, claude_code.interaction em si se torna um filho do span do chamador quando TRACEPARENT está definido no ambiente.

Quando um hook PreToolUse adia uma chamada de ferramenta, Claude Code salva o contexto de rastreamento do turno que o adiou. Quando você retoma a sessão e a ferramenta é executada novamente, os spans da ferramenta se unem ao rastreamento daquele turno anterior como filhos do span claude_code.interaction do turno.

Atributos de span

Cada span carrega os atributos padrão mais um atributo span.type correspondendo ao seu nome. As tabelas abaixo listam os atributos adicionais definidos em cada span. Os spans llm_request, tool.execution e hook definem status OpenTelemetry ERROR quando registram uma falha; os outros spans sempre terminam com status UNSET.

claude_code.interaction

Atributo	Descrição	Controlado Por
`user_prompt`	Texto do prompt. O valor é `<REDACTED>` a menos que o gate esteja definido	`OTEL_LOG_USER_PROMPTS`
`user_prompt_length`	Comprimento do prompt em caracteres
`interaction.sequence`	Contador baseado em 1 de interações, contado por processo Claude Code em vez de por sessão, conforme descrito para `event.sequence`
`parent.source`	Como o span obteve seu pai de rastreamento: `env` quando foi pai sob um `TRACEPARENT` de entrada, `none` quando iniciou seu próprio rastreamento. Requer Claude Code v2.1.268 ou posterior
`interaction.duration_ms`	Duração de parede do turno

claude_code.llm_request

Atributo	Descrição	Controlado Por
`model`	Identificador do modelo
`gen_ai.system`	Sempre `anthropic`. Convenção semântica GenAI OpenTelemetry
`gen_ai.request.model`	Mesmo valor que `model`. Convenção semântica GenAI OpenTelemetry
`query_source`	Subsistema que emitiu a solicitação, como `repl_main_thread` ou um nome de subagente	`ENABLE_BETA_TRACING_DETAILED`
`query_source_safe`	Forma limitada de `query_source`, emitida independentemente de rastreamento beta detalhado estar ativo, com valores como `repl_main_thread` ou `agent.builtin.general-purpose`. `:` se torna `.` e agentes nomeados pelo usuário aparecem como `agent.custom`. Requer Claude Code v2.1.268 ou posterior
`agent_id`	Identificador do subagente ou colega que emitiu a solicitação. Ausente na sessão principal
`parent_agent_id`	Identificador do agente que gerou este. Ausente para a sessão principal e para agentes gerados diretamente a partir dela
`workflow.run_id`	Identificador de execução da ferramenta Workflow que gerou este agente, prefixado `wf_`. Ausente para agentes não gerados por um workflow
`workflow.name`	Nome do workflow que gerou este agente. Nomes criados pelo usuário são substituídos por `custom` a menos que o gate esteja definido	`OTEL_LOG_TOOL_DETAILS`
`speed`	`fast` ou `normal`
`effort`	Nível de esforço aplicado à solicitação: `low`, `medium`, `high`, `xhigh` ou `max`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço. Requer Claude Code v2.1.274 ou posterior
`llm_request.context`	`interaction`, `tool` ou `standalone` dependendo do span pai
`duration_ms`	Duração de parede incluindo tentativas
`ttft_ms`	Tempo até o primeiro token em milissegundos
`first_content_ms`	Tempo desde o início da solicitação até o primeiro bloco de conteúdo da tentativa bem-sucedida, em milissegundos. Ausente em solicitações que voltaram para o caminho não-streaming. Requer Claude Code v2.1.268 ou posterior
`input_tokens`	Contagem de tokens de entrada do bloco de uso da API
`output_tokens`	Contagem de tokens de saída
`cache_read_tokens`	Tokens lidos do cache de prompt
`cache_creation_tokens`	Tokens escritos no cache de prompt
`request_id`	ID de solicitação da API Anthropic do cabeçalho de resposta `request-id`
`gen_ai.response.id`	Mesmo valor que `request_id`. Convenção semântica GenAI OpenTelemetry
`client_request_id`	`x-client-request-id` gerado pelo cliente da tentativa final
`attempt`	Total de tentativas feitas para esta solicitação
`success`	`true` ou `false`
`status_code`	Código de status HTTP quando a solicitação falhou
`error`	Mensagem de erro quando a solicitação falhou
`error_class`	Token de classe de erro curto quando a solicitação falhou, como `api_timeout` ou `server_overload`. Requer Claude Code v2.1.268 ou posterior
`response.has_tool_call`	`true` quando a resposta continha blocos de uso de ferramenta
`stop_reason`	API response `stop_reason`, como `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` ou `refusal`
`gen_ai.response.finish_reasons`	Mesmo valor que `stop_reason`, envolvido em um array de string. Convenção semântica GenAI OpenTelemetry

Cada tentativa de repetição também é registrada como um evento de span gen_ai.request.attempt com atributos attempt e client_request_id.

claude_code.tool

Atributo	Descrição	Controlado Por
`tool_name`	Nome da ferramenta
`tool_name_safe`	Forma de `tool_name` que não carrega nomes escolhidos pelo usuário. Nomes de ferramentas integradas passam verbatim. Nomes de ferramentas MCP aparecem como `mcp_other`, exceto nomes de ferramentas que correspondem a algumas formas fixas, como ferramentas `playwright` nomeadas `browser_*`, que passam verbatim. Requer Claude Code v2.1.268 ou posterior
`bash_command_class`	Para a ferramenta Bash: categoria do primeiro programa do comando de uma lista fixa, como `vcs` ou `package_manager`. `other` para um programa fora da lista, `unparsed` quando a linha não pode ser analisada. Requer Claude Code v2.1.268 ou posterior
`bash_argv0`	Para a ferramenta Bash: o primeiro programa do comando quando está na mesma lista fixa, como `git` ou `npm`. `other` para qualquer programa fora da lista. Requer Claude Code v2.1.268 ou posterior
`duration_ms`	Duração de parede incluindo espera de permissão e execução
`result_tokens`	Tamanho aproximado em tokens do resultado da ferramenta
`agent_id`	Identificador do subagente ou colega que executou a ferramenta. Ausente na sessão principal
`parent_agent_id`	Identificador do agente que gerou este. Ausente para a sessão principal e para agentes gerados diretamente a partir dela
`workflow.run_id`	Identificador de execução da ferramenta Workflow que gerou este agente, prefixado `wf_`. Ausente para agentes não gerados por um workflow
`workflow.name`	Nome do workflow que gerou este agente. Nomes criados pelo usuário são substituídos por `custom` a menos que o gate esteja definido	`OTEL_LOG_TOOL_DETAILS`
`tool_use_id`	O id do bloco `tool_use` do modelo para esta chamada. Corresponde ao `tool_use_id` nos eventos tool_result e tool_decision e nas cargas de hook, para que você possa unir o span a esses registros
`gen_ai.tool.call.id`	Mesmo valor que `tool_use_id`. Convenção semântica GenAI OpenTelemetry
`file_path`	Caminho de arquivo alvo para ferramentas Read, Edit e Write	`OTEL_LOG_TOOL_DETAILS`
`full_command`	String de comando para a ferramenta Bash	`OTEL_LOG_TOOL_DETAILS`
`skill_name`	Nome da skill para a ferramenta Skill	`OTEL_LOG_TOOL_DETAILS`
`subagent_type`	Tipo de subagente para a ferramenta Agent ou ferramenta Task legada	`OTEL_LOG_TOOL_DETAILS`

tool.output span event on claude_code.tool

Se você definir OTEL_LOG_TOOL_CONTENT=1, chamadas Read e Bash podem registrar um evento de span tool.output no span claude_code.tool. Chamadas Edit e Write registram um apenas quando você também define OTEL_LOG_TOOL_DETAILS=1. Essa variável não é limitada a essas duas ferramentas, então verifique sua linha na tabela de configuração para os argumentos que ela adiciona em outro lugar.

Claude Code escreve este evento do retorno bem-sucedido de uma chamada de ferramenta, então uma chamada que gera um erro não registra nada, qualquer que seja a ferramenta. Entre as chamadas que retornam, ela não registra nenhum evento tool.output para:

Uma chamada para qualquer ferramenta que não seja Read, Edit, Write e Bash, incluindo ferramentas MCP e WebFetch
Um Read que retorna qualquer coisa que não seja texto de arquivo, como uma imagem, um PDF ou uma releitura de um arquivo cujo conteúdo não mudou
Uma chamada Edit ou Write, a menos que você também defina OTEL_LOG_TOOL_DETAILS=1

O evento carrega esses atributos, cada um truncado no limite de conteúdo (60 KB por padrão). Controlado Por nomeia a variável que um atributo precisa além de OTEL_LOG_TOOL_CONTENT=1, e para Edit e Write essa variável controla o evento em si em vez do atributo.

Atributo	Descrição	Controlado Por
`content`	Texto que a ferramenta Read retornou, ou o texto que uma chamada Write foi solicitada a escrever	`OTEL_LOG_TOOL_DETAILS` para a ferramenta Write
`output`	Saída combinada de um comando Bash, com stderr intercalado em stdout
`diff`	Patch estruturado que a ferramenta Edit aplicou	`OTEL_LOG_TOOL_DETAILS`
`file_path`	Caminho de arquivo alvo para as ferramentas Read, Edit e Write, repetindo o atributo de span do mesmo nome	`OTEL_LOG_TOOL_DETAILS`
`bash_command`	String de comando para a ferramenta Bash	`OTEL_LOG_TOOL_DETAILS`

O atributo tool_name do span pai informa qual ferramenta um evento veio. Um atributo cortado no limite de conteúdo é acompanhado por <attribute>_truncated e <attribute>_original_length.

claude_code.tool.blocked_on_user

Atributo	Descrição	Controlado Por
`duration_ms`	Tempo gasto esperando a decisão de permissão
`decision`	`accept` ou `reject`
`source`	Fonte de decisão, correspondendo ao Evento de decisão da ferramenta

claude_code.tool.execution

Atributo	Descrição	Controlado Por
`duration_ms`	Tempo gasto executando o corpo da ferramenta
`tool_use_id`	Mesmo valor que no span pai `claude_code.tool`
`gen_ai.tool.call.id`	Mesmo valor que `tool_use_id`. Convenção semântica GenAI OpenTelemetry
`success`	`true` ou `false`
`error`	String de categoria de erro quando a execução falhou, como `Error:ENOENT` ou `ShellError`. Contém a mensagem de erro completa em vez disso quando o gate está definido	`OTEL_LOG_TOOL_DETAILS`
`error_class`	A categoria de erro em forma de identificador, com caracteres fora de letras, dígitos e sublinhados substituídos por `_`, como `Error_ENOENT` ou `ShellError`. Carrega a categoria mesmo quando `error` carrega a mensagem completa. Requer Claude Code v2.1.268 ou posterior

claude_code.hook

Este span aparece apenas quando rastreamento beta detalhado está ativo, o que requer ENABLE_BETA_TRACING_DETAILED=1 e BETA_TRACING_ENDPOINT, um par que também muda para onde seus logs e rastreamentos vão. Defina o par em seu shell, configurações de usuário ou configurações gerenciadas; ambas as variáveis são ignoradas em configurações de projeto e local. CLAUDE_CODE_ENHANCED_TELEMETRY_BETA sozinho não o produz.

Em sessões CLI interativas, rastreamento beta detalhado também requer que sua organização esteja na lista de permissões para o recurso. Sessões Agent SDK e não-interativas -p não requerem lista de permissões.

Atributo	Descrição	Controlado Por
`hook_event`	Tipo de evento de hook, como `PreToolUse`
`hook_name`	Nome completo do hook, como `PreToolUse:Write`
`num_hooks`	Número de comandos de hook correspondentes executados
`hook_definitions`	Configuração de hook serializada em JSON	`OTEL_LOG_TOOL_DETAILS`
`duration_ms`	Duração de parede de todos os hooks correspondentes
`num_success`	Contagem de hooks que completaram com sucesso
`num_blocking`	Contagem de hooks que retornaram uma decisão de bloqueio
`num_non_blocking_error`	Contagem de hooks que falharam sem bloquear
`num_cancelled`	Contagem de hooks cancelados antes da conclusão

Note

Atributos adicionais que contêm conteúdo, como new_context, system_prompt_preview, user_system_prompt, tool_input e response.model_output, são emitidos apenas quando rastreamento beta detalhado está ativo. Eles não fazem parte do esquema de span estável.

O gate em new_context depende de qual span o carrega, e cada cópia é truncada no limite de conteúdo (60 KB por padrão). No span claude_code.tool ele carrega o resultado dessa chamada de ferramenta, qualquer que seja a ferramenta, e requer OTEL_LOG_TOOL_CONTENT=1. No span claude_code.interaction ele carrega o prompt do usuário, e no span claude_code.llm_request as novas mensagens do usuário e resultados de ferramenta dessa solicitação. Ambos requerem OTEL_LOG_USER_PROMPTS=1.

user_system_prompt também requer OTEL_LOG_USER_PROMPTS=1. Ele carrega apenas o texto do prompt do sistema que você fornece através da opção SDK systemPrompt ou dos sinalizadores --system-prompt e --append-system-prompt, truncado no limite de conteúdo (60 KB por padrão), e é emitido uma vez por sessão em vez de por solicitação.

Cabeçalhos dinâmicos

Para ambientes corporativos que exigem autenticação dinâmica, você pode configurar um script para gerar cabeçalhos dinamicamente. Cabeçalhos dinâmicos se aplicam apenas aos protocolos http/protobuf e http/json. Com o protocolo grpc, Claude Code usa apenas as variáveis de cabeçalhos estáticos, OTEL_EXPORTER_OTLP_HEADERS e suas variantes por sinal.

Configuração de configurações

Adicione ao seu .claude/settings.json, substituindo o caminho pelo seu próprio script:

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

O valor pode ser o caminho para um arquivo executável, incluindo um caminho que contém espaços, ou uma linha de comando shell com argumentos. No Windows, o valor sempre é executado através do shell, então coloque entre aspas um caminho que contém espaços dentro do valor JSON.

Requisitos do script

O script deve gerar JSON válido com pares de chave-valor de string representando cabeçalhos HTTP:

#!/bin/bash
# Exemplo: Múltiplos cabeçalhos
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, as exportações falham e seu backend de telemetria não recebe nada da sessão até que o auxiliar funcione novamente. Claude Code relata a falha em:

Uma notificação de aviso em sessões interativas, otelHeadersHelper failed; telemetry is not being exported, mostrada uma vez por sessão quando o auxiliar falha pela primeira vez
Saída de /status
O log de depuração, ao executar com --debug ou após executar /debug na sessão
stderr, em sessões não-interativas iniciadas com -p

Comportamento de atualização

O script auxiliar de cabeçalhos é executado na inicialização e periodicamente depois para suportar atualização de token. Por padrão, o script é executado a cada 29 minutos. Personalize o intervalo com a variável de ambiente CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS.

Suporte a organizações multi-equipe

Organizações com múltiplas equipes ou departamentos podem adicionar atributos personalizados para distinguir entre diferentes grupos usando a variável de ambiente OTEL_RESOURCE_ATTRIBUTES:

# Adicionar atributos personalizados para identificação de equipe
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

Esses atributos personalizados serão incluídos em todas as métricas e eventos, permitindo que você:

Filtre métricas por equipe ou departamento
Rastreie custos por centro de custo
Crie dashboards específicos de equipe
Configure alertas para equipes específicas

Claude Code anexa esses valores como atributos em cada ponto de dados de métrica e registro de evento, além de enviá-los no bloco de recurso OTLP. Como a maioria dos backends de métricas expõe atributos de ponto de dados como rótulos consultáveis, você pode agrupar e filtrar métricas por suas chaves personalizadas diretamente. Exceto pelos atributos de repositório vcs.* repository attributes, chaves personalizadas nunca substituem os atributos padrão como user.id ou session.id: quando uma chave colide, Claude Code mantém o valor integrado.

Cada chave personalizada se torna um rótulo em cada série de métrica, então valores de alta cardinalidade aumentam o custo de armazenamento no seu backend de métricas. Para enviar atributos personalizados apenas no bloco de recurso e omiti-los dos rótulos de ponto de dados, defina OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false. Veja Controle de cardinalidade de métricas.

Warning

A variável de ambiente OTEL_RESOURCE_ATTRIBUTES usa pares chave=valor separados por vírgula com requisitos rigorosos de formatação:

Sem espaços permitidos: os valores não podem conter espaços. Por exemplo, user.organizationName=My Company é inválido
Formato: deve ser pares chave=valor separados por vírgula: key1=value1,key2=value2
Caracteres permitidos: apenas caracteres US-ASCII excluindo caracteres de controle, espaços em branco, aspas duplas, vírgulas, ponto-e-vírgula e barras invertidas
Caracteres especiais: caracteres fora do intervalo permitido devem ser codificados em percentual

Para um valor que precisaria de um espaço, use sublinhados ou camelCase em vez disso. Os exemplos a seguir definem org.name com cada forma:

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

Você pode codificar em percentual qualquer caractere, não apenas os excluídos. Este exemplo codifica tanto o espaço quanto o apóstrofo:

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

Envolver valores em aspas não escapa espaços. Por exemplo, org.name="My Company" resulta no valor literal "My Company" com as aspas incluídas, não My Company.

Configurações de exemplo

Defina essas variáveis de ambiente antes de executar claude. Cada cenário abaixo mostra uma configuração completa, e cada variável é descrita em Variáveis de configuração comuns. Para confirmar que uma configuração entrou em vigor, verifique seu backend para a métrica claude_code.session.count após iniciar uma sessão; o Início rápido cobre verificação apenas de logs e o que verificar quando nada chega.

Para depuração de console com intervalo de exportação de 1 segundo:

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

Para OTLP sobre 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

Para Prometheus, raspado de http://localhost:9464/metrics:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

Em um ambiente auto-hospedado, a sessão vincula a porta 9464 apenas na capacidade padrão do runner de um. Em capacidade mais alta, o runner re-expõe contadores e medidores de sessão em seu próprio endpoint /metrics em vez disso.

Para enviar métricas para múltiplos exportadores:

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

Para enviar métricas e logs para diferentes endpoints ou backends:

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

Para exportar apenas métricas, sem eventos ou logs:

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

Para exportar apenas eventos e logs, sem métricas:

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

Métricas e eventos disponíveis

Atributos padrão

Todas as métricas e eventos compartilham estes atributos padrão:

Atributo	Descrição	Controlado por
`session.id`	Identificador único de sessão	`OTEL_METRICS_INCLUDE_SESSION_ID` (padrão: true)
`app.version`	Versão atual do Claude Code	`OTEL_METRICS_INCLUDE_VERSION` (padrão: false)
`app.entrypoint`	Como a sessão foi iniciada, como `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, ou `claude-vscode`	`OTEL_METRICS_INCLUDE_ENTRYPOINT` (padrão: false)
`organization.id`	UUID da organização (quando autenticado)	Sempre incluído quando disponível
`user.account_uuid`	UUID da conta (quando autenticado)	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (padrão: true)
`user.account_id`	ID da conta em formato marcado correspondendo às APIs de administração da Anthropic (quando autenticado), como `user_01BWBeN28...`	`OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (padrão: true)
`user.id`	Identificador anônimo aleatório gerado na primeira execução e persistido em `~/.claude.json`. Não contém informações pessoais e não é derivado da sua conta Claude. Deletar o arquivo produz um novo valor não relacionado na próxima execução.	Sempre incluído
`user.email`	Endereço de email do usuário, do seu login ou, em uma sessão na nuvem, das credenciais da própria sessão	Sempre incluído quando disponível
`terminal.type`	Tipo de terminal, como `iTerm.app`, `vscode`, `cursor`, ou `tmux`	Sempre incluído quando detectado
Chaves de `OTEL_RESOURCE_ATTRIBUTES`	Atributos personalizados que você define, como `department` ou `team.id`. Veja Suporte a organização multi-equipe	`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (padrão: true)
`vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name`	A identidade do repositório da sessão, derivada do seu remote `origin`. Veja Atributos de repositório	`OTEL_METRICS_INCLUDE_REPOSITORY` (padrão: false). Requer Claude Code v2.1.269 ou posterior

Quando Claude Code está conectado a um gateway de aplicativos Claude, a CLI marca as exportações com a identidade autenticada da sessão do gateway: user.id é o assunto do IdP em vez de um identificador de instalação anônimo, user.email é o email conectado, e user.groups carrega a associação de grupo do IdP como uma string separada por vírgulas. Cada exportação também carrega identity.source: gateway-oidc. A identidade do gateway é aplicada por último, então as chaves user.* e identity.* definidas através de OTEL_RESOURCE_ATTRIBUTES são ignoradas em sessões de gateway.

Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:

prompt.id: UUID correlacionando um prompt do usuário com todos os eventos subsequentes até o próximo prompt. Veja Atributos de correlação de eventos.
workspace.host_paths: diretórios do workspace do host selecionados no aplicativo desktop, como um array de strings
workflow.run_id: identificador de execução, prefixado com wf_, nos eventos de API e ferramenta emitidos por agentes que pertencem a uma execução de ferramenta Workflow. Filtrar eventos por um workflow.run_id reconstrói as requisições de API e resultados de ferramentas dessa execução. O identificador cobre os agentes que o script de workflow gera e quaisquer agentes que esses gerem por sua vez, como invocações de skills. Corresponde ao identificador de execução relatado no resultado da ferramenta Workflow. Ausente em todos os outros eventos. Requer Claude Code v2.1.202 ou posterior
workflow.name: nome do workflow, o meta.name do seu script, emitido junto com workflow.run_id. Os nomes de workflow integrados aparecem literalmente quando a execução executa o script integrado não modificado. Nomes de autoria do usuário, incluindo cópias editadas de scripts integrados, são substituídos por custom a menos que OTEL_LOG_TOOL_DETAILS=1 esteja definido. Requer Claude Code v2.1.202 ou posterior

Atributos de repositório

Defina OTEL_METRICS_INCLUDE_REPOSITORY=true para marcar métricas e eventos com a identidade do repositório da sessão, para que um coletor compartilhado possa atribuir uso por repositório. Requer Claude Code v2.1.269 ou posterior.

Claude Code deriva esses atributos uma vez por sessão do remote origin do repositório. Os remotes HTTPS e SSH de um repositório produzem valores idênticos:

Atributo	Valor
`vcs.repository.url.full`	A URL do navegador do repositório sem `.git`, como `https://github.com/example-org/example-repo`
`vcs.owner.name`	O caminho do proprietário ou grupo, como `example-org`; omitido quando o caminho remoto tem um único segmento
`vcs.repository.name`	O nome do repositório simples, como `example-repo`
`vcs.provider.name`	`github`, `gitlab`, `bitbucket`, ou `gitea` quando Claude Code reconhece o host remoto ou a forma da URL como um desses provedores; omitido caso contrário

Os valores são convertidos para minúsculas, e credenciais, strings de consulta e fragmentos da URL remota nunca aparecem neles. Os atributos são omitidos quando a sessão não tem um remote origin, quando o remote não é em forma de URL, ou quando o único repositório envolvente é seu diretório home.

Uma chave vcs.* que você declara em OTEL_RESOURCE_ATTRIBUTES substitui o valor derivado para essa chave. Se você declarar vcs.repository.url.full, Claude Code nunca lê o remote e relata apenas as chaves que você declara.

Os atributos fluem apenas para seus próprios exportadores; a telemetria da Anthropic descarta todas as chaves vcs.*.

Métricas

Claude Code exporta as seguintes métricas. A coluna Unit mostra a string de unidade OpenTelemetry anexada a cada métrica; métricas de contagem não carregam nenhuma.

Nome da Métrica	Descrição	Unidade
`claude_code.session.count`	Contagem de sessões CLI iniciadas	nenhuma
`claude_code.lines_of_code.count`	Contagem de linhas de código modificadas	nenhuma
`claude_code.pull_request.count`	Número de pull requests criadas	nenhuma
`claude_code.commit.count`	Número de commits git criados	nenhuma
`claude_code.cost.usage`	Custo da sessão Claude Code	USD
`claude_code.token.usage`	Número de tokens usados	tokens
`claude_code.code_edit_tool.decision`	Contagem de decisões de permissão da ferramenta de edição de código	nenhuma
`claude_code.active_time.total`	Tempo ativo total	s

Quando prometheus é o único exportador listado em OTEL_METRICS_EXPORTER, Claude Code omite as unidades USD, tokens, e s das métricas exportadas para que o scrape permaneça em formato de texto Prometheus válido. Os nomes das métricas não mudam, e configurações que combinam exportadores, como otlp,prometheus, mantêm as unidades. Antes da v2.1.216, o scrape do Prometheus incluía linhas # UNIT apenas do OpenMetrics que alguns scrapers rejeitavam.

Detalhes das métricas

Cada métrica inclui os atributos padrão listados acima. Métricas com atributos adicionais específicos do contexto são anotadas abaixo.

Contador de sessão

Incrementado no início de cada sessão.

Atributos:

Todos os atributos padrão
start_type: Como a sessão foi iniciada. Um de "fresh", "resume", "continue", ou "agents_view". O valor "agents_view" identifica o processo do dashboard claude agents, uma UI local iniciada pelo usuário em vez de uma sessão conversacional. Filtre neste valor para separar inicializações de processo de UI de sessões conversacionais em seus dashboards.

Contador de linhas de código

Incrementado quando código é adicionado ou removido.

Atributos:

Todos os atributos padrão
type: ("added", "removed")
model: Identificador do modelo para o modelo que fez a alteração (por exemplo, "claude-sonnet-5")

Contador de pull request

Incrementado quando Claude Code cria uma pull request ou merge request através de um comando shell ou uma ferramenta MCP.

Atributos:

Todos os atributos padrão

Contador de commit

Incrementado ao criar commits git via Claude Code.

Atributos:

Todos os atributos padrão

Contador de custo

Incrementado após cada requisição de API.

Atributos:

Todos os atributos padrão
model: Identificador do modelo (por exemplo, "claude-sonnet-5")
query_source: Categoria do subsistema que emitiu a requisição. Um de "main", "subagent", ou "auxiliary"
speed: "fast" quando a requisição usou modo rápido. Ausente caso contrário
effort: Nível de esforço aplicado à requisição: "low", "medium", "high", "xhigh", ou "max". Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.
agent.name: Tipo de subagente que emitiu a requisição. Nomes de agentes integrados e agentes de plugins do marketplace oficial aparecem literalmente. Outros nomes de agentes definidos pelo usuário são substituídos por "custom". Ausente quando a requisição não foi emitida por um tipo de subagente nomeado.
skill.name: Skill ativa para a requisição, definida pela ferramenta Skill, um comando /, ou herdada por um subagente gerado. Nomes de skills integrados, agrupados, definidos pelo usuário e de plugins do marketplace oficial aparecem literalmente. Nomes de skills de plugins de terceiros são substituídos por "third-party". Ausente quando nenhuma skill está ativa.
plugin.name: Plugin proprietário quando a skill ativa ou subagente é fornecido por um plugin. Nomes de plugins do marketplace oficial aparecem literalmente. Nomes de plugins de terceiros são substituídos por "third-party". Ausente quando nem a skill nem o subagente tem um plugin proprietário.
marketplace.name: Marketplace do qual o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial. Ausente caso contrário.
mcp_server.name: Servidor MCP cujo resultado de ferramenta esta requisição consumiu. Nomes de servidores integrados, proxied por claude.ai e do registro oficial aparecem literalmente. Nomes de servidores configurados pelo usuário são substituídos por "custom". Ausente quando a requisição não consumiu resultado de ferramenta MCP. Antes da v2.1.222, Claude Code definia este atributo em cada requisição após uma chamada de ferramenta MCP, não apenas em requisições que consumiram um resultado de ferramenta, então dashboards que o agregam mostram uma queda após você atualizar.
mcp_tool.name: Ferramenta MCP cujo resultado esta requisição consumiu, com o mesmo comportamento de redação e versão que mcp_server.name. Ausente quando a requisição não consumiu resultado de ferramenta MCP.

Contador de tokens

Incrementado após cada requisição de API.

Atributos:

Todos os atributos padrão
type: ("input", "output", "cacheRead", "cacheCreation")
model: Identificador do modelo (por exemplo, "claude-sonnet-5")
query_source: Categoria do subsistema que emitiu a requisição. Um de "main", "subagent", ou "auxiliary"
speed: "fast" quando a requisição usou modo rápido. Ausente caso contrário
effort: Nível de esforço aplicado à requisição. Veja Contador de custo para detalhes.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribuição de skill, plugin, agente e MCP para a requisição. Veja Contador de custo para definições e comportamento de redação.

Contador de decisão da ferramenta de edição de código

Incrementado quando o usuário aceita ou rejeita o uso da ferramenta Edit, Write, ou NotebookEdit.

Atributos:

Todos os atributos padrão
tool_name: Nome da ferramenta ("Edit", "Write", "NotebookEdit")
decision: Decisão do usuário ("accept", "reject")
source: De onde a decisão veio. Um de "config", "hook", "user_permanent", "user_temporary", "user_abort", ou "user_reject". Veja o evento de decisão de ferramenta para o que cada valor significa.
language: Linguagem de programação do arquivo editado, como "TypeScript", "Python", "JavaScript", ou "Markdown". Retorna "unknown" para extensões de arquivo não reconhecidas.

Contador de tempo ativo

Rastreia o tempo real gasto usando ativamente Claude Code, excluindo tempo ocioso. Esta métrica é incrementada durante interações do usuário, como digitação e leitura de respostas, e durante processamento da CLI, como execução de ferramentas e geração de resposta de IA.

Atributos:

Todos os atributos padrão
type: "user" para interações de teclado, "cli" para execução de ferramentas e respostas de IA

Eventos

Claude Code exporta os seguintes eventos via logs/eventos OpenTelemetry (quando OTEL_LOGS_EXPORTER está configurado):

Atributos de correlação de eventos

Quando um usuário envia um prompt, Claude Code pode fazer múltiplas chamadas de API e executar várias ferramentas. O atributo prompt.id permite vincular todos esses eventos de volta ao único prompt que os acionou.

Atributo	Descrição
`prompt.id`	Identificador UUID v4 vinculando todos os eventos produzidos ao processar um único prompt do usuário
`event.sequence`	Contador baseado em 0 para ordenar eventos, contado por processo Claude Code em vez de por sessão
`message.uuid`	UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects//.jsonl`. Presente em `assistant_response`, em `api_response_body`, e em `user_prompt` exceto para dispatches de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response` e `api_response_body`, esta é a entrada final da transcrição da resposta, da qual o `parentUuid` do próximo turno se encadeia. Requer Claude Code v2.1.214 ou posterior, ou v2.1.274 ou posterior em `api_response_body`
`client_request_id`	UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedores de terceiros e quando a requisição foi retentada através do fallback não-streaming. Emparelha uma requisição com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior

Para rastrear toda atividade acionada por um único prompt, filtre seus eventos por um valor específico de prompt.id. Isto retorna o evento user_prompt, quaisquer eventos api_request, e quaisquer eventos tool_result que ocorreram ao processar esse prompt.

event.sequence começa em 0 cada vez que um processo Claude Code inicia e conta para cima pela vida desse processo. Continua contando através de /clear, que atribui um novo session.id. Se você retomar uma sessão sem fazer fork, a sessão mantém seu session.id mas toma seus valores de event.sequence do processo que a retomou, então dentro de uma sessão um evento posterior pode carregar um valor menor que um anterior, ou repetir um. Para ordenar os eventos de uma sessão, ordene por event.timestamp e use event.sequence para ordenar eventos que compartilham um timestamp.

Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada da transcrição é interno ao Claude Code e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer release; trate as uniões como específicas da versão em vez de um contrato estável:

message.uuid em user_prompt, assistant_response, e api_response_body
request_id nos eventos de API, persistido como requestId nas entradas de assistente da transcrição
tool_use_id em eventos tool_result e tool_decision

Evento de prompt do usuário

Registrado quando um usuário envia um prompt.

Nome do Evento: claude_code.user_prompt

Atributos:

Todos os atributos padrão
event.name: "user_prompt"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
prompt_length: Comprimento do prompt
prompt: Conteúdo do prompt. Redatado por padrão. Defina OTEL_LOG_USER_PROMPTS=1 para incluí-lo
message.uuid: UUID da mensagem do usuário resultante, correspondendo à entrada da transcrição persistida. Ausente em dispatches de comando, que podem produzir zero ou muitas mensagens. Requer Claude Code v2.1.214 ou posterior
command_name: Nome do comando quando o prompt invoca um. Nomes de comando integrados e agrupados como compact ou debug são emitidos como estão; aliases como reset emitem conforme digitado em vez do nome canônico. Nomes de comando personalizados, de plugin e MCP colapsam para custom ou mcp a menos que OTEL_LOG_TOOL_DETAILS=1 esteja definido
command_source: Origem do comando quando presente: builtin, custom, ou mcp. Comandos fornecidos por plugin relatam como custom

Evento de resposta do assistente

Registrado após cada requisição de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos. Requer Claude Code v2.1.193 ou posterior.

Nome do Evento: claude_code.assistant_response

Atributos:

Todos os atributos padrão
event.name: "assistant_response"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
response_length: Comprimento do texto de resposta em caracteres
response: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Redatado para <REDACTED> por padrão. Defina OTEL_LOG_ASSISTANT_RESPONSES=1 para incluí-lo. Quando OTEL_LOG_ASSISTANT_RESPONSES não está definido, OTEL_LOG_USER_PROMPTS o controla em vez disso, então defina OTEL_LOG_ASSISTANT_RESPONSES=0 para manter respostas redatadas enquanto o log de prompt está ativado
model: Identificador do modelo (por exemplo, "claude-sonnet-5")
request_id: ID de requisição de API da Anthropic do header request-id da resposta. Presente apenas quando a API retorna um
message.uuid: UUID da entrada final da transcrição da resposta. Uma resposta de API é persistida como uma entrada de transcrição por bloco de conteúdo; esta é a última, da qual o parentUuid do próximo turno se encadeia. Requer Claude Code v2.1.214 ou posterior
query_source: Subsistema que emitiu a requisição, como "repl_main_thread", "compact", ou um nome de subagente

Evento de resultado de ferramenta

Registrado quando uma ferramenta completa a execução. Não emitido se a chamada de ferramenta foi rejeitada; veja o evento de decisão de ferramenta para rejeições.

Nome do Evento: claude_code.tool_result

Atributos:

Todos os atributos padrão
event.name: "tool_result"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
tool_name: Nome da ferramenta
tool_use_id: Identificador único para esta invocação de ferramenta. Corresponde ao tool_use_id passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.
success: "true" ou "false"
duration_ms: Tempo de execução em milissegundos
error_type: String de categoria de erro quando a ferramenta falhou, como "Error:ENOENT" ou "ShellError"
error (quando OTEL_LOG_TOOL_DETAILS=1): Mensagem de erro completa quando a ferramenta falhou
decision_type: Sempre "accept", já que este evento é emitido apenas após a ferramenta ser executada. Chamadas rejeitadas não produzem um resultado de ferramenta
decision_source: De onde a decisão de permissão veio. Um de "config", "hook", "user_permanent", ou "user_temporary". Veja o evento de decisão de ferramenta para o que cada valor significa. As fontes apenas de rejeição "user_abort" e "user_reject" nunca aparecem neste evento.
tool_input_size_bytes: Tamanho da entrada de ferramenta serializada em JSON em bytes
tool_result_size_bytes: Tamanho do resultado da ferramenta em bytes
mcp_server_scope: Identificador de escopo do servidor MCP (para ferramentas MCP)
vcs.ref.head.revision, vcs.ref.head.name, vcs.ref.head.type (quando OTEL_LOG_TOOL_DETAILS=1): a identidade do commit de uma execução bem-sucedida de git commit executada pela ferramenta Bash ou PowerShell. vcs.ref.head.revision é o SHA do commit, vcs.ref.head.name é o branch no qual foi feito o commit, e vcs.ref.head.type é branch. O nome e tipo são omitidos quando o commit foi feito em um HEAD desanexado. Requer Claude Code v2.1.269 ou posterior
tool_parameters (quando OTEL_LOG_TOOL_DETAILS=1): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, o par mcp_server_name/mcp_tool_name é incluído mesmo com a flag desativada, a mesma exceção de autoria do host que o evento de decisão de ferramenta, requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:
- Para ferramenta Bash: inclui bash_command, full_command, timeout, description, e dangerouslyDisableSandbox, mais git_commit_id e git_branch quando um comando git commit é bem-sucedido. git_commit_id é o SHA completo do commit quando o commit é o HEAD do diretório de trabalho da sessão, e o SHA abreviado do git caso contrário. git_branch é o branch no qual foi feito o commit, omitido em um HEAD desanexado
- Para a ferramenta Bash do workspace do aplicativo desktop, que também relata tool_name como Bash: inclui apenas bash_command, full_command, e timeout
- Para ferramentas MCP: inclui mcp_server_name, mcp_tool_name
- Para ferramenta Skill: inclui skill_name
- Para ferramenta Agent ou ferramenta Task legada: inclui subagent_type
tool_input (quando OTEL_LOG_TOOL_DETAILS=1): Argumentos de ferramenta serializados em JSON. Valores individuais acima de 512 caracteres são truncados, e o payload completo é limitado a ~4 K caracteres. Aplica-se a todas as ferramentas incluindo ferramentas MCP.

Evento de requisição de API

Registrado para cada requisição de API para Claude.

Nome do Evento: claude_code.api_request

Atributos:

Todos os atributos padrão
event.name: "api_request"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
model: Modelo usado (por exemplo, "claude-sonnet-5")
cost_usd: Custo estimado em USD
cost_usd_micros: Custo estimado em milionésimos de dólar americano, emitido como um inteiro
duration_ms: Duração da requisição em milissegundos
input_tokens: Número de tokens de entrada
output_tokens: Número de tokens de saída
cache_read_tokens: Número de tokens lidos do cache
cache_creation_tokens: Número de tokens usados para criação de cache
request_id: ID de requisição de API da Anthropic do header request-id da resposta, como "req_011...". Presente apenas quando a API retorna um.
client_request_id: UUID gerado pelo cliente enviado como o header de requisição x-client-request-id; veja a tabela atributos de correlação de eventos para quando está presente. Requer Claude Code v2.1.214 ou posterior
speed: "fast" ou "normal", indicando se o modo rápido estava ativo
query_source: Subsistema que emitiu a requisição, como "repl_main_thread", "compact", ou um nome de subagente
effort: Nível de esforço aplicado à requisição: "low", "medium", "high", "xhigh", ou "max". Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribuição de skill, plugin, agente e MCP para a requisição. Veja Contador de custo para definições e comportamento de redação.

Evento de erro de API

Registrado quando uma requisição de API para Claude falha.

Nome do Evento: claude_code.api_error

Atributos:

Todos os atributos padrão
event.name: "api_error"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
model: Modelo usado (por exemplo, "claude-sonnet-5")
error: Mensagem de erro
status_code: Código de status HTTP como um número. Ausente para erros não-HTTP como falhas de conexão.
duration_ms: Duração da requisição em milissegundos
attempt: Número total de tentativas feitas, incluindo a requisição inicial (1 significa que nenhuma retentativa ocorreu)
request_id: ID de requisição de API da Anthropic do header request-id da resposta, como "req_011...". Presente apenas quando a API retorna um.
client_request_id: UUID gerado pelo cliente enviado como o header de requisição x-client-request-id. Disponível mesmo quando uma falha como timeout ou erro de conexão nunca produziu um request_id do servidor; veja a tabela atributos de correlação de eventos para quando está presente. Requer Claude Code v2.1.214 ou posterior
speed: "fast" ou "normal", indicando se o modo rápido estava ativo
query_source: Subsistema que emitiu a requisição, como "repl_main_thread", "compact", ou um nome de subagente
effort: Nível de esforço aplicado à requisição. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribuição de skill, plugin, agente e MCP para a requisição. Veja Contador de custo para definições e comportamento de redação.

Evento de recusa de API

Registrado quando uma requisição de API retorna stop_reason: "refusal". Recusas chegam em um stream de resposta bem-sucedido em vez de como um erro HTTP, então o evento api_error não dispara para elas. Este evento permite rastrear a frequência de recusa e agrupar recusas pelos mesmos atributos que api_request e api_error.

Nome do Evento: claude_code.api_refusal

Atributos:

Todos os atributos padrão
event.name: "api_refusal"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
model: Identificador do modelo da requisição
request_id: ID de requisição de API da Anthropic do header request-id da resposta, como "req_011...". Presente apenas quando a API retorna um.
query_source: Subsistema que emitiu a requisição, como "repl_main_thread", "compact", ou um nome de subagente. Veja api_request para definições.
speed: Ou "fast" quando Modo rápido está ativo, ou "normal"
attempt: Número de tentativa de retentativa. A primeira tentativa é 1.
effort: Nível de esforço aplicado à requisição. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.
server_fallback_hop: true quando o fallback de modelo do lado do servidor da API já retentou esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. false quando a requisição terminou em uma recusa. Um único turno pode emitir tanto um evento de hop true quanto um evento final false posterior quando o modelo de fallback também recusa.
has_category: true quando a resposta da API carregava um stop_details.category de "cyber", "bio", "frontier_llm", ou "reasoning_extraction". false quando a resposta não carregava categoria ou um valor fora desse conjunto. Ausente quando server_fallback_hop é true, porque blocos de hop não carregam stop_details.
has_explanation: true quando a resposta da API carregava um stop_details.explanation, caso contrário false. Ausente quando server_fallback_hop é true.
category: O valor stop_details.category da resposta da API. Um de "cyber", "bio", "frontier_llm", ou "reasoning_extraction". Presente apenas quando OTEL_LOG_TOOL_DETAILS=1 está definido e has_category é true.
agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribuição de skill, plugin, agente e MCP para a requisição. Veja Contador de custo para definições e comportamento de redação.

Evento de corpo de requisição de API

Registrado para cada tentativa de requisição de API quando OTEL_LOG_RAW_API_BODIES está definido. Um evento é emitido por tentativa, então retentativas com parâmetros ajustados cada uma produz seu próprio evento.

Nome do Evento: claude_code.api_request_body

Atributos:

Todos os atributos padrão
event.name: "api_request_body"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
body: Parâmetros de requisição da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é redatado. Emitido apenas em modo inline (OTEL_LOG_RAW_API_BODIES=1).
body_ref: Caminho absoluto para um arquivo <dir>/<uuid>.request.json contendo o corpo não truncado. Emitido apenas em modo arquivo (OTEL_LOG_RAW_API_BODIES=file:<dir>).
body_length: Comprimento do corpo não truncado. Bytes UTF-8 quando OTEL_LOG_RAW_API_BODIES=file:<dir>, ou unidades de código UTF-16 quando =1
body_truncated: "true" quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.
model: Identificador do modelo dos parâmetros de requisição
query_source: Subsistema que emitiu a requisição (por exemplo, "compact")
request_body_id: UUID que identifica o corpo de requisição desta tentativa. O evento api_response_body para a tentativa que é bem-sucedida carrega o mesmo valor, então você pode emparelhar uma resposta com a requisição exata que a produziu. Requer Claude Code v2.1.274 ou posterior

Evento de corpo de resposta de API

Registrado para cada resposta de API bem-sucedida quando OTEL_LOG_RAW_API_BODIES está definido.

Em modo arquivo (OTEL_LOG_RAW_API_BODIES=file:<dir>), Claude Code também anexa uma linha JSON a <dir>/index.jsonl para cada resposta bem-sucedida, com os campos timestamp, session_id, query_source, model, request_id, message_id, message_uuid, request_file, e response_file. Leia-o para encontrar os arquivos de requisição e resposta atrás de uma determinada mensagem de transcrição sem consultar seu backend de telemetria. O arquivo de índice requer Claude Code v2.1.274 ou posterior.

Nome do Evento: claude_code.api_response_body

Atributos:

Todos os atributos padrão
event.name: "api_response_body"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
body: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é redatado. Emitido apenas em modo inline (OTEL_LOG_RAW_API_BODIES=1).
body_ref: Caminho absoluto para um arquivo <dir>/<request_id>.response.json contendo o corpo não truncado. Emitido apenas em modo arquivo (OTEL_LOG_RAW_API_BODIES=file:<dir>).
body_length: Comprimento do corpo não truncado. Bytes UTF-8 quando OTEL_LOG_RAW_API_BODIES=file:<dir>, ou unidades de código UTF-16 quando =1
body_truncated: "true" quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.
model: Identificador do modelo
query_source: Subsistema que emitiu a requisição
request_id: ID de requisição de API da Anthropic do header request-id da resposta, como "req_011...". Presente apenas quando a API retorna um.
request_body_id: O request_body_id do evento api_request_body que esta resposta responde. Requer Claude Code v2.1.274 ou posterior
message.id: ID de mensagem que a API atribuiu à resposta, o campo id do corpo da resposta. Requer Claude Code v2.1.274 ou posterior
message.uuid: UUID da entrada final da transcrição da resposta. Junto com request_body_id, vincula uma mensagem de transcrição aos corpos de requisição e resposta atrás dela. Requer Claude Code v2.1.274 ou posterior

Evento de decisão de ferramenta

Registrado quando uma decisão de permissão de ferramenta é feita (aceitar/rejeitar).

Nome do Evento: claude_code.tool_decision

Atributos:

Todos os atributos padrão
event.name: "tool_decision"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
tool_name: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")
tool_use_id: Identificador único para esta invocação de ferramenta. Corresponde ao tool_use_id passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.
decision: Ou "accept" ou "reject"
tool_source: Sempre presente. A proveniência da ferramenta, como um conjunto fechado de valores de autoria da CLI. Requer Claude Code v2.1.214 ou posterior
- "builtin": as próprias ferramentas da CLI
- "mcp": servidores MCP em geral
- "sdk_host_builtin_mcp": um servidor em processo integrado ao próprio Claude Desktop, em uma sessão que Claude Desktop possui. Claude Desktop possui uma sessão que iniciou de um de seus próprios pontos de entrada, claude-desktop, claude-desktop-3p, ou local-agent, quando essa sessão não é um filho aninhado; sessões aninhadas, incluindo sessões que Claude Code gera, relatam esses servidores como "mcp"
source: De onde a decisão veio:
- "config": Decidido automaticamente sem solicitar, baseado em configurações de projeto, regras de permissão ou negação nas configurações pessoais do usuário, política gerenciada pela empresa, flags --allowedTools ou --disallowedTools, o modo de permissão ativo, uma concessão com escopo de sessão de um prompt anterior na mesma sessão CLI interativa, ou porque a ferramenta é inerentemente segura. O evento não indica qual dessas fontes correspondeu. Claude Code também relata "config" quando a própria requisição de prompt de permissão falha, por exemplo quando o callback canUseTool do Agent SDK ou a ferramenta --permission-prompt-tool retorna um resultado inválido, ou quando o stream de entrada fecha enquanto a requisição está pendente. Antes da v2.1.216, Claude Code relatava essas falhas como "user_reject".
- "hook": Um hook PreToolUse ou PermissionRequest retornou a decisão.
- "user_permanent": Emitido quando o usuário escolheu "Sim, e não pergunte novamente para ..." em um prompt de permissão, que salva uma regra de permissão em suas configurações pessoais. Na CLI interativa isto é emitido apenas para essa escolha em si; chamadas posteriores que correspondem à regra salva emitem "config" em vez disso. Em sessões Agent SDK ou não-interativas -p, tanto a escolha inicial quanto correspondências posteriores de regra emitem "user_permanent". Tratado como uma aceitação.
- "user_temporary": Emitido quando o usuário escolheu "Sim" em um prompt de permissão para uma aprovação única, ou escolheu uma opção que concede acesso pelo resto da sessão em um prompt de edição ou leitura de arquivo. Na CLI interativa isto é emitido apenas para a escolha em si; chamadas posteriores permitidas por essa concessão com escopo de sessão emitem "config" em vez disso. Em sessões Agent SDK ou não-interativas -p, tanto a escolha quanto correspondências posteriores emitem "user_temporary". Tratado como uma aceitação.
- "user_abort": Emitido quando o usuário descartou o prompt de permissão sem responder. Em sessões Agent SDK e não-interativas -p, isto inclui interromper o turno enquanto uma requisição de permissão canUseTool ou --permission-prompt-tool está pendente; antes da v2.1.216, Claude Code relatava essa interrupção como "user_reject". Tratado como uma rejeição.
- "user_reject": Emitido quando o usuário escolheu "Não" quando solicitado. Na CLI interativa isto é emitido apenas para essa escolha em si; chamadas que correspondem a uma regra de negação nas configurações pessoais do usuário emitem "config" em vez disso. Em sessões Agent SDK ou não-interativas -p, chamadas que correspondem a uma regra de negação em configurações pessoais emitem "user_reject". Tratado como uma rejeição.
tool_parameters (quando OTEL_LOG_TOOL_DETAILS=1): String JSON contendo parâmetros específicos da ferramenta. Mesma forma que o evento de resultado de ferramenta, menos campos pós-execução como git_commit_id. Os valores podem diferir de tool_result para uma chamada aceita se a decisão de permissão reescreve a entrada da ferramenta via updatedInput. Use este atributo para ver qual comando foi rejeitado quando decision é "reject".
- Para ferramentas "sdk_host_builtin_mcp": mcp_server_name e mcp_tool_name são incluídos mesmo quando OTEL_LOG_TOOL_DETAILS está desativado, porque a aplicação host define esses nomes; sem eles, uma chamada rejeitada para um desses servidores integrados seria não atribuível no stream padrão. Para servidores MCP configurados pelo usuário, o tool_name do evento é sempre o literal "mcp_tool", e os nomes do servidor e ferramenta aparecem apenas em tool_parameters com a flag ativada; conteúdo de argumento requer a flag em todos os lugares. Requer Claude Code v2.1.214 ou posterior
- Para ferramenta Bash: inclui bash_command, full_command, timeout, description, dangerouslyDisableSandbox. A ferramenta bash do workspace do aplicativo desktop também relata tool_name como Bash, mas inclui apenas bash_command, full_command, e timeout
- Para ferramentas MCP: inclui mcp_server_name, mcp_tool_name
- Para ferramenta Skill: inclui skill_name
- Para ferramenta Agent ou ferramenta Task legada: inclui subagent_type

Evento de mudança de modo de permissão

Registrado quando o modo de permissão muda, por exemplo de ciclagem Shift+Tab, saída do modo de plano, ou uma verificação de gate de modo automático.

Nome do Evento: claude_code.permission_mode_changed

Atributos:

Todos os atributos padrão
event.name: "permission_mode_changed"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
from_mode: O modo de permissão anterior, por exemplo "default", "plan", "acceptEdits", "auto", ou "bypassPermissions"
to_mode: O novo modo de permissão
trigger: O que causou a mudança. Um de "shift_tab", "exit_plan_mode", "auto_gate_denied", ou "auto_opt_in". Ausente quando a transição origina do SDK ou bridge

Evento de autenticação

Registrado quando /login ou /logout é concluído.

Nome do Evento: claude_code.auth

Atributos:

Todos os atributos padrão
event.name: "auth"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
action: "login" ou "logout"
success: "true" ou "false"
auth_method: Método de autenticação, como "oauth"
error_category: Tipo de erro categórico quando a ação falhou. A mensagem de erro bruta nunca é incluída
status_code: Código de status HTTP como uma string quando a ação falhou com um erro HTTP

Evento de conexão do servidor MCP

Registrado quando um servidor MCP se conecta, desconecta, ou falha em conectar.

Nome do Evento: claude_code.mcp_server_connection

Atributos:

Todos os atributos padrão
event.name: "mcp_server_connection"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
status: "connected", "failed", ou "disconnected"
transport_type: Transporte do servidor, como "stdio", "sse", ou "http"
server_scope: Escopo no qual o servidor está configurado, como "user", "project", ou "local"
duration_ms: Duração da tentativa de conexão em milissegundos
error_code: Código de erro quando a conexão falhou
is_plugin: true quando o servidor é fornecido por um plugin, false caso contrário
plugin_id_hash (quando is_plugin é true): Hash estável do nome do plugin e marketplace, para agrupar eventos por plugin sem expor o nome. Claude Code o computa conforme descrito no evento de plugin carregado
plugin.name (quando is_plugin é true): Nome do plugin que fornece o servidor. Para plugins de terceiros isto é a string literal "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1; isto protege nomes de plugins de terceiros de aparecerem em logs por padrão. Plugins de fontes oficiais da Anthropic são sempre identificados por nome. Os atributos plugin_id_hash e plugin.name fluem para seu próprio backend de monitoramento e não são enviados para a Anthropic
server_name (quando OTEL_LOG_TOOL_DETAILS=1): Nome do servidor configurado
error (quando OTEL_LOG_TOOL_DETAILS=1): Mensagem de erro completa quando a conexão falhou

Evento de erro interno

Registrado quando Claude Code captura um erro interno inesperado. Apenas o nome da classe de erro e um código estilo errno são registrados. A mensagem de erro e stack trace nunca são incluídos. Este evento não é emitido ao executar contra Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, ou quando DISABLE_ERROR_REPORTING está definido.

Nome do Evento: claude_code.internal_error

Atributos:

Todos os atributos padrão
event.name: "internal_error"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
error_name: Nome da classe de erro, como "TypeError" ou "SyntaxError"
error_code: Código errno do Node.js como "ENOENT" quando presente no erro

Evento de plugin instalado

Registrado quando um plugin termina de instalar, tanto do comando CLI claude plugin install quanto da UI interativa /plugin.

Nome do Evento: claude_code.plugin_installed

Atributos:

Todos os atributos padrão
event.name: "plugin_installed"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
marketplace.is_official: "true" se o marketplace é um marketplace oficial da Anthropic, "false" caso contrário
install.trigger: "cli" ou "ui"
plugin.name: Nome do plugin instalado. Para marketplaces de terceiros isto é incluído apenas quando OTEL_LOG_TOOL_DETAILS=1
plugin.version: Versão do plugin quando declarada na entrada do marketplace. Para marketplaces de terceiros isto é incluído apenas quando OTEL_LOG_TOOL_DETAILS=1
marketplace.name: Marketplace do qual o plugin foi instalado. Para marketplaces de terceiros isto é incluído apenas quando OTEL_LOG_TOOL_DETAILS=1

Evento de plugin carregado

Registrado uma vez por plugin habilitado no início da sessão. Use este evento para inventariar quais plugins estão ativos em sua frota, como complemento a plugin_installed que registra a ação de instalação em si.

Nome do Evento: claude_code.plugin_loaded

Atributos:

Todos os atributos padrão
event.name: "plugin_loaded"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
plugin.name: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1
marketplace.name: marketplace do qual o plugin foi instalado, quando conhecido. Redatado para "third-party" sob a mesma condição que plugin.name
plugin.version: versão do manifesto do plugin. Incluído apenas quando o nome não é redatado e o manifesto declara uma versão
plugin.scope: categoria de proveniência para o plugin: "official", "community", "org", "user-local", ou "default-bundle"
enabled_via: como o plugin veio a ser habilitado: "default-enable", "org-policy", "admin-install", "seed-mount", ou "user-install". O valor "admin-install" significa que o plugin está definido como obrigatório ou auto-instalação para sua organização em Configurações da Organização > Plugins. Antes da v2.1.246, Claude Code relatava esses plugins como "user-install" ou "seed-mount"
plugin_id_hash: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar os plugins de terceiros distintos carregados em sua frota sem registrar seus nomes. Para plugins sincronizados de claude.ai, Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com synced caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash
has_hooks: se o plugin contribui hooks
has_mcp: se o plugin contribui servidores MCP
host_owned_mcp: true quando o host SDK gerencia as conexões MCP deste plugin e Claude Code pulou a leitura da configuração do servidor MCP do plugin, false caso contrário. Requer Claude Code v2.1.172 ou posterior
skill_path_count: número de diretórios de skill que o plugin declara
command_path_count: número de diretórios de comando que o plugin declara
agent_path_count: número de diretórios de agente que o plugin declara
safe_mode: "true" quando a sessão foi iniciada com --safe-mode, "false" caso contrário. Em modo seguro este evento relata apenas inventário configurado; os comandos, skills, hooks e servidores MCP do plugin não carregam. Requer Claude Code v2.1.169 ou posterior

Evento de skill ativada

Registrado quando uma skill é invocada, seja Claude a chama através da ferramenta Skill ou você a executa como um comando /.

Nome do Evento: claude_code.skill_activated

Atributos:

Todos os atributos padrão
event.name: "skill_activated"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
skill.name: Nome da skill. Para skills definidas pelo usuário e de plugins de terceiros o valor é o placeholder "custom_skill" a menos que OTEL_LOG_TOOL_DETAILS=1
invocation_trigger: Como a skill foi acionada ("user-slash", "claude-proactive", ou "nested-skill")
skill.source: De onde a skill foi carregada (por exemplo, "bundled", "userSettings", "projectSettings", "plugin")
skill.kind: "workflow" quando a skill é uma skill de workflow. Ausente caso contrário
plugin.name (quando OTEL_LOG_TOOL_DETAILS=1 ou o plugin é de um marketplace oficial): Nome do plugin proprietário quando a skill é fornecida por um plugin
marketplace.name (quando OTEL_LOG_TOOL_DETAILS=1 ou o plugin é de um marketplace oficial): Marketplace do qual o plugin proprietário foi instalado, quando a skill é fornecida por um plugin

Evento de menção @

Registrado quando Claude Code resolve uma menção @ em um prompt. Nem toda menção emite um evento: caminhos de saída antecipada como negações de permissão, arquivos superdimensionados, anexos de referência PDF e falhas de listagem de diretório retornam sem registrar.

Nome do Evento: claude_code.at_mention

Atributos:

Todos os atributos padrão
event.name: "at_mention"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
mention_type: Tipo de menção ("file", "directory", "agent", "mcp_resource", "peer"). O valor "peer" significa que você mencionou uma de suas outras sessões Claude Code. Requer Claude Code v2.1.232 ou posterior
success: Se a menção foi resolvida com sucesso ("true" ou "false")

Evento de retentativas de API esgotadas

Registrado uma vez quando uma requisição de API falha após mais de uma tentativa. Emitido junto com o evento api_error final.

Nome do Evento: claude_code.api_retries_exhausted

Atributos:

Todos os atributos padrão
event.name: "api_retries_exhausted"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
model: Modelo usado
error: Mensagem de erro final
status_code: Código de status HTTP como um número. Ausente para erros não-HTTP.
total_attempts: Número total de tentativas feitas
total_retry_duration_ms: Tempo total de wall-clock em todas as tentativas
speed: "fast" ou "normal"

Evento de hook registrado

Registrado uma vez por hook configurado no início da sessão. Use este evento para inventariar quais hooks estão ativos em sua frota, como complemento aos eventos por execução hook_execution_start e hook_execution_complete.

Nome do Evento: claude_code.hook_registered

Atributos:

Todos os atributos padrão
event.name: "hook_registered"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
hook_event: tipo de evento de hook, como "PreToolUse" ou "PostToolUse"
hook_type: tipo de implementação de hook: "command", "prompt", "mcp_tool", "http", ou "agent"
hook_source: onde o hook é definido: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings", ou "pluginHook"
safe_mode: "true" quando a sessão foi iniciada com --safe-mode, "false" caso contrário. Requer Claude Code v2.1.169 ou posterior
hook_matcher (quando OTEL_LOG_TOOL_DETAILS=1): a string de matcher da configuração do hook, quando uma está definida
plugin.name (quando hook_source é "pluginHook"): nome do plugin contribuidor. Para plugins fora do marketplace oficial e pacote integrado o valor é "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1
plugin_id_hash (quando hook_source é "pluginHook"): hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar plugins contribuidores distintos sem registrar seus nomes. Claude Code o computa conforme descrito no evento de plugin carregado

Evento de início de execução de hook

Registrado quando um ou mais hooks começam a executar para um evento de hook.

Nome do Evento: claude_code.hook_execution_start

Atributos:

Todos os atributos padrão
event.name: "hook_execution_start"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
hook_event: Tipo de evento de hook, como "PreToolUse" ou "PostToolUse"
hook_name: Nome completo do hook incluindo matcher, como "PreToolUse:Write"
num_hooks: Número de comandos de hook correspondentes
managed_only: "true" quando apenas hooks de política gerenciada são permitidos
hook_source: "policySettings" ou "merged"
safe_mode: "true" quando a sessão foi iniciada com --safe-mode, "false" caso contrário. Requer Claude Code v2.1.169 ou posterior
hook_definitions: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e OTEL_LOG_TOOL_DETAILS=1 estão ambos habilitados

Evento de conclusão de execução de hook

Registrado quando todos os hooks para um evento de hook terminaram.

Nome do Evento: claude_code.hook_execution_complete

Atributos:

Todos os atributos padrão
event.name: "hook_execution_complete"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
hook_event: Tipo de evento de hook
hook_name: Nome completo do hook incluindo matcher
num_hooks: Número de comandos de hook correspondentes
num_success: Contagem que completou com sucesso
num_blocking: Contagem que retornou uma decisão de bloqueio
num_non_blocking_error: Contagem que falhou sem bloquear
num_cancelled: Contagem cancelada antes da conclusão
total_duration_ms: Duração de wall-clock de todos os hooks correspondentes
managed_only: "true" quando apenas hooks de política gerenciada são permitidos
hook_source: "policySettings" ou "merged"
safe_mode: "true" quando a sessão foi iniciada com --safe-mode, "false" caso contrário. Requer Claude Code v2.1.169 ou posterior
hook_definitions: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e OTEL_LOG_TOOL_DETAILS=1 estão ambos habilitados

Evento de métricas de plugin de hook

Registrado quando um hook de plugin do marketplace oficial emite métricas por invocação. Apenas plugins instalados de um marketplace oficial da Anthropic podem emitir estes. Plugins de marketplace de terceiros e hooks configurados pelo usuário não emitem para este evento. Use este evento para monitorar comportamento de plugin como taxas de descoberta, custos e durações de sua própria pilha de observabilidade.

Nome do Evento: claude_code.hook_plugin_metrics

Atributos:

Todos os atributos padrão
event.name: "hook_plugin_metrics"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
plugin_id: identificador do plugin em forma <name>@<marketplace>
hook_event: tipo de evento de hook que emitiu as métricas
Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a ^[a-z][a-z0-9_]{0,39}$. Os valores são booleano ou número.

Evento de compactação

Registrado quando a compactação de conversa é concluída.

Nome do Evento: claude_code.compaction

Atributos:

Todos os atributos padrão
event.name: "compaction"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
trigger: "auto" ou "manual"
success: "true" ou "false"
duration_ms: Duração da compactação
pre_tokens: Contagem aproximada de tokens antes da compactação
post_tokens: Contagem aproximada de tokens após compactação
error: Mensagem de erro quando a compactação falhou
precompute_reuse: Definido apenas quando trigger é "manual". A compactação automática pode preparar um resumo em background antes da janela de contexto ficar cheia, e este atributo registra se /compact reutilizou esse resumo preparado. "hit" significa que foi reutilizado; "miss_custom_instructions", "miss_hook", e "miss_not_ready" dão a razão pela qual um resumo fresco foi computado em vez disso. Requer Claude Code v2.1.153 ou posterior

Evento de conclusão de subagente

Registrado quando um subagente termina e retorna seu resultado para a conversa que o iniciou. Use-o para agregar uso de ferramenta e tempo de execução por tipo de subagente; para agregações de token ou custo, use o contador de tokens e contador de custo filtrados para query_source "subagent", já que o total_tokens deste evento cobre apenas a requisição final. A categoria "subagent" também conta requisições de hooks baseados em agente, que não emitem evento de subagente.

Nome do Evento: claude_code.subagent_completed

Atributos:

Todos os atributos padrão
event.name: "subagent_completed"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
agent_type: O tipo de subagente. Nomes de agentes integrados e agentes de plugins do marketplace oficial aparecem literalmente; outros nomes de agente são substituídos por "custom" a menos que OTEL_LOG_TOOL_DETAILS=1 esteja definido
agent.source: De onde a definição do agente veio: built-in, plugin, ou a fonte de configurações que definiu um agente personalizado, como userSettings ou projectSettings
is_built_in: Se o subagente é um tipo de agente integrado
is_async: Se o subagente executou em background
total_tokens: A pegada de token da requisição final de API do subagente: tokens de entrada, criação de cache, leitura de cache e saída dessa única requisição, aproximadamente o tamanho do contexto do subagente na conclusão. Não uma soma em toda a execução
total_tool_uses: Número de chamadas de ferramenta que o subagente fez em toda a execução
duration_ms: Tempo de execução em milissegundos
model: O modelo que o subagente foi resolvido para executar
final_model: O modelo que produziu a resposta final do subagente, que difere de model após uma mudança no meio da execução como um fallback. Requer Claude Code v2.1.212 ou posterior
model_swapped: Se mais de um modelo serviu as requisições do subagente. Requer Claude Code v2.1.212 ou posterior
plugin_id_hash, plugin.name: Presente para agentes fornecidos por plugin. Nomes de plugins do marketplace oficial aparecem literalmente; outros nomes de plugin são substituídos por "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1 esteja definido

Evento de pesquisa de feedback

Registrado quando uma pesquisa de qualidade de sessão é mostrada ou respondida. Veja Pesquisas de qualidade de sessão para o que as pesquisas coletam e como controlá-las.

Nome do Evento: claude_code.feedback_survey

Atributos:

Todos os atributos padrão
event.name: "feedback_survey"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
event_type: Evento do ciclo de vida da pesquisa, por exemplo "appeared", "responded", ou "transcript_prompt_appeared"
appearance_id: ID único vinculando os eventos emitidos para uma instância de pesquisa
survey_type: Qual pesquisa produziu o evento. "session" é o prompt de classificação "Como Claude está se saindo?"
response: A seleção do usuário em eventos responded
enabled_via_override: true quando CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL está definido. Emitido como um booleano, não uma string. Presente em eventos de pesquisa session. Filtre neste atributo para confirmar que a substituição é aplicada em uma frota

Evento de varredura de retenção

Registrado uma vez por execução da varredura de limpeza de retenção, que deleta transcrições de sessão e outros dados de aplicação mais antigos que a configuração cleanupPeriodDays. Claude Code executa a varredura em background no máximo uma vez por sessão, e uma execução que não deleta nada ainda emite o evento. Se Claude Code executou a varredura em qualquer sessão na mesma máquina nos últimos 24 horas, ele atrasa a varredura desta sessão por pelo menos 10 minutos, então uma sessão que sai mais cedo não emite nada. Quando você executa claude -p com --bare, Claude Code não executa a varredura e não emite nada.

Como todo evento OTel nesta página, ele vai apenas para o backend de telemetria que você configura. Requer Claude Code v2.1.227 ou posterior.

Quando Claude Code não pode determinar com segurança o período de retenção, ele pausa a varredura e emite o evento com result definido para "skipped" e um skip_reason. Quando configurações gerenciadas definem cleanupPeriodDays, o valor gerenciado fixa o período de retenção e a varredura é executada mesmo quando um arquivo de configurações em um escopo de prioridade mais baixa está quebrado ou inválido. Quando managed-settings.json em si não pode ser lido, Claude Code ainda pausa a varredura a menos que o nível gerenciado forneça cleanupPeriodDays de outro lugar, como configurações gerenciadas pelo servidor ou um drop-in managed-settings.d/ ao lado do arquivo quebrado. Os atributos do contador de exclusão estão presentes apenas quando result é "complete".

Nome do Evento: claude_code.retention_sweep

Atributos:

Todos os atributos padrão
event.name: "retention_sweep"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
result: "complete" quando a varredura foi executada, "skipped" quando Claude Code a pausou
period_days: O valor cleanupPeriodDays das configurações mescladas, em dias, ou 30 quando nenhuma fonte o define. Em eventos pulados, o valor que a varredura teria usado, computado das fontes de configurações que Claude Code pôde ler
used_default: "true" quando nenhuma fonte de configurações legível define cleanupPeriodDays, "false" caso contrário. Em eventos completos, "true" significa que o padrão de 30 dias foi aplicado
skip_reason: Por que Claude Code pausou a varredura. Presente apenas quando result é "skipped":
- "user_source_disabled": Configurações do usuário são excluídas, por exemplo pela flag --setting-sources ou opção settingSources do SDK, e nenhuma fonte habilitada fornece cleanupPeriodDays
- "settings_unknowable": Um arquivo de configurações não pôde ser lido ou analisado, então cleanupPeriodDays ou desktopSessionCleanupPeriodDays pode estar definido para um valor que Claude Code não pode ver
- "settings_invalid_key_set": Configurações têm erros de validação e cleanupPeriodDays ou desktopSessionCleanupPeriodDays está explicitamente definido, então fazer fallback para o padrão poderia deletar ou manter arquivos contra essa configuração
transcripts_deleted: Número de transcrições de sessão, os arquivos ~/.claude/projects/*/*.jsonl de nível superior, que a varredura deletou
transcripts_exempted_desktop: Número de transcrições passadas do período de retenção que a varredura manteve sob a regra de Claude Desktop e Cowork. Estes não contam para files_past_cutoff. Requer Claude Code v2.1.248 ou posterior
session_files_deleted: Número de artefatos que a varredura de arquivos de sessão deletou: transcrições mais arquivos complementares por sessão como sidecars, gravações e resultados de ferramentas
artifacts_deleted: Total de itens que a varredura deletou em todos os diretórios de dados que cobre, incluindo os arquivos de sessão. Algumas varreduras contam uma árvore de diretório removida inteira como um item e algumas passagens de limpeza não contribuem para o contador, então trate o valor como um piso em vez de uma contagem exata de arquivos
files_retained_fresh: Arquivos inspecionados e deixados em lugar porque ainda estão dentro do período de retenção. Apenas varreduras por arquivo contam estes, então o valor é um piso; um valor diferente de zero é o estado estável normal
files_past_cutoff: Arquivos mais antigos que o período de retenção que a varredura falhou em deletar, por exemplo por causa de um erro de permissão ou um arquivo mantido aberto. Um valor acima de zero significa que arquivos sobreviveram ao período de retenção configurado; zero não é prova de que nenhum fez, porque uma remoção falhada de um diretório inteiro conta para error_count em vez disso
error_count: Número de erros que a varredura encontrou ao listar ou deletar arquivos

Evento de configurações gerenciadas resolvidas

Registrado com as configurações gerenciadas que uma sessão resolveu: uma vez no início da sessão, novamente quando as configurações gerenciadas ou o auxiliar de política mudam de estado durante a sessão, e quando Claude Code recusa iniciar ou termina a sessão por uma das razões que o atributo error.type lista. Use este evento para encontrar máquinas executando em uma fonte gerenciada inesperada, máquinas cujo auxiliar de política está falhando, e a razão pela qual uma máquina recusou iniciar. Requer Claude Code v2.1.274 ou posterior.

Por padrão, o evento carrega as fontes gerenciadas e o estado do auxiliar de política mas não as configurações em si. Para adicionar o atributo managed_settings.settings redatado e o digest managed_settings.resolved_sha256, defina OTEL_LOG_MANAGED_SETTINGS=1:

Defina-o no bloco env de configurações gerenciadas, configurações do usuário, ou --settings, ou no ambiente com o qual você inicia Claude Code. Um valor em configurações de projeto ou local não o ativa, porque um repositório clonado pode escrevê-los.
Configurações gerenciadas pelo servidor podem defini-lo sem mostrar o diálogo de aprovação de segurança, porque a variável apenas adiciona sua própria política redatada da organização a um evento que sua organização já recebe.

Em uma sessão interativa em uma pasta que você não confiou, Claude Code não exporta o evento de recusa, porque configurações de projeto e local poderiam apontar a exportação para um coletor diferente antes da confiança.

Nome do Evento: claude_code.managed_settings_resolved

Atributos:

Todos os atributos padrão
event.name: "managed_settings_resolved"
event.timestamp: Timestamp ISO 8601
event.sequence: contador por processo para ordenar eventos, descrito em Atributos de correlação de eventos
managed_settings.trigger: "startup" para o evento de início de sessão, "change" quando as configurações gerenciadas ou o estado do auxiliar de política mudaram mais tarde na sessão, ou "refused" quando uma política de configurações gerenciadas parou a sessão. Claude Code envia um evento change apenas quando um atributo difere do último evento que enviou, e um valor de configuração alterado conta mesmo quando OTEL_LOG_MANAGED_SETTINGS está desativado
error.type: por que Claude Code parou a sessão. Presente apenas em eventos refused:
- "helper_failed": uma execução do auxiliar de política falhou
- "policy_invalid": as configurações gerenciadas contêm um erro que impede Claude Code de iniciar, ou uma fonte de administrador falhou em carregar, então Claude Code não pode verificar a imposição de login da organização
- "consent_rejected": o usuário rejeitou o diálogo de aprovação de segurança para configurações gerenciadas pelo servidor
- "force_refresh_failed": a busca de configurações que forceRemoteSettingsRefresh requer falhou
- "gateway_rejected": um gateway de aplicativos Claude respondeu ao carregamento de configurações gerenciadas com HTTP 403
- "version_below_minimum": esta versão de Claude Code está abaixo de requiredMinimumVersion ou acima de requiredMaximumVersion
- "_OTHER": o carregamento de configurações gerenciadas do gateway de aplicativos Claude falhou por outro motivo
managed_settings.sources: cada fonte gerenciada que entrega pelo menos uma chave de política, prioridade mais alta primeiro, incluindo fontes cujas chaves não entram em efeito sob first-wins. Os valores são "remote", "plist" ou "hklm" para a política MDM ou nível de SO, "file" para arquivos de configurações gerenciadas e drop-ins, "parent" quando um host de incorporação fornece configurações, e "hkcu" para o valor de registro HKCU do Windows quando Claude Code o lê. Uma fonte que carrega apenas chaves de controle, ou que Claude Code não pôde ler, não está listada. Emitido como um array de strings, vazio quando nenhuma fonte gerenciada entrega uma chave de política
managed_settings.source_behavior: o valor managedSourcesBehavior que Claude Code leu, "first-wins" ou "merge". "first-wins" quando nenhuma fonte define a chave
managed_settings.helper.state: estado do auxiliar de política que a fonte MDM ou arquivo selecionada configura:
- "ok": a saída do auxiliar serve como as configurações gerenciadas
- "bad_path", "not_a_file", "exit_nonzero", "timed_out", "oversize", "parse_failed", "envelope_invalid", ou "schema_rejected": a última execução do auxiliar falhou. Falhas do auxiliar descreve os casos
- "none": nenhum auxiliar está configurado, ou a fonte que o configura não é uma política MDM ou arquivo de configurações gerenciadas
managed_settings.helper.applied: "output" enquanto a saída do próprio auxiliar serve como as configurações gerenciadas, "none" quando não serve
managed_settings.helper.entry: "policyHelper" quando Claude Code selecionou um policyHelper. Ausente quando selecionou nenhum auxiliar
managed_settings.helper.path: o path configurado do auxiliar. Presente sempre que Claude Code selecionou um auxiliar, independentemente de OTEL_LOG_MANAGED_SETTINGS estar definido
managed_settings.resolved_sha256 (quando OTEL_LOG_MANAGED_SETTINGS=1): SHA-256 das configurações gerenciadas resolvidas antes da redação, serializadas como JSON com chaves ordenadas recursivamente e sem espaço em branco. Máquinas com o mesmo digest executam a mesma política. Claude Code envia o digest apenas com o opt-in porque uma política curta pode ser recuperada fazendo hash de suposições. Ausente quando nenhuma configuração gerenciada foi resolvida, e em eventos refused
managed_settings.settings (quando OTEL_LOG_MANAGED_SETTINGS=1): os nomes e forma das configurações gerenciadas resolvidas como uma string JSON, com os valores redatados. Ausente em eventos refused. Claude Code o constrói a partir de seu esquema de configurações:
- Um nome de configuração que o esquema declara é exportado, e uma chave que não declara é deixada de fora
- Booleanos, números e valores de string que o esquema restringe a um conjunto fixo de opções, como permissions.defaultMode, são exportados como estão. sandbox.network.httpProxyPort e sandbox.network.socksProxyPort são exportados como "[REDACTED]"
- Toda outra string, como model, apiKeyHelper, todo valor env, toda URL e todo comando, é exportado como "[REDACTED]"
- Os nomes de entrada de mapas, como nomes de variáveis env e IDs de plugin, são exportados como estão. Uma configuração cujas entradas o esquema não digita, como vimInsertModeRemaps, é exportada como um único "[REDACTED]", e sandbox.ignoreViolations é exportado como uma lista de suas listas de caminho sem os padrões de comando
- Uma lista mantém seu comprimento, com cada entrada redatada pelas mesmas regras
- Uma regra permissions.allow, permissions.deny, ou permissions.ask é exportada como seu nome de ferramenta com o conteúdo redatado, como Read([REDACTED]), quando a ferramenta é integrada nesta versão de Claude Code ou é uma referência mcp__ como mcp__jira__create_issue. Qualquer outra regra é exportada como "[REDACTED]"
- Hooks seguem as mesmas regras, então campos de opção fixa e numéricos como type e timeout mostram, enquanto cada comando, URL, matcher, e condição if é exportada como "[REDACTED]"
Por exemplo, configurações gerenciadas com apiKeyHelper, duas variáveis env, e uma regra de negação são exportadas como {"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}.

Claude Code corta o valor em 8 KB de UTF-8, e o valor cortado não é JSON válido
managed_settings.settings_truncated (quando managed_settings.settings está presente): true quando Claude Code cortou managed_settings.settings em 8 KB, false caso contrário. Emitido como um booleano, não uma string

Interpretar dados de métricas e eventos

As métricas e eventos exportados suportam uma gama de análises:

Monitoramento de uso

Métrica	Oportunidade de Análise
`claude_code.token.usage`	Dividir por `type` (entrada/saída), usuário, equipe, modelo, `skill.name`, `plugin.name` ou `agent.name`
`claude_code.session.count`	Rastrear adoção e engajamento ao longo do tempo
`claude_code.lines_of_code.count`	Medir produtividade rastreando adições e remoções de código, dividido por modelo
`claude_code.commit.count` & `claude_code.pull_request.count`	Entender o impacto nos fluxos de trabalho de desenvolvimento

Monitoramento de custo

A métrica claude_code.cost.usage ajuda com:

Rastreamento de tendências de uso entre equipes ou indivíduos
Identificação de sessões de alto uso para otimização
Atribuição de gastos a skills, plugins ou tipos de subagente específicos via atributos skill.name, plugin.name e agent.name

Claude Code conta cada resposta de streaming em relação às métricas de custo e token exatamente uma vez, incluindo quando um gateway ou proxy atrás de ANTHROPIC_BASE_URL transmite uso progressivamente em vários frames. Antes da v2.1.214, streams que carregavam uso em mais de um frame inflacionavam claude_code.cost.usage e claude_code.token.usage por aproximadamente uma solicitação completa extra por frame extra.

Alertas e segmentação

Alertas comuns a considerar:

Picos de custo
Consumo incomum de tokens
Alto volume de sessão de usuários específicos

Todas as métricas podem ser segmentadas pelos atributos padrão. O atributo model está disponível em claude_code.token.usage, claude_code.cost.usage e a partir da v2.1.172, claude_code.lines_of_code.count.

Divisões por modelo de commits podem ser apenas aproximadas unindo contra as métricas de token ou custo em session.id, já que uma sessão pode abranger vários modelos. Filtre o lado do token ou custo para linhas onde query_source é "main" para que solicitações auxiliares e de subagente não atribuam os commits da sessão a um modelo que não os fez.

Detectar esgotamento de tentativas

Claude Code retenta solicitações de API falhadas internamente e emite um único evento claude_code.api_error apenas depois de desistir, então o evento em si é o sinal terminal para essa solicitação. Tentativas de repetição intermediárias não são registradas como eventos separados.

O atributo attempt no evento registra o número total de tentativas. CLAUDE_CODE_MAX_RETRIES tem como padrão 10 e é limitado a 15. A partir da v2.1.199, você pode definir CLAUDE_CODE_RETRY_WATCHDOG para aumentar o padrão e remover o limite.

Quando a solicitação esgota todas as tentativas em um erro transitório, attempt é igual a um a mais do que esse limite efetivo: 11 por padrão, e nunca mais de 16 a menos que o watchdog esteja definido. Um valor menor indica um erro não retentável, como uma resposta 400, ou uma causa com seu próprio orçamento de tentativas menor. Por exemplo, Claude Code retenta uma falha ao carregar credenciais da AWS ou Google Cloud no máximo duas vezes.

Para distinguir uma sessão que se recuperou de uma que travou, agrupe eventos por session.id e verifique se um evento api_request posterior existe após o erro.

Análise de eventos

Os dados de eventos descrevem cada interação do Claude Code em detalhes:

Padrões de uso de ferramentas: analise eventos de resultado de ferramentas para identificar:

Ferramentas mais frequentemente usadas
Taxas de sucesso da ferramenta
Tempos médios de execução da ferramenta
Padrões de erro por tipo de ferramenta

Monitoramento de desempenho: rastreie durações de solicitações de API e tempos de execução de ferramentas para identificar gargalos de desempenho.

Auditar eventos de segurança

Os eventos OpenTelemetry são a fonte de dados de auditoria para atividade do Claude Code. Cada evento carrega atributos de identidade que vinculam chamadas de ferramenta, atividade MCP e decisões de permissão de volta ao usuário que as acionou. O exportador de logs OTLP pode entregar esses eventos a qualquer plataforma Security Information and Event Management (SIEM) com um receptor OTLP, ou a um OpenTelemetry Collector que encaminha para seu SIEM.

Atribuir ações a usuários

Os atributos padrão em cada evento incluem a identidade do usuário autenticado: user.email, user.account_uuid, user.account_id e organization.id quando conectado com uma conta Claude ou, em uma sessão na nuvem, quando as credenciais da própria sessão as carregam, mais user.id e o session.id por sessão. user.id é um identificador com escopo de instalação, exceto em sessões do gateway de aplicativos Claude, onde é o assunto do IdP do token emitido pelo gateway.

Chamadas de ferramenta MCP, comandos Bash e edições de arquivo são, portanto, atribuídas ao desenvolvedor que iniciou a sessão. Claude Code não atua sob uma conta de serviço separada; a identidade registrada em cada evento é a própria conta Claude do desenvolvedor, ou a identidade do IdP do desenvolvedor em uma sessão do gateway de aplicativos Claude.

Quando Claude Code autentica com uma chave de API direta, ou contra Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, não há conta Claude na sessão e apenas user.id e session.id são preenchidos. Nessas implantações, anexe identidade do usuário você mesmo com OTEL_RESOURCE_ATTRIBUTES, definido por usuário através do arquivo de configurações gerenciadas ou um wrapper de inicialização. Sessões do gateway de aplicativos Claude não precisam de nada disso: a CLI marca a identidade do IdP automaticamente, conforme descrito em Atributos padrão.

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

Auditoria de atividade MCP

Para capturar atividade do servidor MCP com detalhe completo de chamada, ative o exportador de logs e defina OTEL_LOG_TOOL_DETAILS=1. Cada operação MCP então produz eventos estruturados que carregam o nome do servidor, nome da ferramenta e argumentos de chamada junto com os atributos de identidade padrão:

Evento	O que registra para MCP
`mcp_server_connection`	Conexão do servidor, desconexão e falha de conexão com `server_name`, `transport_type`, `server_scope` e detalhe de erro
`tool_result`	Cada chamada de ferramenta MCP com `tool_name` e `mcp_server_scope`, uma carga útil `tool_parameters` contendo `mcp_server_name` e `mcp_tool_name`, e uma carga útil `tool_input` contendo os argumentos de chamada
`tool_decision`	Se a chamada foi permitida ou negada, se a decisão veio de config, um hook ou o usuário, e uma carga útil `tool_parameters` contendo `mcp_server_name` e `mcp_tool_name`

Sem OTEL_LOG_TOOL_DETAILS, esses eventos descartam o detalhe de identificação:

tool_result: mantém mcp_server_scope e um tool_name reduzido ao literal "mcp_tool" para servidores configurados pelo usuário, omite conteúdo de argumentos. Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, também mantém o par mcp_server_name/mcp_tool_name dentro de tool_parameters, a mesma exceção de autoria de host que tool_decision, exigindo Claude Code v2.1.214 ou posterior
tool_decision: mantém tool_source e um tool_name reduzido ao literal "mcp_tool" para servidores configurados pelo usuário, omite conteúdo de argumentos. Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, também mantém o par mcp_server_name/mcp_tool_name dentro de tool_parameters; tool_source e o par de nomes exigem Claude Code v2.1.214 ou posterior
mcp_server_connection: omite server_name e a mensagem de erro, mas mantém is_plugin, plugin_id_hash e plugin.name, com nomes de plugins não-Anthropic reduzidos ao literal "third-party", para que servidores fornecidos por plugins permaneçam distinguíveis sem registro detalhado

Mapear questões de segurança para eventos

Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:

Sinal	Evento	Atributos-chave
Chamada de ferramenta permitida ou negada, e por quê	`tool_decision`	`decision`, `source`, `tool_name`, `tool_parameters`
Escalação de modo de permissão	`permission_mode_changed`	`from_mode`, `to_mode`, `trigger`
Hook de política bloqueou uma ação	`hook_execution_complete`	`hook_event`, `num_blocking`
Login, logout e falha de autenticação	`auth`	`action`, `success`, `error_category`
Conexão do servidor MCP ou falha	`mcp_server_connection`	`status`, `server_name`, `is_plugin`, `error_code`
Plugin instalado e sua origem	`plugin_installed`	`plugin.name`, `marketplace.name`, `marketplace.is_official`
Comandos executados e arquivos tocados	`tool_result` (executado) ou `tool_decision` (rejeitado) com `OTEL_LOG_TOOL_DETAILS=1`	`tool_parameters`; `tool_input` (apenas `tool_result`)
Quais fontes de configurações gerenciadas uma máquina executa, se seu auxiliar de política está saudável e por que uma máquina recusou iniciar	`managed_settings_resolved`	`managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type`; `managed_settings.settings` e `managed_settings.resolved_sha256` com `OTEL_LOG_MANAGED_SETTINGS=1`

Claude Code emite apenas o fluxo de eventos bruto. Detecção de anomalias, linha de base, correlação entre sessões e alertas são responsabilidade do seu SIEM ou backend de observabilidade.

Enviar eventos para um SIEM

Aponte OTEL_EXPORTER_OTLP_LOGS_ENDPOINT para o receptor OTLP do seu SIEM, ou para um OpenTelemetry Collector que encaminha para a API de ingestão nativa do seu SIEM. O seguinte exemplo de configurações gerenciadas exporta apenas eventos, com detalhe completo de ferramenta ativado para auditoria 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"
  }
}

Para confirmar que os eventos chegam, envie um prompt em uma sessão executada sob essa configuração e verifique seu SIEM para o evento claude_code.user_prompt. Se nada chegar, execute claude --debug e verifique o log de depuração para erros de exportação [3P telemetry].

Considerações de backend

Sua escolha de backends de métricas, logs e rastreamentos determina os tipos de análises que você pode realizar:

Para métricas

Bancos de dados de série temporal: Cálculos de taxa, métricas agregadas
Armazenamentos colunares: Consultas complexas, análise de usuário único
Plataformas de observabilidade completas: Consultas avançadas, visualização, alertas

Para eventos/logs

Sistemas de agregação de logs: Busca de texto completo, análise de logs
Armazenamentos colunares: Análise de eventos estruturados
Plataformas de observabilidade completas: Correlação entre métricas e eventos

Para rastreamentos

Escolha um backend que suporte armazenamento de rastreamento distribuído e correlação de span:

Sistemas de rastreamento distribuído: Visualização de span, waterfalls de solicitação, análise de latência
Plataformas de observabilidade completas: Busca de rastreamento e correlação com métricas e logs

Para organizações que exigem métricas de Usuário Ativo Diário/Semanal/Mensal (DAU/WAU/MAU), considere backends que suportam consultas eficientes de valor único.

Informações de serviço

Todas as métricas e eventos são exportados com os seguintes atributos de recurso:

service.name: claude-code para sessões de terminal, claude-code-desktop para sessões iniciadas a partir da aba Code no aplicativo Claude Desktop
service.version: Versão atual do Claude Code, ou a versão do aplicativo Desktop para sessões da aba Code
os.type: Tipo de sistema operacional (por exemplo, linux, darwin, windows)
os.version: String de versão do sistema operacional
host.arch: Arquitetura do host (por exemplo, amd64, arm64)
wsl.version: Número de versão do WSL (apenas presente ao executar no Windows Subsystem for Linux)
Nome do Medidor: com.anthropic.claude_code

Se seus pipelines de coletor ou painéis filtrarem em service.name = claude-code, adicione claude-code-desktop ao filtro para também capturar telemetria de sessões da aba Code.

Recursos de medição de ROI

Para um guia abrangente sobre como medir o retorno sobre investimento para Claude Code, incluindo configuração de telemetria, análise de custo, métricas de produtividade e relatórios automatizados, consulte o Guia de Medição de ROI do Claude Code. Este repositório fornece configurações Docker Compose prontas para uso, configurações Prometheus e OpenTelemetry, e modelos para gerar relatórios de produtividade integrados com ferramentas como Linear.

Segurança e privacidade

A exportação OpenTelemetry para seu backend é opt-in e requer configuração explícita. Para a telemetria operacional separada da Anthropic e como desabilitá-la, consulte Uso de dados
Conteúdos de arquivo brutos e trechos de código não são incluídos em métricas ou eventos. Os spans de rastreamento são um caminho de dados separado: veja o ponto OTEL_LOG_TOOL_CONTENT abaixo
Quando autenticado via OAuth, user.email é incluído em atributos de telemetria, enviado apenas para o endpoint OTel que você configura, nunca para a Anthropic. Se isso for uma preocupação para sua organização, trabalhe com seu backend de telemetria para filtrar ou reduzir este campo
O conteúdo do prompt do usuário não é coletado por padrão. Apenas o comprimento do prompt é registrado. Para incluir conteúdo do prompt, defina OTEL_LOG_USER_PROMPTS=1. Sob rastreamento beta detalhado, esta variável alcança mais do que apenas texto de prompt: ela também controla o atributo de span new_context, que carrega resultados de ferramenta no span claude_code.llm_request
O texto de resposta do assistente não é coletado por padrão. Apenas o comprimento da resposta é registrado. Para incluir texto de resposta, defina OTEL_LOG_ASSISTANT_RESPONSES=1. Como todos os dados OpenTelemetry do Claude Code, o texto de resposta é enviado apenas para o endpoint OTel que você configura, nunca para a Anthropic. Quando esta variável não está definida, OTEL_LOG_USER_PROMPTS é usado como fallback, portanto defina OTEL_LOG_ASSISTANT_RESPONSES=0 se você quiser conteúdo de prompt sem conteúdo de resposta
Argumentos de entrada de ferramenta e parâmetros não são registrados por padrão. Para incluí-los, defina OTEL_LOG_TOOL_DETAILS=1. Para os servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, tool_decision e tool_result carregam o par mcp_server_name/mcp_tool_name, nomes criados pelo host em vez de conteúdo de argumentos, mesmo com a flag desativada. A exceção requer Claude Code v2.1.214 ou posterior. Estes dados são enviados apenas para o endpoint OTEL que você configura, nunca para a Anthropic. Os argumentos ainda podem conter valores sensíveis, portanto configure seu backend de telemetria para filtrar ou reduzir esses atributos conforme necessário. Quando ativado:
- Eventos tool_result e tool_decision incluem um atributo tool_parameters com comandos Bash, nomes de servidor MCP e ferramenta, e nomes de skill. Campos como full_command são emitidos sem truncamento
- Eventos tool_result adicionalmente incluem um atributo tool_input com caminhos de arquivo, URLs, padrões de busca e outros argumentos. Valores individuais com mais de 512 caracteres são truncados e o total é limitado a ~4 K caracteres
- Eventos user_prompt incluem o command_name verbatim para comandos customizados, plugin e MCP
- Spans de rastreamento incluem o mesmo atributo tool_input e atributos derivados de entrada como file_path, com o mesmo truncamento que tool_input
O conteúdo de ferramenta não é registrado em spans de rastreamento por padrão. Para incluí-lo, defina OTEL_LOG_TOOL_CONTENT=1. O span claude_code.tool então carrega um evento de span tool.output com conteúdos de arquivo brutos e saída de comando Bash, truncado no limite de conteúdo (60 KB por padrão) por atributo. O conteúdo de ferramenta também alcança spans através de new_context, cujo controle difere por span. Configure seu backend de telemetria para filtrar ou reduzir esses atributos conforme necessário
Corpos de solicitação e resposta da API Anthropic Messages brutos não são registrados por padrão. Para incluí-los, defina OTEL_LOG_RAW_API_BODIES em suas configurações de shell, usuário ou gerenciadas. É ignorado em configurações de projeto e local. Os corpos contêm o histórico de conversa completo, incluindo o prompt do sistema, cada turno anterior de usuário e assistente, e resultados de ferramenta, portanto ativar isso implica consentimento para tudo que os outros sinalizadores de conteúdo OTEL_LOG_* revelariam. O Claude Code sempre reduz o conteúdo de pensamento estendido do Claude desses corpos, independentemente de outras configurações. O valor que você define determina como o Claude Code entrega os corpos:
- Com =1, Claude Code emite eventos de log api_request_body e api_response_body para cada chamada de API. O atributo body dos eventos carrega a carga útil serializada em JSON, truncada no limite de conteúdo (60 KB por padrão)
- Com =file:<dir>, Claude Code escreve corpos não truncados em arquivos .request.json e .response.json sob esse diretório, e os eventos carregam um caminho body_ref em vez do corpo inline. Envie o diretório com um coletor de log ou sidecar em vez de através do fluxo de telemetria.
  
  Para cada resposta bem-sucedida, Claude Code também anexa uma linha a index.jsonl nesse diretório, vinculando o arquivo de resposta ao arquivo de solicitação que o produziu e à mensagem de transcrição em que se tornou. Cada linha não contém conteúdo de mensagem, e a seção evento de corpo de resposta da API lista seus campos. O arquivo de índice requer Claude Code v2.1.274 ou posterior

Monitorar Claude Code no Amazon Bedrock

Para orientação detalhada de monitoramento de uso do Claude Code para Amazon Bedrock, consulte Implementação de Monitoramento do Claude Code (Amazon Bedrock).

monitoring-usage.md +275 −214

123| `OTEL_LOG_ASSISTANT_RESPONSES` | Ativar registro de texto de resposta do assistente em eventos `assistant_response` (padrão: desativado). Quando não definido, volta para o valor de `OTEL_LOG_USER_PROMPTS`. Requer Claude Code v2.1.193 ou posterior | `1` para ativar, `0` para manter reduzido |123| `OTEL_LOG_ASSISTANT_RESPONSES` | Ativar registro de texto de resposta do assistente em eventos `assistant_response` (padrão: desativado). Quando não definido, volta para o valor de `OTEL_LOG_USER_PROMPTS`. Requer Claude Code v2.1.193 ou posterior | `1` para ativar, `0` para manter reduzido |

124| `OTEL_LOG_TOOL_DETAILS` | Ativar registro de parâmetros de ferramenta e argumentos de entrada em eventos de ferramenta e atributos de span de rastreamento: comandos Bash, nomes de servidor MCP e ferramenta, nomes de skill, nomes de workflow criados pelo usuário e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado). Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com o sinalizador desativado. A exceção requer Claude Code v2.1.214 ou posterior | `1` para ativar |124| `OTEL_LOG_TOOL_DETAILS` | Ativar registro de parâmetros de ferramenta e argumentos de entrada em eventos de ferramenta e atributos de span de rastreamento: comandos Bash, nomes de servidor MCP e ferramenta, nomes de skill, nomes de workflow criados pelo usuário e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado). Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com o sinalizador desativado. A exceção requer Claude Code v2.1.214 ou posterior | `1` para ativar |

125| `OTEL_LOG_TOOL_CONTENT` | Ativar registro de conteúdo de ferramenta no [evento de span `tool.output`](#tool-output-span-event) (padrão: desativado). Os atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](#new-context-gates). Requer [rastreamento](#traces-beta). O conteúdo é truncado no limite de conteúdo (60 KB por padrão) | `1` para ativar |125| `OTEL_LOG_TOOL_CONTENT` | Ativar registro de conteúdo de ferramenta no [evento de span `tool.output`](#tool-output-span-event) (padrão: desativado). Os atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](#new-context-gates). Requer [rastreamento](#traces-beta). O conteúdo é truncado no limite de conteúdo (60 KB por padrão) | `1` para ativar |

126| `OTEL_LOG_MANAGED_SETTINGS` | Adicionar as configurações gerenciadas reduzidas e um resumo SHA-256 das configurações antes da redução aos eventos [managed settings resolved](#managed-settings-resolved-event) (padrão: desativado). Um valor em configurações de projeto ou local não o ativa. Requer Claude Code v2.1.274 ou posterior | `1` para ativar |

126| `OTEL_LOG_RAW_API_BODIES` | Emitir o corpo JSON completo da solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body` (padrão: desativado). Os corpos incluem todo o histórico de conversa. Ativar isso implica consentimento para tudo que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` e `OTEL_LOG_TOOL_CONTENT` revelariam | `1` para corpos inline truncados no limite de conteúdo (60 KB por padrão), ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento |127| `OTEL_LOG_RAW_API_BODIES` | Emitir o corpo JSON completo da solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body` (padrão: desativado). Os corpos incluem todo o histórico de conversa. Ativar isso implica consentimento para tudo que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` e `OTEL_LOG_TOOL_CONTENT` revelariam | `1` para corpos inline truncados no limite de conteúdo (60 KB por padrão), ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento |

127| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite de conteúdo: o comprimento máximo de atributos que contêm conteúdo, como respostas de modelo, conteúdo de ferramenta, prompts do sistema e corpos de API brutos, marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). O padrão é dimensionado para backends que limitam valores de atributo a 64 KB; aumente-o apenas se seu backend aceitar valores maiores, ou diminua-o para reduzir o volume de telemetria. Quando um limite de atributo do SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou uma de suas variantes de logrecord e span, é definido como menor, Claude Code trunca nesse valor menor para que o marcador `[TRUNCATED ...]` permaneça dentro do limite do SDK. Requer Claude Code v2.1.214 ou posterior | `262144` |128| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite de conteúdo: o comprimento máximo de atributos que contêm conteúdo, como respostas de modelo, conteúdo de ferramenta, prompts do sistema e corpos de API brutos, marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). O padrão é dimensionado para backends que limitam valores de atributo a 64 KB; aumente-o apenas se seu backend aceitar valores maiores, ou diminua-o para reduzir o volume de telemetria. Quando um limite de atributo do SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou uma de suas variantes de logrecord e span, é definido como menor, Claude Code trunca nesse valor menor para que o marcador `[TRUNCATED ...]` permaneça dentro do limite do SDK. Requer Claude Code v2.1.214 ou posterior | `262144` |

128| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferência de temporalidade de métricas (padrão: `delta`). Defina como `cumulative` se seu backend espera temporalidade cumulativa | `delta`, `cumulative` |129| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferência de temporalidade de métricas (padrão: `delta`). Defina como `cumulative` se seu backend espera temporalidade cumulativa | `delta`, `cumulative` |

241| `workflow.run_id` | Identificador de execução da ferramenta [Workflow](/docs/pt/workflows) que gerou este agente, prefixado `wf_`. Ausente para agentes não gerados por um workflow | |242| `workflow.run_id` | Identificador de execução da ferramenta [Workflow](/docs/pt/workflows) que gerou este agente, prefixado `wf_`. Ausente para agentes não gerados por um workflow | |

242| `workflow.name` | Nome do workflow que gerou este agente. Nomes criados pelo usuário são substituídos por `custom` a menos que o gate esteja definido | `OTEL_LOG_TOOL_DETAILS` |243| `workflow.name` | Nome do workflow que gerou este agente. Nomes criados pelo usuário são substituídos por `custom` a menos que o gate esteja definido | `OTEL_LOG_TOOL_DETAILS` |

245| `effort` | [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação: `low`, `medium`, `high`, `xhigh` ou `max`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço. Requer Claude Code v2.1.274 ou posterior | |

385echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"387echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

386```388```

387 389

388Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, Claude Code relata o erro em:390Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, as exportações falham e seu backend de telemetria não recebe nada da sessão até que o auxiliar funcione novamente. Claude Code relata a falha em:

389 391

392* Uma notificação de aviso em sessões interativas, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/pt/errors#otelheadershelper-failed), mostrada uma vez por sessão quando o auxiliar falha pela primeira vez

390* Saída de `/status`393* Saída de `/status`

391* O log de depuração, ao executar com [`--debug`](/docs/pt/cli-reference#cli-flags) ou após executar `/debug` na sessão394* O log de depuração, ao executar com [`--debug`](/docs/pt/cli-reference#cli-flags) ou após executar `/debug` na sessão

392* stderr, em sessões não-interativas iniciadas com `-p`395* stderr, em sessões não-interativas iniciadas com `-p`

521 Atributos padrão524 Atributos padrão

522</h3>525</h3>

523 526

524Todas as métricas e eventos compartilham esses atributos padrão:527Todas as métricas e eventos compartilham estes atributos padrão:

525 528

527| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |530| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

533| `user.account_id` | ID da conta em formato marcado correspondendo às APIs de administrador Anthropic (quando autenticado), como `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (padrão: true) |536| `user.account_id` | ID da conta em formato marcado correspondendo às APIs de administração da Anthropic (quando autenticado), como `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (padrão: true) |

534| `user.id` | Identificador anônimo aleatório gerado na primeira execução e persistido em `~/.claude.json`. Não contém informações pessoais e não é derivado da sua conta Claude. Deletar o arquivo produz um novo valor não relacionado na próxima execução. | Sempre incluído |537| `user.id` | Identificador anônimo aleatório gerado na primeira execução e persistido em `~/.claude.json`. Não contém informações pessoais e não é derivado da sua conta Claude. Deletar o arquivo produz um novo valor não relacionado na próxima execução. | Sempre incluído |

535| `user.email` | Endereço de email do usuário, do seu login ou, em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), das credenciais da própria sessão | Sempre incluído quando disponível |538| `user.email` | Endereço de email do usuário, do seu login ou, em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), das credenciais da própria sessão | Sempre incluído quando disponível |

537| Chaves de `OTEL_RESOURCE_ATTRIBUTES` | Atributos personalizados que você define, como `department` ou `team.id`. Veja [Suporte a organização multi-equipe](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (padrão: true) |540| Chaves de `OTEL_RESOURCE_ATTRIBUTES` | Atributos personalizados que você define, como `department` ou `team.id`. Veja [Suporte a organização multi-equipe](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (padrão: true) |

538| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | A identidade do repositório da sessão, derivada do seu remote `origin`. Veja [Atributos de repositório](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (padrão: false). Requer Claude Code v2.1.269 ou posterior |541| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | A identidade do repositório da sessão, derivada do seu remote `origin`. Veja [Atributos de repositório](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (padrão: false). Requer Claude Code v2.1.269 ou posterior |

539 542

540Quando Claude Code está conectado a um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), a CLI marca as exportações com a identidade autenticada da sessão do gateway: `user.id` é o assunto do IdP em vez de um identificador de instalação anônimo, `user.email` é o email conectado e `user.groups` carrega a associação de grupo do IdP como uma string separada por vírgula. Cada exportação também carrega `identity.source: gateway-oidc`. A identidade do gateway é aplicada por último, então as chaves `user.*` e `identity.*` definidas através de `OTEL_RESOURCE_ATTRIBUTES` são ignoradas em sessões de gateway.543Quando Claude Code está conectado a um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), a CLI marca as exportações com a identidade autenticada da sessão do gateway: `user.id` é o assunto do IdP em vez de um identificador de instalação anônimo, `user.email` é o email conectado, e `user.groups` carrega a associação de grupo do IdP como uma string separada por vírgulas. Cada exportação também carrega `identity.source: gateway-oidc`. A identidade do gateway é aplicada por último, então as chaves `user.*` e `identity.*` definidas através de `OTEL_RESOURCE_ATTRIBUTES` são ignoradas em sessões de gateway.

541 544

542Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:545Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:

543 546

544* `prompt.id`: UUID correlacionando um prompt do usuário com todos os eventos subsequentes até o próximo prompt. Veja [Atributos de correlação de evento](#event-correlation-attributes).547* `prompt.id`: UUID correlacionando um prompt do usuário com todos os eventos subsequentes até o próximo prompt. Veja [Atributos de correlação de eventos](#event-correlation-attributes).

545* `workspace.host_paths`: diretórios de workspace do host selecionados no aplicativo desktop, como um array de string548* `workspace.host_paths`: diretórios do workspace do host selecionados no aplicativo desktop, como um array de strings

546* `workflow.run_id`: identificador de execução, prefixado com `wf_`, nos eventos de API e ferramenta emitidos por agentes que pertencem a uma execução de ferramenta [Workflow](/docs/pt/workflows). Filtrando eventos por um `workflow.run_id` reconstrói as solicitações de API e resultados de ferramentas dessa execução. O identificador cobre os agentes que o script de workflow gera e quaisquer agentes que esses gerem por sua vez, como invocações de skill. Ele corresponde ao identificador de execução relatado no resultado da ferramenta Workflow. Ausente em todos os outros eventos. Requer Claude Code v2.1.202 ou posterior549* `workflow.run_id`: identificador de execução, prefixado com `wf_`, nos eventos de API e ferramenta emitidos por agentes que pertencem a uma execução de ferramenta [Workflow](/docs/pt/workflows). Filtrar eventos por um `workflow.run_id` reconstrói as requisições de API e resultados de ferramentas dessa execução. O identificador cobre os agentes que o script de workflow gera e quaisquer agentes que esses gerem por sua vez, como invocações de skills. Corresponde ao identificador de execução relatado no resultado da ferramenta Workflow. Ausente em todos os outros eventos. Requer Claude Code v2.1.202 ou posterior

547* `workflow.name`: nome do workflow, o `meta.name` do seu script, emitido junto com `workflow.run_id`. Nomes de workflow integrados aparecem verbatim quando a execução executa o script integrado não modificado. Nomes criados pelo usuário, incluindo cópias editadas de scripts integrados, são substituídos por `custom` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido. Requer Claude Code v2.1.202 ou posterior550* `workflow.name`: nome do workflow, o `meta.name` do seu script, emitido junto com `workflow.run_id`. Os nomes de workflow integrados aparecem literalmente quando a execução executa o script integrado não modificado. Nomes de autoria do usuário, incluindo cópias editadas de scripts integrados, são substituídos por `custom` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido. Requer Claude Code v2.1.202 ou posterior

548 551

549<h4 id="repository-attributes">552<h4 id="repository-attributes">

550 Atributos de repositório553 Atributos de repositório

552 555

553Defina `OTEL_METRICS_INCLUDE_REPOSITORY=true` para marcar métricas e eventos com a identidade do repositório da sessão, para que um coletor compartilhado possa atribuir uso por repositório. Requer Claude Code v2.1.269 ou posterior.556Defina `OTEL_METRICS_INCLUDE_REPOSITORY=true` para marcar métricas e eventos com a identidade do repositório da sessão, para que um coletor compartilhado possa atribuir uso por repositório. Requer Claude Code v2.1.269 ou posterior.

554 557

555Claude Code deriva esses atributos uma vez por sessão a partir do remote `origin` do repositório. Os remotes HTTPS e SSH de um repositório produzem valores idênticos:558Claude Code deriva esses atributos uma vez por sessão do remote `origin` do repositório. Os remotes HTTPS e SSH de um repositório produzem valores idênticos:

556 559

557| Atributo | Valor |560| Atributo | Valor |

558| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |561| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |

559| `vcs.repository.url.full` | A URL do navegador do repositório sem `.git`, como `https://github.com/example-org/example-repo` |562| `vcs.repository.url.full` | A URL do navegador do repositório sem `.git`, como `https://github.com/example-org/example-repo` |

560| `vcs.owner.name` | O caminho do proprietário ou grupo, como `example-org`; omitido quando o caminho remoto tem um único segmento |563| `vcs.owner.name` | O caminho do proprietário ou grupo, como `example-org`; omitido quando o caminho remoto tem um único segmento |

562| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` ou `gitea` quando Claude Code reconhece o host remoto ou forma de URL como um desses provedores; omitido caso contrário |565| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, ou `gitea` quando Claude Code reconhece o host remoto ou a forma da URL como um desses provedores; omitido caso contrário |

563 566

564Os valores são minúsculos, e credenciais, strings de consulta e fragmentos do URL remoto nunca aparecem neles. Os atributos são omitidos quando a sessão não tem um remote `origin`, quando o remote não é em forma de URL ou quando o único repositório envolvente é seu diretório home.567Os valores são convertidos para minúsculas, e credenciais, strings de consulta e fragmentos da URL remota nunca aparecem neles. Os atributos são omitidos quando a sessão não tem um remote `origin`, quando o remote não é em forma de URL, ou quando o único repositório envolvente é seu diretório home.

565 568

566Uma chave `vcs.*` que você declara em [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) substitui o valor derivado para essa chave. Se você declarar `vcs.repository.url.full`, Claude Code nunca lê o remote e relata apenas as chaves que você declara.569Uma chave `vcs.*` que você declara em [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) substitui o valor derivado para essa chave. Se você declarar `vcs.repository.url.full`, Claude Code nunca lê o remote e relata apenas as chaves que você declara.

567 570

568Os atributos fluem apenas para seus próprios exportadores; a telemetria Anthropic descarta cada chave `vcs.*`.571Os atributos fluem apenas para seus próprios exportadores; a telemetria da Anthropic descarta todas as chaves `vcs.*`.

569 572

570<h3 id="metrics">573<h3 id="metrics">

571 Métricas574 Métricas

575 578

577| ------------------------------------- | ------------------------------------------------------------------- | ------- |580| ------------------------------------- | ------------------------------------------------------------------- | ------- |

582| `claude_code.cost.usage` | Custo da sessão Claude Code | USD |585| `claude_code.cost.usage` | Custo da sessão Claude Code | USD |

585| `claude_code.active_time.total` | Tempo ativo total | s |588| `claude_code.active_time.total` | Tempo ativo total | s |

586 589

587Quando `prometheus` é o único exportador listado em `OTEL_METRICS_EXPORTER`, Claude Code omite as unidades `USD`, `tokens` e `s` das métricas exportadas para que o scrape permaneça em formato de texto Prometheus válido. Os nomes das métricas não mudam, e configurações que combinam exportadores, como `otlp,prometheus`, mantêm as unidades. Antes da v2.1.216, o scrape Prometheus incluía linhas `# UNIT` apenas de OpenMetrics que alguns scrapers rejeitavam.590Quando `prometheus` é o único exportador listado em `OTEL_METRICS_EXPORTER`, Claude Code omite as unidades `USD`, `tokens`, e `s` das métricas exportadas para que o scrape permaneça em formato de texto Prometheus válido. Os nomes das métricas não mudam, e configurações que combinam exportadores, como `otlp,prometheus`, mantêm as unidades. Antes da v2.1.216, o scrape do Prometheus incluía linhas `# UNIT` apenas do OpenMetrics que alguns scrapers rejeitavam.

588 591

589<h3 id="metric-details">592<h3 id="metric-details">

590 Detalhes das métricas593 Detalhes das métricas

591</h3>594</h3>

592 595

593Cada métrica inclui os atributos padrão listados acima. Métricas com atributos adicionais específicos do contexto são observadas abaixo.596Cada métrica inclui os atributos padrão listados acima. Métricas com atributos adicionais específicos do contexto são anotadas abaixo.

594 597

595<h4 id="session-counter">598<h4 id="session-counter">

596 Contador de sessão599 Contador de sessão

601**Atributos**:604**Atributos**:

602 605

603* Todos os [atributos padrão](#standard-attributes)606* Todos os [atributos padrão](#standard-attributes)

604* `start_type`: Como a sessão foi iniciada. Um de `"fresh"`, `"resume"`, `"continue"` ou `"agents_view"`. O valor `"agents_view"` identifica o processo do painel `claude agents`, uma UI local lançada pelo usuário em vez de uma sessão conversacional. Filtre neste valor para separar lançamentos de processo de UI de sessões conversacionais em seus painéis.607* `start_type`: Como a sessão foi iniciada. Um de `"fresh"`, `"resume"`, `"continue"`, ou `"agents_view"`. O valor `"agents_view"` identifica o processo do dashboard `claude agents`, uma UI local iniciada pelo usuário em vez de uma sessão conversacional. Filtre neste valor para separar inicializações de processo de UI de sessões conversacionais em seus dashboards.

605 608

606<h4 id="lines-of-code-counter">609<h4 id="lines-of-code-counter">

607 Contador de linhas de código610 Contador de linhas de código

619 Contador de pull request622 Contador de pull request

620</h4>623</h4>

621 624

622Incrementado quando Claude Code cria um pull request ou merge request através de um comando shell ou uma ferramenta MCP.625Incrementado quando Claude Code cria uma pull request ou merge request através de um comando shell ou uma ferramenta MCP.

623 626

624**Atributos**:627**Atributos**:

625 628

639 Contador de custo642 Contador de custo

640</h4>643</h4>

641 644

642Incrementado após cada solicitação de API.645Incrementado após cada requisição de API.

643 646

644**Atributos**:647**Atributos**:

645 648

646* Todos os [atributos padrão](#standard-attributes)649* Todos os [atributos padrão](#standard-attributes)

647* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")650* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

648* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`651* `query_source`: Categoria do subsistema que emitiu a requisição. Um de `"main"`, `"subagent"`, ou `"auxiliary"`

649* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário652* `speed`: `"fast"` quando a requisição usou modo rápido. Ausente caso contrário

650* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação: `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Ausente quando o modelo não suporta esforço.653* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição: `"low"`, `"medium"`, `"high"`, `"xhigh"`, ou `"max"`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

651* `agent.name`: Tipo de subagente que emitiu a solicitação. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim. Outros nomes de agente definidos pelo usuário são substituídos por `"custom"`. Ausente quando a solicitação não foi emitida por um tipo de subagente nomeado.654* `agent.name`: Tipo de subagente que emitiu a requisição. Nomes de agentes integrados e agentes de plugins do marketplace oficial aparecem literalmente. Outros nomes de agentes definidos pelo usuário são substituídos por `"custom"`. Ausente quando a requisição não foi emitida por um tipo de subagente nomeado.

652* `skill.name`: Skill ativa para a solicitação, definida pela ferramenta Skill, um comando `/` ou herdada por um subagente gerado. Nomes de skill integrados, agrupados, definidos pelo usuário e de plugins do marketplace oficial aparecem verbatim. Nomes de skill de plugin de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.655* `skill.name`: Skill ativa para a requisição, definida pela ferramenta Skill, um comando `/`, ou herdada por um subagente gerado. Nomes de skills integrados, agrupados, definidos pelo usuário e de plugins do marketplace oficial aparecem literalmente. Nomes de skills de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.

653* `plugin.name`: Plugin proprietário quando a skill ativa ou subagente é fornecido por um plugin. Nomes de plugin do marketplace oficial aparecem verbatim. Nomes de plugin de terceiros são substituídos por `"third-party"`. Ausente quando nem a skill nem o subagente têm um plugin proprietário.656* `plugin.name`: Plugin proprietário quando a skill ativa ou subagente é fornecido por um plugin. Nomes de plugins do marketplace oficial aparecem literalmente. Nomes de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nem a skill nem o subagente tem um plugin proprietário.

654* `marketplace.name`: Marketplace do qual o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial. Ausente caso contrário.657* `marketplace.name`: Marketplace do qual o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial. Ausente caso contrário.

655* `mcp_server.name`: Servidor MCP cuja ferramenta resultado esta solicitação consumiu. Nomes de servidor integrados, proxied por claude.ai e do registro oficial aparecem verbatim. Nomes de servidor configurados pelo usuário são substituídos por `"custom"`. Ausente quando a solicitação não consumiu nenhum resultado de ferramenta MCP. Antes da v2.1.222, Claude Code definia este atributo em cada solicitação após uma chamada de ferramenta MCP, não apenas em solicitações que consumiram um resultado de ferramenta, então painéis que o agregam mostram uma queda após você atualizar.658* `mcp_server.name`: Servidor MCP cujo resultado de ferramenta esta requisição consumiu. Nomes de servidores integrados, proxied por claude.ai e do registro oficial aparecem literalmente. Nomes de servidores configurados pelo usuário são substituídos por `"custom"`. Ausente quando a requisição não consumiu resultado de ferramenta MCP. Antes da v2.1.222, Claude Code definia este atributo em cada requisição após uma chamada de ferramenta MCP, não apenas em requisições que consumiram um resultado de ferramenta, então dashboards que o agregam mostram uma queda após você atualizar.

656* `mcp_tool.name`: Ferramenta MCP cujo resultado esta solicitação consumiu, com a mesma redação e comportamento de versão que `mcp_server.name`. Ausente quando a solicitação não consumiu nenhum resultado de ferramenta MCP.659* `mcp_tool.name`: Ferramenta MCP cujo resultado esta requisição consumiu, com o mesmo comportamento de redação e versão que `mcp_server.name`. Ausente quando a requisição não consumiu resultado de ferramenta MCP.

657 660

658<h4 id="token-counter">661<h4 id="token-counter">

659 Contador de token662 Contador de tokens

660</h4>663</h4>

661 664

662Incrementado após cada solicitação de API.665Incrementado após cada requisição de API.

663 666

664**Atributos**:667**Atributos**:

665 668

666* Todos os [atributos padrão](#standard-attributes)669* Todos os [atributos padrão](#standard-attributes)

667* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)670* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)

668* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")671* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

669* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`672* `query_source`: Categoria do subsistema que emitiu a requisição. Um de `"main"`, `"subagent"`, ou `"auxiliary"`

670* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário673* `speed`: `"fast"` quando a requisição usou modo rápido. Ausente caso contrário

671* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Veja [Contador de custo](#cost-counter) para detalhes.674* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição. Veja [Contador de custo](#cost-counter) para detalhes.

672* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.675* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

673 676

674<h4 id="code-edit-tool-decision-counter">677<h4 id="code-edit-tool-decision-counter">

675 Contador de decisão da ferramenta de edição de código678 Contador de decisão da ferramenta de edição de código

676</h4>679</h4>

677 680

678Incrementado quando o usuário aceita ou rejeita o uso da ferramenta Edit, Write ou NotebookEdit.681Incrementado quando o usuário aceita ou rejeita o uso da ferramenta Edit, Write, ou NotebookEdit.

679 682

680**Atributos**:683**Atributos**:

681 684

682* Todos os [atributos padrão](#standard-attributes)685* Todos os [atributos padrão](#standard-attributes)

683* `tool_name`: Nome da ferramenta (`"Edit"`, `"Write"`, `"NotebookEdit"`)686* `tool_name`: Nome da ferramenta (`"Edit"`, `"Write"`, `"NotebookEdit"`)

684* `decision`: Decisão do usuário (`"accept"`, `"reject"`)687* `decision`: Decisão do usuário (`"accept"`, `"reject"`)

685* `source`: Onde a decisão veio. Um de `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"` ou `"user_reject"`. Veja o [Evento de decisão da ferramenta](#tool-decision-event) para o que cada valor significa.688* `source`: De onde a decisão veio. Um de `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"`, ou `"user_reject"`. Veja o [evento de decisão de ferramenta](#tool-decision-event) para o que cada valor significa.

686* `language`: Linguagem de programação do arquivo editado, como `"TypeScript"`, `"Python"`, `"JavaScript"` ou `"Markdown"`. Retorna `"unknown"` para extensões de arquivo não reconhecidas.689* `language`: Linguagem de programação do arquivo editado, como `"TypeScript"`, `"Python"`, `"JavaScript"`, ou `"Markdown"`. Retorna `"unknown"` para extensões de arquivo não reconhecidas.

687 690

688<h4 id="active-time-counter">691<h4 id="active-time-counter">

689 Contador de tempo ativo692 Contador de tempo ativo

690</h4>693</h4>

691 694

692Rastreia o tempo real gasto usando ativamente Claude Code, excluindo tempo ocioso. Essa métrica é incrementada durante interações do usuário, como digitação e leitura de respostas, e durante processamento CLI, como execução de ferramentas e geração de resposta de IA.695Rastreia o tempo real gasto usando ativamente Claude Code, excluindo tempo ocioso. Esta métrica é incrementada durante interações do usuário, como digitação e leitura de respostas, e durante processamento da CLI, como execução de ferramentas e geração de resposta de IA.

693 696

694**Atributos**:697**Atributos**:

695 698

703Claude Code exporta os seguintes eventos via logs/eventos OpenTelemetry (quando `OTEL_LOGS_EXPORTER` está configurado):706Claude Code exporta os seguintes eventos via logs/eventos OpenTelemetry (quando `OTEL_LOGS_EXPORTER` está configurado):

704 707

705<h4 id="event-correlation-attributes">708<h4 id="event-correlation-attributes">

706 Atributos de correlação de evento709 Atributos de correlação de eventos

707</h4>710</h4>

708 711

709Quando um usuário envia um prompt, Claude Code pode fazer múltiplas chamadas de API e executar várias ferramentas. O atributo `prompt.id` permite vincular todos esses eventos de volta ao único prompt que os acionou.712Quando um usuário envia um prompt, Claude Code pode fazer múltiplas chamadas de API e executar várias ferramentas. O atributo `prompt.id` permite vincular todos esses eventos de volta ao único prompt que os acionou.

710 713

712| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |715| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

715| `message.uuid` | UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects/*/*.jsonl`. Presente em `assistant_response` e em `user_prompt` exceto para despachos de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response`, esta é a entrada de transcrição final da resposta, da qual o `parentUuid` da próxima rodada se encadeia. Requer Claude Code v2.1.214 ou posterior |718| `message.uuid` | UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects/*/*.jsonl`. Presente em `assistant_response`, em `api_response_body`, e em `user_prompt` exceto para dispatches de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response` e `api_response_body`, esta é a entrada final da transcrição da resposta, da qual o `parentUuid` do próximo turno se encadeia. Requer Claude Code v2.1.214 ou posterior, ou v2.1.274 ou posterior em `api_response_body` |

716| `client_request_id` | UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedor de terceiros e quando a solicitação foi repetida através do fallback não-streaming. Emparelha uma solicitação com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior |719| `client_request_id` | UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedores de terceiros e quando a requisição foi retentada através do fallback não-streaming. Emparelha uma requisição com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior |

717 720

718Para rastrear toda a atividade acionada por um único prompt, filtre seus eventos por um valor específico de `prompt.id`. Isso retorna o evento user\_prompt, quaisquer eventos api\_request e quaisquer eventos tool\_result que ocorreram ao processar esse prompt.721Para rastrear toda atividade acionada por um único prompt, filtre seus eventos por um valor específico de `prompt.id`. Isto retorna o evento user\_prompt, quaisquer eventos api\_request, e quaisquer eventos tool\_result que ocorreram ao processar esse prompt.

719 722

720`event.sequence` começa em 0 cada vez que um processo Claude Code inicia e conta para cima pela vida desse processo. Ele continua contando através de `/clear`, que atribui um novo `session.id`. Se você [retomar uma sessão sem fazer fork](/docs/pt/how-claude-code-works#resume-or-fork-sessions), a sessão mantém seu `session.id` mas toma seus valores de `event.sequence` do processo que a retomou, então dentro de uma sessão um evento posterior pode carregar um valor menor que um anterior, ou repetir um. Para ordenar os eventos de uma sessão, classifique por `event.timestamp` e use `event.sequence` para ordenar eventos que compartilham um timestamp.723`event.sequence` começa em 0 cada vez que um processo Claude Code inicia e conta para cima pela vida desse processo. Continua contando através de `/clear`, que atribui um novo `session.id`. Se você [retomar uma sessão sem fazer fork](/docs/pt/how-claude-code-works#resume-or-fork-sessions), a sessão mantém seu `session.id` mas toma seus valores de `event.sequence` do processo que a retomou, então dentro de uma sessão um evento posterior pode carregar um valor menor que um anterior, ou repetir um. Para ordenar os eventos de uma sessão, ordene por `event.timestamp` e use `event.sequence` para ordenar eventos que compartilham um timestamp.

721 724

722Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada de transcrição é [interno ao Claude Code](/docs/pt/sessions#where-transcripts-are-stored) e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer versão; trate as uniões como específicas da versão em vez de um contrato estável:725Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada da transcrição é [interno ao Claude Code](/docs/pt/sessions#where-transcripts-are-stored) e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer release; trate as uniões como específicas da versão em vez de um contrato estável:

723 726

724* `message.uuid` em `user_prompt` e `assistant_response`727* `message.uuid` em `user_prompt`, `assistant_response`, e `api_response_body`

725* `request_id` nos eventos de API, persistido como `requestId` nas entradas do assistente da transcrição728* `request_id` nos eventos de API, persistido como `requestId` nas entradas de assistente da transcrição

726* `tool_use_id` em eventos `tool_result` e `tool_decision`729* `tool_use_id` em eventos `tool_result` e `tool_decision`

727 730

728<h4 id="user-prompt-event">731<h4 id="user-prompt-event">

738* Todos os [atributos padrão](#standard-attributes)741* Todos os [atributos padrão](#standard-attributes)

739* `event.name`: `"user_prompt"`742* `event.name`: `"user_prompt"`

740* `event.timestamp`: Timestamp ISO 8601743* `event.timestamp`: Timestamp ISO 8601

741* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)744* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

742* `prompt_length`: Comprimento do prompt745* `prompt_length`: Comprimento do prompt

743* `prompt`: Conteúdo do prompt. Reduzido por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo746* `prompt`: Conteúdo do prompt. Redatado por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo

744* `message.uuid`: UUID da mensagem do usuário resultante, correspondendo à entrada de transcrição persistida. Ausente em despachos de comando, que podem produzir zero ou muitas mensagens. Requer Claude Code v2.1.214 ou posterior747* `message.uuid`: UUID da mensagem do usuário resultante, correspondendo à entrada da transcrição persistida. Ausente em dispatches de comando, que podem produzir zero ou muitas mensagens. Requer Claude Code v2.1.214 ou posterior

745* `command_name`: Nome do comando quando o prompt invoca um. Nomes de comando integrados e agrupados como `compact` ou `debug` são emitidos como estão; aliases como `reset` emitem como digitados em vez do nome canônico. Nomes de comando customizado, plugin e MCP colapsam para `custom` ou `mcp` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido748* `command_name`: Nome do comando quando o prompt invoca um. Nomes de comando integrados e agrupados como `compact` ou `debug` são emitidos como estão; aliases como `reset` emitem conforme digitado em vez do nome canônico. Nomes de comando personalizados, de plugin e MCP colapsam para `custom` ou `mcp` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

746* `command_source`: Origem do comando quando presente: `builtin`, `custom` ou `mcp`. Comandos fornecidos por plugin relatam como `custom`749* `command_source`: Origem do comando quando presente: `builtin`, `custom`, ou `mcp`. Comandos fornecidos por plugin relatam como `custom`

747 750

748<h4 id="assistant-response-event">751<h4 id="assistant-response-event">

749 Evento de resposta do assistente752 Evento de resposta do assistente

750</h4>753</h4>

751 754

752Registrado após cada solicitação de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos. Requer Claude Code v2.1.193 ou posterior.755Registrado após cada requisição de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos. Requer Claude Code v2.1.193 ou posterior.

753 756

754**Nome do Evento**: `claude_code.assistant_response`757**Nome do Evento**: `claude_code.assistant_response`

755 758

758* Todos os [atributos padrão](#standard-attributes)761* Todos os [atributos padrão](#standard-attributes)

759* `event.name`: `"assistant_response"`762* `event.name`: `"assistant_response"`

760* `event.timestamp`: Timestamp ISO 8601763* `event.timestamp`: Timestamp ISO 8601

761* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)764* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

762* `response_length`: Comprimento do texto de resposta em caracteres765* `response_length`: Comprimento do texto de resposta em caracteres

763* `response`: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Reduzido para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` controla isso em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas reduzidas enquanto o registro de prompt está ativado766* `response`: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Redatado para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` o controla em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas redatadas enquanto o log de prompt está ativado

764* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")767* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

765* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta. Presente apenas quando a API retorna um768* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta. Presente apenas quando a API retorna um

766* `message.uuid`: UUID da entrada de transcrição final da resposta. Uma resposta de API é persistida como uma entrada de transcrição por bloco de conteúdo; esta é a última, da qual o `parentUuid` da próxima rodada se encadeia. Requer Claude Code v2.1.214 ou posterior769* `message.uuid`: UUID da entrada final da transcrição da resposta. Uma resposta de API é persistida como uma entrada de transcrição por bloco de conteúdo; esta é a última, da qual o `parentUuid` do próximo turno se encadeia. Requer Claude Code v2.1.214 ou posterior

767* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente770* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente

768 771

769<h4 id="tool-result-event">772<h4 id="tool-result-event">

770 Evento de resultado da ferramenta773 Evento de resultado de ferramenta

771</h4>774</h4>

772 775

773Registrado quando uma ferramenta conclui a execução. Não é emitido se a chamada da ferramenta foi rejeitada; veja o [Evento de decisão da ferramenta](#tool-decision-event) para rejeições.776Registrado quando uma ferramenta completa a execução. Não emitido se a chamada de ferramenta foi rejeitada; veja o [evento de decisão de ferramenta](#tool-decision-event) para rejeições.

774 777

775**Nome do Evento**: `claude_code.tool_result`778**Nome do Evento**: `claude_code.tool_result`

776 779

779* Todos os [atributos padrão](#standard-attributes)782* Todos os [atributos padrão](#standard-attributes)

780* `event.name`: `"tool_result"`783* `event.name`: `"tool_result"`

781* `event.timestamp`: Timestamp ISO 8601784* `event.timestamp`: Timestamp ISO 8601

782* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)785* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

783* `tool_name`: Nome da ferramenta786* `tool_name`: Nome da ferramenta

784* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.787* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.

785* `success`: `"true"` ou `"false"`788* `success`: `"true"` ou `"false"`

787* `error_type`: String de categoria de erro quando a ferramenta falhou, como `"Error:ENOENT"` ou `"ShellError"`790* `error_type`: String de categoria de erro quando a ferramenta falhou, como `"Error:ENOENT"` ou `"ShellError"`

788* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a ferramenta falhou791* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a ferramenta falhou

789* `decision_type`: Sempre `"accept"`, já que este evento é emitido apenas após a ferramenta ser executada. Chamadas rejeitadas não produzem um resultado de ferramenta792* `decision_type`: Sempre `"accept"`, já que este evento é emitido apenas após a ferramenta ser executada. Chamadas rejeitadas não produzem um resultado de ferramenta

790* `decision_source`: Onde a decisão de permissão veio. Um de `"config"`, `"hook"`, `"user_permanent"` ou `"user_temporary"`. Veja o [Evento de decisão da ferramenta](#tool-decision-event) para o que cada valor significa. As fontes apenas de rejeição `"user_abort"` e `"user_reject"` nunca aparecem neste evento.793* `decision_source`: De onde a decisão de permissão veio. Um de `"config"`, `"hook"`, `"user_permanent"`, ou `"user_temporary"`. Veja o [evento de decisão de ferramenta](#tool-decision-event) para o que cada valor significa. As fontes apenas de rejeição `"user_abort"` e `"user_reject"` nunca aparecem neste evento.

791* `tool_input_size_bytes`: Tamanho da entrada da ferramenta serializada em JSON em bytes794* `tool_input_size_bytes`: Tamanho da entrada de ferramenta serializada em JSON em bytes

792* `tool_result_size_bytes`: Tamanho do resultado da ferramenta em bytes795* `tool_result_size_bytes`: Tamanho do resultado da ferramenta em bytes

793* `mcp_server_scope`: Identificador de escopo do servidor MCP (para ferramentas MCP)796* `mcp_server_scope`: Identificador de escopo do servidor MCP (para ferramentas MCP)

794* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): a identidade do commit de uma execução bem-sucedida de `git commit` executada pela ferramenta Bash ou PowerShell. `vcs.ref.head.revision` é o SHA do commit, `vcs.ref.head.name` é o branch no qual foi feito o commit, e `vcs.ref.head.type` é `branch`. O nome e tipo são omitidos quando o commit foi feito em um HEAD desanexado. Requer Claude Code v2.1.269 ou posterior797* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): a identidade do commit de uma execução bem-sucedida de `git commit` executada pela ferramenta Bash ou PowerShell. `vcs.ref.head.revision` é o SHA do commit, `vcs.ref.head.name` é o branch no qual foi feito o commit, e `vcs.ref.head.type` é `branch`. O nome e tipo são omitidos quando o commit foi feito em um HEAD desanexado. Requer Claude Code v2.1.269 ou posterior

795* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, o par `mcp_server_name`/`mcp_tool_name` é incluído mesmo com a flag desligada, a mesma exceção de autoria do host que o [Evento de decisão da ferramenta](#tool-decision-event), requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:798* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, o par `mcp_server_name`/`mcp_tool_name` é incluído mesmo com a flag desativada, a mesma exceção de autoria do host que o [evento de decisão de ferramenta](#tool-decision-event), requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:

796 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description` e `dangerouslyDisableSandbox`, mais `git_commit_id` e `git_branch` quando um comando `git commit` é bem-sucedido. `git_commit_id` é o SHA do commit completo quando o commit é o HEAD do diretório de trabalho da sessão, e o SHA abreviado do git caso contrário. `git_branch` é o branch no qual foi feito o commit, omitido em um HEAD desanexado799 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, e `dangerouslyDisableSandbox`, mais `git_commit_id` e `git_branch` quando um comando `git commit` é bem-sucedido. `git_commit_id` é o SHA completo do commit quando o commit é o HEAD do diretório de trabalho da sessão, e o SHA abreviado do git caso contrário. `git_branch` é o branch no qual foi feito o commit, omitido em um HEAD desanexado

797 * Para a ferramenta Bash de workspace do aplicativo desktop, que também relata `tool_name` como `Bash`: inclui apenas `bash_command`, `full_command` e `timeout`800 * Para a ferramenta Bash do workspace do aplicativo desktop, que também relata `tool_name` como `Bash`: inclui apenas `bash_command`, `full_command`, e `timeout`

798 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`801 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`

799 * Para ferramenta Skill: inclui `skill_name`802 * Para ferramenta Skill: inclui `skill_name`

800 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`803 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`

801* `tool_input` (quando `OTEL_LOG_TOOL_DETAILS=1`): Argumentos de ferramenta serializados em JSON. Valores individuais com mais de 512 caracteres são truncados, e a carga útil completa é limitada a \~4 K caracteres. Aplica-se a todas as ferramentas, incluindo ferramentas MCP.804* `tool_input` (quando `OTEL_LOG_TOOL_DETAILS=1`): Argumentos de ferramenta serializados em JSON. Valores individuais acima de 512 caracteres são truncados, e o payload completo é limitado a \~4 K caracteres. Aplica-se a todas as ferramentas incluindo ferramentas MCP.

802 805

803<h4 id="api-request-event">806<h4 id="api-request-event">

804 Evento de solicitação de API807 Evento de requisição de API

805</h4>808</h4>

806 809

807Registrado para cada solicitação de API para Claude.810Registrado para cada requisição de API para Claude.

808 811

809**Nome do Evento**: `claude_code.api_request`812**Nome do Evento**: `claude_code.api_request`

810 813

813* Todos os [atributos padrão](#standard-attributes)816* Todos os [atributos padrão](#standard-attributes)

814* `event.name`: `"api_request"`817* `event.name`: `"api_request"`

815* `event.timestamp`: Timestamp ISO 8601818* `event.timestamp`: Timestamp ISO 8601

816* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)819* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

817* `model`: Modelo usado (por exemplo, "claude-sonnet-5")820* `model`: Modelo usado (por exemplo, "claude-sonnet-5")

818* `cost_usd`: Custo estimado em USD821* `cost_usd`: Custo estimado em USD

819* `cost_usd_micros`: Custo estimado em milionésimos de dólar americano, emitido como um inteiro822* `cost_usd_micros`: Custo estimado em milionésimos de dólar americano, emitido como um inteiro

820* `duration_ms`: Duração da solicitação em milissegundos823* `duration_ms`: Duração da requisição em milissegundos

821* `input_tokens`: Número de tokens de entrada824* `input_tokens`: Número de tokens de entrada

822* `output_tokens`: Número de tokens de saída825* `output_tokens`: Número de tokens de saída

823* `cache_read_tokens`: Número de tokens lidos do cache826* `cache_read_tokens`: Número de tokens lidos do cache

824* `cache_creation_tokens`: Número de tokens usados para criação de cache827* `cache_creation_tokens`: Número de tokens usados para criação de cache

825* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.828* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

826* `client_request_id`: UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`; veja a tabela [atributos de correlação de evento](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior829* `client_request_id`: UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`; veja a tabela [atributos de correlação de eventos](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior

827* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo830* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo

828* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente831* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente

829* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação: `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Ausente quando o modelo não suporta esforço.832* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição: `"low"`, `"medium"`, `"high"`, `"xhigh"`, ou `"max"`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

830* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.833* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

831 834

832<h4 id="api-error-event">835<h4 id="api-error-event">

833 Evento de erro de API836 Evento de erro de API

834</h4>837</h4>

835 838

836Registrado quando uma solicitação de API para Claude falha.839Registrado quando uma requisição de API para Claude falha.

837 840

838**Nome do Evento**: `claude_code.api_error`841**Nome do Evento**: `claude_code.api_error`

839 842

842* Todos os [atributos padrão](#standard-attributes)845* Todos os [atributos padrão](#standard-attributes)

843* `event.name`: `"api_error"`846* `event.name`: `"api_error"`

844* `event.timestamp`: Timestamp ISO 8601847* `event.timestamp`: Timestamp ISO 8601

845* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)848* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

846* `model`: Modelo usado (por exemplo, "claude-sonnet-5")849* `model`: Modelo usado (por exemplo, "claude-sonnet-5")

847* `error`: Mensagem de erro850* `error`: Mensagem de erro

848* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP, como falhas de conexão.851* `status_code`: Código de status HTTP como um número. Ausente para erros não-HTTP como falhas de conexão.

849* `duration_ms`: Duração da solicitação em milissegundos852* `duration_ms`: Duração da requisição em milissegundos

850* `attempt`: Número total de tentativas feitas, incluindo a solicitação inicial (`1` significa que nenhuma tentativa ocorreu)853* `attempt`: Número total de tentativas feitas, incluindo a requisição inicial (`1` significa que nenhuma retentativa ocorreu)

851* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.854* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

852* `client_request_id`: UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`. Disponível mesmo quando uma falha como timeout ou erro de conexão nunca produziu um `request_id` do servidor; veja a tabela [atributos de correlação de evento](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior855* `client_request_id`: UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`. Disponível mesmo quando uma falha como timeout ou erro de conexão nunca produziu um `request_id` do servidor; veja a tabela [atributos de correlação de eventos](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior

853* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo856* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo

854* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente857* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente

855* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.858* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

856* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.859* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

857 860

858<h4 id="api-refusal-event">861<h4 id="api-refusal-event">

859 Evento de recusa de API862 Evento de recusa de API

860</h4>863</h4>

861 864

862Registrado quando uma solicitação de API retorna `stop_reason: "refusal"`. Recusas chegam em um fluxo de resposta bem-sucedido em vez de como um erro HTTP, então o evento `api_error` não dispara para elas. Este evento permite rastrear a frequência de recusa e agrupar recusas pelos mesmos atributos que `api_request` e `api_error`.865Registrado quando uma requisição de API retorna `stop_reason: "refusal"`. Recusas chegam em um stream de resposta bem-sucedido em vez de como um erro HTTP, então o evento `api_error` não dispara para elas. Este evento permite rastrear a frequência de recusa e agrupar recusas pelos mesmos atributos que `api_request` e `api_error`.

863 866

864**Nome do Evento**: `claude_code.api_refusal`867**Nome do Evento**: `claude_code.api_refusal`

865 868

868* Todos os [atributos padrão](#standard-attributes)871* Todos os [atributos padrão](#standard-attributes)

869* `event.name`: `"api_refusal"`872* `event.name`: `"api_refusal"`

870* `event.timestamp`: Timestamp ISO 8601873* `event.timestamp`: Timestamp ISO 8601

871* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)874* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

872* `model`: Identificador do modelo da solicitação875* `model`: Identificador do modelo da requisição

873* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.876* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

874* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente. Veja [`api_request`](#api-request-event) para definições.877* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente. Veja [`api_request`](#api-request-event) para definições.

875* `speed`: Ou `"fast"` quando [Fast mode](/docs/pt/fast-mode) está ativo, ou `"normal"`878* `speed`: Ou `"fast"` quando [Modo rápido](/docs/pt/fast-mode) está ativo, ou `"normal"`

876* `attempt`: Número de tentativa de repetição. A primeira tentativa é `1`.879* `attempt`: Número de tentativa de retentativa. A primeira tentativa é `1`.

877* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.880* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

878* `server_fallback_hop`: `true` quando o fallback de modelo do lado do servidor da API já tentou novamente esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. `false` quando a solicitação terminou em uma recusa. Uma única rodada pode emitir tanto um evento hop `true` quanto um evento final `false` posterior quando o modelo de fallback também recusa.881* `server_fallback_hop`: `true` quando o fallback de modelo do lado do servidor da API já retentou esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. `false` quando a requisição terminou em uma recusa. Um único turno pode emitir tanto um evento de hop `true` quanto um evento final `false` posterior quando o modelo de fallback também recusa.

879* `has_category`: `true` quando a resposta da API carregava um `stop_details.category` de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. `false` quando a resposta não carregava categoria ou um valor fora desse conjunto. Ausente quando `server_fallback_hop` é `true`, porque blocos hop não carregam `stop_details`.882* `has_category`: `true` quando a resposta da API carregava um `stop_details.category` de `"cyber"`, `"bio"`, `"frontier_llm"`, ou `"reasoning_extraction"`. `false` quando a resposta não carregava categoria ou um valor fora desse conjunto. Ausente quando `server_fallback_hop` é `true`, porque blocos de hop não carregam `stop_details`.

880* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.883* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.

881* `category`: O valor `stop_details.category` da resposta da API. Um de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. Presente apenas quando `OTEL_LOG_TOOL_DETAILS=1` está definido e `has_category` é `true`.884* `category`: O valor `stop_details.category` da resposta da API. Um de `"cyber"`, `"bio"`, `"frontier_llm"`, ou `"reasoning_extraction"`. Presente apenas quando `OTEL_LOG_TOOL_DETAILS=1` está definido e `has_category` é `true`.

882* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.885* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

883 886

884<h4 id="api-request-body-event">887<h4 id="api-request-body-event">

885 Evento de corpo de solicitação de API888 Evento de corpo de requisição de API

886</h4>889</h4>

887 890

888Registrado para cada tentativa de solicitação de API quando `OTEL_LOG_RAW_API_BODIES` está definido. Um evento é emitido por tentativa, então tentativas com parâmetros ajustados cada uma produzem seu próprio evento.891Registrado para cada tentativa de requisição de API quando `OTEL_LOG_RAW_API_BODIES` está definido. Um evento é emitido por tentativa, então retentativas com parâmetros ajustados cada uma produz seu próprio evento.

889 892

890**Nome do Evento**: `claude_code.api_request_body`893**Nome do Evento**: `claude_code.api_request_body`

891 894

894* Todos os [atributos padrão](#standard-attributes)897* Todos os [atributos padrão](#standard-attributes)

895* `event.name`: `"api_request_body"`898* `event.name`: `"api_request_body"`

896* `event.timestamp`: Timestamp ISO 8601899* `event.timestamp`: Timestamp ISO 8601

897* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)900* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

898* `body`: Parâmetros de solicitação da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).901* `body`: Parâmetros de requisição da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é redatado. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).

899* `body_ref`: Caminho absoluto para um arquivo `<dir>/<uuid>.request.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).902* `body_ref`: Caminho absoluto para um arquivo `<dir>/<uuid>.request.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

900* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`903* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`

901* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.904* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.

902* `model`: Identificador do modelo dos parâmetros de solicitação905* `model`: Identificador do modelo dos parâmetros de requisição

903* `query_source`: Subsistema que emitiu a solicitação (por exemplo, `"compact"`)906* `query_source`: Subsistema que emitiu a requisição (por exemplo, `"compact"`)

904* `request_body_id`: UUID que identifica o corpo de solicitação desta tentativa. O evento [`api_response_body`](#api-response-body-event) para a tentativa que é bem-sucedida carrega o mesmo valor, para que você possa emparelhar uma resposta com a solicitação exata que a produziu. Requer Claude Code v2.1.274 ou posterior907* `request_body_id`: UUID que identifica o corpo de requisição desta tentativa. O evento [`api_response_body`](#api-response-body-event) para a tentativa que é bem-sucedida carrega o mesmo valor, então você pode emparelhar uma resposta com a requisição exata que a produziu. Requer Claude Code v2.1.274 ou posterior

905 908

906<h4 id="api-response-body-event">909<h4 id="api-response-body-event">

907 Evento de corpo de resposta de API910 Evento de corpo de resposta de API

909 912

910Registrado para cada resposta de API bem-sucedida quando `OTEL_LOG_RAW_API_BODIES` está definido.913Registrado para cada resposta de API bem-sucedida quando `OTEL_LOG_RAW_API_BODIES` está definido.

911 914

912Em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code também anexa uma linha JSON a `<dir>/index.jsonl` para cada resposta bem-sucedida, com os campos `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` e `response_file`. Leia-o para encontrar os arquivos de solicitação e resposta atrás de uma determinada mensagem de transcrição sem consultar seu backend de telemetria. O arquivo de índice requer Claude Code v2.1.274 ou posterior.915Em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code também anexa uma linha JSON a `<dir>/index.jsonl` para cada resposta bem-sucedida, com os campos `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, e `response_file`. Leia-o para encontrar os arquivos de requisição e resposta atrás de uma determinada mensagem de transcrição sem consultar seu backend de telemetria. O arquivo de índice requer Claude Code v2.1.274 ou posterior.

913 916

914**Nome do Evento**: `claude_code.api_response_body`917**Nome do Evento**: `claude_code.api_response_body`

915 918

918* Todos os [atributos padrão](#standard-attributes)921* Todos os [atributos padrão](#standard-attributes)

919* `event.name`: `"api_response_body"`922* `event.name`: `"api_response_body"`

920* `event.timestamp`: Timestamp ISO 8601923* `event.timestamp`: Timestamp ISO 8601

921* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)924* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

922* `body`: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).925* `body`: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é redatado. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).

923* `body_ref`: Caminho absoluto para um arquivo `<dir>/<request_id>.response.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).926* `body_ref`: Caminho absoluto para um arquivo `<dir>/<request_id>.response.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

924* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`927* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`

925* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.928* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.

926* `model`: Identificador do modelo929* `model`: Identificador do modelo

927* `query_source`: Subsistema que emitiu a solicitação930* `query_source`: Subsistema que emitiu a requisição

928* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.931* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

929* `request_body_id`: O `request_body_id` do evento [`api_request_body`](#api-request-body-event) que esta resposta responde. Requer Claude Code v2.1.274 ou posterior932* `request_body_id`: O `request_body_id` do evento [`api_request_body`](#api-request-body-event) que esta resposta responde. Requer Claude Code v2.1.274 ou posterior

930* `message.id`: ID da mensagem que a API atribuiu à resposta, o campo `id` do corpo da resposta. Requer Claude Code v2.1.274 ou posterior933* `message.id`: ID de mensagem que a API atribuiu à resposta, o campo `id` do corpo da resposta. Requer Claude Code v2.1.274 ou posterior

931* `message.uuid`: UUID da entrada de transcrição final da resposta. Junto com `request_body_id`, ele vincula uma mensagem de transcrição aos corpos de solicitação e resposta atrás dela. Requer Claude Code v2.1.274 ou posterior934* `message.uuid`: UUID da entrada final da transcrição da resposta. Junto com `request_body_id`, vincula uma mensagem de transcrição aos corpos de requisição e resposta atrás dela. Requer Claude Code v2.1.274 ou posterior

932 935

933<h4 id="tool-decision-event">936<h4 id="tool-decision-event">

934 Evento de decisão da ferramenta937 Evento de decisão de ferramenta

935</h4>938</h4>

936 939

937Registrado quando uma decisão de permissão da ferramenta é feita (aceitar/rejeitar).940Registrado quando uma decisão de permissão de ferramenta é feita (aceitar/rejeitar).

938 941

939**Nome do Evento**: `claude_code.tool_decision`942**Nome do Evento**: `claude_code.tool_decision`

940 943

943* Todos os [atributos padrão](#standard-attributes)946* Todos os [atributos padrão](#standard-attributes)

944* `event.name`: `"tool_decision"`947* `event.name`: `"tool_decision"`

945* `event.timestamp`: Timestamp ISO 8601948* `event.timestamp`: Timestamp ISO 8601

946* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)949* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

947* `tool_name`: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")950* `tool_name`: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")

948* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.951* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.

949* `decision`: Ou `"accept"` ou `"reject"`952* `decision`: Ou `"accept"` ou `"reject"`

950* `tool_source`: Sempre presente. A proveniência da ferramenta, como um conjunto fechado de valores criados pela CLI. Requer Claude Code v2.1.214 ou posterior953* `tool_source`: Sempre presente. A proveniência da ferramenta, como um conjunto fechado de valores de autoria da CLI. Requer Claude Code v2.1.214 ou posterior

951 * `"builtin"`: as próprias ferramentas da CLI954 * `"builtin"`: as próprias ferramentas da CLI

952 * `"mcp"`: servidores MCP em geral955 * `"mcp"`: servidores MCP em geral

953 * `"sdk_host_builtin_mcp"`: um servidor em processo integrado ao próprio Claude Desktop, em uma sessão que Claude Desktop possui. Claude Desktop possui uma sessão que iniciou a partir de um de seus próprios pontos de entrada, `claude-desktop`, `claude-desktop-3p` ou `local-agent`, quando essa sessão não é uma criança aninhada; sessões aninhadas, incluindo sessões que o próprio Claude Code gera, relatam esses servidores como `"mcp"`956 * `"sdk_host_builtin_mcp"`: um servidor em processo integrado ao próprio Claude Desktop, em uma sessão que Claude Desktop possui. Claude Desktop possui uma sessão que iniciou de um de seus próprios pontos de entrada, `claude-desktop`, `claude-desktop-3p`, ou `local-agent`, quando essa sessão não é um filho aninhado; sessões aninhadas, incluindo sessões que Claude Code gera, relatam esses servidores como `"mcp"`

954* `source`: Onde a decisão veio:957* `source`: De onde a decisão veio:

955 * `"config"`: Decidido automaticamente sem avisar, baseado em configurações de projeto, regras de permissão nas configurações pessoais do usuário, política gerenciada corporativa, sinalizadores `--allowedTools` ou `--disallowedTools`, o modo de permissão ativo, uma concessão com escopo de sessão de um prompt anterior na mesma sessão CLI interativa, ou porque a ferramenta é inerentemente segura. O evento não indica qual dessas fontes correspondeu. Claude Code também relata `"config"` quando a própria solicitação de aviso de permissão falha, por exemplo quando o callback [`canUseTool`](/docs/pt/agent-sdk/typescript#canusetool) do Agent SDK ou a ferramenta [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) retorna um resultado inválido, ou quando o fluxo de entrada fecha enquanto a solicitação está pendente. Antes da v2.1.216, Claude Code relatava essas falhas como `"user_reject"`.958 * `"config"`: Decidido automaticamente sem solicitar, baseado em configurações de projeto, regras de permissão ou negação nas configurações pessoais do usuário, política gerenciada pela empresa, flags `--allowedTools` ou `--disallowedTools`, o modo de permissão ativo, uma concessão com escopo de sessão de um prompt anterior na mesma sessão CLI interativa, ou porque a ferramenta é inerentemente segura. O evento não indica qual dessas fontes correspondeu. Claude Code também relata `"config"` quando a própria requisição de prompt de permissão falha, por exemplo quando o callback [`canUseTool`](/docs/pt/agent-sdk/typescript#canusetool) do Agent SDK ou a ferramenta [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) retorna um resultado inválido, ou quando o stream de entrada fecha enquanto a requisição está pendente. Antes da v2.1.216, Claude Code relatava essas falhas como `"user_reject"`.

956 * `"hook"`: Um hook `PreToolUse` ou `PermissionRequest` retornou a decisão.959 * `"hook"`: Um hook `PreToolUse` ou `PermissionRequest` retornou a decisão.

957 * `"user_permanent"`: Emitido quando o usuário escolheu "Sim, e não pergunte novamente para ..." em um aviso de permissão, que salva uma regra de permissão em suas configurações pessoais. Na CLI interativa isso é emitido apenas para essa escolha em si; chamadas posteriores que correspondem à regra salva emitem `"config"` em vez disso. No Agent SDK ou sessões não-interativas `-p`, tanto a escolha inicial quanto correspondências de regra posteriores emitem `"user_permanent"`. Tratado como uma aceitação.960 * `"user_permanent"`: Emitido quando o usuário escolheu "Sim, e não pergunte novamente para ..." em um prompt de permissão, que salva uma regra de permissão em suas configurações pessoais. Na CLI interativa isto é emitido apenas para essa escolha em si; chamadas posteriores que correspondem à regra salva emitem `"config"` em vez disso. Em sessões Agent SDK ou não-interativas `-p`, tanto a escolha inicial quanto correspondências posteriores de regra emitem `"user_permanent"`. Tratado como uma aceitação.

958 * `"user_temporary"`: Emitido quando o usuário escolheu "Sim" em um aviso de permissão para uma aprovação única, ou escolheu uma opção que concede acesso pelo resto da sessão em um aviso de edição ou leitura de arquivo. Na CLI interativa isso é emitido apenas para a escolha em si; chamadas posteriores permitidas por essa concessão com escopo de sessão emitem `"config"` em vez disso. No Agent SDK ou sessões não-interativas `-p`, tanto a escolha quanto correspondências posteriores emitem `"user_temporary"`. Tratado como uma aceitação.961 * `"user_temporary"`: Emitido quando o usuário escolheu "Sim" em um prompt de permissão para uma aprovação única, ou escolheu uma opção que concede acesso pelo resto da sessão em um prompt de edição ou leitura de arquivo. Na CLI interativa isto é emitido apenas para a escolha em si; chamadas posteriores permitidas por essa concessão com escopo de sessão emitem `"config"` em vez disso. Em sessões Agent SDK ou não-interativas `-p`, tanto a escolha quanto correspondências posteriores emitem `"user_temporary"`. Tratado como uma aceitação.

959 * `"user_abort"`: Emitido quando o usuário descartou o aviso de permissão sem responder. No Agent SDK e sessões não-interativas `-p`, isso inclui interromper a rodada enquanto uma solicitação de permissão `canUseTool` ou `--permission-prompt-tool` está pendente; antes da v2.1.216, Claude Code relatava essa interrupção como `"user_reject"`. Tratado como uma rejeição.962 * `"user_abort"`: Emitido quando o usuário descartou o prompt de permissão sem responder. Em sessões Agent SDK e não-interativas `-p`, isto inclui interromper o turno enquanto uma requisição de permissão `canUseTool` ou `--permission-prompt-tool` está pendente; antes da v2.1.216, Claude Code relatava essa interrupção como `"user_reject"`. Tratado como uma rejeição.

960 * `"user_reject"`: Emitido quando o usuário escolheu "Não" quando solicitado. Na CLI interativa isso é emitido apenas para essa escolha em si; chamadas que correspondem a uma regra de negação nas configurações pessoais do usuário emitem `"config"` em vez disso. No Agent SDK ou sessões não-interativas `-p`, chamadas que correspondem a uma regra de negação em configurações pessoais emitem `"user_reject"`. Tratado como uma rejeição.963 * `"user_reject"`: Emitido quando o usuário escolheu "Não" quando solicitado. Na CLI interativa isto é emitido apenas para essa escolha em si; chamadas que correspondem a uma regra de negação nas configurações pessoais do usuário emitem `"config"` em vez disso. Em sessões Agent SDK ou não-interativas `-p`, chamadas que correspondem a uma regra de negação em configurações pessoais emitem `"user_reject"`. Tratado como uma rejeição.

961* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Mesma forma que o [Evento de resultado da ferramenta](#tool-result-event), menos campos pós-execução como `git_commit_id`. Os valores podem diferir de `tool_result` para uma chamada aceita se a decisão de permissão reescrever a entrada da ferramenta via `updatedInput`. Use este atributo para ver qual comando foi rejeitado quando `decision` é `"reject"`.964* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Mesma forma que o [evento de resultado de ferramenta](#tool-result-event), menos campos pós-execução como `git_commit_id`. Os valores podem diferir de `tool_result` para uma chamada aceita se a decisão de permissão reescreve a entrada da ferramenta via `updatedInput`. Use este atributo para ver qual comando foi rejeitado quando `decision` é `"reject"`.

962 * Para ferramentas `"sdk_host_builtin_mcp"`: `mcp_server_name` e `mcp_tool_name` são incluídos mesmo quando `OTEL_LOG_TOOL_DETAILS` está desligado, porque a aplicação host define esses nomes; sem eles, uma chamada rejeitada para um desses servidores integrados seria não atribuível no fluxo padrão. Para servidores MCP configurados pelo usuário, o `tool_name` do evento é sempre o literal `"mcp_tool"`, e os nomes do servidor e ferramenta aparecem apenas em `tool_parameters` com a flag ligada; conteúdo de argumento requer a flag em todos os lugares. Requer Claude Code v2.1.214 ou posterior965 * Para ferramentas `"sdk_host_builtin_mcp"`: `mcp_server_name` e `mcp_tool_name` são incluídos mesmo quando `OTEL_LOG_TOOL_DETAILS` está desativado, porque a aplicação host define esses nomes; sem eles, uma chamada rejeitada para um desses servidores integrados seria não atribuível no stream padrão. Para servidores MCP configurados pelo usuário, o `tool_name` do evento é sempre o literal `"mcp_tool"`, e os nomes do servidor e ferramenta aparecem apenas em `tool_parameters` com a flag ativada; conteúdo de argumento requer a flag em todos os lugares. Requer Claude Code v2.1.214 ou posterior

963 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. A ferramenta bash de workspace do aplicativo desktop também relata `tool_name` como `Bash`, mas inclui apenas `bash_command`, `full_command` e `timeout`966 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. A ferramenta bash do workspace do aplicativo desktop também relata `tool_name` como `Bash`, mas inclui apenas `bash_command`, `full_command`, e `timeout`

964 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`967 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`

965 * Para ferramenta Skill: inclui `skill_name`968 * Para ferramenta Skill: inclui `skill_name`

966 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`969 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`

967 970

968<h4 id="permission-mode-changed-event">971<h4 id="permission-mode-changed-event">

969 Evento de modo de permissão alterado972 Evento de mudança de modo de permissão

970</h4>973</h4>

971 974

972Registrado quando o modo de permissão muda, por exemplo de ciclagem Shift+Tab, saída do Plan Mode ou verificação de gate de modo automático.975Registrado quando o modo de permissão muda, por exemplo de ciclagem `Shift+Tab`, saída do modo de plano, ou uma verificação de gate de modo automático.

973 976

974**Nome do Evento**: `claude_code.permission_mode_changed`977**Nome do Evento**: `claude_code.permission_mode_changed`

975 978

978* Todos os [atributos padrão](#standard-attributes)981* Todos os [atributos padrão](#standard-attributes)

979* `event.name`: `"permission_mode_changed"`982* `event.name`: `"permission_mode_changed"`

980* `event.timestamp`: Timestamp ISO 8601983* `event.timestamp`: Timestamp ISO 8601

981* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)984* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

982* `from_mode`: O modo de permissão anterior, por exemplo `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` ou `"bypassPermissions"`985* `from_mode`: O modo de permissão anterior, por exemplo `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, ou `"bypassPermissions"`

983* `to_mode`: O novo modo de permissão986* `to_mode`: O novo modo de permissão

984* `trigger`: O que causou a mudança. Um de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` ou `"auto_opt_in"`. Ausente quando a transição se origina do SDK ou bridge987* `trigger`: O que causou a mudança. Um de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, ou `"auto_opt_in"`. Ausente quando a transição origina do SDK ou bridge

985 988

986<h4 id="auth-event">989<h4 id="auth-event">

987 Evento de autenticação990 Evento de autenticação

996* Todos os [atributos padrão](#standard-attributes)999* Todos os [atributos padrão](#standard-attributes)

997* `event.name`: `"auth"`1000* `event.name`: `"auth"`

998* `event.timestamp`: Timestamp ISO 86011001* `event.timestamp`: Timestamp ISO 8601

999* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1002* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1000* `action`: `"login"` ou `"logout"`1003* `action`: `"login"` ou `"logout"`

1001* `success`: `"true"` ou `"false"`1004* `success`: `"true"` ou `"false"`

1002* `auth_method`: Método de autenticação, como `"oauth"`1005* `auth_method`: Método de autenticação, como `"oauth"`

1003* `error_category`: Tipo de erro categórico quando a ação falhou. A mensagem de erro bruta nunca é incluída1006* `error_category`: Tipo de erro categórico quando a ação falhou. A mensagem de erro bruta nunca é incluída

1004* `status_code`: Código de status HTTP como string quando a ação falhou com um erro HTTP1007* `status_code`: Código de status HTTP como uma string quando a ação falhou com um erro HTTP

1005 1008

1006<h4 id="mcp-server-connection-event">1009<h4 id="mcp-server-connection-event">

1007 Evento de conexão do servidor MCP1010 Evento de conexão do servidor MCP

1008</h4>1011</h4>

1009 1012

1010Registrado quando um servidor MCP se conecta, desconecta ou falha ao conectar.1013Registrado quando um servidor MCP se conecta, desconecta, ou falha em conectar.

1011 1014

1012**Nome do Evento**: `claude_code.mcp_server_connection`1015**Nome do Evento**: `claude_code.mcp_server_connection`

1013 1016

1016* Todos os [atributos padrão](#standard-attributes)1019* Todos os [atributos padrão](#standard-attributes)

1017* `event.name`: `"mcp_server_connection"`1020* `event.name`: `"mcp_server_connection"`

1018* `event.timestamp`: Timestamp ISO 86011021* `event.timestamp`: Timestamp ISO 8601

1019* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1022* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1020* `status`: `"connected"`, `"failed"` ou `"disconnected"`1023* `status`: `"connected"`, `"failed"`, ou `"disconnected"`

1021* `transport_type`: Transporte do servidor, como `"stdio"`, `"sse"` ou `"http"`1024* `transport_type`: Transporte do servidor, como `"stdio"`, `"sse"`, ou `"http"`

1022* `server_scope`: Escopo em que o servidor está configurado, como `"user"`, `"project"` ou `"local"`1025* `server_scope`: Escopo no qual o servidor está configurado, como `"user"`, `"project"`, ou `"local"`

1023* `duration_ms`: Duração da tentativa de conexão em milissegundos1026* `duration_ms`: Duração da tentativa de conexão em milissegundos

1024* `error_code`: Código de erro quando a conexão falhou1027* `error_code`: Código de erro quando a conexão falhou

1025* `is_plugin`: `true` quando o servidor é fornecido por um plugin, `false` caso contrário1028* `is_plugin`: `true` quando o servidor é fornecido por um plugin, `false` caso contrário

1026* `plugin_id_hash` (quando `is_plugin` é `true`): Hash estável do nome do plugin e marketplace, para agrupar eventos por plugin sem expor o nome. Claude Code o computa conforme descrito sob o [evento de plugin carregado](#plugin-loaded-event)1029* `plugin_id_hash` (quando `is_plugin` é `true`): Hash estável do nome do plugin e marketplace, para agrupar eventos por plugin sem expor o nome. Claude Code o computa conforme descrito no [evento de plugin carregado](#plugin-loaded-event)

1027* `plugin.name` (quando `is_plugin` é `true`): Nome do plugin que fornece o servidor. Para plugins de terceiros isso é a string literal `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`; isso protege nomes de plugins de terceiros de aparecerem em logs por padrão. Plugins de fontes oficiais Anthropic são sempre identificados por nome. Os atributos `plugin_id_hash` e `plugin.name` fluem para seu próprio backend de monitoramento e não são enviados para Anthropic1030* `plugin.name` (quando `is_plugin` é `true`): Nome do plugin que fornece o servidor. Para plugins de terceiros isto é a string literal `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`; isto protege nomes de plugins de terceiros de aparecerem em logs por padrão. Plugins de fontes oficiais da Anthropic são sempre identificados por nome. Os atributos `plugin_id_hash` e `plugin.name` fluem para seu próprio backend de monitoramento e não são enviados para a Anthropic

1028* `server_name` (quando `OTEL_LOG_TOOL_DETAILS=1`): Nome do servidor configurado1031* `server_name` (quando `OTEL_LOG_TOOL_DETAILS=1`): Nome do servidor configurado

1029* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a conexão falhou1032* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a conexão falhou

1030 1033

1032 Evento de erro interno1035 Evento de erro interno

1033</h4>1036</h4>

1034 1037

1035Registrado quando Claude Code captura um erro interno inesperado. Apenas o nome da classe de erro e um código estilo errno são registrados. A mensagem de erro e rastreamento de pilha nunca são incluídos. Este evento não é emitido ao executar contra Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, ou quando `DISABLE_ERROR_REPORTING` está definido.1038Registrado quando Claude Code captura um erro interno inesperado. Apenas o nome da classe de erro e um código estilo errno são registrados. A mensagem de erro e stack trace nunca são incluídos. Este evento não é emitido ao executar contra Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, ou quando `DISABLE_ERROR_REPORTING` está definido.

1036 1039

1037**Nome do Evento**: `claude_code.internal_error`1040**Nome do Evento**: `claude_code.internal_error`

1038 1041

1041* Todos os [atributos padrão](#standard-attributes)1044* Todos os [atributos padrão](#standard-attributes)

1042* `event.name`: `"internal_error"`1045* `event.name`: `"internal_error"`

1043* `event.timestamp`: Timestamp ISO 86011046* `event.timestamp`: Timestamp ISO 8601

1044* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1047* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1045* `error_name`: Nome da classe de erro, como `"TypeError"` ou `"SyntaxError"`1048* `error_name`: Nome da classe de erro, como `"TypeError"` ou `"SyntaxError"`

1046* `error_code`: Código errno Node.js como `"ENOENT"` quando presente no erro1049* `error_code`: Código errno do Node.js como `"ENOENT"` quando presente no erro

1047 1050

1048<h4 id="plugin-installed-event">1051<h4 id="plugin-installed-event">

1049 Evento de plugin instalado1052 Evento de plugin instalado

1058* Todos os [atributos padrão](#standard-attributes)1061* Todos os [atributos padrão](#standard-attributes)

1059* `event.name`: `"plugin_installed"`1062* `event.name`: `"plugin_installed"`

1060* `event.timestamp`: Timestamp ISO 86011063* `event.timestamp`: Timestamp ISO 8601

1061* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1064* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1062* `marketplace.is_official`: `"true"` se o marketplace é um marketplace oficial Anthropic, `"false"` caso contrário1065* `marketplace.is_official`: `"true"` se o marketplace é um marketplace oficial da Anthropic, `"false"` caso contrário

1063* `install.trigger`: `"cli"` ou `"ui"`1066* `install.trigger`: `"cli"` ou `"ui"`

1064* `plugin.name`: Nome do plugin instalado. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1067* `plugin.name`: Nome do plugin instalado. Para marketplaces de terceiros isto é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1065* `plugin.version`: Versão do plugin quando declarada na entrada do marketplace. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1068* `plugin.version`: Versão do plugin quando declarada na entrada do marketplace. Para marketplaces de terceiros isto é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1066* `marketplace.name`: Marketplace do qual o plugin foi instalado. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1069* `marketplace.name`: Marketplace do qual o plugin foi instalado. Para marketplaces de terceiros isto é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1067 1070

1068<h4 id="plugin-loaded-event">1071<h4 id="plugin-loaded-event">

1069 Evento de plugin carregado1072 Evento de plugin carregado

1070</h4>1073</h4>

1071 1074

1072Registrado uma vez por plugin ativado no início da sessão. Use este evento para inventariar quais plugins estão ativos em toda a sua frota, como complemento ao `plugin_installed` que registra a ação de instalação em si.1075Registrado uma vez por plugin habilitado no início da sessão. Use este evento para inventariar quais plugins estão ativos em sua frota, como complemento a `plugin_installed` que registra a ação de instalação em si.

1073 1076

1074**Nome do Evento**: `claude_code.plugin_loaded`1077**Nome do Evento**: `claude_code.plugin_loaded`

1075 1078

1078* Todos os [atributos padrão](#standard-attributes)1081* Todos os [atributos padrão](#standard-attributes)

1079* `event.name`: `"plugin_loaded"`1082* `event.name`: `"plugin_loaded"`

1080* `event.timestamp`: Timestamp ISO 86011083* `event.timestamp`: Timestamp ISO 8601

1081* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1084* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1082* `plugin.name`: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1085* `plugin.name`: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1083* `marketplace.name`: marketplace do qual o plugin foi instalado, quando conhecido. Reduzido para `"third-party"` sob a mesma condição que `plugin.name`1086* `marketplace.name`: marketplace do qual o plugin foi instalado, quando conhecido. Redatado para `"third-party"` sob a mesma condição que `plugin.name`

1084* `plugin.version`: versão do manifesto do plugin. Incluído apenas quando o nome não é reduzido e o manifesto declara uma versão1087* `plugin.version`: versão do manifesto do plugin. Incluído apenas quando o nome não é redatado e o manifesto declara uma versão

1085* `plugin.scope`: categoria de proveniência para o plugin: `"official"`, `"community"`, `"org"`, `"user-local"` ou `"default-bundle"`1088* `plugin.scope`: categoria de proveniência para o plugin: `"official"`, `"community"`, `"org"`, `"user-local"`, ou `"default-bundle"`

1086* `enabled_via`: como o plugin veio a ser ativado: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` ou `"user-install"`. O valor `"admin-install"` significa que o plugin está definido como obrigatório ou auto-instalação para sua organização em [**Configurações da Organização > Plugins**](https://claude.ai/admin-settings/plugins). Antes da v2.1.246, Claude Code relatava esses plugins como `"user-install"` ou `"seed-mount"`1089* `enabled_via`: como o plugin veio a ser habilitado: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"`, ou `"user-install"`. O valor `"admin-install"` significa que o plugin está definido como obrigatório ou auto-instalação para sua organização em [**Configurações da Organização > Plugins**](https://claude.ai/admin-settings/plugins). Antes da v2.1.246, Claude Code relatava esses plugins como `"user-install"` ou `"seed-mount"`

1087* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar os plugins de terceiros distintos carregados em toda a sua frota sem registrar seus nomes. Para [plugins sincronizados de claude.ai](/docs/pt/plugins-reference#synced-plugins), Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com `synced` caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash1090* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar os plugins de terceiros distintos carregados em sua frota sem registrar seus nomes. Para [plugins sincronizados de claude.ai](/docs/pt/plugins-reference#synced-plugins), Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com `synced` caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash

1088* `has_hooks`: se o plugin contribui hooks1091* `has_hooks`: se o plugin contribui hooks

1089* `has_mcp`: se o plugin contribui servidores MCP1092* `has_mcp`: se o plugin contribui servidores MCP

1090* `host_owned_mcp`: `true` quando o host SDK gerencia as conexões MCP deste plugin e Claude Code pulou a leitura da configuração do servidor MCP do plugin, `false` caso contrário. Requer Claude Code v2.1.172 ou posterior1093* `host_owned_mcp`: `true` quando o host SDK gerencia as conexões MCP deste plugin e Claude Code pulou a leitura da configuração do servidor MCP do plugin, `false` caso contrário. Requer Claude Code v2.1.172 ou posterior

1094* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Em modo seguro este evento relata apenas inventário configurado; os comandos, skills, hooks e servidores MCP do plugin não carregam. Requer Claude Code v2.1.169 ou posterior1097* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Em modo seguro este evento relata apenas inventário configurado; os comandos, skills, hooks e servidores MCP do plugin não carregam. Requer Claude Code v2.1.169 ou posterior

1095 1098

1096<h4 id="skill-activated-event">1099<h4 id="skill-activated-event">

1097 Evento de skill ativado1100 Evento de skill ativada

1098</h4>1101</h4>

1099 1102

1100Registrado quando uma skill é invocada, seja Claude a chama através da ferramenta Skill ou você a executa como um comando `/`.1103Registrado quando uma skill é invocada, seja Claude a chama através da ferramenta Skill ou você a executa como um comando `/`.

1106* Todos os [atributos padrão](#standard-attributes)1109* Todos os [atributos padrão](#standard-attributes)

1107* `event.name`: `"skill_activated"`1110* `event.name`: `"skill_activated"`

1108* `event.timestamp`: Timestamp ISO 86011111* `event.timestamp`: Timestamp ISO 8601

1109* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1112* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1110* `skill.name`: Nome da skill. Para skills definidas pelo usuário e de plugin de terceiros o valor é o placeholder `"custom_skill"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1113* `skill.name`: Nome da skill. Para skills definidas pelo usuário e de plugins de terceiros o valor é o placeholder `"custom_skill"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1111* `invocation_trigger`: Como a skill foi acionada (`"user-slash"`, `"claude-proactive"` ou `"nested-skill"`)1114* `invocation_trigger`: Como a skill foi acionada (`"user-slash"`, `"claude-proactive"`, ou `"nested-skill"`)

1112* `skill.source`: De onde a skill foi carregada (por exemplo, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1115* `skill.source`: De onde a skill foi carregada (por exemplo, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1113* `skill.kind`: `"workflow"` quando a skill é uma skill de workflow. Ausente caso contrário1116* `skill.kind`: `"workflow"` quando a skill é uma skill de workflow. Ausente caso contrário

1114* `plugin.name` (quando `OTEL_LOG_TOOL_DETAILS=1` ou o plugin é de um marketplace oficial): Nome do plugin proprietário quando a skill é fornecida por um plugin1117* `plugin.name` (quando `OTEL_LOG_TOOL_DETAILS=1` ou o plugin é de um marketplace oficial): Nome do plugin proprietário quando a skill é fornecida por um plugin

1118 Evento de menção @1121 Evento de menção @

1119</h4>1122</h4>

1120 1123

1121Registrado quando Claude Code resolve uma menção `@` em um prompt. Nem toda menção emite um evento: caminhos de saída antecipada, como negações de permissão, arquivos superdimensionados, anexos de referência PDF e falhas de listagem de diretório retornam sem registrar.1124Registrado quando Claude Code resolve uma menção `@` em um prompt. Nem toda menção emite um evento: caminhos de saída antecipada como negações de permissão, arquivos superdimensionados, anexos de referência PDF e falhas de listagem de diretório retornam sem registrar.

1122 1125

1123**Nome do Evento**: `claude_code.at_mention`1126**Nome do Evento**: `claude_code.at_mention`

1124 1127

1127* Todos os [atributos padrão](#standard-attributes)1130* Todos os [atributos padrão](#standard-attributes)

1128* `event.name`: `"at_mention"`1131* `event.name`: `"at_mention"`

1129* `event.timestamp`: Timestamp ISO 86011132* `event.timestamp`: Timestamp ISO 8601

1130* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1133* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1131* `mention_type`: Tipo de menção (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). O valor `"peer"` significa que você mencionou [uma de suas outras sessões Claude Code](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.232 ou posterior1134* `mention_type`: Tipo de menção (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). O valor `"peer"` significa que você mencionou [uma de suas outras sessões Claude Code](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.232 ou posterior

1132* `success`: Se a menção foi resolvida com sucesso (`"true"` ou `"false"`)1135* `success`: Se a menção foi resolvida com sucesso (`"true"` ou `"false"`)

1133 1136

1134<h4 id="api-retries-exhausted-event">1137<h4 id="api-retries-exhausted-event">

1135 Evento de tentativas de API esgotadas1138 Evento de retentativas de API esgotadas

1136</h4>1139</h4>

1137 1140

1138Registrado uma vez quando uma solicitação de API falha após mais de uma tentativa. Emitido junto com o evento `api_error` final.1141Registrado uma vez quando uma requisição de API falha após mais de uma tentativa. Emitido junto com o evento `api_error` final.

1139 1142

1140**Nome do Evento**: `claude_code.api_retries_exhausted`1143**Nome do Evento**: `claude_code.api_retries_exhausted`

1141 1144

1144* Todos os [atributos padrão](#standard-attributes)1147* Todos os [atributos padrão](#standard-attributes)

1145* `event.name`: `"api_retries_exhausted"`1148* `event.name`: `"api_retries_exhausted"`

1146* `event.timestamp`: Timestamp ISO 86011149* `event.timestamp`: Timestamp ISO 8601

1147* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1150* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1148* `model`: Modelo usado1151* `model`: Modelo usado

1149* `error`: Mensagem de erro final1152* `error`: Mensagem de erro final

1150* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP.1153* `status_code`: Código de status HTTP como um número. Ausente para erros não-HTTP.

1151* `total_attempts`: Número total de tentativas feitas1154* `total_attempts`: Número total de tentativas feitas

1152* `total_retry_duration_ms`: Tempo total de parede em todas as tentativas1155* `total_retry_duration_ms`: Tempo total de wall-clock em todas as tentativas

1153* `speed`: `"fast"` ou `"normal"`1156* `speed`: `"fast"` ou `"normal"`

1154 1157

1155<h4 id="hook-registered-event">1158<h4 id="hook-registered-event">

1156 Evento de hook registrado1159 Evento de hook registrado

1157</h4>1160</h4>

1158 1161

1159Registrado uma vez por hook configurado no início da sessão. Use este evento para inventariar quais hooks estão ativos em toda a sua frota, como complemento aos eventos `hook_execution_start` e `hook_execution_complete` por execução.1162Registrado uma vez por hook configurado no início da sessão. Use este evento para inventariar quais hooks estão ativos em sua frota, como complemento aos eventos por execução `hook_execution_start` e `hook_execution_complete`.

1160 1163

1161**Nome do Evento**: `claude_code.hook_registered`1164**Nome do Evento**: `claude_code.hook_registered`

1162 1165

1165* Todos os [atributos padrão](#standard-attributes)1168* Todos os [atributos padrão](#standard-attributes)

1166* `event.name`: `"hook_registered"`1169* `event.name`: `"hook_registered"`

1167* `event.timestamp`: Timestamp ISO 86011170* `event.timestamp`: Timestamp ISO 8601

1168* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1171* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1169* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1172* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1170* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` ou `"agent"`1173* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, ou `"agent"`

1171* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` ou `"pluginHook"`1174* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, ou `"pluginHook"`

1172* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior1175* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior

1173* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): a string matcher da configuração do hook, quando uma está definida1176* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): a string de matcher da configuração do hook, quando uma está definida

1174* `plugin.name` (quando `hook_source` é `"pluginHook"`): nome do plugin contribuidor. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1177* `plugin.name` (quando `hook_source` é `"pluginHook"`): nome do plugin contribuidor. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1175* `plugin_id_hash` (quando `hook_source` é `"pluginHook"`): hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar plugins contribuidores distintos sem registrar seus nomes. Claude Code o computa conforme descrito sob o [evento de plugin carregado](#plugin-loaded-event)1178* `plugin_id_hash` (quando `hook_source` é `"pluginHook"`): hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar plugins contribuidores distintos sem registrar seus nomes. Claude Code o computa conforme descrito no [evento de plugin carregado](#plugin-loaded-event)

1176 1179

1177<h4 id="hook-execution-start-event">1180<h4 id="hook-execution-start-event">

1178 Evento de início de execução de hook1181 Evento de início de execução de hook

1187* Todos os [atributos padrão](#standard-attributes)1190* Todos os [atributos padrão](#standard-attributes)

1188* `event.name`: `"hook_execution_start"`1191* `event.name`: `"hook_execution_start"`

1189* `event.timestamp`: Timestamp ISO 86011192* `event.timestamp`: Timestamp ISO 8601

1190* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1193* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1191* `hook_event`: Tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1194* `hook_event`: Tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1192* `hook_name`: Nome completo do hook incluindo matcher, como `"PreToolUse:Write"`1195* `hook_name`: Nome completo do hook incluindo matcher, como `"PreToolUse:Write"`

1193* `num_hooks`: Número de comandos de hook correspondentes1196* `num_hooks`: Número de comandos de hook correspondentes

1194* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos1197* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos

1195* `hook_source`: `"policySettings"` ou `"merged"`1198* `hook_source`: `"policySettings"` ou `"merged"`

1196* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior1199* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior

1197* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos ativados1200* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos habilitados

1198 1201

1199<h4 id="hook-execution-complete-event">1202<h4 id="hook-execution-complete-event">

1200 Evento de conclusão de execução de hook1203 Evento de conclusão de execução de hook

1209* Todos os [atributos padrão](#standard-attributes)1212* Todos os [atributos padrão](#standard-attributes)

1210* `event.name`: `"hook_execution_complete"`1213* `event.name`: `"hook_execution_complete"`

1211* `event.timestamp`: Timestamp ISO 86011214* `event.timestamp`: Timestamp ISO 8601

1212* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1215* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1213* `hook_event`: Tipo de evento de hook1216* `hook_event`: Tipo de evento de hook

1214* `hook_name`: Nome completo do hook incluindo matcher1217* `hook_name`: Nome completo do hook incluindo matcher

1215* `num_hooks`: Número de comandos de hook correspondentes1218* `num_hooks`: Número de comandos de hook correspondentes

1217* `num_blocking`: Contagem que retornou uma decisão de bloqueio1220* `num_blocking`: Contagem que retornou uma decisão de bloqueio

1218* `num_non_blocking_error`: Contagem que falhou sem bloquear1221* `num_non_blocking_error`: Contagem que falhou sem bloquear

1219* `num_cancelled`: Contagem cancelada antes da conclusão1222* `num_cancelled`: Contagem cancelada antes da conclusão

1220* `total_duration_ms`: Duração de parede de todos os hooks correspondentes1223* `total_duration_ms`: Duração de wall-clock de todos os hooks correspondentes

1221* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos1224* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos

1222* `hook_source`: `"policySettings"` ou `"merged"`1225* `hook_source`: `"policySettings"` ou `"merged"`

1223* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior1226* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior

1224* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos ativados1227* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos habilitados

1225 1228

1226<h4 id="hook-plugin-metrics-event">1229<h4 id="hook-plugin-metrics-event">

1227 Evento de métricas de plugin de hook1230 Evento de métricas de plugin de hook

1228</h4>1231</h4>

1229 1232

1230Registrado quando um hook de plugin do marketplace oficial emite métricas por invocação. Apenas plugins instalados de um marketplace oficial Anthropic podem emitir esses dados. Plugins de marketplace de terceiros e hooks configurados pelo usuário não emitem para este evento. Use este evento para monitorar o comportamento do plugin, como taxas de descoberta, custos e durações de sua própria pilha de observabilidade.1233Registrado quando um hook de plugin do marketplace oficial emite métricas por invocação. Apenas plugins instalados de um marketplace oficial da Anthropic podem emitir estes. Plugins de marketplace de terceiros e hooks configurados pelo usuário não emitem para este evento. Use este evento para monitorar comportamento de plugin como taxas de descoberta, custos e durações de sua própria pilha de observabilidade.

1231 1234

1232**Nome do Evento**: `claude_code.hook_plugin_metrics`1235**Nome do Evento**: `claude_code.hook_plugin_metrics`

1233 1236

1236* Todos os [atributos padrão](#standard-attributes)1239* Todos os [atributos padrão](#standard-attributes)

1237* `event.name`: `"hook_plugin_metrics"`1240* `event.name`: `"hook_plugin_metrics"`

1238* `event.timestamp`: Timestamp ISO 86011241* `event.timestamp`: Timestamp ISO 8601

1239* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1242* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1240* `plugin_id`: identificador do plugin em forma `<name>@<marketplace>`1243* `plugin_id`: identificador do plugin em forma `<name>@<marketplace>`

1241* `hook_event`: tipo de evento de hook que emitiu as métricas1244* `hook_event`: tipo de evento de hook que emitiu as métricas

1242* Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a `^[a-z][a-z0-9_]{0,39}$`. Os valores são booleanos ou números.1245* Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a `^[a-z][a-z0-9_]{0,39}$`. Os valores são booleano ou número.

1243 1246

1244<h4 id="compaction-event">1247<h4 id="compaction-event">

1245 Evento de compactação1248 Evento de compactação

1254* Todos os [atributos padrão](#standard-attributes)1257* Todos os [atributos padrão](#standard-attributes)

1255* `event.name`: `"compaction"`1258* `event.name`: `"compaction"`

1256* `event.timestamp`: Timestamp ISO 86011259* `event.timestamp`: Timestamp ISO 8601

1257* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1260* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1258* `trigger`: `"auto"` ou `"manual"`1261* `trigger`: `"auto"` ou `"manual"`

1259* `success`: `"true"` ou `"false"`1262* `success`: `"true"` ou `"false"`

1260* `duration_ms`: Duração da compactação1263* `duration_ms`: Duração da compactação

1261* `pre_tokens`: Contagem aproximada de tokens antes da compactação1264* `pre_tokens`: Contagem aproximada de tokens antes da compactação

1262* `post_tokens`: Contagem aproximada de tokens após compactação1265* `post_tokens`: Contagem aproximada de tokens após compactação

1263* `error`: Mensagem de erro quando a compactação falhou1266* `error`: Mensagem de erro quando a compactação falhou

1264* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em segundo plano antes da janela de contexto se encher, e este atributo registra se `/compact` reutilizou esse resumo preparado. `"hit"` significa que foi reutilizado; `"miss_custom_instructions"`, `"miss_hook"` e `"miss_not_ready"` dão a razão pela qual um resumo fresco foi computado em vez disso. Requer Claude Code v2.1.153 ou posterior1267* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em background antes da janela de contexto ficar cheia, e este atributo registra se `/compact` reutilizou esse resumo preparado. `"hit"` significa que foi reutilizado; `"miss_custom_instructions"`, `"miss_hook"`, e `"miss_not_ready"` dão a razão pela qual um resumo fresco foi computado em vez disso. Requer Claude Code v2.1.153 ou posterior

1265 1268

1266<h4 id="subagent-completed-event">1269<h4 id="subagent-completed-event">

1267 Evento de subagente concluído1270 Evento de conclusão de subagente

1268</h4>1271</h4>

1269 1272

1270Registrado quando um [subagente](/docs/pt/sub-agents) termina e retorna seu resultado para a conversa que o iniciou. Use-o para agregar uso de ferramenta e tempo de execução por tipo de subagente; para agregações de token ou custo, use o [contador de token](#token-counter) e [contador de custo](#cost-counter) filtrados para `query_source` `"subagent"`, já que o `total_tokens` deste evento cobre apenas a solicitação final. A categoria `"subagent"` também conta solicitações de hooks baseados em agentes, que não emitem nenhum evento de subagente.1273Registrado quando um [subagente](/docs/pt/sub-agents) termina e retorna seu resultado para a conversa que o iniciou. Use-o para agregar uso de ferramenta e tempo de execução por tipo de subagente; para agregações de token ou custo, use o [contador de tokens](#token-counter) e [contador de custo](#cost-counter) filtrados para `query_source` `"subagent"`, já que o `total_tokens` deste evento cobre apenas a requisição final. A categoria `"subagent"` também conta requisições de hooks baseados em agente, que não emitem evento de subagente.

1271 1274

1272**Nome do Evento**: `claude_code.subagent_completed`1275**Nome do Evento**: `claude_code.subagent_completed`

1273 1276

1276* Todos os [atributos padrão](#standard-attributes)1279* Todos os [atributos padrão](#standard-attributes)

1277* `event.name`: `"subagent_completed"`1280* `event.name`: `"subagent_completed"`

1278* `event.timestamp`: Timestamp ISO 86011281* `event.timestamp`: Timestamp ISO 8601

1279* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1282* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1280* `agent_type`: O tipo de subagente. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim; outros nomes de agente são substituídos por `"custom"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido1283* `agent_type`: O tipo de subagente. Nomes de agentes integrados e agentes de plugins do marketplace oficial aparecem literalmente; outros nomes de agente são substituídos por `"custom"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

1281* `agent.source`: De onde a definição do agente veio: `built-in`, `plugin` ou a fonte de configurações que definiu um agente customizado, como `userSettings` ou `projectSettings`1284* `agent.source`: De onde a definição do agente veio: `built-in`, `plugin`, ou a fonte de configurações que definiu um agente personalizado, como `userSettings` ou `projectSettings`

1282* `is_built_in`: Se o subagente é um tipo de agente integrado1285* `is_built_in`: Se o subagente é um tipo de agente integrado

1283* `is_async`: Se o subagente foi executado em [segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background)1286* `is_async`: Se o subagente executou em [background](/docs/pt/sub-agents#run-subagents-in-foreground-or-background)

1284* `total_tokens`: A pegada de token da solicitação final de API do subagente: tokens de entrada, criação de cache, leitura de cache e saída dessa solicitação, aproximadamente o tamanho do contexto do subagente na conclusão. Não é uma soma em toda a execução1287* `total_tokens`: A pegada de token da requisição final de API do subagente: tokens de entrada, criação de cache, leitura de cache e saída dessa única requisição, aproximadamente o tamanho do contexto do subagente na conclusão. Não uma soma em toda a execução

1285* `total_tool_uses`: Número de chamadas de ferramenta que o subagente fez em toda a execução1288* `total_tool_uses`: Número de chamadas de ferramenta que o subagente fez em toda a execução

1286* `duration_ms`: Tempo de execução em milissegundos1289* `duration_ms`: Tempo de execução em milissegundos

1287* `model`: O modelo que o subagente foi resolvido para executar1290* `model`: O modelo que o subagente foi resolvido para executar

1288* `final_model`: O modelo que produziu a resposta final do subagente, que difere de `model` após uma mudança no meio da execução, como um fallback. Requer Claude Code v2.1.212 ou posterior1291* `final_model`: O modelo que produziu a resposta final do subagente, que difere de `model` após uma mudança no meio da execução como um fallback. Requer Claude Code v2.1.212 ou posterior

1289* `model_swapped`: Se mais de um modelo serviu as solicitações do subagente. Requer Claude Code v2.1.212 ou posterior1292* `model_swapped`: Se mais de um modelo serviu as requisições do subagente. Requer Claude Code v2.1.212 ou posterior

1290* `plugin_id_hash`, `plugin.name`: Presente para agentes fornecidos por plugin. Nomes de plugin do marketplace oficial aparecem verbatim; outros nomes de plugin são substituídos por `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido1293* `plugin_id_hash`, `plugin.name`: Presente para agentes fornecidos por plugin. Nomes de plugins do marketplace oficial aparecem literalmente; outros nomes de plugin são substituídos por `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

1291 1294

1292<h4 id="feedback-survey-event">1295<h4 id="feedback-survey-event">

1293 Evento de pesquisa de feedback1296 Evento de pesquisa de feedback

1302* Todos os [atributos padrão](#standard-attributes)1305* Todos os [atributos padrão](#standard-attributes)

1303* `event.name`: `"feedback_survey"`1306* `event.name`: `"feedback_survey"`

1304* `event.timestamp`: Timestamp ISO 86011307* `event.timestamp`: Timestamp ISO 8601

1305* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1308* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1306* `event_type`: Evento do ciclo de vida da pesquisa, por exemplo `"appeared"`, `"responded"` ou `"transcript_prompt_appeared"`1309* `event_type`: Evento do ciclo de vida da pesquisa, por exemplo `"appeared"`, `"responded"`, ou `"transcript_prompt_appeared"`

1307* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa1310* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa

1308* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"1311* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"

1309* `response`: A seleção do usuário em eventos `responded`1312* `response`: A seleção do usuário em eventos `responded`

1310* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/pt/env-vars) está definido. Emitido como um booleano, não uma string. Presente em eventos de pesquisa `session`. Filtre neste atributo para confirmar que a substituição é aplicada em toda a frota1313* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/pt/env-vars) está definido. Emitido como um booleano, não uma string. Presente em eventos de pesquisa `session`. Filtre neste atributo para confirmar que a substituição é aplicada em uma frota

1311 1314

1312<h4 id="retention-sweep-event">1315<h4 id="retention-sweep-event">

1313 Evento de varredura de retenção1316 Evento de varredura de retenção

1314</h4>1317</h4>

1315 1318

1316Registrado uma vez por execução da varredura de limpeza de retenção, que deleta [transcrições de sessão e outros dados de aplicação](/docs/pt/claude-directory#cleaned-up-automatically) mais antigos que a configuração [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays). Claude Code executa a varredura em segundo plano no máximo uma vez por sessão, e uma execução que não deleta nada ainda emite o evento. Se Claude Code executou a varredura em qualquer sessão na mesma máquina nas últimas 24 horas, ele atrasa a varredura desta sessão por pelo menos 10 minutos, então uma sessão que sai mais cedo não emite nada. Quando você executa `claude -p` com `--bare`, Claude Code não executa a varredura e não emite nada.1319Registrado uma vez por execução da varredura de limpeza de retenção, que deleta [transcrições de sessão e outros dados de aplicação](/docs/pt/claude-directory#cleaned-up-automatically) mais antigos que a configuração [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays). Claude Code executa a varredura em background no máximo uma vez por sessão, e uma execução que não deleta nada ainda emite o evento. Se Claude Code executou a varredura em qualquer sessão na mesma máquina nos últimos 24 horas, ele atrasa a varredura desta sessão por pelo menos 10 minutos, então uma sessão que sai mais cedo não emite nada. Quando você executa `claude -p` com `--bare`, Claude Code não executa a varredura e não emite nada.

1317 1320

1318Como todo evento OTel nesta página, ele vai apenas para o backend de telemetria que você configura. Requer Claude Code v2.1.227 ou posterior.1321Como todo evento OTel nesta página, ele vai apenas para o backend de telemetria que você configura. Requer Claude Code v2.1.227 ou posterior.

1319 1322

1320Quando Claude Code não consegue determinar com segurança o período de retenção, ele pausa a varredura e emite o evento com `result` definido como `"skipped"` e um `skip_reason`. Quando [configurações gerenciadas](/docs/pt/server-managed-settings) definem `cleanupPeriodDays`, o valor gerenciado fixa o período de retenção e a varredura é executada mesmo quando um arquivo de configurações em um escopo de prioridade mais baixa está quebrado ou inválido. Quando `managed-settings.json` em si não consegue ser lido, Claude Code ainda pausa a varredura a menos que o [nível gerenciado](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) forneça `cleanupPeriodDays` de outro lugar, como configurações gerenciadas pelo servidor ou um drop-in `managed-settings.d/` ao lado do arquivo quebrado. Os atributos do contador de exclusão estão presentes apenas quando `result` é `"complete"`.1323Quando Claude Code não pode determinar com segurança o período de retenção, ele pausa a varredura e emite o evento com `result` definido para `"skipped"` e um `skip_reason`. Quando [configurações gerenciadas](/docs/pt/server-managed-settings) definem `cleanupPeriodDays`, o valor gerenciado fixa o período de retenção e a varredura é executada mesmo quando um arquivo de configurações em um escopo de prioridade mais baixa está quebrado ou inválido. Quando `managed-settings.json` em si não pode ser lido, Claude Code ainda pausa a varredura a menos que o [nível gerenciado](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) forneça `cleanupPeriodDays` de outro lugar, como configurações gerenciadas pelo servidor ou um drop-in `managed-settings.d/` ao lado do arquivo quebrado. Os atributos do contador de exclusão estão presentes apenas quando `result` é `"complete"`.

1321 1324

1322**Nome do Evento**: `claude_code.retention_sweep`1325**Nome do Evento**: `claude_code.retention_sweep`

1323 1326

1326* Todos os [atributos padrão](#standard-attributes)1329* Todos os [atributos padrão](#standard-attributes)

1327* `event.name`: `"retention_sweep"`1330* `event.name`: `"retention_sweep"`

1328* `event.timestamp`: Timestamp ISO 86011331* `event.timestamp`: Timestamp ISO 8601

1329* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)1332* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1330* `result`: `"complete"` quando a varredura foi executada, `"skipped"` quando Claude Code a pausou1333* `result`: `"complete"` quando a varredura foi executada, `"skipped"` quando Claude Code a pausou

1331* `period_days`: O valor `cleanupPeriodDays` das configurações mescladas, em dias, ou `30` quando nenhuma fonte o define. Em eventos ignorados, o valor que a varredura teria usado, computado a partir das fontes de configurações que Claude Code conseguiu ler1334* `period_days`: O valor `cleanupPeriodDays` das configurações mescladas, em dias, ou `30` quando nenhuma fonte o define. Em eventos pulados, o valor que a varredura teria usado, computado das fontes de configurações que Claude Code pôde ler

1332* `used_default`: `"true"` quando nenhuma fonte de configurações legível define `cleanupPeriodDays`, `"false"` caso contrário. Em eventos completos, `"true"` significa que o padrão de 30 dias foi aplicado1335* `used_default`: `"true"` quando nenhuma fonte de configurações legível define `cleanupPeriodDays`, `"false"` caso contrário. Em eventos completos, `"true"` significa que o padrão de 30 dias foi aplicado

1333* `skip_reason`: Por que Claude Code pausou a varredura. Presente apenas quando `result` é `"skipped"`:1336* `skip_reason`: Por que Claude Code pausou a varredura. Presente apenas quando `result` é `"skipped"`:

1334 * `"user_source_disabled"`: Configurações de usuário são excluídas, por exemplo pela flag [`--setting-sources`](/docs/pt/cli-reference#cli-flags) ou a opção [`settingSources`](/docs/pt/agent-sdk/typescript#options) do SDK, e nenhuma fonte ativada fornece `cleanupPeriodDays`1337 * `"user_source_disabled"`: Configurações do usuário são excluídas, por exemplo pela flag [`--setting-sources`](/docs/pt/cli-reference#cli-flags) ou opção [`settingSources`](/docs/pt/agent-sdk/typescript#options) do SDK, e nenhuma fonte habilitada fornece `cleanupPeriodDays`

1335 * `"settings_unknowable"`: Um arquivo de configurações não conseguiu ser lido ou analisado, então `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` pode estar definido para um valor que Claude Code não consegue ver1338 * `"settings_unknowable"`: Um arquivo de configurações não pôde ser lido ou analisado, então `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` pode estar definido para um valor que Claude Code não pode ver

1336 * `"settings_invalid_key_set"`: Configurações têm erros de validação e `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` está explicitamente definido, então fazer fallback para o padrão poderia deletar ou manter arquivos contra essa configuração1339 * `"settings_invalid_key_set"`: Configurações têm erros de validação e `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` está explicitamente definido, então fazer fallback para o padrão poderia deletar ou manter arquivos contra essa configuração

1337* `transcripts_deleted`: Número de transcrições de sessão, os arquivos de nível superior `~/.claude/projects/*/*.jsonl`, que a varredura deletou1340* `transcripts_deleted`: Número de transcrições de sessão, os arquivos `~/.claude/projects/*/*.jsonl` de nível superior, que a varredura deletou

1338* `transcripts_exempted_desktop`: Número de transcrições passadas do período de retenção que a varredura manteve sob a [regra Claude Desktop e Cowork](/docs/pt/claude-directory#cleaned-up-automatically). Estes não contam para `files_past_cutoff`. Requer Claude Code v2.1.248 ou posterior1341* `transcripts_exempted_desktop`: Número de transcrições passadas do período de retenção que a varredura manteve sob a [regra de Claude Desktop e Cowork](/docs/pt/claude-directory#cleaned-up-automatically). Estes não contam para `files_past_cutoff`. Requer Claude Code v2.1.248 ou posterior

1339* `session_files_deleted`: Número de artefatos que a varredura de arquivos de sessão deletou: transcrições mais arquivos complementares por sessão, como sidecars, gravações e resultados de ferramentas1342* `session_files_deleted`: Número de artefatos que a varredura de arquivos de sessão deletou: transcrições mais arquivos complementares por sessão como sidecars, gravações e resultados de ferramentas

1340* `artifacts_deleted`: Total de itens que a varredura deletou em todos os diretórios de dados que cobre, incluindo os arquivos de sessão. Algumas varreduras contam uma árvore de diretório removida inteira como um item e algumas passagens de limpeza não contribuem para o contador, então trate o valor como um piso em vez de uma contagem exata de arquivos1343* `artifacts_deleted`: Total de itens que a varredura deletou em todos os diretórios de dados que cobre, incluindo os arquivos de sessão. Algumas varreduras contam uma árvore de diretório removida inteira como um item e algumas passagens de limpeza não contribuem para o contador, então trate o valor como um piso em vez de uma contagem exata de arquivos

1341* `files_retained_fresh`: Arquivos inspecionados e deixados no lugar porque ainda estão dentro do período de retenção. Apenas varreduras por arquivo contam estes, então o valor é um piso; um valor diferente de zero é o estado estável normal1344* `files_retained_fresh`: Arquivos inspecionados e deixados em lugar porque ainda estão dentro do período de retenção. Apenas varreduras por arquivo contam estes, então o valor é um piso; um valor diferente de zero é o estado estável normal

1342* `files_past_cutoff`: Arquivos mais antigos que o período de retenção que a varredura falhou em deletar, por exemplo por causa de um erro de permissão ou um arquivo mantido aberto. Um valor acima de zero significa que arquivos sobreviveram ao período de retenção configurado; zero não é prova de que nenhum fez, porque uma remoção falhada de um diretório inteiro conta para `error_count` em vez disso1345* `files_past_cutoff`: Arquivos mais antigos que o período de retenção que a varredura falhou em deletar, por exemplo por causa de um erro de permissão ou um arquivo mantido aberto. Um valor acima de zero significa que arquivos sobreviveram ao período de retenção configurado; zero não é prova de que nenhum fez, porque uma remoção falhada de um diretório inteiro conta para `error_count` em vez disso

1343* `error_count`: Número de erros que a varredura encontrou ao listar ou deletar arquivos1346* `error_count`: Número de erros que a varredura encontrou ao listar ou deletar arquivos

1344 1347

1348<h4 id="managed-settings-resolved-event">

1349 Evento de configurações gerenciadas resolvidas

1350</h4>

1351

1352Registrado com as [configurações gerenciadas](/docs/pt/managed-settings) que uma sessão resolveu: uma vez no início da sessão, novamente quando as configurações gerenciadas ou o [auxiliar de política](/docs/pt/managed-settings#compute-the-policy-with-a-helper-program) mudam de estado durante a sessão, e quando Claude Code recusa iniciar ou termina a sessão por uma das razões que o atributo `error.type` lista.

1353Use este evento para encontrar máquinas executando em uma fonte gerenciada inesperada, máquinas cujo auxiliar de política está falhando, e a razão pela qual uma máquina recusou iniciar.

1354Requer Claude Code v2.1.274 ou posterior.

1355

1356Por padrão, o evento carrega as fontes gerenciadas e o estado do auxiliar de política mas não as configurações em si. Para adicionar o atributo `managed_settings.settings` redatado e o digest `managed_settings.resolved_sha256`, defina `OTEL_LOG_MANAGED_SETTINGS=1`:

1357

1358* Defina-o no bloco `env` de configurações gerenciadas, configurações do usuário, ou `--settings`, ou no ambiente com o qual você inicia Claude Code. Um valor em configurações de projeto ou local não o ativa, porque um repositório clonado pode escrevê-los.

1359* Configurações gerenciadas pelo servidor podem defini-lo sem mostrar o [diálogo de aprovação de segurança](/docs/pt/server-managed-settings#security-approval-dialogs), porque a variável apenas adiciona sua própria política redatada da organização a um evento que sua organização já recebe.

1360

1361Em uma sessão interativa em uma pasta que você não [confiou](/docs/pt/permissions#what-runs-before-you-trust-a-folder), Claude Code não exporta o evento de recusa, porque configurações de projeto e local poderiam apontar a exportação para um coletor diferente antes da confiança.

1362

1363**Nome do Evento**: `claude_code.managed_settings_resolved`

1364

1365**Atributos**:

1366

1367* Todos os [atributos padrão](#standard-attributes)

1368* `event.name`: `"managed_settings_resolved"`

1369* `event.timestamp`: Timestamp ISO 8601

1370* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

1371* `managed_settings.trigger`: `"startup"` para o evento de início de sessão, `"change"` quando as configurações gerenciadas ou o estado do auxiliar de política mudaram mais tarde na sessão, ou `"refused"` quando uma política de configurações gerenciadas parou a sessão. Claude Code envia um evento `change` apenas quando um atributo difere do último evento que enviou, e um valor de configuração alterado conta mesmo quando `OTEL_LOG_MANAGED_SETTINGS` está desativado

1372* `error.type`: por que Claude Code parou a sessão. Presente apenas em eventos `refused`:

1373 * `"helper_failed"`: uma [execução do auxiliar de política falhou](/docs/pt/settings-reference#helper-failures)

1374 * `"policy_invalid"`: as configurações gerenciadas contêm um erro que impede Claude Code de iniciar, ou uma fonte de administrador falhou em carregar, então Claude Code não pode verificar a imposição de login da organização

1375 * `"consent_rejected"`: o usuário rejeitou o [diálogo de aprovação de segurança](/docs/pt/server-managed-settings#security-approval-dialogs) para configurações gerenciadas pelo servidor

1376 * `"force_refresh_failed"`: a busca de configurações que [`forceRemoteSettingsRefresh`](/docs/pt/settings-reference#forceremotesettingsrefresh) requer falhou

1377 * `"gateway_rejected"`: um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) respondeu ao carregamento de configurações gerenciadas com HTTP 403

1378 * `"version_below_minimum"`: esta versão de Claude Code está abaixo de [`requiredMinimumVersion`](/docs/pt/settings-reference#requiredminimumversion) ou acima de [`requiredMaximumVersion`](/docs/pt/settings-reference#requiredmaximumversion)

1379 * `"_OTHER"`: o carregamento de configurações gerenciadas do gateway de aplicativos Claude falhou por outro motivo

1380* `managed_settings.sources`: cada fonte gerenciada que entrega pelo menos uma [chave de política](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), prioridade mais alta primeiro, incluindo fontes cujas chaves não entram em efeito sob `first-wins`. Os valores são `"remote"`, `"plist"` ou `"hklm"` para a política MDM ou nível de SO, `"file"` para arquivos de configurações gerenciadas e drop-ins, `"parent"` quando um [host de incorporação](/docs/pt/managed-settings#let-an-embedding-host-add-policy) fornece configurações, e `"hkcu"` para o [valor de registro HKCU do Windows](/docs/pt/managed-settings#where-each-mechanism-stores-the-policy) quando Claude Code o [lê](/docs/pt/managed-settings#how-claude-code-combines-managed-sources). Uma fonte que carrega apenas chaves de controle, ou que Claude Code não pôde ler, não está listada. Emitido como um array de strings, vazio quando nenhuma fonte gerenciada entrega uma chave de política

1381* `managed_settings.source_behavior`: o valor [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) que Claude Code leu, `"first-wins"` ou `"merge"`. `"first-wins"` quando nenhuma fonte define a chave

1382* `managed_settings.helper.state`: estado do auxiliar de política que a fonte MDM ou arquivo selecionada configura:

1383 * `"ok"`: a saída do auxiliar serve como as configurações gerenciadas

1384 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"`, ou `"schema_rejected"`: a última execução do auxiliar falhou. [Falhas do auxiliar](/docs/pt/settings-reference#helper-failures) descreve os casos

1385 * `"none"`: nenhum auxiliar está configurado, ou a fonte que o configura não é uma política MDM ou arquivo de configurações gerenciadas

1386* `managed_settings.helper.applied`: `"output"` enquanto a saída do próprio auxiliar serve como as configurações gerenciadas, `"none"` quando não serve

1387* `managed_settings.helper.entry`: `"policyHelper"` quando Claude Code selecionou um [`policyHelper`](/docs/pt/settings-reference#policyhelper). Ausente quando selecionou nenhum auxiliar

1388* `managed_settings.helper.path`: o [`path`](/docs/pt/settings-reference#policyhelper-path) configurado do auxiliar. Presente sempre que Claude Code selecionou um auxiliar, independentemente de `OTEL_LOG_MANAGED_SETTINGS` estar definido

1389* `managed_settings.resolved_sha256` (quando `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 das configurações gerenciadas resolvidas antes da redação, serializadas como JSON com chaves ordenadas recursivamente e sem espaço em branco. Máquinas com o mesmo digest executam a mesma política. Claude Code envia o digest apenas com o opt-in porque uma política curta pode ser recuperada fazendo hash de suposições. Ausente quando nenhuma configuração gerenciada foi resolvida, e em eventos `refused`

1390* `managed_settings.settings` (quando `OTEL_LOG_MANAGED_SETTINGS=1`): os nomes e forma das configurações gerenciadas resolvidas como uma string JSON, com os valores redatados. Ausente em eventos `refused`. Claude Code o constrói a partir de seu esquema de configurações:

1391

1392 * Um nome de configuração que o esquema declara é exportado, e uma chave que não declara é deixada de fora

1393 * Booleanos, números e valores de string que o esquema restringe a um conjunto fixo de opções, como `permissions.defaultMode`, são exportados como estão. `sandbox.network.httpProxyPort` e `sandbox.network.socksProxyPort` são exportados como `"[REDACTED]"`

1394 * Toda outra string, como `model`, `apiKeyHelper`, todo valor `env`, toda URL e todo comando, é exportado como `"[REDACTED]"`

1395 * Os nomes de entrada de mapas, como nomes de variáveis `env` e IDs de plugin, são exportados como estão. Uma configuração cujas entradas o esquema não digita, como `vimInsertModeRemaps`, é exportada como um único `"[REDACTED]"`, e `sandbox.ignoreViolations` é exportado como uma lista de suas listas de caminho sem os padrões de comando

1396 * Uma lista mantém seu comprimento, com cada entrada redatada pelas mesmas regras

1397 * Uma regra `permissions.allow`, `permissions.deny`, ou `permissions.ask` é exportada como seu nome de ferramenta com o conteúdo redatado, como `Read([REDACTED])`, quando a ferramenta é integrada nesta versão de Claude Code ou é uma referência `mcp__` como `mcp__jira__create_issue`. Qualquer outra regra é exportada como `"[REDACTED]"`

1398 * Hooks seguem as mesmas regras, então campos de opção fixa e numéricos como `type` e `timeout` mostram, enquanto cada comando, URL, `matcher`, e condição `if` é exportada como `"[REDACTED]"`

1399

1400 Por exemplo, configurações gerenciadas com `apiKeyHelper`, duas variáveis `env`, e uma regra de negação são exportadas como `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1401

1402 Claude Code corta o valor em 8 KB de UTF-8, e o valor cortado não é JSON válido

1403* `managed_settings.settings_truncated` (quando `managed_settings.settings` está presente): `true` quando Claude Code cortou `managed_settings.settings` em 8 KB, `false` caso contrário. Emitido como um booleano, não uma string

1404

1345<h2 id="interpret-metrics-and-events-data">1405<h2 id="interpret-metrics-and-events-data">

1346 Interpretar dados de métricas e eventos1406 Interpretar dados de métricas e eventos

1347</h2>1407</h2>

1461Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:1521Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:

1462 1522

1464| ---------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------ |1524| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1471| Comandos executados e arquivos tocados | `tool_result` (executado) ou `tool_decision` (rejeitado) com `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (apenas `tool_result`) |1531| Comandos executados e arquivos tocados | `tool_result` (executado) ou `tool_decision` (rejeitado) com `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (apenas `tool_result`) |

1532| Quais fontes de configurações gerenciadas uma máquina executa, se seu auxiliar de política está saudável e por que uma máquina recusou iniciar | `managed_settings_resolved` | `managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type`; `managed_settings.settings` e `managed_settings.resolved_sha256` com `OTEL_LOG_MANAGED_SETTINGS=1` |

1472 1533

1473Claude Code emite apenas o fluxo de eventos bruto. Detecção de anomalias, linha de base, correlação entre sessões e alertas são responsabilidade do seu SIEM ou backend de observabilidade.1534Claude Code emite apenas o fluxo de eventos bruto. Detecção de anomalias, linha de base, correlação entre sessões e alertas são responsabilidade do seu SIEM ou backend de observabilidade.

1474 1535

monitoring-usage.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

Monitoramento

Início rápido

Configuração do administrador

Como as configurações gerenciadas bloqueiam o destino OTLP

Detalhes de configuração

Variáveis de configuração comuns

Autenticação mTLS

Controle de cardinalidade de métricas

Rastreamentos (beta)

Hierarquia de span

Atributos de span

Cabeçalhos dinâmicos

Configuração de configurações

Requisitos do script

Comportamento de atualização

Suporte a organizações multi-equipe

Configurações de exemplo

Métricas e eventos disponíveis

Atributos padrão

Atributos de repositório

Métricas

Detalhes das métricas

Contador de sessão

Contador de linhas de código

Contador de pull request

Contador de commit

Contador de custo

Contador de tokens

Contador de decisão da ferramenta de edição de código

Contador de tempo ativo

Eventos

Atributos de correlação de eventos

Evento de prompt do usuário

Evento de resposta do assistente

Evento de resultado de ferramenta

Evento de requisição de API

Evento de erro de API

Evento de recusa de API

Evento de corpo de requisição de API

Evento de corpo de resposta de API

Evento de decisão de ferramenta

Evento de mudança de modo de permissão

Evento de autenticação

Evento de conexão do servidor MCP

Evento de erro interno

Evento de plugin instalado

Evento de plugin carregado

Evento de skill ativada

Evento de menção @

Evento de retentativas de API esgotadas

Evento de hook registrado

Evento de início de execução de hook

Evento de conclusão de execução de hook

Evento de métricas de plugin de hook

Evento de compactação

Evento de conclusão de subagente

Evento de pesquisa de feedback

Evento de varredura de retenção

Evento de configurações gerenciadas resolvidas

Interpretar dados de métricas e eventos

Monitoramento de uso

Monitoramento de custo

Alertas e segmentação

Detectar esgotamento de tentativas

Análise de eventos

Auditar eventos de segurança

Atribuir ações a usuários

Auditoria de atividade MCP

Mapear questões de segurança para eventos

Enviar eventos para um SIEM

Considerações de backend

Para métricas

Para eventos/logs

Para rastreamentos

Informações de serviço

Recursos de medição de ROI

Segurança e privacidade

Monitorar Claude Code no Amazon Bedrock