Cloudflare lançou rastreamento de agentes em 15 de agosto de 2026, o primeiro recurso em seu novo painel Agents. O lançamento adiciona spans em nível de agente ao rastreamento de Workers que já cobre chamadas fetch, leituras de KV e consultas D1. É gratuito durante a versão beta; a partir de 1º de outubro de 2026, cai sob o preço Workers Observability.
O problema é real. Um agente pode retornar HTTP 200 e ainda falhar: escolher a ferramenta errada, passar contexto obsoleto para um subagente ou queimar tokens em um loop de retry. A telemetria de aplicação vê a solicitação de API e consulta de banco de dados, mas não o comportamento do agente que as acionou. O rastreamento de agentes adiciona spans para invocações de agentes, chamadas de modelo, execução de ferramentas e aprovações, com identidade de modelo e uso de tokens como metadados. Cada turno produz um rastreamento: `invoke_agent {agent class}` na raiz, com `chat {model}` e `execute_tool {tool}` aninhados abaixo, e `tool_approval {tool}` sob isso. O trabalho do subagente é aninhado sob a operação pai que o invocou.
Três campos conectam spans ao painel: nome do agente (implementação lógica), ID do agente (instância) e ID de conversa. Cloudflare avisa contra derivar nome do agente de identificadores de solicitação ou usuário—isso fragmenta um agente em muitos na visualização. O replay de sessão reconstrói conversas entre turnos a partir de mensagens gravadas, raciocínio, chamadas de ferramentas com argumentos e resultados, e atividade de subagentes. Cloudflare não re-executa o agente; o replay usa apenas dados armazenados.
Os padrões de payload exigem auditoria. Think não armazena cargas de mensagem ou ferramenta, a menos que `storeMessages` e `storeTools` sejam definidos na classe do agente; `wrapAISDK()` se comporta de forma idêntica. Flue armazena mensagens, instruções do sistema, definições de ferramentas, argumentos e resultados por padrão, exigindo `content: false` para recusar. O mesmo recurso é fornecido com padrões de privacidade opostos, dependendo de qual arnês os times escolheram. As cargas de mensagem rotineiramente carregam dados pessoais ou segredos; a discrepância não é acadêmica.
As limitações documentadas restringem a confiança no replay. Cloudflare declara que os rastreamentos não são completos ou sem perdas: dados de payload atingem limites de tamanho de span, portanto mensagens longas, raciocínio, argumentos de ferramentas e resultados podem ser truncados. O replay de sessão não exibe imagens. A retenção é 3 dias em Workers Free, 7 dias em Workers Paid—muito curta para análise de padrões recorrentes, adequada apenas para incidentes recentes.
O preço conta por span, não por exibição de painel. Cada span conta, incluindo internos do SDK e operações em nível de Worker que a visualização não expõe. Workers Free cobre 200.000 eventos por dia; Workers Paid inclui 20 milhões por mês com milhões adicionais a $0,60 cada. Um arnês verboso ou um gráfico de subagente profundamente aninhado aumentará uma conta que o painel sozinho não vai prever. Um span de aprovação registra um evento de ciclo de vida; ele não mede a latência de resposta humana entre invocações—a latência HITL não é capturada.
Os caminhos de instrumentação diferem por stack. Think e Flue v2 ou posterior instrumentam turnos automaticamente. Chamadas diretas de AI SDK precisam de um wrapper `wrapAISDK()` (v6 e v7 suportadas), com campos de identidade fornecidos em cada chamada. Arneses personalizados usam a API de spans personalizados de Workers seguindo as implementações de referência GenAI do OpenTelemetry. Workers ainda não suporta a API do OpenTelemetry diretamente, embora Cloudflare esteja trabalhando nisso. Os atributos de span seguem as convenções semânticas GenAI do OTel e exportam para qualquer endpoint OTLP.
O rastreamento de agentes oferece aos times de infraestrutura uma superfície de debugging real. Padrões de payload inconsistentes e limites de truncamento o tornam um auxílio de debugging, não um trilho de auditoria. Planeje adequadamente antes que a cobrança de outubro comece.