OpenTelemetry no Claude: Anthropic adiciona traces

Novo recurso exporta métricas de latência, chamadas de ferramentas e contagem de tokens do Claude Managed Agents e da Messages API para coletores OTLP.

A Anthropic liberou suporte nativo ao padrão aberto OpenTelemetry no Claude, permitindo o rastreamento estruturado de execuções no Claude Managed Agents, na Messages API e nos SDKs oficiais da fornecedora. O recurso, documentado em 14 de outubro de 2026, viabiliza o envio contínuo de telemetria diretamente para plataformas corporativas de observabilidade ou coletores próprios via protocolo padrão OTLP/HTTP.

Coleta no cliente e exportação direta do servidor

A arquitetura opera em duas camadas complementares. No lado da aplicação, os SDKs passam a emitir spans locais para chamadas pontuais da API e execuções de ferramentas. No lado da infraestrutura em nuvem, os próprios servidores da Anthropic realizam a exportação automática em sessões do Claude Managed Agents e da Messages API, eliminando a necessidade de alterar código cliente para obter traces de backend.

Gerenciamento de destinos e validação no console

Para administrar esses fluxos, a Anthropic lançou a API corporativa de Destinos de Telemetria sob o cabeçalho beta telemetry-destinations-2026-08-11. Organizações podem registrar até dez endpoints OTLP/HTTP distintos, direcionar dados conforme o workspace de origem e validar a conexão emitindo spans de teste identificados como anthropic.test.

Equipes técnicas também contam com uma interface visual no Claude Console. Pelo caminho /settings/telemetry-destinations, administradores cadastram provedores compatíveis e acompanham a integridade da entrega dos traces em uma coluna dedicada de status.

Metadados, ferramentas e controle de privacidade

Cada span gerado pelo Claude captura duração de execução, status HTTP, identificador do modelo utilizado, consumo de tokens de entrada e saída e nomes das ferramentas acionadas pelos agentes.

Para atender requisitos regulatórios e políticas de segurança da informação, a fornecedora oferece dois modos de retenção de dados. O modo exclusivo de metadados (metadata_only) permite auditar latências e custos sem enviar o conteúdo de mensagens e prompts aos coletores. Já o espelhamento completo inclui o texto integral das entradas e respostas, atendendo auditorias que demandam conferência textual de cada etapa.

Por que OpenTelemetry no Claude importa para agentes

A transição de prompts isolados para fluxos agênticos transformou a depuração de software com IA. Em execuções autônomas, o modelo toma decisões iterativas, vasculha arquivos e dispara chamadas assíncronas a ferramentas externas. Sem rastreamento estruturado, identificar gargalos de latência em etapas intermediárias, loops acidentais ou picos anômalos no consumo de tokens exigia esforço manual expressivo.

Ao escolher o OpenTelemetry, padrão neutro governado pela Cloud Native Computing Foundation (CNCF), a Anthropic evita formatos proprietários de monitoramento. Engenheiros de confiabilidade conseguem direcionar traces do Claude para pilhas que já sustentam sua infraestrutura, como Grafana, Splunk, Databricks e LangSmith, unificando a telemetria de agentes inteligentes aos demais microsserviços do sistema.

Limites da fase beta e custos de ingestão

O envio server-side fica restrito a contas em nível organizacional, com o teto de dez destinos por organização. A Anthropic não estabeleceu tarifas adicionais pelo envio de pacotes OTLP, embora custos normais de ingestão se apliquem conforme o contrato mantido com a ferramenta de observabilidade receptora. A fornecedora ainda não publicou uma data para a transição da API de destinos da fase beta para disponibilidade geral.