A ClaudeDevs anunciou em 14 de outubro de 2026 a beta pública da exportação de traces OpenTelemetry do Claude Platform, com suporte à Claude Messages API, ao Claude Managed Agents e aos Claude SDKs. A Anthropic documenta dois caminhos: instrumentar o aplicativo pelo SDK ou configurar a exportação de traces da API no Console. O anúncio da ClaudeDevs A visão geral da Anthropic
OpenTelemetry é um padrão para coletar e encaminhar dados de observabilidade. Nesse contexto, um trace registra o percurso de uma solicitação; seus spans são registros de etapas desse percurso, como uma chamada de modelo ou a execução de uma ferramenta.
O que cada caminho rastreia
O rastreamento pelo SDK cria spans dentro do aplicativo, usando o exportador OpenTelemetry que ele já configura. O rastreamento da API, ativado no Claude Console, acrescenta spans de atividades do lado do serviço da Anthropic. Os dois podem ser combinados para relacionar a atividade do aplicativo à execução na plataforma. A documentação de OpenTelemetry da Anthropic O guia de SDK O guia de rastreamento da API
| Critério | Rastreamento pelo SDK | Rastreamento da API no Console |
| Configuração | No aplicativo, com um provedor de traces e um exportador. | No Claude Console, adicionando um destino de observabilidade. |
| Permissão no Console | Não exige permissão especial no Console. | É necessário ser administrador da organização para adicionar ou alterar destinos. |
| Atividade visível | Atividade do aplicativo, incluindo ferramentas executadas pelo seu executor de ferramentas. | Solicitações à API, execuções individuais de modelos, sessões do Claude Managed Agents e ferramentas executadas no servidor. |
Na prática, o SDK atende a quem precisa acompanhar também o que acontece no próprio aplicativo, como ferramentas executadas pelo cliente. A configuração pelo Console é útil para observar chamadas e etapas executadas dentro do Claude Platform sem alterar o código do aplicativo para exportar esses spans. Para configurar destinos, porém, a Anthropic exige uma conta com papel de administrador da organização.
O que configurar no SDK e no streaming
No caminho do SDK, registre o provedor de traces antes da primeira chamada que você quer acompanhar. Uma solicitação feita antes desse registro não terá o span criado por essa instrumentação. O guia de OpenTelemetry para os Claude SDKs
Em uma resposta transmitida em streaming, o span termina quando o aplicativo consome ou fecha o fluxo. No modo de conteúdo, os dados da resposta entram no trace quando a leitura é feita com messages.stream(). Portanto, o ciclo de vida do fluxo afeta o que aparece no span.
Metadados ou prompts e respostas
Metadados apenas é o modo padrão. A opção de conteúdo completo acrescenta prompts e respostas aos spans. Cada span comporta até 0,75 MB por padrão; quando o conteúdo excede o limite configurado, ele é encurtado e recebe o atributo anthropic.content.truncated=true. A Anthropic estima que um contexto de 1 milhão de tokens ocupe cerca de 4 MB. A visão geral da Anthropic sobre OpenTelemetry
O destino escolhido recebe os dados exportados e aplica seus próprios controles de acesso e retenção. Há também condições específicas: para organizações com restrições de tratamento de dados HIPAA, FERPA ou K-12 acordadas com a Anthropic, os destinos configurados no Console exportam apenas metadados, independentemente do modo selecionado. Essa restrição de destino não se aplica aos spans do SDK.
Com retenção zero de dados, a exportação de conteúdo completo continua disponível para traces da Messages API, e a Anthropic mantém esse conteúdo apenas em memória até a entrega. O Claude Managed Agents não é elegível para retenção zero; o OpenTelemetry não altera a retenção desse serviço.
Endpoint e limites do Console
O destino da API precisa aceitar OTLP/HTTP protobuf em um endereço HTTPS na porta 443. Ao configurar um endereço-base, o sistema acrescenta /v1/traces, a menos que você defina um endpoint separado para traces. Cada destino pode incluir até 1.000 workspaces selecionados e 20 cabeçalhos de solicitação; cada organização pode configurar até 10 destinos. O guia da Anthropic para rastreamento da API
Há prazos diferentes para cada etapa de entrega: o handshake TLS precisa terminar em até 5 segundos, e o endpoint deve retornar os cabeçalhos da resposta em até 5 segundos. O limite total de cada tentativa de entrega é de 10 segundos.
Traces não substituem os dados de uso
A entrega é best effort e ocorre pelo menos uma vez: spans podem se perder ou chegar duplicados. A Anthropic recomenda a Usage API para acompanhar o uso da API; os traces não formam um registro completo desse uso. O guia da API A visão geral da Anthropic
A documentação da Anthropic trata o monitoramento do Claude Code separadamente. A beta anunciada cobre o rastreamento do Claude Platform, incluindo a Messages API, o Claude Managed Agents e os Claude SDKs. A documentação de monitoramento do Claude Code
A Anthropic também enquadra a exportação como beta sob o acordo do cliente, incluindo a seção Beta Services dos Service Specific Terms. A empresa alerta que opções do SDK e o esquema dos spans podem mudar de forma incompatível durante a beta, e recomenda fixar a versão do SDK para controlar quando essas mudanças chegam ao aplicativo. A visão geral da Anthropic O guia dos Claude SDKs
