A Anthropic adiciona a exportação de traces do OpenTelemetry à Claude Platform

A Anthropic adicionou a exportação de traces do OpenTelemetry à Claude Platform e anunciou, em 14 de outubro de 2026, que os desenvolvedores já podem enviar traces de Claude Managed Agents, da Messages API e dos Claude SDKs para qualquer ferramenta de observabilidade compatível com o padrão. O recurso está disponível em beta público.

No anúncio da Anthropic, a empresa afirmou que adicionar um destino no Claude Console envia cada turno do agente, chamada de modelo e uso de ferramenta para a ferramenta de observabilidade do usuário como um trace padrão do OpenTelemetry, com informações de latência, contagens de tokens e IDs. O uso de Managed Agents e da Messages API exige a configuração desse destino no Console, enquanto os Claude SDKs exportam traces automaticamente. Desenvolvedores que já enviam traces do Claude Code ou do Cowork para uma ferramenta de observabilidade podem visualizar no mesmo local os agentes criados na Claude Platform.

A Anthropic afirmou que os traces do Claude seguem as convenções semânticas GenAI do OpenTelemetry. Assim, os dados do Claude e de outros provedores funcionam nas mesmas ferramentas e painéis, e os traces também são compatíveis com qualquer ferramenta do OpenTelemetry que aceite um endpoint OTLP padrão.

Duas formas de configuração e um único modelo de trace

A documentação da Claude Platform define um trace como o registro completo de uma solicitação feita a um sistema e um span como uma etapa de um trace, como uma solicitação a um modelo ou o uso de uma ferramenta. A documentação descreve duas formas de configuração. O rastreamento pelo SDK é configurado no código, com a instalação do SDK e o registro de um provedor de tracer, e não exige permissões especiais. O rastreamento pela API é configurado com a adição de um destino no Claude Console e exige permissão de administrador.

A cobertura varia entre as duas formas. O rastreamento pela API captura cada execução de modelo dentro de uma solicitação, os turnos de Managed Agents e as ferramentas de servidor executadas pela API. O rastreamento pelo SDK também abrange ferramentas de cliente executadas pelo executor de ferramentas, ferramentas em um ambiente isolado hospedado pelo próprio usuário e outras solicitações à API, como o envio de arquivos. Com as duas formas configuradas, os spans do SDK e da API de uma solicitação ficam em um único trace; já nas solicitações à Claude Platform na AWS, os spans da API aparecem em traces separados.

No caso de Managed Agents, uma sessão gera um span para cada solicitação à Sessions API e um span de turno para cada turno do agente. Cada turno contém spans para cada solicitação a um modelo, cada ferramenta executada pela API e cada avaliação de resultado. A documentação direciona os usuários do Claude Code, do Agent SDK e do Cowork a materiais separados sobre monitoramento e observabilidade desses produtos.

Modos de conteúdo, limites e comportamento de conformidade

Cada destino e cada cliente do SDK têm um modo de conteúdo que determina se os spans incluem solicitações e respostas dos modelos. O modo Somente metadados, padrão, registra identificadores, horários, status, contagens de tokens e textos escolhidos pelo usuário, como nomes e descrições de agentes e ferramentas e nomes de servidores MCP. O modo Conteúdo completo também inclui as solicitações e respostas dos modelos.

No modo Conteúdo completo, cada span comporta, por padrão, até 0,75 MB de conteúdo. Segundo a documentação, esse limite é suficiente para uma janela de contexto de 200 mil tokens de texto em inglês e fica abaixo do limite de 1 MB por solicitação de muitas plataformas e proxies de observabilidade; uma janela de contexto completa de 1 milhão de tokens exige cerca de 4 MB. Quando o conteúdo ultrapassa o limite, o SDK ou a API o encurta e define como true o atributo anthropic.content.truncated. Nos spans de solicitação, o prompt do sistema e as mensagens mais antigas são removidos primeiro, e as imagens e os documentos aparecem apenas identificados pelo tipo.

Para organizações sujeitas a restrições de tratamento de dados da HIPAA, da FERPA ou do ensino fundamental e médio (K-12) junto à Anthropic, os destinos exportam apenas metadados, independentemente do modo de conteúdo configurado, embora isso não afete os spans do SDK. Com a retenção zero de dados, o modo Conteúdo completo continua disponível, pois a API mantém o conteúdo exportado apenas na memória até enviá-lo ao destino. Claude Managed Agents não é elegível para a retenção zero de dados, e seus termos de retenção não mudam com o uso do OpenTelemetry.

Para contabilizar tokens, a documentação orienta os usuários a contar cada token uma única vez, somando os spans de apenas uma fonte por solicitação e usando os spans da API quando uma solicitação tiver spans tanto do SDK quanto da API. A documentação também observa que os spans podem chegar mais de uma vez quando uma entrega é repetida.

Integrações citadas e relatos de clientes pioneiros

O anúncio organiza as plataformas de observabilidade compatíveis por caso de uso. Para depurar agentes junto com o restante de uma pilha de software, cita Grafana Cloud, Honeycomb, Sentry e Splunk, nas quais os traces dos agentes aparecem ao lado de registros e métricas, permitindo que os desenvolvedores identifiquem de qual serviço veio uma etapa lenta ou com falha. Para aprimorar agentes com dados de produção, cita Arize AI, Braintrust, Datadog, Langfuse, LangSmith da LangChain, New Relic e PostHog, mencionando usos como transformar traces reais em avaliações e detectar problemas de qualidade. Para acompanhar o uso em toda a organização, cita o Databricks Unity Gateway, no qual as equipes de plataforma e segurança podem consultar o uso de tokens por equipe e sinalizar atividades incomuns.

Vários clientes pioneiros descreveram suas implantações no anúncio. Roman Shtylman, cofundador e diretor de tecnologia da Foxglove, afirmou que a empresa desenvolve agentes que ajudam equipes de robótica a depurar seus robôs. Ele também disse que a exportação nativa do OpenTelemetry pela Claude Platform permite analisar as interações dos agentes no PostHog, junto com dados de uso do produto, para avaliar o desempenho dos agentes na prática e priorizar melhorias para as equipes de robótica.

David Traina, engenheiro de software sênior da Ramp, disse que a empresa desenvolveu o Reflect, um sistema agêntico que avalia rastros do Langfuse, identifica falhas recorrentes e propõe correções. “Em alguns agentes, já reduzimos o uso de tokens em 10–20% e tornamos as sessões 30% mais rápidas”, disse Traina, acrescentando que a exportação nativa de OpenTelemetry da Claude API pode alimentar diretamente esse ciclo de aprimoramento com dados de instrumentação, sem etapas adicionais.

Hyon Lee, CTO da Sterling Labs, disse que a exportação nativa envia todos os rastros ao Langfuse sem instrumentação personalizada para os agentes da empresa que analisam mercados em tempo real. Ankush Sharma, responsável pela infraestrutura da FloQast, disse que os agentes da empresa de software contábil são executados na Claude Platform, com telemetria no Grafana Cloud. Assim, cada chamada de modelo aparece no mesmo rastro que o fluxo de trabalho de conciliação ou lançamento contábil em que foi executada, permitindo que a empresa responda às perguntas dos auditores sobre o que um agente fez a partir de uma única linha do tempo.