Qué ha cambiado
La documentación de Platform de Anthropic dice que la Claude API y el SDK pueden trazar solicitudes de la Messages API, usos de herramientas y sesiones de Managed Agents hacia una plataforma de observabilidad que ya esté en marcha. Una traza es el registro completo de una solicitud. Un span es un paso, como una solicitud al modelo o un uso de herramienta. Los spans usan atributos de las convenciones semánticas de GenAI, de modo que una plataforma que admita esas convenciones puede reconocerlos sin configuración adicional. Los usos que declara la documentación son depurar solicitudes fallidas o lentas, seguir el gasto de tokens y la latencia, y construir evaluaciones a partir del tráfico real, con cada solicitud vinculada al usuario o a la función que la envió.
El artículo de lanzamiento dice que las mismas trazas pueden salir de Claude Managed Agents, de la Messages API y de los SDK de Claude, y que los agentes de Platform pueden aparecer en una herramienta que ya reciba trazas de Claude Code o de Cowork. La documentación de Platform envía Claude Code, el Agent SDK y Cowork a sus propias páginas de monitorización. El artículo dice que añadir un destino en la Console entrega cada turno del agente, cada llamada al modelo y cada uso de herramienta como una traza OpenTelemetry estándar, con latencia, tokens e ID. La documentación dice que la entrega es best effort y que un span puede perderse. Quien hace la llamada también puede dejar fuera los spans de una solicitud apagando la marca sampled en la cabecera traceparent de esa solicitud, la cabecera que lleva la decisión de muestreo.
Para quién es y qué sale de la cuenta
Cualquier plataforma que acepte OTLP, el protocolo de exportación de OpenTelemetry, puede ser un destino. La documentación nombra Arize AI, Braintrust, Databricks, Datadog, Grafana Cloud, Honeycomb, Langfuse, LangSmith, New Relic, PostHog, Sentry y Splunk, y describe Langfuse como código abierto. El artículo de lanzamiento agrupa Grafana Cloud, Honeycomb, Sentry y Splunk con la depuración junto a registros y métricas; Arize AI, Braintrust, Datadog, Langfuse, LangSmith de LangChain, New Relic y PostHog con las evaluaciones; y Databricks Unity Gateway con el uso de tokens por equipo. La documentación lista a ese último socio como Databricks.
Las organizaciones con una restricción de tratamiento de datos HIPAA, FERPA o K-12 con Anthropic tienen destinos que exportan solo metadatos, sea cual sea el modo de contenido. La documentación dice que los spans del SDK no se ven afectados por esa restricción. Con retención de datos cero, Full content sigue funcionando para las solicitudes de la Messages API, y la API conserva el contenido exportado solo en memoria hasta la entrega. Claude Managed Agents no es elegible para la retención de datos cero, y la documentación dice que OpenTelemetry deja esa retención sin cambios.
| Opción | Lo que dice la documentación |
|---|---|
| Solo metadatos (metadata_only) | Valor predeterminado. Identificadores, tiempos, estado, recuentos de tokens y el texto que usted elija, como nombres y descripciones de agentes y herramientas y nombres de servidores MCP. Los prompts y las respuestas quedan fuera. |
| Contenido completo (content) | Añade prompts y respuestas del modelo. La plataforma de observabilidad los guarda bajo sus propios ajustes de acceso y retención. |
| Tamaño predeterminado | 0.75 MB por span. La documentación dice que cabe en un contexto en inglés de 200k tokens y queda por debajo de un límite de 1 MB habitual en plataformas y proxies. |
| Ventana de 1M tokens | Una ventana de contexto completa de 1M tokens necesita unos 4 MB. Suba o retire el límite cuando la plataforma acepte cargas mayores. |
| Socio como Provider | Una opción distinta de la Console. Usted elige una plataforma socia como Provider, y la Console fija un límite que esa plataforma acepta. |
| Tope menor | Baje el límite cuando la plataforma de observabilidad, o un proxy delante de ella, rechace solicitudes grandes. |
| Por encima del tope | El contenido se acorta y anthropic.content.truncated queda en true. Los spans de solicitud eliminan primero el prompt del sistema y los mensajes más antiguos. Los spans de herramienta eliminan bloques desde el final. Las imágenes y los documentos aparecen solo como su tipo. |
| Dónde cambiarlo | SDK: traces.max_content_bytes. Console: active Full content y después Maximum content size in MB en Advanced settings. |
Cómo activarlo y cómo contar los tokens una sola vez
El trazado del SDK consiste en instalar el SDK y registrar un tracer provider, el paso de registro que la documentación nombra para que el SDK pueda emitir spans. El trazado de la API consiste en añadir un destino en la Claude Console. El artículo de lanzamiento dice que Managed Agents y la Messages API necesitan ese destino de la Console, mientras que los SDK de Claude exportan trazas de forma automática. La documentación sigue exigiendo el tracer provider para los spans del SDK. Configure ambos para ver los spans del SDK y de la API de una solicitud en una sola traza. Para las solicitudes a Claude Platform on AWS, la documentación dice que los spans de la API permanecen en sus propias trazas.
La documentación compara el trazado del SDK, el trazado de la API y ambos. En ese orden de columnas, la configuración es código, luego Console, luego ambos; el permiso requerido es None, luego Admin, luego Admin; y la cobertura es clientes que usan el SDK, luego cualquier cliente, luego cualquier cliente.
En el ejemplo de Messages de la documentación, la aplicación llama al tool runner, el auxiliar del SDK que ejecuta herramientas y devuelve sus resultados. El SDK emite el span del tool runner, el span de la herramienta personalizada del cliente y el span create de cliente de cada solicitud. La API emite el span create de servidor, un span por cada solicitud al modelo y un span de herramienta por cada herramienta de servidor o herramienta de conector MCP que ejecuta la API.
Cuando una solicitud de la Messages API tiene a la vez un span del SDK y un span de la API, sume los spans de la API. Ambos se llaman anthropic.messages.create. El kind los distingue: el span del SDK es CLIENT y su hijo, el span de la API, es SERVER. Para los spans de Messages de la API, el total es uno de dos conjuntos: los spans anthropic.messages.create o los spans anthropic.model_request. Para una sesión de Managed Agents, sume los spans anthropic.model_request y anthropic.session.outcome_evaluation. Los spans de una sesión pueden estar en varias trazas. Con multiagent activado, gen_ai.conversation.id agrupa un hilo y anthropic.session.id agrupa toda la sesión. gen_ai.usage.input_tokens ya incluye las lecturas y escrituras de la caché de prompts. Si un reintento envía otra vez el mismo span, cuéntelo una sola vez por trace ID y span ID. La tabla es la lista de una vez por origen.
En los spans create del SDK, añada también anthropic.usage.compaction.input_tokens y anthropic.usage.compaction.output_tokens, porque gen_ai.usage.* deja fuera los tokens de compactación. Si un modelo de fallback atendió la solicitud, ese span del SDK tiene el uso solo del modelo que sirvió la respuesta. En los spans de Messages de la API, añada los spans anthropic.compaction de la solicitud y deje fuera de ese mismo total los atributos anthropic.usage.compaction.* del span create, porque contienen los mismos tokens.
| Origen | Spans de la suma | Compactación y fallback |
|---|---|---|
| Solicitud de Messages con un span del SDK y un span de la API | Spans anthropic.messages.create de la API, kind SERVER. El span del SDK con el mismo nombre es kind CLIENT. | Después use la fila de API Messages. |
| Spans create del SDK | anthropic.messages.create | Añada también anthropic.usage.compaction.input_tokens y anthropic.usage.compaction.output_tokens. Un span de fallback tiene el uso solo del modelo que sirvió la respuesta. |
| Spans de Messages de la API | O bien anthropic.messages.create, o bien anthropic.model_request | Añada también los spans anthropic.compaction. Los atributos anthropic.usage.compaction.* del span create contienen los mismos tokens, así que quedan fuera de este total. |
| Sesión de Managed Agents | anthropic.model_request y anthropic.session.outcome_evaluation | Las reglas de recuento no nombran una suma aparte de compactación para estos spans. Los spans de una sesión pueden estar en varias trazas. |
Precio, fechas y qué miden las citas
La documentación de OpenTelemetry y el artículo de lanzamiento no indican precio, nivel de plan, cuota de exportación ni fecha de disponibilidad general. El texto del artículo no tiene fecha de publicación propia. El aviso de beta dice que la exportación se ofrece conforme a su acuerdo con Anthropic, incluida la sección Beta Services de los Service Specific Terms.
David Traina, de Ramp, dice que Reflect, que puntúa trazas de Langfuse, ya ha reducido el uso de tokens entre un 10–20% y ha hecho las sesiones un 30% más rápidas en algunos agentes. Dice que la exportación nativa desde la Claude API puede alimentar ese ciclo, y que Reflect solo puede mejorar lo que observa. Esos porcentajes son su relato de los resultados ya existentes de Reflect. El artículo también cita a Roman Shtylman, de Foxglove, sobre PostHog junto al uso del producto; a Hyon Lee, de Sterling Labs, sobre Langfuse recibiendo cada traza sin instrumentación personalizada; y a Ankush Sharma, responsable de infraestructura sin organización nombrada, sobre Grafana Cloud junto a flujos de conciliación y de asientos contables. La frase de Lee de que llega cada traza queda junto a la entrega best effort de la documentación.
El registro de cambios de Claude Code añade por separado atributos GenAI en los spans de traza de Claude Code, entre ellos gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name y error.type, y añade cache_creation_5m_tokens y cache_creation_1h_tokens en el evento api_request. Esas viñetas no nombran versión, y son telemetría de Claude Code y no este destino de la Console.
Fuente
También de
Fuentes y criterio editorial
Esta nota se apoya en la publicación de ClaudeDevs del 15 de octubre de 2026, en la documentación de OpenTelemetry de Platform de Anthropic y en el artículo de lanzamiento “Trace agents with OpenTelemetry on the Claude Platform”, los tres leídos ese día. Un pasaje del registro de cambios de Claude Code sobre atributos GenAI de los spans se incluye solo para mantenerlo aparte de la exportación de Platform. Esas viñetas no tienen encabezado de versión. Los términos de Beta Services, la referencia de atributos de spans, la página de atributos de uso de tokens y las páginas de monitorización de Claude Code, el Agent SDK y Cowork quedaron fuera de esta lectura. No se configuró ningún destino y no se exportó ninguna traza.