For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the complete content index is available at https://we0.ai/llms.txt, the full English article bundle is available at https://we0.ai/llms-full.txt, and this page is available as Markdown at https://we0.ai/es/articles/claude-opentelemetry-tracing-api-and-sdk-4adbbb12.md.
Anthropic ha introducido la exportación de trazas OpenTelemetry para Claude Managed Agents, la API Messages y los SDK de Claude. Anunciada e...
Anthropic ha introducido la exportación de trazas OpenTelemetry para Claude Managed Agents, la API Messages y los SDK de Claude. Anunciada el 14 de octubre de 2026, la función está en beta pública y envía datos de trazado estándar a plataformas de observabilidad que aceptan OTLP.
El objetivo es práctico: seguir las llamadas al modelo y la actividad de herramientas de un agente junto con la aplicación que lo invocó. En lugar de investigar la latencia, los fallos y el uso de tokens en lugares separados, un equipo puede inspeccionar los spans relevantes en su sistema de observabilidad existente.
Una traza registra el recorrido de una solicitud a través de un sistema. Un span registra una operación dentro de ese recorrido, como una llamada al modelo o una ejecución de herramienta. Los spans de Claude siguen las convenciones semánticas de GenAI de OpenTelemetry, lo que ayuda a las herramientas compatibles a interpretar datos entre distintos proveedores de modelos.
Fuente: Anthropic. El diagrama ilustra la estructura de las trazas y los flujos de análisis, no resultados de rendimiento medidos.
Existen dos formas complementarias de recopilar los datos:
| Capacidad | Trazado de SDK | Trazado de API |
|---|---|---|
| Configuración | Código de la aplicación y proveedor de trazador | Destino en la Consola de Claude |
| Permiso especial de Claude | Ninguno | Rol de administrador para añadir o modificar destinos |
| Ejecuciones de modelo dentro de una solicitud | No se exponen individualmente solo mediante el trazado de SDK | Incluidas |
| Turnos de Managed Agents | No se exponen solo mediante el trazado de SDK | Incluidos |
| Herramientas ejecutadas por la API | No se exponen solo mediante el trazado de SDK | Incluidas |
| Herramientas del cliente ejecutadas por el ejecutor de herramientas del SDK | Incluidas | No se capturan solo mediante el trazado de API |
| Herramientas en un entorno aislado autoalojado | Incluidas mediante el worker compatible del SDK | No se capturan solo mediante el trazado de API |
| Otras operaciones de API del cliente, como cargas de archivos | Incluidas | No se capturan solo mediante el trazado de API |
Ambas rutas registran spans de solicitud y uso de tokens. Juntas, proporcionan visibilidad sobre el trabajo del cliente y sobre el trabajo realizado dentro de la API de Claude. Enviar ambas al mismo backend también permite que este muestre su relación.
El trazado de API no requiere cambiar el código habitual de las solicitudes simplemente para recibir trazas de API independientes. Un administrador añade un destino que especifica dónde debe enviarlas Claude.
anthropic.test.service.name = claude-platform.Para un destino personalizado, el requisito documentado es un endpoint OTLP/HTTP que acepte protobuf en un nombre de host HTTPS en el puerto 443. Un Collector que escuche únicamente en su puerto habitual 4318 necesita una exposición HTTPS adecuada o un proxy inverso. Las credenciales deben incluirse en los valores de las cabeceras.
El endpoint base normalmente omite /v1/traces, porque Claude lo añade. Un endpoint avanzado de trazas puede sobrescribir la ruta, pero debe usar el mismo host. Los endpoints de direcciones privadas y las redirecciones no son compatibles como destinos normales de entrega.
El trazado de SDK comienza instalando un SDK de Claude compatible y actualizado, y registrando un proveedor de trazador de OpenTelemetry antes de la primera llamada que se vaya a trazar. La aplicación proporciona el exportador que entrega los spans al backend de observabilidad. Por ello, la “exportación automática del SDK” no significa que una aplicación nueva envíe datos a algún destino sin un proveedor de trazador y un exportador de destino.
Un exportador de consola puede ayudar a comprobar la instrumentación local antes de conectar una plataforma remota. Una vez configurado, el SDK emite spans de solicitud y spans para las herramientas ejecutadas mediante su ejecutor de herramientas. Las llamadas realizadas dentro de un span de aplicación pueden anidarse bajo ese span.
Durante la beta, las opciones del SDK, los nombres de spans y los atributos pueden cambiar. Anthropic recomienda fijar la versión del SDK para que los equipos puedan decidir cuándo adoptar esos cambios.
El SDK propaga el contexto de trazado para que los spans del servidor de la API puedan situarse debajo de los spans del cliente del SDK. Las solicitudes a Claude Platform on AWS son una excepción: los spans de API aparecen en sus propias trazas porque esa plataforma todavía no admite el mismo comportamiento de unión de contexto de trazado.
Las sesiones de Managed Agents exponen spans de solicitud de la API Sessions, spans de turnos de agente, solicitudes de modelo, herramientas ejecutadas por la API y evaluaciones de resultados. Una sesión puede abarcar varias trazas y, en operaciones multiagente, varios hilos. La documentación recomienda agrupar por anthropic.session.id para una sesión o por gen_ai.conversation.id para un hilo.
Claude Code, el Agent SDK y Cowork tienen su propia documentación de monitorización. La nueva función de plataforma no debe considerarse un reemplazo de las instrucciones de instrumentación existentes para cada producto.
Cada destino de Consola y cliente SDK tiene un modo de contenido. El modo predeterminado, Solo metadatos, incluye identificadores, tiempos, estado, recuentos de tokens y texto descriptivo seleccionado, como nombres de herramientas, descripciones de herramientas y nombres de servidores MCP. Excluye los prompts y las respuestas del modelo, pero no garantiza que cada campo exportado esté libre de texto proporcionado por la aplicación.
El modo de Contenido completo también incluye prompts y respuestas. Esto resulta útil para depurar interacciones fallidas y crear evaluaciones a partir de tráfico real, pero traslada el contenido de las conversaciones a otro sistema con sus propios ajustes de acceso y retención.
El límite de contenido predeterminado es de 0,75 MB por span. Anthropic indica que esto admite aproximadamente un contexto en inglés de 200.000 tokens y se mantiene por debajo del límite de solicitud de 1 MB utilizado por muchos servicios de observabilidad y proxies. Un contexto completo de un millón de tokens puede requerir aproximadamente 4 MB, por lo que el valor predeterminado no basta para conservar cada prompt grande de forma íntegra.
Cuando un span supera su límite de contenido, el SDK o la API lo acorta y establece anthropic.content.truncated en true. Los spans de solicitud descartan primero el prompt del sistema y los mensajes más antiguos; los spans de herramientas descartan bloques desde el final del resultado de la herramienta. Las imágenes y los documentos aparecen por tipo, en lugar de incluir sus cargas multimedia completas.
El SDK utiliza traces.max_content_bytes para controlar el límite. Los destinos de Consola muestran un tamaño máximo de contenido en la configuración avanzada, y los proveedores de la lista pueden tener un valor predeterminado específico del proveedor.
Describe tu idea una vez y We0 AI puede generar un sitio de presentacion, paginas y CMS, y ayudarte a atraer clientes y trafico tras el lanzamiento.
Una generación completa de proyectos para registro gratuito
Lo mejor para probar un flujo de generación completo y ver rápidamente el primer borrador del proyecto.
Las organizaciones con restricciones de gestión de datos HIPAA, FERPA o K–12 con Anthropic exportan solo metadatos mediante destinos de API, independientemente del modo de contenido seleccionado. La documentación indica que esta restricción no se aplica a los spans de SDK, por lo que la configuración del SDK aún necesita una revisión independiente.
La exportación de contenido completo puede utilizarse con solicitudes elegibles de la API Messages con retención cero de datos, porque la API mantiene el contenido de exportación en memoria hasta su entrega. Managed Agents no es elegible para retención cero de datos, y habilitar OpenTelemetry no modifica sus condiciones de retención.
Una solicitud puede situar su uso de tokens en varios spans. Por tanto, sumar todos los spans de la traza puede sobrestimar el uso.
Cuando existen spans de SDK y de API para una solicitud de la API Messages, utilice la fuente de API. Dentro de esa fuente, sume los spans de solicitud o sus spans de solicitud de modelo, pero no ambos; tenga en cuenta la compactación mediante las reglas específicas de la documentación. Para Managed Agents, los spans de API relevantes son las solicitudes de modelo y las evaluaciones de resultados.
Los reintentos de entrega también pueden producir spans duplicados. Deduplice utilizando el ID de traza y el ID de span si el backend no lo hace ya.
Las trazas exportadas son un registro de depuración, no un libro mayor de facturación completo y garantizado. La entrega se realiza con el mejor esfuerzo y el muestreo puede omitir solicitudes. Anthropic dirige a los equipos que necesitan un seguimiento completo de uso por clave de API a la API Usage.
Anthropic menciona Grafana Cloud, Honeycomb, Sentry y Splunk para visualizar trazas de agentes junto con registros y métricas de aplicación. También enumera Arize AI, Braintrust, Datadog, Langfuse, LangSmith, New Relic y PostHog para flujos de trabajo que conectan las trazas con evaluaciones y mejoras de calidad. Databricks Unity Gateway se destaca por aportar visibilidad a nivel de organización.
Estos son ejemplos, no una lista exclusiva de compatibilidad. Otras herramientas pueden recibir los datos si aceptan la exportación OTLP estándar requerida.
El anuncio incluye declaraciones de clientes de Foxglove, Ramp, Sterling Labs y FloQast. Sus casos de uso incluyen depuración de robótica, análisis de agentes de mercado y trazado de flujos de trabajo contables.
Ramp describe un sistema interno llamado Reflect que puntúa las trazas de Langfuse y propone correcciones. Su ingeniero informa de un uso de tokens entre un 10 % y un 20 % menor y de sesiones un 30 % más rápidas en algunos agentes. Son resultados comunicados por un cliente de ese flujo de mejora; no constituyen una promesa de que habilitar únicamente la exportación de trazas genere esas ganancias.
Envía spans estándar que describen solicitudes de API de Claude, turnos de agentes, llamadas de modelo y actividad de herramientas compatibles a un backend de observabilidad. La función está en beta pública y admite rutas independientes de trazado de API y SDK.
Necesita el rol de administrador para añadir o modificar destinos de trazado de API en la Consola de Claude. El trazado de SDK se configura en el código de la aplicación y no requiere un permiso especial de organización de Claude.
No, el modo predeterminado es Solo metadatos. Contenido completo añade prompts y respuestas, sujeto a los límites de contenido y las restricciones documentadas para organizaciones concretas.
Sí, siempre que el destino de API cumpla los requisitos documentados de red y protocolo. En particular, la exportación de API necesita un receptor OTLP/HTTP protobuf accesible mediante un nombre de host HTTPS público en el puerto 443, en lugar de depender únicamente de un listener Collector privado.
Sí, cuando se propaga el contexto de trazado y los spans llegan al mismo backend de observabilidad. Los spans de API para solicitudes a Claude Platform on AWS aparecen actualmente en sus propias trazas.
No, las trazas pueden ser muestreadas, perderse o entregarse más de una vez. Utilice las reglas de recuento documentadas para el análisis y la API Usage cuando necesite una contabilidad completa del uso.
La beta de OpenTelemetry de Claude conecta las llamadas al modelo y las herramientas de los agentes con los sistemas de trazado que los equipos ya utilizan. El trazado de API expone la actividad del lado del servidor, mientras que el trazado de SDK añade operaciones y herramientas del cliente; combinarlos proporciona la cronología de aplicación más clara donde se admite la unión de trazas.
Elija deliberadamente los modos de contenido, compruebe el truncamiento y el estado de entrega, y cuente los tokens desde una única fuente apropiada. El trazado mejora la visibilidad, pero la contabilidad completa del uso y los controles de retención siguen siendo responsabilidades independientes.
Empieza con una sola frase y obtén un sitio completo en minutos.
