Monitoreo

Inicio rápido

# 1. Habilitar telemetría
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. Elegir exportadores (ambos son opcionales - configura solo lo que necesites)
export OTEL_METRICS_EXPORTER=otlp       # Opciones: otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp          # Opciones: otlp, console, none

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

# 4. Establecer autenticación (si es requerida)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. Para depuración: reducir intervalos de exportación, y restablecerlos para uso en producción
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10 segundos (predeterminado: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5 segundos (predeterminado: 5000ms)

# 6. Ejecutar Claude Code
claude

Configuración del administrador

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

Cómo los ajustes administrados bloquean el destino OTLP

• Puntos finales: cuando estableces OTEL_EXPORTER_OTLP_ENDPOINT, Claude Code elimina todos los puntos finales por señal establecidos por el desarrollador. Los desarrolladores no pueden apuntar una señal a un recopilador diferente, así que no necesitas establecer también las variables de punto final por señal en los ajustes administrados.
• Protocolos: cuando estableces OTEL_EXPORTER_OTLP_PROTOCOL, Claude Code elimina todos los protocolos por señal establecidos por el desarrollador.
• Credenciales: cuando estableces OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_CLIENT_KEY, u OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, Claude Code elimina las versiones por señal establecidas por el desarrollador de esa variable, más todas las variables de punto final establecidas por el desarrollador, genéricas o por señal, ya que esas credenciales de otro modo llegarían a un recopilador que los ajustes administrados no eligieron.
• Selectores de exportador: OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, y el OTEL_TRACES_EXPORTER beta siguen la precedencia normal por clave. Un ajuste del desarrollador aún puede desactivar una señal o cambiarla al exportador de consola, así que establece también los selectores en los ajustes administrados si necesitas que estén bloqueados. En fuentes de administrador, OTEL_LOGS_EXPORTER sigue la unidad de telemetría mientras que los otros dos selectores se fusionan por clave. Requiere Claude Code v2.1.223 o posterior.
• Puntos finales de rastreo beta: con rastreo beta detallado activo, Claude Code exporta registros y rastreos a BETA_TRACING_ENDPOINT en lugar de a través de los exportadores de registros y rastreos. Claude Code por lo tanto elimina un BETA_TRACING_ENDPOINT establecido por el desarrollador siempre que cualquiera de estos ajustes administrados decida el destino de cualquiera de las señales:
  • Un punto final genérico o de registros/rastreos o credencial
  • Un otelHeadersHelper
  • Un selector de exportador de registros o rastreos establecido en none, console, o vacío, valores que mantienen la señal fuera de un recopilador
  • CLAUDE_CODE_ENABLE_TELEMETRY desactivado
  Un punto final o credencial solo de métricas no lo elimina. Antes de v2.1.251, un BETA_TRACING_ENDPOINT establecido por el desarrollador redirigía los registros y rastreos que el rastreo beta detallado exporta incluso cuando los ajustes administrados fijaban el recopilador.

Detalles de configuración

Variables de configuración comunes

Autenticación mTLS

Control de cardinalidad de métricas

Traces (beta)

Jerarquía de tramos

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

Atributos de tramo

• Una llamada a cualquier herramienta que no sea Read, Edit, Write, Bash, WebFetch, WebSearch y herramientas MCP
• Una Read que retorna algo que no sea texto de archivo, como una imagen, un PDF o una relectura de un archivo cuyo contenido no ha cambiado
• Una llamada de Edit o Write, a menos que también establezca OTEL_LOG_TOOL_DETAILS=1
• Una llamada a WebFetch o WebSearch que Claude Code movió a segundo plano mientras se ejecutaba para que un mensaje en espera pudiera llegar a Claude. El resultado que llega más tarde tampoco se registra. Para saber cuándo Claude Code mueve una llamada, consulta Cuándo Claude Code envía lo que pusiste en cola para la terminal y el campo priority para las sesiones del Agent SDK

Encabezados dinámicos

Configuración de ajustes

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

Requisitos del script

#!/bin/bash
# Ejemplo: Múltiples encabezados
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

• Una notificación de advertencia en sesiones interactivas, otelHeadersHelper failed; telemetry is not being exported, mostrada una vez por sesión cuando el asistente falla por primera vez
• Salida de /status
• El registro de depuración, cuando se ejecuta con --debug o después de ejecutar /debug en la sesión
• stderr, en sesiones no interactivas iniciadas con -p

Comportamiento de actualización

Soporte de organización de múltiples equipos

# Agregar atributos personalizados para identificación de equipo
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

• Filtrar métricas por equipo o departamento
• Rastrear costos por centro de costos
• Crear paneles específicos del equipo
• Configurar alertas para equipos específicos

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

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

Atribuir la telemetría a las sesiones SSH de Desktop

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_RESOURCE_ATTRIBUTES": "host.name=build-7"
  }
}

• Lo estableciste en la computadora que ejecuta Desktop: Desktop no pasa a la sesión SSH un valor que establezcas ahí
• Lo exportaste en /etc/profile u otro archivo que solo leen los shells de inicio de sesión: el nombre llega cuando ejecutas claude desde un shell de inicio de sesión, pero no en una sesión SSH de Desktop. Desktop no inicia Claude Code a través de un shell de inicio de sesión. En su lugar, establece la variable en env en el archivo de configuración administrada de la máquina remota.
• Un valor contiene un espacio: en ese caso, Claude Code no copia ninguna de las claves en los eventos ni en los puntos de datos. Para ver qué valor tiene el espacio, ejecuta /status en una sesión en la máquina remota. Quita el espacio del valor.
• Algo más ya establece la variable: en una sesión que inicia la aplicación de escritorio, una variable ya establecida en el entorno de lanzamiento tiene precedencia sobre los archivos de configuración. El registro de depuración puede nombrar una variable ignorada. Cuando un despliegue de Desktop de terceros especifica un endpoint OTLP en el entorno que proporciona, ese entorno lleva el propio OTEL_RESOURCE_ATTRIBUTES de Desktop.

Configuraciones de ejemplo

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

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

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

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318/v1/metrics
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Telemetría de sesiones en la nube y Claude Tag

• Configuración administrada por el servidor: agréguelas al bloque env de la configuración administrada por el servidor de su organización. Claude Code obtiene esa configuración al iniciarse dondequiera que se aplique la configuración administrada por el servidor, lo que incluye las máquinas de sus usuarios y las sesiones en la nube que no sean sesiones del canal Claude Tag. Las sesiones de Claude Tag no reciben su configuración administrada por el servidor, por lo que esta ruta no las configura.
• Las variables del entorno: agréguelas a las variables de entorno de un entorno en la nube para configurar solo las sesiones que se ejecutan en ese entorno. Esta es la ruta que llega a las sesiones de Claude Tag.

• Permita que las sesiones lleguen al recopilador: Claude Code envía la exportación a través de la red de la sesión, por lo que si llega al host en su OTEL_EXPORTER_OTLP_ENDPOINT depende del nivel de acceso de red del entorno. Si las sesiones no pueden llegar al dominio del recopilador en el nivel que eligió, agregue el dominio a la lista de permitidos del entorno, porque ninguna configuración administrada por el servidor agrega dominios a la lista de permitidos de red de un entorno.
• Canales de Claude Tag: realiza los cambios en la lista de permitidos y en las variables de entorno en el entorno compartido establecido como predeterminado de tu organización o fijado al canal.
• Cowork se configura por separado: las sesiones de Cowork no reciben la configuración administrada por el servidor, como muestra la tabla de cobertura de superficie, por lo que el bloque env administrado por el servidor no configura su telemetría.

Atribuir telemetría a sesiones en la nube

• Identificar sesiones de Claude Tag: establece OTEL_METRICS_INCLUDE_ENTRYPOINT=true, como se describe en Control de cardinalidad de métricas. Las métricas y los eventos entonces llevan app.entrypoint, cuyo valor es claude-in-slack para sesiones de Claude Tag.
• Agregar atributos personalizados: establezca OTEL_RESOURCE_ATTRIBUTES en el mismo lugar donde establece las otras variables OTEL_* para esas sesiones. Si lo export en el script de configuración del entorno en su lugar, el valor no llega a Claude Code: el script de configuración es un script Bash separado que se ejecuta antes de que Claude Code se inicie, y las variables que exporta terminan con él.

Métricas y eventos disponibles

Atributos estándar

• prompt.id: UUID que correlaciona un prompt del usuario con todos los eventos posteriores hasta el siguiente prompt. Consulta Atributos de correlación de eventos.
• workspace.host_paths: directorios del espacio de trabajo del host seleccionados en la aplicación de escritorio, como un arreglo de cadenas
• workflow.run_id: identificador de ejecución, con el prefijo wf_, en los eventos de API y de herramientas emitidos por agentes que pertenecen a una ejecución de la herramienta Workflow. Filtrar eventos por un workflow.run_id reconstruye las solicitudes a la API y los resultados de herramientas de esa ejecución. El identificador abarca los agentes que genera el script del flujo de trabajo y cualquier agente que estos generen a su vez, como las invocaciones de skills. Coincide con el identificador de ejecución informado en el resultado de la herramienta Workflow.
• workflow.name: nombre del flujo de trabajo, el meta.name de su script, emitido junto con workflow.run_id. Los nombres de flujos de trabajo integrados aparecen textualmente cuando la ejecución usa el script integrado sin modificar. Los nombres creados por el usuario, incluidas las copias editadas de scripts integrados, se reemplazan por custom a menos que se configure OTEL_LOG_TOOL_DETAILS=1.
• agent_id: identificador del subagente que generó el evento, como a3f2c1b4d5e6f7a80. Los eventos que lo llevan incluyen los eventos de API y de herramientas de un subagente, sus eventos assistant_response y subagent_completed para el subagente finalizado. Ausente en los eventos de la sesión principal y de compañeros de equipo en proceso. El agent_id del span del subagente es el mismo valor, o agrega una etiqueta después de la a inicial, como en acompact-3f2c1b4d5e6f7a80. Requiere Claude Code v2.1.310 o posterior
• parent_agent_id: el agent_id del agente que generó o reanudó por última vez al subagente que generó el evento. Ausente cuando ese agente es la sesión principal. Requiere Claude Code v2.1.310 o posterior

Atributos del repositorio

Métricas

Detalles de las métricas

Contador de sesiones

• Todos los atributos estándar
• start_type: Cómo se inició la sesión. Uno de "fresh", "resume", "continue" o "agents_view". El valor "agents_view" identifica el proceso del panel claude agents, una interfaz local iniciada por el usuario y no una sesión conversacional. Filtra por este valor para separar los inicios de procesos de interfaz de las sesiones conversacionales en tus paneles.

Contador de líneas de código

• Todos los atributos estándar
• type: ("added", "removed")
• model: Identificador del modelo que hizo el cambio (por ejemplo, “claude-sonnet-5”)

Contador de pull requests

• Todos los atributos estándar

Contador de commits

• Todos los atributos estándar

Contador de costos

• Todos los atributos estándar
• model: Identificador del modelo (por ejemplo, “claude-sonnet-5”)
• query_source: Categoría del subsistema que emitió la solicitud. Uno de "main", "subagent", "auxiliary", "plugin_model_complete" o "plugin_model_classify". Los dos últimos marcan las solicitudes que un mod hace con $.model.complete o $.model.classify. Claude Code cuenta esas solicitudes a partir de la v2.1.324, por lo que los totales pueden aumentar después de actualizar.
• speed: "fast" cuando la solicitud usó el modo rápido. Ausente en caso contrario
• effort: Nivel de esfuerzo aplicado a la solicitud: "low", "medium", "high", "xhigh" o "max". Ausente cuando Claude Code no envía ningún nivel de esfuerzo, por ejemplo en un modelo que no admite esfuerzo.
• agent.name: Tipo de subagente que emitió la solicitud. Los nombres de agentes integrados y los agentes de plugins del marketplace oficial aparecen textualmente. Los demás nombres de agentes definidos por el usuario se reemplazan por "custom". Ausente cuando la solicitud no la emitió un tipo de subagente con nombre.
• skill.name: Skill activo para la solicitud, establecido por la herramienta Skill o un comando /, o heredado por un subagente generado. Los nombres de skills integrados, incluidos, definidos por el usuario y de plugins del marketplace oficial aparecen textualmente. Los nombres de skills de plugins de terceros se reemplazan por "third-party". Ausente cuando no hay ningún skill activo.
• plugin.name: Plugin propietario cuando el skill o subagente activo lo proporciona un plugin, o el plugin cuya llamada a $.model hizo la solicitud. Los nombres de plugins del marketplace oficial aparecen textualmente. Los nombres de plugins de terceros se reemplazan por "third-party". Ausente en otras solicitudes.
• marketplace.name: Marketplace desde el que se instaló el plugin propietario. Solo se emite para plugins del marketplace oficial, incluso con OTEL_LOG_TOOL_DETAILS=1 configurado. Ausente en caso contrario.
• mcp_server.name: Servidor MCP cuyo resultado de herramienta consumió esta solicitud. Los nombres de servidores integrados, con proxy de claude.ai y del registro oficial aparecen literalmente. Los nombres de servidores configurados por el usuario se reemplazan por "custom". No aparece cuando la solicitud no consumió ningún resultado de herramienta MCP. Antes de v2.1.222, Claude Code establecía este atributo en cada solicitud posterior a una llamada a herramienta MCP, no solo en las solicitudes que consumían un resultado de herramienta, por lo que los paneles que lo agregan muestran un descenso después de actualizar.
  • A partir de v2.1.312, el nombre de un servidor remoto con una URL fija que declara un plugin del marketplace oficial de Anthropic también aparece literalmente, como plugin_<plugin>_<server>. Ese nombre se reemplaza por "custom" cuando la copia del marketplace del plugin no provino de la fuente registrada de Anthropic, como una montada desde un directorio semilla en una sesión en la nube.
• mcp_tool.name: Herramienta MCP cuyo resultado consumió esta solicitud, con el mismo comportamiento de ocultación y de versiones que mcp_server.name, salvo que puede indicar "custom" cuando mcp_server.name muestra un nombre plugin_<plugin>_<server>. No aparece cuando la solicitud no consumió ningún resultado de herramienta MCP.

Contador de tokens

• Todos los atributos estándar
• type: ("input", "output", "cacheRead", "cacheCreation"). El tipo "input" excluye los tokens leídos de la caché de prompts o escritos en ella, que se cuentan en "cacheRead" y "cacheCreation". El tipo "cacheCreation" cuenta juntas las escrituras en caché con las duraciones de caché de cinco minutos y de una hora.
• model: Identificador del modelo (por ejemplo, “claude-sonnet-5”)
• query_source: Categoría del subsistema que emitió la solicitud. Consulta Contador de costos para ver los valores.
• speed: "fast" cuando la solicitud usó el modo rápido. Ausente en caso contrario
• effort: Nivel de esfuerzo aplicado a la solicitud. Consulta Contador de costos para más detalles.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribución de skill, plugin, agente y MCP para la solicitud. Consulta Contador de costos para ver las definiciones y el comportamiento de redacción.

Contador de decisiones de herramientas de edición de código

• Todos los atributos estándar
• tool_name: Nombre de la herramienta ("Edit", "Write", "NotebookEdit")
• decision: Decisión del usuario ("accept", "reject")
• source: De dónde provino la decisión. Uno de "config", "hook", "user_permanent", "user_temporary", "user_abort" o "user_reject". Consulta el Evento de decisión de herramienta para saber qué significa cada valor.
• language: Lenguaje de programación del archivo editado, como "TypeScript", "Python", "JavaScript" o "Markdown". Devuelve "unknown" para extensiones de archivo no reconocidas.

Contador de tiempo activo

• Todos los atributos estándar
• type: "user" para interacciones con el teclado, "cli" para la ejecución de herramientas y las respuestas de IA

Eventos

Atributos de correlación de eventos

• message.uuid en user_prompt, assistant_response y api_response_body
• request_id en los eventos de API, guardado como requestId en las entradas del asistente de la transcripción
• tool_use_id en los eventos tool_result y tool_decision, y en los eventos safety_event excepto los del final de un turno

Evento de prompt del usuario

• Todos los atributos estándar
• event.name: "user_prompt"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• prompt_length: Longitud del prompt
• prompt: Contenido del prompt. Redactado de forma predeterminada. Configura OTEL_LOG_USER_PROMPTS=1 para incluirlo
• prompt_text: Mismo valor que prompt, redactado bajo la misma condición. Un backend que almacena nombres de atributos con puntos como objetos anidados lee prompt.id como id dentro de un objeto llamado prompt y puede perder la cadena del prompt. En ese caso, lee prompt_text. Requiere Claude Code v2.1.287 o posterior
• message.uuid: UUID del mensaje de usuario resultante, que coincide con la entrada guardada en la transcripción. Ausente en los despachos de comandos, que pueden producir cero o varios mensajes.
• command_name: Nombre del comando cuando el prompt invoca uno. Los nombres de comandos integrados e incluidos, como compact o debug, se emiten tal cual; los alias como reset se emiten tal como se escribieron y no con el nombre canónico. Los nombres de comandos personalizados, de plugins y de MCP se reducen a custom o mcp a menos que se configure OTEL_LOG_TOOL_DETAILS=1
• command_source: Origen del comando cuando está presente: builtin, custom o mcp. Los comandos proporcionados por plugins se informan como custom

Evento de respuesta del asistente

• Todos los atributos estándar
• event.name: "assistant_response"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• response_length: Longitud del texto de la respuesta en caracteres
• response: Texto de la respuesta, truncado en el límite de contenido (60 KB de forma predeterminada). Redactado como <REDACTED> de forma predeterminada. Configura OTEL_LOG_ASSISTANT_RESPONSES=1 para incluirlo. Cuando OTEL_LOG_ASSISTANT_RESPONSES no está configurada, lo controla OTEL_LOG_USER_PROMPTS, así que configura OTEL_LOG_ASSISTANT_RESPONSES=0 para mantener redactadas las respuestas mientras el registro de prompts está activado
• model: Identificador del modelo (por ejemplo, “claude-sonnet-5”)
• request_id: ID de la solicitud a la API, descrito en Atributos de correlación de eventos
• message.uuid: UUID de la entrada final de la transcripción de la respuesta. Una respuesta de la API se guarda como una entrada de transcripción por bloque de contenido; esta es la última, desde la que se encadena el parentUuid del siguiente turno.
• query_source: Subsistema que emitió la solicitud, como "repl_main_thread", "compact" o el nombre de un subagente

Evento de resultado de herramienta

• Todos los atributos estándar
• event.name: "tool_result"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• tool_name: Nombre de la herramienta
• tool_use_id: Identificador único de esta invocación de la herramienta. Coincide con el tool_use_id que se pasa a los hooks, lo que permite correlacionar los eventos de OTel con los datos capturados por los hooks.
• request_id: el request_id de la respuesta de la API que contenía esta llamada a herramienta, para que puedas unir la llamada con los eventos de API de esa respuesta. Ausente cuando esa respuesta no tenía ID de solicitud o cuando ninguna respuesta de la API contenía la llamada. Requiere Claude Code v2.1.310 o posterior
• success: "true" o "false"
• duration_ms: Tiempo de ejecución en milisegundos
• error_type: Cadena de categoría de error cuando la herramienta falló, como "Error:ENOENT" o "ShellError"
• error (cuando OTEL_LOG_TOOL_DETAILS=1): Mensaje de error completo cuando la herramienta falló
• decision_type: Siempre "accept", ya que este evento solo se emite después de que la herramienta se ejecuta. Las llamadas rechazadas no producen un resultado de herramienta
• decision_source: De dónde provino la decisión de permisos. Uno de "config", "hook", "user_permanent" o "user_temporary". Consulta el Evento de decisión de herramienta para saber qué significa cada valor. Los orígenes exclusivos de rechazo "user_abort" y "user_reject" nunca aparecen en este evento.
• tool_input_size_bytes: Tamaño de la entrada de la herramienta serializada en JSON, en bytes
• tool_result_size_bytes: Tamaño del resultado de la herramienta en bytes
• mcp_server_scope: Identificador del alcance del servidor MCP (para herramientas MCP)
• vcs.ref.head.revision, vcs.ref.head.name, vcs.ref.head.type (cuando OTEL_LOG_TOOL_DETAILS=1): la identidad del commit de un git commit exitoso ejecutado por la herramienta Bash o PowerShell. vcs.ref.head.revision es el SHA del commit, vcs.ref.head.name es la rama en la que se hizo el commit y vcs.ref.head.type es branch. El nombre y el tipo se omiten cuando el commit se hizo en un HEAD desacoplado. Requiere Claude Code v2.1.269 o posterior
• tool_parameters (cuando OTEL_LOG_TOOL_DETAILS=1): Cadena JSON que contiene parámetros específicos de la herramienta. Para los servidores integrados de Claude Desktop, en sesiones que pertenecen a Claude Desktop, el par mcp_server_name/mcp_tool_name se incluye incluso con el flag desactivado, la misma excepción definida por el host que en el Evento de decisión de herramienta. Los parámetros varían según la herramienta:
  • Para la herramienta Bash: incluye bash_command, full_command, timeout, description y dangerouslyDisableSandbox, además de git_commit_id y git_branch cuando un comando git commit tiene éxito. git_commit_id es el SHA completo del commit cuando el commit es el HEAD del directorio de trabajo de la sesión, y el SHA abreviado de git en caso contrario. git_branch es la rama en la que se hizo el commit, y se omite en un HEAD desacoplado
  • Para la herramienta Bash del espacio de trabajo de la aplicación de escritorio, que también informa tool_name como Bash: incluye solo bash_command, full_command y timeout
  • Para herramientas MCP: incluye mcp_server_name, mcp_tool_name
  • Para la herramienta Skill: incluye skill_name
  • Para la herramienta Agent o la herramienta Task heredada: incluye subagent_type
• tool_input (cuando OTEL_LOG_TOOL_DETAILS=1): Argumentos de la herramienta serializados en JSON. Los valores individuales de más de 512 caracteres se truncan, y el payload completo está limitado a ~4 K caracteres. Se aplica a todas las herramientas, incluidas las herramientas MCP.

Evento de solicitud a la API

• Todos los atributos estándar
• event.name: "api_request"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• model: Modelo usado (por ejemplo, “claude-sonnet-5”)
• cost_usd: Costo estimado en USD
• cost_usd_micros: Costo estimado en millonésimas de dólar estadounidense, emitido como un entero
• duration_ms: Duración de la solicitud en milisegundos
• input_tokens: Número de tokens de entrada, excluidos los tokens leídos de la caché de prompts o escritos en ella
• output_tokens: Número de tokens de salida
• cache_read_tokens: Número de tokens leídos de la caché
• cache_creation_tokens: Número de tokens usados para la creación de caché
• cache_creation_5m_tokens, cache_creation_1h_tokens: el número de tokens que la respuesta de la API informa como escritos en la caché con una duración de caché de cinco minutos y el número escrito con una duración de una hora. Ambos son 0 cuando la respuesta de la API no los informa, incluso cuando cache_creation_tokens es mayor que cero. Requiere Claude Code v2.1.300 o posterior
• request_id: ID de la solicitud a la API, como "req_011...", descrito en Atributos de correlación de eventos.
• client_request_id: UUID generado por el cliente y enviado como el encabezado de solicitud x-client-request-id; consulta la tabla de atributos de correlación de eventos para saber cuándo está presente
• speed: "fast" o "normal", que indica si el modo rápido estaba activo
• query_source: Subsistema que emitió la solicitud, como "repl_main_thread", "compact" o el nombre de un subagente
• effort: Nivel de esfuerzo aplicado a la solicitud: "low", "medium", "high", "xhigh" o "max". Ausente cuando Claude Code no envía ningún nivel de esfuerzo, por ejemplo en un modelo que no admite esfuerzo.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribución de skill, plugin, agente y MCP para la solicitud. Consulta Contador de costos para ver las definiciones y el comportamiento de ocultación. Cuando un mod que no pertenece al marketplace oficial ni al paquete integrado llama a $.model, marketplace.name también está presente, oculto como "third-party" a menos que establezcas OTEL_LOG_TOOL_DETAILS=1.

Evento de error de la API

• Todos los atributos estándar
• event.name: "api_error"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• model: Modelo usado (por ejemplo, “claude-sonnet-5”)
• error: Mensaje de error
• status_code: Código de estado HTTP como número. Ausente para errores que no son HTTP, como las fallas de conexión.
• duration_ms: Duración de la solicitud en milisegundos
• attempt: Número de intentos realizados, incluida la solicitud inicial. Detectar el agotamiento de reintentos indica cuándo se reinicia el conteo
• request_id: ID de la solicitud a la API, como "req_011...", descrito en Atributos de correlación de eventos.
• client_request_id: UUID generado por el cliente y enviado como el encabezado de solicitud x-client-request-id. Disponible incluso cuando una falla, como un tiempo de espera agotado o un error de conexión, nunca produjo un request_id del servidor; consulta la tabla de atributos de correlación de eventos para saber cuándo está presente.
• speed: "fast" o "normal", que indica si el modo rápido estaba activo
• query_source: Subsistema que emitió la solicitud, como "repl_main_thread", "compact" o el nombre de un subagente
• effort: Nivel de esfuerzo aplicado a la solicitud. Ausente cuando Claude Code no envía ningún nivel de esfuerzo, por ejemplo en un modelo que no admite esfuerzo.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribución de skill, plugin, agente y MCP para la solicitud. Consulta Contador de costos para ver las definiciones y el comportamiento de ocultación. Para marketplace.name en las llamadas a $.model de un mod, consulta api_request.

Evento de rechazo de la API

• Todos los atributos estándar
• event.name: "api_refusal"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• model: Identificador del modelo de la solicitud
• request_id: ID de la solicitud a la API, como "req_011...", descrito en Atributos de correlación de eventos.
• query_source: Subsistema que emitió la solicitud, como "repl_main_thread", "compact" o el nombre de un subagente. Consulta api_request para ver las definiciones.
• speed: "fast" cuando el modo rápido está activo, o "normal"
• attempt: Número de intento de reintento. El primer intento es 1.
• effort: Nivel de esfuerzo aplicado a la solicitud. Ausente cuando Claude Code no envía ningún nivel de esfuerzo, por ejemplo en un modelo que no admite esfuerzo.
• server_fallback_hop: true cuando el respaldo de modelo del lado del servidor de la API ya reintentó este rechazo en un modelo diferente, por lo que el usuario no vio este rechazo en particular. false cuando la solicitud terminó en un rechazo. Un mismo turno puede emitir tanto un evento de salto con true como un evento final posterior con false cuando el modelo de respaldo también rechaza.
• has_category: true cuando la respuesta de la API incluyó un stop_details.category de "cyber", "bio", "frontier_llm" o "reasoning_extraction". false cuando la respuesta no incluyó ninguna categoría o un valor fuera de ese conjunto. Ausente cuando server_fallback_hop es true, porque los bloques de salto no incluyen stop_details.
• has_explanation: true cuando la respuesta de la API incluyó un stop_details.explanation; en caso contrario, false. Ausente cuando server_fallback_hop es true.
• category: El valor de stop_details.category de la respuesta de la API. Uno de "cyber", "bio", "frontier_llm" o "reasoning_extraction". Solo presente cuando OTEL_LOG_TOOL_DETAILS=1 está configurado y has_category es true.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: Atribución de skill, plugin, agente y MCP para la solicitud. Consulta Contador de costos para ver las definiciones y el comportamiento de redacción.

Evento de cuerpo de la solicitud a la API

• Todos los atributos estándar
• event.name: "api_request_body"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• body: Parámetros de la solicitud a la API de Messages serializados en JSON, como el prompt del sistema, los mensajes y las herramientas, truncados en el límite de contenido (60 KB de forma predeterminada). El contenido de pensamiento extendido de turnos anteriores del asistente se redacta. Se emite solo en modo en línea (OTEL_LOG_RAW_API_BODIES=1).
• body_ref: Ruta absoluta a un archivo <dir>/<uuid>.request.json que contiene el cuerpo sin truncar. Se emite solo en modo de archivo (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length: Longitud del cuerpo sin truncar. Bytes UTF-8 cuando OTEL_LOG_RAW_API_BODIES=file:<dir>, o unidades de código UTF-16 cuando =1
• body_truncated: "true" cuando se produjo un truncamiento en línea. Ausente en modo de archivo y cuando no hubo truncamiento.
• model: Identificador del modelo de los parámetros de la solicitud
• query_source: Subsistema que emitió la solicitud (por ejemplo, "compact")
• request_body_id: UUID que identifica el cuerpo de la solicitud de este intento. El evento api_response_body del intento que tiene éxito incluye el mismo valor, por lo que puedes emparejar una respuesta con la solicitud exacta que la produjo. Requiere Claude Code v2.1.274 o posterior

Evento de cuerpo de la respuesta de la API

• Todos los atributos estándar
• event.name: "api_response_body"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• body: Respuesta de la API de Messages serializada en JSON, incluidos el id, los bloques de contenido, el uso y el motivo de detención, truncada en el límite de contenido (60 KB de forma predeterminada). El contenido de pensamiento extendido se redacta. Se emite solo en modo en línea (OTEL_LOG_RAW_API_BODIES=1).
• body_ref: Ruta absoluta a un archivo <dir>/<request_id>.response.json que contiene el cuerpo sin truncar. Se emite solo en modo de archivo (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length: Longitud del cuerpo sin truncar. Bytes UTF-8 cuando OTEL_LOG_RAW_API_BODIES=file:<dir>, o unidades de código UTF-16 cuando =1
• body_truncated: "true" cuando se produjo un truncamiento en línea. Ausente en modo de archivo y cuando no hubo truncamiento.
• model: Identificador del modelo
• query_source: Subsistema que emitió la solicitud
• request_id: ID de la solicitud a la API, como "req_011...", descrito en Atributos de correlación de eventos.
• request_body_id: El request_body_id del evento api_request_body al que responde esta respuesta. Requiere Claude Code v2.1.274 o posterior
• message.id: ID del mensaje que la API asignó a la respuesta, el campo id del cuerpo de la respuesta. Requiere Claude Code v2.1.274 o posterior
• message.uuid: UUID de la entrada final de la transcripción de la respuesta. Junto con request_body_id, vincula un mensaje de la transcripción con los cuerpos de solicitud y respuesta que lo respaldan. Requiere Claude Code v2.1.274 o posterior

Evento de decisión de herramienta

• Todos los atributos estándar
• event.name: "tool_decision"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• tool_name: Nombre de la herramienta (por ejemplo, “Read”, “Edit”, “Write”, “NotebookEdit”)
• tool_use_id: Identificador único de esta invocación de la herramienta. Coincide con el tool_use_id que se pasa a los hooks, lo que permite correlacionar los eventos de OTel con los datos capturados por los hooks.
• request_id: el request_id de la respuesta de la API que contenía esta llamada a herramienta, para que puedas unir la llamada con los eventos de API de esa respuesta. Ausente cuando esa respuesta no tenía ID de solicitud o cuando ninguna respuesta de la API contenía la llamada. Requiere Claude Code v2.1.310 o posterior
• decision: "accept" o "reject"
• tool_source: Siempre presente. La procedencia de la herramienta, como un conjunto cerrado de valores definidos por la CLI:
  • "builtin": las herramientas propias de la CLI
  • "mcp": servidores MCP en general
  • "sdk_host_builtin_mcp": un servidor en proceso integrado en el propio Claude Desktop, en una sesión que pertenece a Claude Desktop. Una sesión pertenece a Claude Desktop cuando la inició desde uno de sus propios puntos de entrada, claude-desktop, claude-desktop-3p o local-agent, y esa sesión no es un hijo anidado; las sesiones anidadas, incluidas las que genera el propio Claude Code, informan estos servidores como "mcp"
• source: De dónde provino la decisión:
  • "config": Decidida automáticamente sin preguntar, por uno de estos orígenes:
    • Configuración del proyecto
    • Reglas de permitir o denegar en la configuración personal del usuario
    • Política administrada empresarial
    • Flags --allowedTools o --disallowedTools
    • El modo de permisos activo
    • El clasificador del modo automático, cuyo veredicto registra el mismo evento en classifier_verdict
    • Una concesión para el resto de la sesión, otorgada en una solicitud de permiso anterior en la misma sesión interactiva de la CLI
    • Que la herramienta sea intrínsecamente segura
    El valor de source no indica cuál de estas fuentes coincidió. Cuando classifier_verdict está presente, indica el resultado del clasificador que decidió la llamada. Ningún atributo de tool_decision nombra la regla de permisos o el ajuste que rechazó la llamada. Claude Code también informa "config" cuando falla la propia solicitud de permiso. Por ejemplo, esa solicitud falla cuando el callback canUseTool del Agent SDK o la herramienta --permission-prompt-tool devuelven un resultado no válido, o cuando el flujo de entrada se cierra mientras la solicitud está pendiente.
  • "hook": Un hook PreToolUse o PermissionRequest devolvió la decisión.
  • "user_permanent": Se emite cuando el usuario eligió “Yes, and don’t ask again for …” en una solicitud de permiso, lo que guarda una regla de permitir en su configuración personal. En la CLI interactiva, esto se emite solo para esa elección en sí; las llamadas posteriores que coinciden con la regla guardada emiten "config" en su lugar. En sesiones del Agent SDK o sesiones no interactivas con -p, tanto la elección inicial como las coincidencias posteriores con la regla emiten "user_permanent". Se trata como una aceptación.
  • "user_temporary": Se emite cuando el usuario eligió “Yes” en una solicitud de permiso para una aprobación única, o eligió una opción que otorga acceso durante el resto de la sesión en una solicitud de edición o lectura de archivos. En la CLI interactiva, esto se emite solo para la elección en sí; las llamadas posteriores permitidas por esa autorización limitada a la sesión emiten "config" en su lugar. En sesiones del Agent SDK o sesiones no interactivas con -p, tanto la elección como las coincidencias posteriores emiten "user_temporary". Se trata como una aceptación.
  • "user_abort": Se emite cuando el usuario descartó la solicitud de permiso sin responder. En sesiones del Agent SDK y sesiones no interactivas con -p, esto incluye interrumpir el turno mientras hay una solicitud de permiso de canUseTool o --permission-prompt-tool pendiente. Se trata como un rechazo.
  • "user_reject": Se emite cuando el usuario eligió “No” al solicitársele. En la CLI interactiva, esto se emite solo para esa elección en sí; las llamadas que coinciden con una regla de denegar en la configuración personal del usuario emiten "config" en su lugar. En sesiones del Agent SDK o sesiones no interactivas con -p, las llamadas que coinciden con una regla de denegar en la configuración personal emiten "user_reject". Se trata como un rechazo.
• classifier_verdict: El veredicto del clasificador del modo automático para la llamada, o el motivo por el que Claude Code denegó la llamada cuando no llegó ninguno. Requiere Claude Code v2.1.301 o posterior
  • "allow": el clasificador aprobó la llamada
  • "block": el clasificador bloqueó la llamada. Una comprobación del clasificador que falla a mitad de camino también puede terminar como "block", por lo que una interrupción parcial del clasificador puede aparecer como más bloqueos en lugar de como "unavailable"
  • "no_verdict": la comprobación se ejecutó pero no dio ningún veredicto utilizable, por lo que Claude Code denegó la llamada. La denegación no significa que el clasificador considerara insegura la llamada
  • "unavailable": la solicitud al clasificador falló, por ejemplo por un rate limit, un tiempo de espera agotado o un error de conexión, por lo que Claude Code denegó la llamada. Con la revisión del clasificador del lado del servidor, también marca una llamada denegada porque el servidor no devolvió ningún veredicto de seguridad
  El atributo también aparece en las llamadas en modo plan cuando el clasificador revisa los comandos en modo plan. El atributo está ausente en estos casos:
  • Una regla de permisos de permitir o denegar decidió la llamada
  • Claude Code aprobó la llamada en modo automático sin consultar al clasificador
  • El usuario respondió la solicitud que Claude Code mostró después de bloqueos repetidos
  • En una ejecución con -p sin --permission-prompt-tool, Claude Code denegó la llamada después de bloqueos repetidos porque no había nadie para responder una solicitud. Ese evento informa decision como "reject" y source como "config"
• classifier_category (cuando OTEL_LOG_TOOL_DETAILS=1): El nombre de la regla integrada que el clasificador indicó al bloquear la llamada, en minúsculas con guiones bajos, como "data_exfiltration" para la regla Data Exfiltration. Requiere Claude Code v2.1.301 o posterior. El atributo está presente cuando se cumplen ambas condiciones:
  • classifier_verdict es "block"
  • El clasificador indicó exactamente una regla, y esa regla es integrada y no una que escribiste tú
  Antes de v2.1.302, el atributo también estaba ausente en cualquier bloqueo decidido por la revisión del clasificador del lado del servidor.
• permission_mode: Modo de permisos activo cuando comenzó la comprobación de permisos de esta llamada: "default", "plan", "acceptEdits", "bypassPermissions", "dontAsk" o "auto". El modo manual aparece como "default". Una llamada de un subagente informa el modo de permisos del subagente y no el de la sesión. Requiere Claude Code v2.1.301 o posterior
• tool_parameters (cuando OTEL_LOG_TOOL_DETAILS=1): Cadena JSON que contiene parámetros específicos de la herramienta. Misma forma que en el Evento de resultado de herramienta, sin los campos posteriores a la ejecución como git_commit_id. Los valores pueden diferir de tool_result en una llamada aceptada si la decisión de permisos reescribe la entrada de la herramienta mediante updatedInput. Usa este atributo para ver qué comando se rechazó cuando decision es "reject".
  • Para herramientas "sdk_host_builtin_mcp": mcp_server_name y mcp_tool_name se incluyen incluso cuando OTEL_LOG_TOOL_DETAILS está desactivada, porque la aplicación host define estos nombres; sin ellos, una llamada rechazada a uno de estos servidores integrados no podría atribuirse en el flujo predeterminado. Para servidores MCP configurados por el usuario, el tool_name del evento es siempre el literal "mcp_tool", y los nombres del servidor y de la herramienta aparecen solo en tool_parameters con el flag activado; el contenido de los argumentos requiere el flag en todos los casos.
  • Para la herramienta Bash: incluye bash_command, full_command, timeout, description, dangerouslyDisableSandbox. La herramienta bash del espacio de trabajo de la aplicación de escritorio también informa tool_name como Bash, pero incluye solo bash_command, full_command y timeout
  • Para herramientas MCP: incluye mcp_server_name, mcp_tool_name
  • Para la herramienta Skill: incluye skill_name
  • Para la herramienta Agent o la herramienta Task heredada: incluye subagent_type

1. parent_agent_id
2. agent_id
3. request_id
4. permission_mode
5. classifier_category
6. classifier_verdict

Evento de seguridad

• v2.1.312 y posteriores: estas versiones no envían el evento, y ningún ajuste lo activa
• v2.1.307 a v2.1.311: una sesión deja de enviar el evento en su siguiente actualización de feature flags. Una sesión que no obtiene feature flags, como en Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry, puede seguir enviándolo.

• Una comprobación rechaza una llamada a herramienta o requiere una solicitud de permiso, excepto en las llamadas sin evento de seguridad
• El proxy de red del sandbox rechaza una conexión o una solicitud
• Un hook bloquea un resultado o el final de un turno

• Todos los atributos estándar
• event.name: "safety_event"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• category: La comprobación o el resultado, un valor de categoría
• decision: "accept", "reject" o "sent_back" cuando un hook bloqueó un resultado o el final de un turno
• decision_source: Quién o qué decidió, un valor de source de tool_decision o "other"
• reason_code: El motivo de la comprobación, como "rule:policySettings", "mode:dontAsk", "hook:PreToolUse", "classifier:auto-mode", "bashMiss:too-complex" o "unknown"
• reason_type: El tipo de motivo de la comprobación, como "rule", "subcommandResults", "mode", "hook", "classifier" o "asyncAgent"
• rule_source: Fuente de configuración de la regla involucrada, como "policySettings", "userSettings", "projectSettings", "localSettings", "flagSettings", "cliArg" o "session"
• grant_scope: "once" o "session" para una solicitud aprobada sin guardar una regla en un archivo de configuración
• circuit_breaker: La comprobación de seguridad integrada, como "dangerousRemoval", "outsideReadsBlocked" o "claudeSettingsFile"
• classifier_category: Con OTEL_LOG_TOOL_DETAILS=1, la regla integrada detrás de un bloqueo del modo automático, como "data_exfiltration"
• hook_event: "pre_tool_use" para un hook PreToolUse, o "post_tool_use", "post_tool_use_failure", "stop" o "subagent_stop" en eventos "hook_review"
• tool_class: "bash" para Bash y Monitor, "powershell", "file" para Read, Edit, Write, NotebookEdit, Glob y Grep, "web" para WebFetch y WebSearch, "mcp" u "other"
• tool_name: El nombre de la herramienta, como "Bash" para una herramienta integrada, o "mcp_tool", "skill_tool", "dynamic_tool" u "other_tool"
• tool_source: "builtin", "mcp" o "sdk_host_builtin_mcp", como en tool_decision
• permission_mode: El modo de permisos de la llamada cuando se comprobó: "default", "plan", "acceptEdits", "bypassPermissions", "dontAsk" o "auto"
• tool_use_id: El ID de la llamada, como en tool_decision y tool_result
• sandbox_violation_count: Cuántas conexiones o solicitudes distintas del comando de la llamada rechazó el proxy de red del sandbox, de "0" a "20" como cadena. Los rechazos se cuentan para un comando en el sandbox que terminó en primer plano
• sandbox_enabled: "true" si el sandboxing está activado para la sesión; de lo contrario, "false"

{
  "event.name": "safety_event",
  "category": "managed_policy",
  "decision": "reject",
  "decision_source": "config",
  "reason_code": "rule:policySettings",
  "rule_source": "policySettings",
  "tool_class": "bash",
  "tool_name": "Bash",
  "tool_source": "builtin",
  "permission_mode": "default",
  "tool_use_id": "toolu_01ABC123...",
  "sandbox_violation_count": "0",
  "sandbox_enabled": "false"
}

Categorías de eventos de seguridad

Llamadas sin evento de seguridad

• Una llamada aprobada en una solicitud sin categoría
• Una llamada que un callback canUseTool o una herramienta --permission-prompt-tool aprobó en una solicitud que solo requería un hook PreToolUse
• Una llamada a AskUserQuestion o ExitPlanMode, rechazada o no

Solicitudes sin categoría

Evento de cambio de modo de permisos

• Todos los atributos estándar
• event.name: "permission_mode_changed"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• from_mode: El modo de permisos anterior, por ejemplo "default", "plan", "acceptEdits", "auto" o "bypassPermissions"
• to_mode: El nuevo modo de permisos
• trigger: Qué causó el cambio, por ejemplo "shift_tab", "exit_plan_mode" o "auto_gate_denied". Ausente en algunos cambios, como cuando el SDK establece el modo de permisos mediante setPermissionMode()

Evento de autenticación

• Todos los atributos estándar
• event.name: "auth"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• action: "login" o "logout"
• success: "true" o "false"
• auth_method: Método de autenticación, como "oauth"
• error_category: Tipo categórico de error cuando la acción falló. El mensaje de error sin procesar nunca se incluye
• status_code: Código de estado HTTP como cadena cuando la acción falló con un error HTTP

Evento de conexión de servidor MCP

• Todos los atributos estándar
• event.name: "mcp_server_connection"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• status: "connected", "failed" o "disconnected"
• transport_type: Transporte del servidor, como "stdio", "sse" o "http"
• server_scope: Alcance en el que está configurado el servidor, como "user", "project" o "local"
• duration_ms: Duración del intento de conexión en milisegundos
• error_code: Código de error cuando la conexión falló
• is_plugin: true cuando el servidor lo proporciona un plugin, false en caso contrario
• plugin_id_hash (cuando is_plugin es true): Hash estable del nombre del plugin y del marketplace, para agrupar eventos por plugin sin exponer el nombre. Claude Code lo calcula como se describe en el evento de plugin cargado
• plugin.name (cuando is_plugin es true): Nombre del plugin que proporciona el servidor. Para plugins de terceros es la cadena literal "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1; esto evita que los nombres de plugins de terceros aparezcan en los registros de forma predeterminada. Los plugins de fuentes oficiales de Anthropic siempre se identifican por su nombre. Los atributos plugin_id_hash y plugin.name fluyen hacia tu propio backend de monitoreo y no se envían a Anthropic
• server_name (cuando OTEL_LOG_TOOL_DETAILS=1): Nombre configurado del servidor
• error (cuando OTEL_LOG_TOOL_DETAILS=1): Mensaje de error completo cuando la conexión falló

Evento de error interno

• Todos los atributos estándar
• event.name: "internal_error"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• error_name: Nombre de la clase del error, como "TypeError" o "SyntaxError"
• error_code: Código errno de Node.js, como "ENOENT", cuando está presente en el error

Evento de plugin instalado

• Todos los atributos estándar
• event.name: "plugin_installed"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• marketplace.is_official: "true" si el marketplace es un marketplace oficial de Anthropic, "false" en caso contrario
• install.trigger: "cli" o "ui"
• plugin.name: Nombre del plugin instalado. Para marketplaces de terceros, se incluye solo cuando OTEL_LOG_TOOL_DETAILS=1
• plugin.version: Versión del plugin cuando está declarada en la entrada del marketplace. Para marketplaces de terceros, se incluye solo cuando OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: Marketplace desde el que se instaló el plugin. Para marketplaces de terceros, se incluye solo cuando OTEL_LOG_TOOL_DETAILS=1

Evento de plugin cargado

• Todos los atributos estándar
• event.name: "plugin_loaded"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• plugin.name: nombre del plugin. Para plugins fuera del marketplace oficial y del paquete integrado, el valor es "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: marketplace desde el que se instaló el plugin, cuando se conoce. Se redacta como "third-party" bajo la misma condición que plugin.name
• plugin.version: versión del manifiesto del plugin. Se incluye solo cuando el nombre no está redactado y el manifiesto declara una versión
• plugin.scope: categoría de procedencia del plugin: "official", "community", "org", "user-local" o "default-bundle"
• enabled_via: cómo llegó a habilitarse el plugin: "default-enable", "org-policy", "admin-install", "seed-mount" o "user-install". El valor "admin-install" significa que el plugin está configurado como obligatorio o de instalación automática para tu organización en Organization settings > Plugins & skills. Antes de v2.1.246, Claude Code informaba estos plugins como "user-install" o "seed-mount"
• plugin_id_hash: hash determinista del nombre del plugin y del marketplace, enviado solo a tu exportador configurado. Te permite contar los distintos plugins de terceros cargados en tu flota sin registrar sus nombres. Para plugins sincronizados desde claude.ai, Claude Code calcula el hash del nombre del plugin con el nombre del marketplace que claude.ai informa para el plugin, o con synced en caso contrario. Antes de v2.1.246, Claude Code no usaba en el hash el nombre del marketplace que informa claude.ai
• has_hooks: si el plugin aporta hooks, mediante configuración de hooks o como un mod
• has_mcp: si el plugin aporta servidores MCP
• host_owned_mcp: true cuando el host del SDK administra las conexiones MCP de este plugin y Claude Code omitió leer la configuración de servidores MCP del plugin, false en caso contrario
• skill_path_count: número de directorios de skills que declara el plugin
• command_path_count: número de directorios de comandos que declara el plugin
• agent_path_count: número de directorios de agentes que declara el plugin
• safe_mode: "true" cuando la sesión se inició con --safe-mode, "false" en caso contrario. En modo seguro, este evento informa solo el inventario configurado; los comandos, skills, hooks y servidores MCP del plugin no se cargan. Requiere Claude Code v2.1.169 o posterior

Evento de skill activado

• Todos los atributos estándar
• event.name: "skill_activated"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• skill.name: Nombre del skill. Para skills definidos por el usuario y de plugins de terceros, el valor es el marcador "custom_skill" a menos que OTEL_LOG_TOOL_DETAILS=1
• invocation_trigger: Cómo se activó el skill ("user-slash", "claude-proactive" o "nested-skill")
• skill.source: Desde dónde se cargó el skill (por ejemplo, "bundled", "userSettings", "projectSettings", "plugin")
• skill.kind: "workflow" cuando el skill es un skill de flujo de trabajo. Ausente en caso contrario
• plugin.name (cuando OTEL_LOG_TOOL_DETAILS=1 o el plugin proviene de un marketplace oficial): Nombre del plugin propietario cuando el skill lo proporciona un plugin
• marketplace.name (cuando OTEL_LOG_TOOL_DETAILS=1 o el plugin proviene de un marketplace oficial): Marketplace desde el que se instaló el plugin propietario, cuando el skill lo proporciona un plugin

Evento de mención con @

• Todos los atributos estándar
• event.name: "at_mention"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• mention_type: Tipo de mención ("file", "directory", "agent", "mcp_resource", "peer"). El valor "peer" significa que mencionaste otra de tus sesiones de Claude Code. Requiere Claude Code v2.1.232 o posterior
• success: Si la mención se resolvió correctamente ("true" o "false")

Evento de reintentos de la API agotados

• Todos los atributos estándar
• event.name: "api_retries_exhausted"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• model: Modelo usado
• error: Mensaje de error final
• status_code: Código de estado HTTP como número. Ausente para errores que no son HTTP.
• total_attempts: Número total de intentos realizados
• total_retry_duration_ms: Tiempo real total entre todos los intentos
• speed: "fast" o "normal"

Evento de hook registrado

• Todos los atributos estándar
• event.name: "hook_registered"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• hook_event: tipo de evento del hook, como "PreToolUse" o "PostToolUse"
• hook_type: tipo de implementación del hook: "command", "prompt", "mcp_tool", "http" o "agent"
• hook_source: dónde está definido el hook: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings" o "pluginHook"
• safe_mode: "true" cuando la sesión se inició con --safe-mode, "false" en caso contrario. Requiere Claude Code v2.1.169 o posterior
• hook_matcher (cuando OTEL_LOG_TOOL_DETAILS=1): la cadena del matcher de la configuración del hook, cuando hay uno configurado
• plugin.name (cuando hook_source es "pluginHook"): nombre del plugin que lo aporta. Para plugins fuera del marketplace oficial y del paquete integrado, el valor es "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1
• plugin_id_hash (cuando hook_source es "pluginHook"): hash determinista del nombre del plugin y del marketplace, enviado solo a tu exportador configurado. Te permite contar los distintos plugins que aportan hooks sin registrar sus nombres. Claude Code lo calcula como se describe en el evento de plugin cargado

Evento de inicio de ejecución de hook

• Todos los atributos estándar
• event.name: "hook_execution_start"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• hook_event: Tipo de evento del hook, como "PreToolUse" o "PostToolUse"
• hook_name: Nombre completo del hook, incluido el matcher, como "PreToolUse:Write"
• num_hooks: Número de comandos de hook coincidentes
• managed_only: "true" cuando solo se permiten hooks de política administrada
• hook_source: "policySettings" o "merged"
• safe_mode: "true" cuando la sesión se inició con --safe-mode, "false" en caso contrario. Requiere Claude Code v2.1.169 o posterior
• hook_definitions: Configuración del hook serializada en JSON. Se incluye solo cuando están habilitados tanto el rastreo beta detallado como OTEL_LOG_TOOL_DETAILS=1

Evento de ejecución de hooks completada

• Todos los atributos estándar
• event.name: "hook_execution_complete"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• hook_event: tipo de evento de hook
• hook_name: nombre completo del hook, incluido el matcher
• num_hooks: número de comandos de hook que coinciden
• num_success: cantidad que se completó correctamente
• num_blocking: cantidad que devolvió una decisión de bloqueo
• num_non_blocking_error: cantidad que falló sin bloquear
• num_cancelled: cantidad cancelada antes de completarse
• total_duration_ms: duración en tiempo real de todos los hooks que coinciden
• stdout_chars: total de caracteres de stdout de los hooks que coinciden y que se completaron correctamente. Requiere Claude Code v2.1.280 o posterior
• additional_context_chars: total de caracteres de additionalContext devueltos por los hooks que coinciden. Requiere Claude Code v2.1.280 o posterior
• system_message_chars: total de caracteres de systemMessage devueltos por los hooks que coinciden. Requiere Claude Code v2.1.280 o posterior
• initial_user_message_chars: total de caracteres de initialUserMessage devueltos por los hooks que coinciden. Requiere Claude Code v2.1.280 o posterior
• num_outputs_persisted: número de salidas de hooks que superan el límite de 10,000 caracteres y que Claude Code guardó en un archivo. Requiere Claude Code v2.1.280 o posterior
• managed_only: "true" cuando solo se permiten hooks de políticas administradas
• hook_source: "policySettings" o "merged"
• safe_mode: "true" cuando la sesión se inició con --safe-mode, "false" en caso contrario. Requiere Claude Code v2.1.169 o posterior
• hook_definitions: configuración de hooks serializada en JSON. Solo se incluye cuando están habilitados tanto el rastreo beta detallado como OTEL_LOG_TOOL_DETAILS=1

Evento de métricas de hooks de plugins

• Todos los atributos estándar
• event.name: "hook_plugin_metrics"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• plugin_id: identificador del plugin con el formato <name>@<marketplace>
• hook_event: tipo de evento de hook que emitió las métricas
• Hasta 20 claves de métricas emitidas por el plugin. Los nombres coinciden con ^[a-z][a-z0-9_]{0,39}$. Los valores son booleanos o numéricos.

Evento de compactación

• Todos los atributos estándar
• event.name: "compaction"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• trigger: "auto" o "manual"
• success: "true" o "false"
• duration_ms: duración de la compactación
• pre_tokens: recuento aproximado de tokens antes de la compactación
• post_tokens: recuento aproximado de tokens después de la compactación
• error: mensaje de error cuando la compactación falló
• precompute_reuse: solo se establece cuando trigger es "manual", o cuando trigger es "auto" para una compactación por inactividad en una sesión interactiva de terminal. La compactación automática puede preparar un resumen en segundo plano antes de que se llene la ventana de contexto, y este atributo registra si la compactación reutilizó ese resumen preparado. "hit" significa que se reutilizó; "miss_custom_instructions", "miss_hook" y "miss_not_ready" indican el motivo por el que, en su lugar, se calculó un resumen nuevo

Evento de subagente completado

• Todos los atributos estándar
• event.name: "subagent_completed"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• agent_type: el tipo de subagente. Los nombres de agentes integrados y los agentes de plugins del marketplace oficial aparecen literalmente; los demás nombres de agentes se sustituyen por "custom" a menos que se establezca OTEL_LOG_TOOL_DETAILS=1
• agent.source: de dónde proviene la definición del agente: built-in, plugin o la fuente de configuración que definió un agente personalizado, como userSettings o projectSettings
• is_built_in: si el subagente es un tipo de agente integrado
• is_async: si el subagente se ejecutó en segundo plano
• total_tokens: la huella de tokens de la solicitud final a la API del subagente: los tokens de entrada, de creación de caché, de lectura de caché y de salida de esa única solicitud, aproximadamente el tamaño del contexto del subagente al completarse. No es una suma de toda la ejecución
• total_tool_uses: número de llamadas a herramientas que el subagente realizó durante toda la ejecución
• duration_ms: tiempo de ejecución en milisegundos
• model: el modelo con el que se resolvió ejecutar el subagente
• final_model: el modelo que produjo la respuesta final del subagente, que difiere de model tras un cambio a mitad de la ejecución, como un respaldo
• model_swapped: si más de un modelo atendió las solicitudes del subagente
• plugin_id_hash, plugin.name: presentes para los agentes proporcionados por plugins. Los nombres de plugins del marketplace oficial aparecen literalmente; los demás nombres de plugins se sustituyen por "third-party" a menos que se establezca OTEL_LOG_TOOL_DETAILS=1

Evento de encuesta de comentarios

• Todos los atributos estándar
• event.name: "feedback_survey"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• event_type: evento del ciclo de vida de la encuesta, por ejemplo "appeared", "responded" o "transcript_prompt_appeared"
• appearance_id: ID único que vincula los eventos emitidos para una instancia de encuesta
• survey_type: qué encuesta produjo el evento. "session" es el prompt de calificación “How is Claude doing?”
• response: la selección del usuario en los eventos responded
• enabled_via_override: true cuando se establece CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL. Se emite como booleano, no como cadena. Está presente en los eventos de encuesta session. Filtra por este atributo para confirmar que la sobrescritura se aplica en toda una flota

Evento de barrido de retención

• "complete": el barrido se ejecutó y el evento incluye sus recuentos
• "skipped": Claude Code no pudo determinar con seguridad el período de retención, así que pausó el barrido y el evento no incluye recuentos. Si skip_reason es "settings_unknowable" o "settings_invalid_key_set", corrige el error de configuración que reporta /status en esa máquina para que una sesión posterior pueda ejecutar el barrido

• Todos los atributos estándar
• event.name: "retention_sweep"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• result: "complete" cuando el barrido se ejecutó, "skipped" cuando Claude Code lo pausó
• period_days: el período de retención con el que comenzó el barrido, en días: cleanupPeriodDays de la configuración combinada, con cualquier cambio aplicado por un hook settings.read. 30 cuando eso deja la clave sin definir. En los eventos omitidos, el valor que el barrido habría usado, calculado a partir de las fuentes de configuración que Claude Code pudo leer
• used_default: "true" cuando period_days recurrió a 30, "false" en caso contrario. En los eventos completados, "true" significa que se aplicó el valor predeterminado de 30 días
• skip_reason: por qué Claude Code pausó el barrido. Presente solo cuando result es "skipped":
  • "user_source_disabled": la configuración del usuario está excluida, por ejemplo mediante el flag --setting-sources o la opción settingSources del SDK, y ninguna fuente habilitada proporciona cleanupPeriodDays
  • "settings_unknowable": no se pudo leer o analizar un archivo de configuración, por lo que cleanupPeriodDays o desktopSessionCleanupPeriodDays podrían estar establecidos en un valor que Claude Code no puede ver
  • "settings_invalid_key_set": la configuración tiene errores de validación y cleanupPeriodDays o desktopSessionCleanupPeriodDays están establecidos explícitamente, por lo que recurrir al valor predeterminado podría eliminar o conservar archivos en contra de ese ajuste
  • "remote_settings_unknowable": una sesión en la pestaña Code de Claude Desktop en un despliegue de terceros solicitó la configuración administrada por el servidor. No recibió ninguna respuesta utilizable, por lo que cleanupPeriodDays podría estar establecido en un valor que Claude Code no puede ver
• transcripts_deleted: número de transcripciones de sesiones, los archivos ~/.claude/projects/*/*.jsonl de nivel superior, que eliminó el barrido
• transcripts_exempted_desktop: número de transcripciones que superan el período de retención y que el barrido conservó según la regla de Claude Desktop y Cowork. Estas no cuentan para files_past_cutoff. Requiere Claude Code v2.1.248 o posterior
• session_files_deleted: número de artefactos que eliminó el barrido de archivos de sesión: transcripciones más archivos complementarios por sesión, como archivos sidecar, grabaciones y resultados de herramientas
• artifacts_deleted: total de elementos que eliminó el barrido en los directorios de datos que abarca, incluidos los archivos de sesión. Algunos barridos cuentan un árbol de directorios eliminado completo como un solo elemento y algunas pasadas de limpieza no contribuyen al contador, así que trata el valor como un mínimo y no como un recuento exacto de archivos
• files_retained_fresh: archivos inspeccionados y conservados porque aún están dentro del período de retención. Solo los barridos por archivo los cuentan, por lo que el valor es un mínimo; un valor distinto de cero es el estado estable normal
• files_past_cutoff: archivos con una antigüedad mayor que el período de retención que el barrido no pudo eliminar, por ejemplo debido a un error de permisos o a un archivo que se mantiene abierto. El recuento también incluye cada carpeta obsoleta que el barrido encuentra en skills/synced/ o plugins/synced/, tanto si mueve la carpeta a la papelera como si no. Aparte de esas carpetas, un valor mayor que cero significa que hay archivos que sobrevivieron al período de retención configurado; cero no prueba que ninguno lo hiciera, porque una eliminación fallida de un directorio completo cuenta para error_count en su lugar
• error_count: número de errores que encontró el barrido al listar o eliminar archivos

Evento de configuración administrada resuelta

• Establécelo en el bloque env de la configuración administrada, la configuración del usuario o --settings, o en el entorno con el que inicias Claude Code. Un valor en la configuración del proyecto o en la configuración local no lo activa, porque un repositorio clonado puede escribirlas.
• La configuración administrada por el servidor puede establecerlo sin mostrar el cuadro de diálogo de aprobación de seguridad, porque la variable solo agrega la propia política redactada de tu organización a un evento que tu organización ya recibe.

• Todos los atributos estándar
• event.name: "managed_settings_resolved"
• event.timestamp: marca de tiempo ISO 8601
• event.sequence: contador por proceso para ordenar eventos, descrito en Atributos de correlación de eventos
• managed_settings.trigger: "startup" para el evento de inicio de sesión, "change" cuando la configuración administrada o el estado del asistente de políticas cambió más adelante en la sesión, o "refused" cuando una política de configuración administrada detuvo la sesión. Claude Code envía un evento change solo cuando un atributo difiere del último evento que envió, y un valor de ajuste modificado cuenta incluso cuando OTEL_LOG_MANAGED_SETTINGS está desactivado
• error.type: por qué Claude Code detuvo la sesión. Solo está presente en los eventos refused:
  • "helper_failed": una ejecución del asistente de políticas falló
  • "policy_invalid": la configuración administrada contiene un error que impide que Claude Code se inicie, o una fuente de administración no se pudo cargar por un motivo distinto de una lectura denegada, por lo que Claude Code no puede comprobar el inicio de sesión de la organización ni la aplicación de proveedores
  • "provider_not_allowed": la sesión usaría un proveedor de API, o enviaría el tráfico de un proveedor a un host, que la lista administrada allowedProviders no permite. Requiere Claude Code v2.1.285 o posterior
  • "consent_rejected": el usuario rechazó el cuadro de diálogo de aprobación de seguridad de la configuración administrada por el servidor
  • "force_refresh_failed": falló la obtención de la configuración que requiere forceRemoteSettingsRefresh
  • "gateway_rejected": un gateway de Claude apps respondió a la carga de la configuración administrada con HTTP 403
  • "version_below_minimum": esta versión de Claude Code es inferior a requiredMinimumVersion o superior a requiredMaximumVersion
  • "_OTHER": la carga de la configuración administrada del gateway de Claude apps falló por otro motivo
• managed_settings.sources: cada fuente administrada que entrega al menos una clave de política, de mayor a menor prioridad, incluidas las fuentes cuyas claves no surten efecto con first-wins. Los valores son "remote", "plist" o "hklm" para la política de MDM o del sistema operativo, "file" para los archivos de configuración administrada y los archivos complementarios, "parent" cuando un host integrador proporciona la configuración, y "hkcu" para el valor del registro HKCU de Windows cuando Claude Code lo lee. Una fuente que solo contiene claves de control, o que Claude Code no pudo leer, no aparece en la lista. Se emite como un arreglo de cadenas, vacío cuando ninguna fuente administrada entrega una clave de política
• managed_settings.source_behavior: el valor de managedSourcesBehavior que leyó Claude Code, "first-wins" o "merge". "first-wins" cuando ninguna fuente establece la clave
• managed_settings.helper.state: estado del asistente de políticas que configura la fuente de MDM o de archivo seleccionada:
  • "ok": la salida del asistente sirve como configuración administrada
  • "bad_path", "not_a_file", "exit_nonzero", "timed_out", "oversize", "parse_failed", "envelope_invalid" o "schema_rejected": la última ejecución del asistente falló. Fallos del asistente describe los casos
  • "none": no hay ningún asistente configurado, o la fuente que lo configura no es una política de MDM ni un archivo de configuración administrada
• managed_settings.helper.applied: "output" mientras la propia salida del asistente sirve como configuración administrada, "none" cuando no es así
• managed_settings.helper.entry: "policyHelper" cuando Claude Code seleccionó un policyHelper. Ausente cuando no seleccionó ningún asistente
• managed_settings.helper.path: la path configurada del asistente. Está presente siempre que Claude Code seleccionó un asistente, independientemente de si OTEL_LOG_MANAGED_SETTINGS está establecido
• managed_settings.resolved_sha256 (cuando OTEL_LOG_MANAGED_SETTINGS=1): SHA-256 de la configuración administrada resuelta antes de la redacción, serializada como JSON con las claves ordenadas recursivamente y sin espacios en blanco. Las máquinas con el mismo resumen ejecutan la misma política. Claude Code envía el resumen solo con la habilitación explícita porque una política corta se puede recuperar calculando el hash de conjeturas. Ausente cuando no se resolvió ninguna configuración administrada, y en los eventos refused
• managed_settings.settings (cuando OTEL_LOG_MANAGED_SETTINGS=1): los nombres y la estructura de la configuración administrada resuelta como una cadena JSON, con los valores redactados. Ausente en los eventos refused. Claude Code lo construye a partir de su esquema de configuración:
  • Se exporta un nombre de ajuste que el esquema declara, y se omite una clave que no declara
  • Los booleanos, los números y los valores de cadena que el esquema restringe a un conjunto fijo de opciones, como permissions.defaultMode, se exportan tal cual. sandbox.network.httpProxyPort y sandbox.network.socksProxyPort se exportan como "[REDACTED]"
  • Cualquier otra cadena, como model, apiKeyHelper, cada valor de env, cada URL y cada comando, se exporta como "[REDACTED]"
  • Los nombres de las entradas de los mapas, como los nombres de variables de env y los IDs de plugins, se exportan tal cual. Un ajuste cuyas entradas el esquema no tipa, como vimInsertModeRemaps, se exporta como un único "[REDACTED]", y sandbox.ignoreViolations se exporta como una lista de sus listas de rutas sin los patrones de comandos
  • Una lista conserva su longitud, con cada entrada redactada según las mismas reglas
  • Una regla de permissions.allow, permissions.deny o permissions.ask se exporta como el nombre de su herramienta con el contenido redactado, como Read([REDACTED]), cuando la herramienta está integrada en esta versión de Claude Code o es una referencia mcp__ como mcp__jira__create_issue. Cualquier otra regla se exporta como "[REDACTED]"
  • Los hooks siguen las mismas reglas, por lo que se muestran los campos numéricos y de opciones fijas como type y timeout, mientras que cada comando, URL, matcher y condición if se exporta como "[REDACTED]"
  Por ejemplo, una configuración administrada con apiKeyHelper, dos variables de env y una regla de denegación se exporta como {"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}. Claude Code recorta el valor a 8 KB de UTF-8, y el valor recortado no es JSON válido
• managed_settings.settings_truncated (cuando managed_settings.settings está presente): true cuando Claude Code recortó managed_settings.settings a 8 KB, false en caso contrario. Se emite como booleano, no como cadena

Interpretar datos de métricas y eventos

Monitoreo de uso

Monitoreo de costos

• Rastrear tendencias de uso entre equipos o individuos
• Identificar sesiones de alto uso para optimización
• Atribuir gastos a habilidades, plugins, o tipos de subagente específicos a través de los atributos skill.name, plugin.name, y agent.name

Alertas y segmentación

• Picos de costo
• Consumo inusual de tokens
• Alto volumen de sesiones de usuarios específicos

Detectar agotamiento de reintentos

Análisis de eventos

• Herramientas más utilizadas frecuentemente
• Tasas de éxito de herramientas
• Tiempos de ejecución promedio de herramientas
• Patrones de error por tipo de herramienta

Asignar tokens de entrada a las convenciones semánticas GenAI de OpenTelemetry

• input_tokens en el span claude_code.llm_request y en el evento api_request
• El tipo "input" de la métrica claude_code.token.usage

• Desde el span o el evento: suma input_tokens, cache_read_tokens y cache_creation_tokens
• Desde la métrica claude_code.token.usage: suma sus tipos "input", "cacheRead" y "cacheCreation"

• cache_read_tokens corresponde a gen_ai.usage.cache_read.input_tokens
• cache_creation_tokens corresponde a gen_ai.usage.cache_write.input_tokens. Las versiones anteriores de las convenciones nombran el atributo de escritura de caché gen_ai.usage.cache_creation.input_tokens, así que usa el nombre que espera tu backend.

Auditar eventos de seguridad

Atribuir acciones a usuarios

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

Auditar actividad MCP

• tool_result: mantiene mcp_server_scope y un tool_name redactado al literal "mcp_tool" para servidores configurados por el usuario, omite el contenido de los argumentos. Para los servidores integrados de Claude Desktop, en sesiones que Claude Desktop posee, también mantiene el par mcp_server_name/mcp_tool_name dentro de tool_parameters, la misma excepción autorizada por el host que tool_decision
• tool_decision: mantiene tool_source y un tool_name redactado al literal "mcp_tool" para servidores configurados por el usuario, omite el contenido de los argumentos. Para los servidores integrados de Claude Desktop, en sesiones que Claude Desktop posee, también mantiene el par mcp_server_name/mcp_tool_name dentro de tool_parameters
• mcp_server_connection: omite server_name y el mensaje de error, pero mantiene is_plugin, plugin_id_hash, y plugin.name, con nombres de plugins que no son de Anthropic redactados al literal "third-party", por lo que los servidores proporcionados por plugins siguen siendo distinguibles sin registro detallado

Mapear preguntas de seguridad a eventos

Mapear rutas de salida a controles administrados y eventos

• allowedHttpHookUrls: las entradas se combinan entre los archivos de configuración, por lo que un desarrollador puede agregar entradas a una lista administrada vacía. allowManagedHooksOnly decide qué hooks se ejecutan
• managed-mcp.json: para desactivar MCP, consulta Deshabilitar MCP por completo. Para confirmar que Claude Code lee el archivo, consulta Validar la configuración
• Eventos de hooks: Claude Code registra hook_execution_start y hook_execution_complete una vez por evento de hook, abarcando todos los hooks coincidentes. OTEL_LOG_TOOL_DETAILS=1 por sí solo no registra la URL de un hook HTTP. La configuración del hook aparece solo en hook_definitions, que además requiere el tracing beta detallado

Verificar el barrido de retención

• Nadie inicia Claude Code: no se ejecuta ningún barrido, y la máquina conserva sus datos hasta el siguiente inicio
• Una sesión permanece abierta: Claude Code ejecuta el barrido como máximo una vez por sesión
• Una sesión termina antes de tiempo: un barrido que no ha terminado cuando la sesión se cierra no emite nada, y tampoco uno que se detiene por un error inesperado

Enviar eventos a un SIEM

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

Consideraciones de backend

Backends para métricas

• Bases de datos de series temporales: Cálculos de tasa, métricas agregadas
• Almacenes columnares: Consultas complejas, análisis de usuario único
• Plataformas de observabilidad completas: Consultas avanzadas, visualización, alertas

Backends para eventos y registros

• Sistemas de agregación de registros: Búsqueda de texto completo, análisis de registros
• Almacenes columnares: Análisis de eventos estructurados
• Plataformas de observabilidad completas: Correlación entre métricas y eventos

Backends para trazas

• Sistemas de trazas distribuidas: Visualización de spans, cascadas de solicitudes, análisis de latencia
• Plataformas de observabilidad completas: Búsqueda de trazas y correlación con métricas y registros

Información del servicio

• service.name: claude-code para sesiones de terminal, claude-code-desktop para sesiones locales iniciadas desde la pestaña Code en la aplicación Claude Desktop
• service.version: Versión actual de Claude Code, o la versión de la aplicación Desktop para sesiones locales de la pestaña Code
• os.type: Tipo de sistema operativo (por ejemplo, linux, darwin, windows)
• os.version: Cadena de versión del sistema operativo
• host.arch: Arquitectura del host (por ejemplo, amd64, arm64)
• wsl.version: Número de versión de WSL (solo presente cuando se ejecuta en Windows Subsystem for Linux)
• Nombre del Medidor: com.anthropic.claude_code

Recursos de medición de ROI

Seguridad y privacidad

• La exportación de OpenTelemetry a tu backend es opcional y requiere configuración explícita. Para la telemetría operativa separada de Anthropic y cómo deshabilitarla, consulta Uso de datos
• De forma predeterminada, los contenidos de archivos sin procesar y los fragmentos de código no se incluyen en métricas ni eventos. Si estableces una variable como OTEL_LOG_TOOL_DETAILS u OTEL_LOG_RAW_API_BODIES, los eventos pueden incluirlos. Las trazas de span son una ruta de datos separada: consulta la viñeta OTEL_LOG_TOOL_CONTENT a continuación
• Cuando está autenticado a través de OAuth, user.email se incluye en atributos de telemetría, enviados solo al punto final de OTel que configures, nunca a Anthropic. Si esto es una preocupación para tu organización, trabaja con tu backend de telemetría para filtrar o redactar este campo
• El contenido del prompt del usuario no se recopila por defecto. Solo se registra la longitud del prompt. Para incluir el contenido del prompt, establece OTEL_LOG_USER_PROMPTS=1. Cuando está habilitado:
  • Los eventos user_prompt llevan el texto del prompt en dos atributos, prompt y prompt_text. Si eliminas o enmascaras el texto del prompt del evento por nombre de atributo en tu recopilador, nombra ambos atributos en la regla Este procesador attributes de OpenTelemetry Collector elimina ambos atributos en los pipelines que lo incluyen:
    processors:
      attributes/drop-prompt-text:
        actions:
          - key: prompt
            action: delete
          - key: prompt_text
            action: delete
    
  • Con el rastreo activado, el span claude_code.interaction lleva el texto del prompt en su atributo user_prompt
  • Bajo el rastreo beta detallado, los spans también llevan los nuevos mensajes del usuario, resultados de herramientas y recordatorios del sistema enviados con cada solicitud, el texto del prompt del sistema y la salida del modelo. Atributos de contenido bajo el rastreo beta detallado enumera cada atributo. El evento claude_code.system_prompt lleva el prompt del sistema completo
• El texto de respuesta del asistente no se recopila por defecto. Solo se registra la longitud de la respuesta. Para incluir texto de respuesta, establece OTEL_LOG_ASSISTANT_RESPONSES=1. Como todos los datos de OpenTelemetry de Claude Code, el texto de respuesta se envía solo al endpoint de OTel que configures, nunca a Anthropic. Cuando esta variable no está establecida, OTEL_LOG_USER_PROMPTS se utiliza como respaldo, así que establece OTEL_LOG_ASSISTANT_RESPONSES=0 si deseas contenido del prompt sin contenido de respuesta en los eventos. Bajo el rastreo beta detallado, el span claude_code.llm_request sigue llevando la salida del modelo en response.model_output, que sigue a OTEL_LOG_USER_PROMPTS en lugar de a esta variable
• Los argumentos de entrada de herramientas y parámetros no se registran por defecto. Para incluirlos, establece OTEL_LOG_TOOL_DETAILS=1. Para los servidores integrados de Claude Desktop, en sesiones que Claude Desktop posee, tool_decision y tool_result llevan el par mcp_server_name/mcp_tool_name, nombres creados por el host en lugar de contenido de argumentos, incluso con el flag desactivado. Estos datos se envían solo al endpoint de OTEL que configures, nunca a Anthropic. Los argumentos aún pueden contener valores sensibles, así que configura tu backend de telemetría para filtrar o redactar estos atributos según sea necesario. Cuando está habilitado:
  • Los eventos tool_result y tool_decision incluyen un atributo tool_parameters con comandos Bash, nombres de servidor MCP y herramienta, y nombres de skills. Los campos como full_command se emiten sin truncar
  • Los eventos tool_result además incluyen un atributo tool_input con rutas de archivo, URLs, patrones de búsqueda y otros argumentos. Los valores individuales superiores a 512 caracteres se truncan y el total está limitado a aproximadamente 4 K caracteres
  • Los eventos user_prompt incluyen el command_name verbatim para comandos personalizados, de plugin y MCP
  • Los contadores de costo y token y los eventos api_request, api_error y api_refusal llevan nombres reales de agente, skill, plugin y servidor MCP y herramienta en sus atributos de atribución
  • El span claude_code.tool lleva atributos derivados de la entrada como file_path. Bajo el rastreo beta detallado también lleva un atributo tool_input
• El contenido de herramientas no se registra en spans de trazas por defecto. Para incluirlo, establece OTEL_LOG_TOOL_CONTENT=1. El span claude_code.tool entonces lleva un evento de span tool.output con contenidos de archivo sin procesar, salida de comandos Bash, y lo que devuelven herramientas MCP, WebFetch y WebSearch, truncado en el límite de contenido (60 KB por defecto) por atributo. Los resultados de herramientas MCP, WebFetch y WebSearch requieren Claude Code v2.1.283 o posterior. El contenido de herramientas también llega a los spans a través de new_context, cuya puerta difiere por span. Configura tu backend de telemetría para filtrar o redactar estos atributos según sea necesario
• Los cuerpos de solicitud y respuesta de la API de Mensajes de Anthropic sin procesar no se registran por defecto. Para incluirlos, establece OTEL_LOG_RAW_API_BODIES en tu shell, configuración de usuario o configuración administrada. Se ignora en configuración de proyecto y local. Los cuerpos contienen el historial de conversación completo, incluido el mensaje del sistema, cada turno anterior de usuario y asistente, y resultados de herramientas, así que habilitar esto implica consentimiento a todo lo que las otras banderas de contenido OTEL_LOG_* revelarían. Claude Code siempre redacta el contenido de pensamiento extendido de Claude de estos cuerpos, independientemente de otras configuraciones. El valor que estableces determina cómo Claude Code entrega los cuerpos:
  • Con =1, Claude Code emite eventos de registro api_request_body y api_response_body para cada llamada de API. El atributo body de los eventos lleva la carga útil serializada en JSON, truncada en el límite de contenido (60 KB por defecto)
  • Con =file:<dir>, Claude Code escribe cuerpos sin truncar en archivos .request.json y .response.json bajo ese directorio, y los eventos llevan una ruta body_ref en su lugar del cuerpo en línea. Envía el directorio con un recopilador de registros o sidecar en lugar de a través del flujo de telemetría. Para cada respuesta exitosa, Claude Code también añade una línea a index.jsonl en ese directorio, vinculando el archivo de respuesta al archivo de solicitud que lo produjo y al mensaje de transcripción en el que se convirtió. Cada línea no contiene contenido de mensaje, y la sección evento de cuerpo de respuesta de API enumera sus campos. El archivo de índice requiere Claude Code v2.1.274 o posterior

Monitorear Claude Code en Amazon Bedrock