Monitoreo

Documentation Index

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

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

​

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

​

Detalles de configuración

​

Variables de configuración comunes

​

Autenticación mTLS

​

Control de cardinalidad de métricas

​

Trazas (beta)

​

Jerarquía de spans

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (requiere trazado beta detallado)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (herramienta Task) spans de claude_code.llm_request / claude_code.tool del subagente

​

Atributos de spans

​

Encabezados dinámicos

​

Configuración de ajustes

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

​

Requisitos del script

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

​

Comportamiento de actualización

​

Soporte de organización multi-equipo

# 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

# ❌ Inválido - contiene espacios
export OTEL_RESOURCE_ATTRIBUTES="org.name=John's Organization"

# ✅ Válido - usar guiones bajos o camelCase en su lugar
export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

# ✅ Válido - codificar en porcentaje caracteres especiales si es necesario
export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

Configuraciones de ejemplo

# Depuración de consola (intervalos de 1 segundo)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

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

# Prometheus
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

# Múltiples exportadores
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

# Diferentes puntos finales/backends para métricas y registros
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

# Solo métricas (sin eventos/registros)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# Solo eventos/registros (sin 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 y eventos disponibles

​

Atributos estándar

• prompt.id: UUID que correlaciona un mensaje del usuario con todos los eventos posteriores hasta el siguiente mensaje. Consulta Atributos de correlación de eventos.
• workspace.host_paths: directorios de espacio de trabajo del host seleccionados en la aplicación de escritorio, como una matriz de cadenas

​

Métricas

​

Detalles de métricas

​

Contador de sesión

• Todos los atributos estándar
• start_type: Cómo se inició la sesión. Uno de "fresh", "resume", o "continue"

​

Contador de líneas de código

• Todos los atributos estándar
• type: ("added", "removed")

​

Contador de solicitud de extracción

• Todos los atributos estándar

​

Contador de confirmación

• Todos los atributos estándar

​

Contador de costo

• Todos los atributos estándar
• model: Identificador de modelo (por ejemplo, “claude-sonnet-4-6”)
• query_source: Categoría del subsistema que emitió la solicitud. Uno de "main", "subagent", o "auxiliary"
• speed: "fast" cuando la solicitud utilizó modo rápido. Ausente de otra manera
• effort: Nivel de esfuerzo aplicado a la solicitud: "low", "medium", "high", "xhigh", o "max". Ausente cuando el modelo no admite esfuerzo.
• agent.name: Tipo de subagente que emitió la solicitud. Los nombres de agentes integrados y de plugins del mercado oficial aparecen tal cual. Otros nombres de agentes definidos por el usuario se reemplazan con "custom". Ausente cuando la solicitud no fue emitida por un tipo de subagente nombrado.
• skill.name: Habilidad activa para la solicitud, establecida por la herramienta Skill, un comando /, o heredada por un subagente generado. Los nombres de habilidades integradas, agrupadas, definidas por el usuario y de plugins del mercado oficial aparecen tal cual. Los nombres de habilidades de plugins de terceros se reemplazan con "third-party". Ausente cuando no hay habilidad activa.
• plugin.name: Plugin propietario cuando la habilidad activa o subagente es proporcionado por un plugin. Los nombres de plugins del mercado oficial aparecen tal cual. Los nombres de plugins de terceros se reemplazan con "third-party". Ausente cuando ni la habilidad ni el subagente tienen un plugin propietario.
• marketplace.name: Mercado desde el que se instaló el plugin propietario. Solo se emite para plugins del mercado oficial. Ausente de otra manera.

​

Contador de tokens

• Todos los atributos estándar
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Identificador de modelo (por ejemplo, “claude-sonnet-4-6”)
• query_source: Categoría del subsistema que emitió la solicitud. Uno de "main", "subagent", o "auxiliary"
• speed: "fast" cuando la solicitud utilizó modo rápido. Ausente de otra manera
• effort: Nivel de esfuerzo aplicado a la solicitud. Consulta Contador de costo para detalles.
• agent.name, skill.name, plugin.name, marketplace.name: Atribución de habilidad, plugin y agente para la solicitud. Consulta Contador de costo para definiciones y comportamiento de redacción.

​

Contador de decisión de herramienta 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: Fuente de 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 de teclado, "cli" para ejecución de herramientas y respuestas de IA

​

Eventos

​

Atributos de correlación de eventos

​

Evento de mensaje del usuario

• Todos los atributos estándar
• event.name: "user_prompt"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• prompt_length: Longitud del mensaje
• prompt: Contenido del mensaje (redactado por defecto, habilitar con OTEL_LOG_USER_PROMPTS=1)
• command_name: Nombre del comando cuando el mensaje invoca uno. Los nombres de comandos integrados y agrupados como compact o debug se emiten tal cual; los alias como reset se emiten como se escribieron en lugar del nombre canónico. Los nombres de comandos personalizados, de plugin y MCP se contraen a custom o mcp a menos que OTEL_LOG_TOOL_DETAILS=1 esté establecido
• command_source: Origen del comando cuando está presente: builtin, custom, o mcp. Los comandos proporcionados por plugins reportan como custom

​

Evento de resultado de herramienta

• Todos los atributos estándar
• event.name: "tool_result"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• tool_name: Nombre de la herramienta
• tool_use_id: Identificador único para esta invocación de herramienta. Coincide con el tool_use_id pasado a hooks, permitiendo correlación entre eventos OTel y datos capturados por hooks.
• 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: Ya sea "accept" o "reject"
• decision_source: Fuente de 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.
• tool_input_size_bytes: Tamaño de la entrada de herramienta serializada en JSON en bytes
• tool_result_size_bytes: Tamaño del resultado de la herramienta en bytes
• mcp_server_scope: Identificador de alcance del servidor MCP (para herramientas MCP)
• tool_parameters (cuando OTEL_LOG_TOOL_DETAILS=1): Cadena JSON que contiene parámetros específicos de la herramienta:
  • Para herramienta Bash: incluye bash_command, full_command, timeout, description, dangerouslyDisableSandbox, y git_commit_id (el SHA del commit, cuando un comando git commit tiene éxito)
  • Para herramientas MCP: incluye mcp_server_name, mcp_tool_name
  • Para herramienta Skill: incluye skill_name
  • Para herramienta Task: incluye subagent_type
• tool_input (cuando OTEL_LOG_TOOL_DETAILS=1): Argumentos de herramienta serializados en JSON. Los valores individuales superiores a 512 caracteres se truncan, y la carga útil completa está limitada a aproximadamente 4 K caracteres. Se aplica a todas las herramientas, incluidas las herramientas MCP.

​

Evento de solicitud de API

• Todos los atributos estándar
• event.name: "api_request"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• model: Modelo utilizado (por ejemplo, “claude-sonnet-4-6”)
• cost_usd: Costo estimado en USD
• duration_ms: Duración de la solicitud en milisegundos
• input_tokens: Número de tokens de entrada
• output_tokens: Número de tokens de salida
• cache_read_tokens: Número de tokens leídos del caché
• cache_creation_tokens: Número de tokens utilizados para la creación del caché
• request_id: ID de solicitud de API de Anthropic del encabezado request-id de la respuesta, como "req_011...". Presente solo cuando la API devuelve uno.
• speed: "fast" o "normal", indicando si el modo rápido estaba activo
• query_source: Subsistema que emitió la solicitud, como "repl_main_thread", "compact", o un nombre de subagente
• effort: Nivel de esfuerzo aplicado a la solicitud: "low", "medium", "high", "xhigh", o "max". Ausente cuando el modelo no admite esfuerzo.

​

Evento de error de API

• Todos los atributos estándar
• event.name: "api_error"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• model: Modelo utilizado (por ejemplo, “claude-sonnet-4-6”)
• error: Mensaje de error
• status_code: Código de estado HTTP como número. Ausente para errores no HTTP como fallos de conexión.
• duration_ms: Duración de la solicitud en milisegundos
• attempt: Número total de intentos realizados, incluyendo la solicitud inicial (1 significa que no ocurrieron reintentos)
• request_id: ID de solicitud de API de Anthropic del encabezado request-id de la respuesta, como "req_011...". Presente solo cuando la API devuelve uno.
• speed: "fast" o "normal", indicando si el modo rápido estaba activo
• query_source: Subsistema que emitió la solicitud, como "repl_main_thread", "compact", o un nombre de subagente
• effort: Nivel de esfuerzo aplicado a la solicitud. Ausente cuando el modelo no admite esfuerzo.

​

Evento de cuerpo de solicitud de API

• Todos los atributos estándar
• event.name: "api_request_body"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• body: Parámetros de solicitud de API de Mensajes serializados en JSON (mensaje del sistema, mensajes, herramientas, etc.), truncados en 60 KB. El contenido de pensamiento extendido en turnos de asistente anteriores 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 ocurrió truncamiento en línea. Ausente en modo de archivo y cuando no ocurrió truncamiento.
• model: Identificador de modelo de los parámetros de solicitud
• query_source: Subsistema que emitió la solicitud (por ejemplo, "compact")

​

Evento de cuerpo de respuesta de API

• Todos los atributos estándar
• event.name: "api_response_body"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• body: Respuesta de API de Mensajes serializada en JSON (id, bloques de contenido, uso, razón de parada), truncada en 60 KB. 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 ocurrió truncamiento en línea. Ausente en modo de archivo y cuando no ocurrió truncamiento.
• model: Identificador de modelo
• query_source: Subsistema que emitió la solicitud
• request_id: ID de solicitud de API de Anthropic del encabezado request-id de la respuesta, como "req_011...". Presente solo cuando la API devuelve uno.

​

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 monotónicamente creciente para ordenar eventos dentro de una sesión
• tool_name: Nombre de la herramienta (por ejemplo, “Read”, “Edit”, “Write”, “NotebookEdit”)
• tool_use_id: Identificador único para esta invocación de herramienta. Coincide con el tool_use_id pasado a hooks, permitiendo correlación entre eventos OTel y datos capturados por hooks.
• decision: Ya sea "accept" o "reject"
• source: Fuente de decisión:
  • "config": Decidido automáticamente sin solicitar, basado en configuración del proyecto, reglas de permiso en la configuración personal del usuario, política administrada empresarial, banderas --allowedTools o --disallowedTools, el modo de permiso activo, una concesión con alcance de sesión de un mensaje anterior en la misma sesión de CLI interactiva, o porque la herramienta es inherentemente segura. El evento no indica cuál de estas fuentes coincidió.
  • "hook": Un hook PreToolUse o PermissionRequest devolvió la decisión.
  • "user_permanent": Se emite cuando el usuario eligió “Sí, y no preguntes de nuevo para …” en un mensaje de permiso, que guarda una regla de permiso en su configuración personal. En la CLI interactiva esto se emite solo para esa opción en sí; las llamadas posteriores que coincidan con la regla guardada emiten "config" en su lugar. En sesiones del SDK de Agent o no interactivas -p, tanto la opción inicial como las coincidencias de regla posteriores emiten "user_permanent". Se trata como una aceptación.
  • "user_temporary": Se emite cuando el usuario eligió “Sí” en un mensaje de permiso para una aprobación única, o eligió una de las opciones ”… durante esta sesión” en un mensaje de edición o lectura de archivo. En la CLI interactiva esto se emite solo para la opción en sí; las llamadas posteriores permitidas por esa concesión con alcance de sesión emiten "config" en su lugar. En sesiones del SDK de Agent o no interactivas -p, tanto la opción como las coincidencias posteriores emiten "user_temporary". Se trata como una aceptación.
  • "user_abort": Se emite cuando el usuario descartó el mensaje de permiso sin responder. Se trata como un rechazo.
  • "user_reject": Se emite cuando el usuario eligió “No” cuando se le solicitó, o una llamada coincidió con una regla de denegación en su configuración personal. Se trata como un rechazo.

​

Evento de cambio de modo de permiso

• Todos los atributos estándar
• event.name: "permission_mode_changed"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• from_mode: El modo de permiso anterior, por ejemplo "default", "plan", "acceptEdits", "auto", o "bypassPermissions"
• to_mode: El nuevo modo de permiso
• trigger: Qué causó el cambio. Uno de "shift_tab", "exit_plan_mode", "auto_gate_denied", o "auto_opt_in". Ausente cuando la transición se origina del SDK o puente

​

Evento de autenticación

• Todos los atributos estándar
• event.name: "auth"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• action: "login" o "logout"
• success: "true" o "false"
• auth_method: Método de autenticación, como "oauth"
• error_category: Tipo de error categórico 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 del servidor MCP

• Todos los atributos estándar
• event.name: "mcp_server_connection"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• 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ó
• server_name (cuando OTEL_LOG_TOOL_DETAILS=1): Nombre del servidor configurado
• 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 monotónicamente creciente para ordenar eventos dentro de una sesión
• error_name: Nombre de la clase de 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 monotónicamente creciente para ordenar eventos dentro de una sesión
• marketplace.is_official: "true" si el mercado es un mercado oficial de Anthropic, "false" de otra manera
• install.trigger: "cli" o "ui"
• plugin.name: Nombre del plugin instalado. Para mercados de terceros esto se incluye solo cuando OTEL_LOG_TOOL_DETAILS=1
• plugin.version: Versión del plugin cuando se declara en la entrada del mercado. Para mercados de terceros esto se incluye solo cuando OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: Mercado desde el que se instaló el plugin. Para mercados de terceros esto 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 monotónicamente creciente para ordenar eventos dentro de una sesión
• plugin.name: nombre del plugin. Para plugins fuera del mercado oficial y paquete integrado el valor es "third-party" a menos que OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: mercado desde el que se instaló el plugin, cuando se conoce. Redactado a "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 para el plugin: "official", "org", "user-local", o "default-bundle"
• enabled_via: cómo el plugin llegó a estar habilitado: "default-enable", "org-policy", "seed-mount", o "user-install"
• plugin_id_hash: hash determinista del nombre del plugin y mercado, enviado solo a tu exportador configurado. Te permite contar cuántos plugins de terceros distintos se cargan en tu flota sin registrar sus nombres
• has_hooks: si el plugin contribuye hooks
• has_mcp: si el plugin contribuye servidores MCP
• skill_path_count: número de directorios de habilidades 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

​

Evento de habilidad activada

• Todos los atributos estándar
• event.name: "skill_activated"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• skill.name: Nombre de la habilidad. Para habilidades definidas por el usuario y de plugin de terceros el valor es el marcador de posición "custom_skill" a menos que OTEL_LOG_TOOL_DETAILS=1
• invocation_trigger: Cómo se activó la habilidad ("user-slash", "claude-proactive", o "nested-skill")
• skill.source: De dónde se cargó la habilidad (por ejemplo, "bundled", "userSettings", "projectSettings", "plugin")
• plugin.name (cuando OTEL_LOG_TOOL_DETAILS=1 o el plugin es de un mercado oficial): Nombre del plugin propietario cuando la habilidad es proporcionada por un plugin
• marketplace.name (cuando OTEL_LOG_TOOL_DETAILS=1 o el plugin es de un mercado oficial): Mercado desde el que se instaló el plugin propietario, cuando la habilidad es proporcionada por un plugin

​

Evento de mención @

• Todos los atributos estándar
• event.name: "at_mention"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• mention_type: Tipo de mención ("file", "directory", "agent", "mcp_resource")
• success: Si la mención se resolvió exitosamente ("true" o "false")

​

Evento de reintentos de API agotados

• Todos los atributos estándar
• event.name: "api_retries_exhausted"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• model: Modelo utilizado
• error: Mensaje de error final
• status_code: Código de estado HTTP como número. Ausente para errores no HTTP.
• total_attempts: Número total de intentos realizados
• total_retry_duration_ms: Tiempo total de pared en 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 monotónicamente creciente para ordenar eventos dentro de una sesión
• hook_event: tipo de evento de hook, como "PreToolUse" o "PostToolUse"
• hook_type: tipo de implementación de hook: "command", "prompt", "mcp_tool", "http", o "agent"
• hook_source: dónde se define el hook: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings", o "pluginHook"
• hook_matcher (cuando OTEL_LOG_TOOL_DETAILS=1): la cadena de coincidencia de la configuración del hook, cuando se establece una
• plugin.name (cuando hook_source es "pluginHook"): nombre del plugin contribuyente. Para plugins fuera del mercado oficial y 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 mercado, enviado solo a tu exportador configurado. Te permite contar plugins contribuyentes distintos sin registrar sus nombres

​

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 monotónicamente creciente para ordenar eventos dentro de una sesión
• hook_event: Tipo de evento de hook, como "PreToolUse" o "PostToolUse"
• hook_name: Nombre completo del hook incluyendo coincidencia, 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"
• hook_definitions: Configuración de hook serializada en JSON. Se incluye solo cuando tanto el trazado beta detallado como OTEL_LOG_TOOL_DETAILS=1 están habilitados

​

Evento de ejecución de hook completado

• Todos los atributos estándar
• event.name: "hook_execution_complete"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• hook_event: Tipo de evento de hook
• hook_name: Nombre completo del hook incluyendo coincidencia
• num_hooks: Número de comandos de hook coincidentes
• num_success: Recuento que se completó exitosamente
• num_blocking: Recuento que devolvió una decisión de bloqueo
• num_non_blocking_error: Recuento que falló sin bloquear
• num_cancelled: Recuento cancelado antes de completarse
• total_duration_ms: Duración de pared de todos los hooks coincidentes
• managed_only: "true" cuando solo se permiten hooks de política administrada
• hook_source: "policySettings" o "merged"
• hook_definitions: Configuración de hook serializada en JSON. Se incluye solo cuando tanto el trazado beta detallado como OTEL_LOG_TOOL_DETAILS=1 están habilitados

​

Evento de compactación

• Todos los atributos estándar
• event.name: "compaction"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• trigger: "auto" o "manual"
• success: "true" o "false"
• duration_ms: Duración de compactación
• pre_tokens: Recuento aproximado de tokens antes de compactación
• post_tokens: Recuento aproximado de tokens después de compactación
• error: Mensaje de error cuando la compactación falló

​

Evento de encuesta de retroalimentación

• Todos los atributos estándar
• event.name: "feedback_survey"
• event.timestamp: Marca de tiempo ISO 8601
• event.sequence: Contador monotónicamente creciente para ordenar eventos dentro de una sesión
• 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 mensaje de calificación “¿Cómo está Claude?”
• response: La selección del usuario en eventos responded
• enabled_via_override: true cuando CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL está establecido. Se emite como booleano, no como cadena. Presente en eventos de encuesta session. Filtra en este atributo para confirmar que la anulación se aplica en toda una flota

​

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

​

Consideraciones de backend

​

Para métricas

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

​

Para eventos/registros

• Sistemas de agregación de registros (por ejemplo, Elasticsearch, Loki): Búsqueda de texto completo, análisis de registros
• Almacenes columnares (por ejemplo, ClickHouse): Análisis de eventos estructurados
• Plataformas de observabilidad completas (por ejemplo, Honeycomb, Datadog): Correlación entre métricas y eventos

​

Para trazas

• Sistemas de trazas distribuidas (por ejemplo, Jaeger, Zipkin, Grafana Tempo): Visualización de spans, cascadas de solicitudes, análisis de latencia
• Plataformas de observabilidad completas (por ejemplo, Honeycomb, Datadog): Búsqueda de trazas y correlación con métricas y registros

​

Información del servicio

• service.name: claude-code
• service.version: Versión actual de Claude 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
• Los contenidos de archivos sin procesar y fragmentos de código no se incluyen en métricas o eventos. 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. 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 mensaje del usuario no se recopila por defecto. Solo se registra la longitud del mensaje. Para incluir contenido del mensaje, establece OTEL_LOG_USER_PROMPTS=1
• Los argumentos de entrada de herramientas y parámetros no se registran por defecto. Para incluirlos, establece OTEL_LOG_TOOL_DETAILS=1. Cuando está habilitado, los eventos tool_result incluyen un atributo tool_parameters con comandos Bash, nombres de servidor MCP y herramienta, y nombres de skills, más un atributo tool_input con rutas de archivo, URLs, patrones de búsqueda y otros argumentos. Los eventos user_prompt incluyen el command_name verbatim para comandos personalizados, de plugin y MCP. Los spans de traza incluyen el mismo atributo tool_input y atributos derivados de entrada como file_path. Los valores individuales superiores a 512 caracteres se truncan y el total está limitado a aproximadamente 4 K caracteres, pero los argumentos aún pueden contener valores sensibles. Configura tu backend de telemetría para filtrar o redactar estos atributos según sea necesario
• El contenido de entrada y salida de herramientas no se registra en spans de trazas por defecto. Para incluirlo, establece OTEL_LOG_TOOL_CONTENT=1. Cuando está habilitado, los eventos de span incluyen contenido completo de entrada y salida de herramientas truncado en 60 KB por span. Esto puede incluir contenidos de archivo sin procesar de resultados de herramienta Read y salida de comandos Bash. 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. Con =1, cada llamada de API emite eventos de registro api_request_body y api_response_body cuyo atributo body es la carga útil serializada en JSON, truncada en 60 KB. Con =file:<dir>, los cuerpos sin truncar se escriben 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. En ambos modos, los cuerpos contienen el historial de conversación completo (mensaje del sistema, cada turno anterior de usuario y asistente, resultados de herramientas), por lo que habilitar esto implica consentimiento a todo lo que las otras banderas de contenido OTEL_LOG_* revelarían. El contenido de pensamiento extendido de Claude siempre se redacta de estos cuerpos independientemente de otras configuraciones

​

Monitorear Claude Code en Amazon Bedrock