El 14 de octubre de 2026, ClaudeDevs anunció la beta pública de trazas OpenTelemetry para Claude Platform: abarca Messages API, Claude Managed Agents y los SDK de Claude. La función ofrece dos rutas —instrumentación en la aplicación y trazado de API desde Claude Console— con alcances distintos; Anthropic la mantiene en beta y la sujeta al acuerdo del cliente, incluida la sección Beta Services de sus Service Specific Terms (descripción general de Anthropic).
Qué actividad registra cada ruta
Una traza reúne spans: unidades que representan operaciones dentro de una petición. El trazado del SDK genera esos datos desde la aplicación del cliente; el de API, configurado en Claude Console, añade actividad que ocurre dentro de Claude Platform. Por eso, no son dos interruptores para ver exactamente lo mismo.
| Aspecto | Trazado del SDK | Trazado de API en Console |
| Dónde se configura | En la aplicación, con un proveedor de trazado y el exportador de OpenTelemetry de la propia aplicación. | En Claude Console, al añadir un destino de observabilidad. |
| Permisos | No requiere un permiso especial de Console. | Hace falta un rol de administrador de la organización para añadir o modificar destinos. |
| Actividad visible | Peticiones a Messages API y uso de tokens; también herramientas ejecutadas por el cliente mediante el ejecutor del SDK. | Peticiones a Messages API, ejecuciones individuales del modelo, turnos de Managed Agents y herramientas ejecutadas en el servidor. |
| Cambio en la aplicación | Hay que configurar el trazado en el código de la aplicación. | No hace falta cambiar el código de la aplicación para exportar los spans de API. |
En la práctica, el SDK ayuda a seguir el trabajo que controla tu aplicación, incluidas sus herramientas de cliente; el trazado de API permite observar operaciones internas del servicio, como ejecuciones del modelo y herramientas del servidor. Si necesitas ambas perspectivas, se pueden combinar. En las peticiones compatibles de Claude Platform, la propagación del contexto puede vincular los spans en una misma traza. Las trazas de API en AWS empiezan en trazas separadas porque AWS aún no admite la cabecera traceparent en este contexto. Anthropic describe los alcances en su guía general de OpenTelemetry.
Registro del proveedor y peticiones en streaming
En el SDK, registra el proveedor de trazado antes de la primera petición que quieras observar; las llamadas anteriores no quedan cubiertas retroactivamente. En una respuesta en streaming, el span termina cuando la aplicación consume o cierra el flujo. Si has activado el modo de contenido, la respuesta se incluye cuando lees el flujo con messages.stream(). Es un detalle pequeño que puede marcar la diferencia al interpretar una traza que termina antes de que la aplicación haya acabado de procesar la respuesta (guía del SDK de Anthropic).
Anthropic incluye el trazado del SDK en beta para Claude API, Claude Platform en AWS, Amazon Bedrock, Google Cloud y Microsoft Foundry. El trazado de API configurado en Console figura para Claude API y Claude Platform en AWS. Esa diferencia importa: la lista de plataformas compatibles con el SDK no se extiende automáticamente a la configuración de API en Console.
Metadatos o contenido completo
El modo predeterminado exporta solo metadatos. Si eliges contenido completo, los spans pueden incluir prompts y respuestas; además, cada destino y cada cliente del SDK permite configurar el modo por separado. El proveedor de observabilidad que recibe los datos aplica sus propios controles de acceso y conservación.
Anthropic fija por defecto un máximo de 0,75 MB por span de contenido completo. Si se supera, el contenido se acorta y el span queda marcado con anthropic.content.truncated=true. En spans de petición se eliminan primero el prompt del sistema y los mensajes más antiguos; en los de herramientas, se recortan bloques del final del resultado. Las imágenes y los documentos aparecen identificados por su tipo. La documentación estima que un contexto de un millón de tokens ocupa alrededor de 4 MB, por encima de ese límite predeterminado.
También hay condiciones específicas para ciertos tratamientos de datos: en organizaciones sujetas a restricciones HIPAA, FERPA o K-12 con Anthropic, los destinos de Console exportan solo metadatos, con independencia del modo configurado. Esa restricción de destinos no afecta a los spans del SDK. Con retención cero de datos, el contenido completo sigue disponible para el trazado de Messages API y Anthropic lo mantiene en memoria hasta entregarlo; Claude Managed Agents no reúne los requisitos para retención cero y OpenTelemetry no modifica su conservación.
Configurar un destino en Console
Para el trazado de API, un administrador añade el destino, selecciona un proveedor compatible o la opción personalizada, indica el endpoint y las cabeceras de autenticación, elige el modo de contenido y los workspaces que cubrirá, y prueba la entrega. El receptor debe aceptar OTLP/HTTP con protobuf en una dirección HTTPS por el puerto 443. Anthropic añade /v1/traces a la URL base, salvo que se configure una ruta específica de trazas; cada destino admite hasta 1.000 workspaces seleccionados, y una organización puede configurar hasta 10 destinos y 20 cabeceras por destino.
Los tiempos de respuesta también cuentan: la negociación TLS debe completarse en cinco segundos y el endpoint debe devolver las cabeceras de respuesta en otros cinco; cada entrega tiene un límite total de diez segundos. La prueba de destino busca un span anthropic.test, mientras que los spans de API pueden localizarse con service.name=claude-platform (guía de trazado de API de Anthropic).
Las trazas no son un registro completo de uso
Anthropic describe la entrega como de mejor esfuerzo y con entrega al menos una vez: puede perderse un span o recibirse duplicado. Por eso, sus trazas no forman un registro completo de uso; Anthropic recomienda la Usage API para seguir el uso de las claves de API. Si la entrega es importante para operar el servicio, conviene tener presente que los duplicados pueden deduplicarse con el ID de traza y el ID de span, pero los spans perdidos no se pueden reenviar.
La beta también puede cambiar: Anthropic advierte de posibles cambios incompatibles en las opciones del SDK y en el esquema de los spans, y recomienda fijar la versión del SDK para decidir cuándo adoptar esas modificaciones.
Claude Code tiene una ruta de telemetría documentada por separado. La beta anunciada por ClaudeDevs se refiere al trazado de Claude Platform para Messages API, Managed Agents y SDK, no a un cambio de telemetría de Claude Code (documentación de monitorización de Claude Code).
