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/pt/articles/claude-opentelemetry-tracing-api-and-sdk-4adbbb12.md.
A Anthropic introduziu a exportação de rastreamentos OpenTelemetry para Claude Managed Agents, a API Messages e os SDKs do Claude. Anunciado...
A Anthropic introduziu a exportação de rastreamentos OpenTelemetry para Claude Managed Agents, a API Messages e os SDKs do Claude. Anunciado em 14 de outubro de 2026, o recurso está em beta público e envia dados de rastreamento padronizados para plataformas de observabilidade que aceitam OTLP.
O objetivo é prático: acompanhar as chamadas de modelo e a atividade de ferramentas de um agente junto à aplicação que o invocou. Em vez de investigar latência, falhas e uso de tokens em locais separados, uma equipe pode inspecionar os spans relevantes em seu sistema de observabilidade existente.
Um trace registra o caminho de uma solicitação por um sistema. Um span registra uma operação dentro desse caminho, como uma chamada de modelo ou a execução de uma ferramenta. Os spans do Claude seguem as convenções semânticas GenAI do OpenTelemetry, o que ajuda ferramentas compatíveis a interpretar dados entre diferentes provedores de modelos.
Fonte: Anthropic. O diagrama ilustra a estrutura de rastreamentos e os fluxos de análise, não resultados de desempenho medidos.
Há duas formas complementares de coletar os dados:
| Capacidade | Rastreamento de SDK | Rastreamento de API |
|---|---|---|
| Configuração | Código da aplicação e provedor de tracer | Destino no Claude Console |
| Permissão especial do Claude | Nenhuma | Função de administrador para adicionar ou alterar destinos |
| Execuções de modelo dentro de uma solicitação | Não expostas individualmente apenas pelo rastreamento de SDK | Incluídas |
| Turnos de Managed Agents | Não expostos apenas pelo rastreamento de SDK | Incluídos |
| Ferramentas executadas pela API | Não expostas apenas pelo rastreamento de SDK | Incluídas |
| Ferramentas de cliente executadas pelo tool runner do SDK | Incluídas | Não capturadas apenas pelo rastreamento de API |
| Ferramentas em um sandbox hospedado pela própria empresa | Incluídas por meio do worker de SDK compatível | Não capturadas apenas pelo rastreamento de API |
| Outras operações de API do cliente, como uploads de arquivos | Incluídas | Não capturadas apenas pelo rastreamento de API |
Ambos os caminhos registram spans de solicitação e uso de tokens. Juntos, eles fornecem visibilidade sobre o trabalho do cliente e também sobre o trabalho realizado dentro da API do Claude. Enviar ambos ao mesmo backend também permite que ele exiba a relação entre eles.
O rastreamento de API não exige alterações no código de solicitações comuns apenas para receber rastreamentos de API independentes. Um administrador adiciona um destino que especifica para onde o Claude deve enviá-los.
anthropic.test chegou.service.name = claude-platform.Para um destino personalizado, o requisito documentado é um endpoint OTLP/HTTP que aceite protobuf em um nome de host HTTPS na porta 443. Um Collector que escuta apenas em sua porta usual 4318 precisa de uma exposição HTTPS adequada ou de um proxy reverso. As credenciais devem ficar nos valores dos cabeçalhos.
Normalmente, o endpoint base omite /v1/traces, porque o Claude o adiciona. Um endpoint avançado de traces pode substituir o caminho, mas precisa usar o mesmo host. Endpoints de endereços privados e redirecionamentos não são compatíveis como destinos normais de entrega.
O rastreamento de SDK começa com a instalação de um SDK do Claude atual e compatível e o registro de um provedor de tracer do OpenTelemetry antes da primeira chamada a ser rastreada. A aplicação fornece o exportador que entrega spans ao backend de observabilidade. Portanto, “exportação automática do SDK” não significa que uma aplicação nova envia dados para algum lugar sem um provedor de tracer e um exportador de destino.
Um exportador de console pode ajudar a verificar a instrumentação local antes da conexão com uma plataforma remota. Depois de configurado, o SDK emite spans de solicitação e spans para ferramentas executadas por seu tool runner. Chamadas feitas dentro de um span da aplicação podem ser aninhadas sob esse span.
Durante o beta, as opções do SDK, os nomes de spans e os atributos podem mudar. A Anthropic recomenda fixar a versão do SDK para que as equipes possam decidir quando adotar essas mudanças.
O SDK propaga o contexto de rastreamento para que os spans de servidor da API possam ficar abaixo dos spans de cliente do SDK. Solicitações para o Claude Platform on AWS são uma exceção: os spans de API aparecem em seus próprios rastreamentos porque essa plataforma ainda não oferece suporte ao mesmo comportamento de união de contexto de rastreamento.
As sessões de Managed Agents expõem spans de solicitação da API Sessions, spans de turnos de agentes, solicitações de modelo, ferramentas executadas pela API e avaliações de resultado. Uma sessão pode abranger vários rastreamentos e, em operações com múltiplos agentes, várias threads. A documentação recomenda agrupar por anthropic.session.id para uma sessão ou por gen_ai.conversation.id para uma thread.
Claude Code, o Agent SDK e o Cowork possuem sua própria documentação de monitoramento. O novo recurso da plataforma não deve ser tratado como substituto de todas as instruções de instrumentação existentes de cada produto.
Cada destino do Console e cliente de SDK tem um modo de conteúdo. O padrão, Metadata only, inclui identificadores, tempo, status, contagens de tokens e texto descritivo selecionado, como nomes de ferramentas, descrições de ferramentas e nomes de servidores MCP. Ele exclui prompts e respostas do modelo, mas não é uma garantia de que todos os campos exportados estejam livres de texto fornecido pela aplicação.
Full content também inclui prompts e respostas. Isso o torna útil para depurar interações com falha e criar avaliações a partir de tráfego real, mas transfere o conteúdo das conversas para um sistema separado com suas próprias configurações de acesso e retenção.
O limite de conteúdo padrão é de 0,75 MB por span. A Anthropic afirma que isso comporta aproximadamente um contexto em inglês de 200.000 tokens e fica abaixo do limite de solicitação de 1 MB usado por muitos serviços de observabilidade e proxies. Um contexto completo de um milhão de tokens pode precisar de cerca de 4 MB; portanto, o padrão não é suficiente para reter integralmente todos os prompts grandes.
Quando um span excede seu limite de conteúdo, o SDK ou a API o reduz e define anthropic.content.truncated como true. Os spans de solicitação descartam primeiro o prompt de sistema e as mensagens mais antigas; os spans de ferramentas descartam blocos a partir do fim do resultado da ferramenta. Imagens e documentos aparecem por tipo, em vez de incluir sua carga completa de mídia.
O SDK usa traces.max_content_bytes para controlar o limite. Os destinos do Console expõem um tamanho máximo de conteúdo nas configurações avançadas, e os provedores listados podem ter um padrão específico do provedor.
Descreva sua ideia uma vez e o We0 AI pode gerar um site de apresentacao, paginas e CMS, alem de ajudar a atrair clientes e trafego apos o lancamento.
Uma geração completa de projetos para registro gratuito
Melhor para experimentar um fluxo de geração completo e ver rapidamente um primeiro rascunho do projeto.
Organizações com restrições de tratamento de dados HIPAA, FERPA ou K–12 com a Anthropic exportam somente metadados por destinos de API, independentemente do modo de conteúdo selecionado. A documentação informa que essa restrição não se aplica aos spans do SDK; portanto, a configuração do SDK ainda exige uma análise separada.
A exportação de conteúdo completo pode ser usada com solicitações elegíveis da API Messages com zero data retention, pois a API mantém o conteúdo de exportação em memória até a entrega. Managed Agents não é elegível para zero data retention, e habilitar o OpenTelemetry não altera seus termos de retenção.
Uma solicitação pode registrar seu uso de tokens em vários spans. Portanto, somar todos os spans do rastreamento pode superestimar o uso.
Quando existem spans de SDK e de API para uma solicitação da API Messages, use a fonte da API. Nessa fonte, some os spans de solicitação ou seus spans de solicitação de modelo, mas não ambos; contabilize a compactação conforme as regras específicas da documentação. Para Managed Agents, os spans de API relevantes são solicitações de modelo e avaliações de resultado.
Novas tentativas de entrega também podem produzir spans duplicados. Elimine duplicidades usando o ID de rastreamento e o ID de span se o backend ainda não fizer isso.
Os rastreamentos exportados são um registro de depuração, não um livro-razão de faturamento completo garantido. A entrega segue o princípio de melhor esforço, e a amostragem pode omitir solicitações. A Anthropic orienta equipes que precisam de acompanhamento completo de uso por chave de API a usar a Usage API.
A Anthropic cita Grafana Cloud, Honeycomb, Sentry e Splunk para visualizar rastreamentos de agentes ao lado de logs e métricas da aplicação. Ela também lista Arize AI, Braintrust, Datadog, Langfuse, LangSmith, New Relic e PostHog para fluxos de trabalho que conectam rastreamentos a avaliações e melhorias de qualidade. O Databricks Unity Gateway é destacado para visibilidade em nível organizacional.
Esses são exemplos, e não uma lista exclusiva de compatibilidade. Outras ferramentas podem receber os dados se aceitarem a exportação OTLP padrão exigida.
O anúncio inclui declarações de clientes da Foxglove, Ramp, Sterling Labs e FloQast. Seus casos de uso incluem depuração de robótica, análise de agentes de mercado e rastreamento de fluxos de trabalho contábeis.
A Ramp descreve um sistema interno chamado Reflect que avalia rastreamentos do Langfuse e propõe correções. Seu engenheiro relata uso de tokens 10–20% menor e sessões 30% mais rápidas em alguns agentes. Esses são resultados relatados por clientes desse fluxo de melhoria; não são uma promessa de que habilitar somente a exportação de rastreamentos gere esses ganhos.
Ela envia spans padronizados que descrevem solicitações à API do Claude, turnos de agentes, chamadas de modelo e atividade de ferramentas compatíveis para um backend de observabilidade. O recurso está em beta público e oferece caminhos separados para rastreamento de API e SDK.
Você precisa da função de administrador para adicionar ou alterar destinos de rastreamento de API no Claude Console. O rastreamento de SDK é configurado no código da aplicação e não exige uma permissão especial da organização Claude.
Não, o modo padrão é Metadata only. Full content adiciona prompts e respostas, sujeito aos limites de conteúdo e às restrições documentadas para organizações específicas.
Sim, desde que o destino de API atenda aos requisitos documentados de rede e protocolo. Em particular, a exportação de API exige um receptor protobuf OTLP/HTTP acessível por um nome de host HTTPS público na porta 443, e não somente um listener privado do Collector.
Sim, quando o contexto de rastreamento é propagado e os spans chegam ao mesmo backend de observabilidade. Atualmente, os spans de API para solicitações ao Claude Platform on AWS aparecem em seus próprios rastreamentos.
Não, os rastreamentos podem ser amostrados, perdidos ou entregues mais de uma vez. Use as regras documentadas de contagem para análise e a Usage API quando precisar de uma contabilização completa de uso.
O beta do OpenTelemetry do Claude conecta chamadas de modelo e ferramentas de agentes aos sistemas de rastreamento que as equipes já usam. O rastreamento de API expõe a atividade do lado do servidor, enquanto o rastreamento de SDK adiciona operações e ferramentas do cliente; combiná-los fornece a linha do tempo mais clara da aplicação onde a união de rastreamentos é compatível.
Escolha os modos de conteúdo de forma deliberada, verifique o truncamento e a integridade da entrega, e conte tokens a partir de uma única fonte adequada. O rastreamento melhora a visibilidade, mas a contabilização completa de uso e os controles de retenção continuam sendo responsabilidades separadas.
Comece com uma frase e tenha um site completo em minutos.
