A Cloudflare lançou o recurso Issues para monitoramento de erros dentro do Cloudflare Workers, atualmente disponível em uma versão beta aberta. O recurso agrupa falhas recorrentes em um único problema e, em seguida, permite enviar seus detalhes a um agente de programação para prosseguir com a investigação, sugerir uma correção e abrir um pull request.
A Cloudflare busca resolver uma lacuna prática no ciclo de tratamento de falhas de produção: os agentes são capazes de consultar dados de monitoramento, navegar por um repositório de código, escrever testes e modificar o código, mas conectar essas etapas exigia intervenção humana para reunir logs e traces e confirmar que várias falhas eram causadas pelo mesmo problema.
O que o Issues monitora?
O recurso funciona dentro do ambiente do Workers e não exige a instalação de um SDK nem a adição de um wrapper ao aplicativo. Depois de ativado, ele registra exceções não tratadas, chamadas malsucedidas, respostas HTTP da categoria 5xx e saídas de console.log() e console.error(), além de logs que incluem uma pilha de chamadas. Ele também detecta a execução repetida de alertas e a escrita de grandes quantidades de logs dentro de loops.
Em vez de exibir cada solicitação malsucedida como um caso separado, o Issues agrupa erros semelhantes e informa quando eles apareceram pela primeira vez, quantas vezes ocorreram e se sua taxa está aumentando. O problema exibe a pilha de chamadas, quando disponível, os logs e traces anteriores e posteriores, a versão do Worker, os detalhes da solicitação e a tendência do problema ao longo do tempo.
Adicionando contexto do aplicativo à investigação
Os desenvolvedores podem usar a interface OpenTelemetry integrada ao ambiente do Workers para anexar identificadores como usuário, conta e sessão. Esses dados aparecem com cada ocorrência, ajudando a determinar se a falha está concentrada em uma conta ou sessão específica antes de enviá-la ao agente.
Do painel de monitoramento ao agente de programação
É possível configurar uma Automation para executar o envio quando o problema ultrapassar um limite específico de ocorrências ou retornar após um período de calmaria. A Cloudflare oferece suporte à conexão do Claude Code por meio de routine ID e token, do Cursor por meio de um endereço de webhook e do Devin por meio de um API token e um identificador da organização, além de webhooks gerais, sistemas de chat e gerenciamento de incidentes.
O contexto enviado inclui um resumo da falha, a exceção, a pilha de chamadas após o vínculo com o código-fonte, logs e traces, a versão do Worker e o contexto do aplicativo adicionado pelo desenvolvedor. Para uma investigação mais aprofundada, o agente pode ser conectado separadamente ao Cloudflare MCP para consultar os logs e traces relacionados, sugerir alterações no código e nos testes e abrir um pull request.
O que muda na prática?
O Issues reduz as etapas manuais entre a descoberta e a investigação de uma falha, mas não torna a correção totalmente automatizada. A revisão do pull request, a implantação da alteração e a definição do problema como resolvido continuam sob controle da equipe. Além disso, a qualidade dos resultados depende do contexto adicionado pelo aplicativo e das configurações de execução e dos limites escolhidos.
A Cloudflare testou o recurso no Workflows, um componente para aplicativos de execução prolongada e com várias etapas construído sobre o Workers. Em um único dia, a automação ajudou a descobrir dois problemas: um loop de nova tentativa durante uma migração no plano de controle causado por um erro do SQLite relacionado à chave estrangeira e uma operação de exclusão que não foi concluída devido à ultrapassagem do limite de subsolicitações no Workers. A automação enviou os dois problemas ao Cloudflare OS, que rastreou os erros no código do Workflows e sugeriu duas correções.
Para começar a usar, é necessário ativar observability.issues.enabled no arquivo wrangler.jsonc e, em seguida, configurar a primeira Automation no painel da Cloudflare para escolher o destino do problema, seja um agente, um webhook, uma ferramenta de gerenciamento de incidentes ou uma plataforma de chat.