Pular para o conteúdo

Como ligar o Sentry, o Datadog e o Zabbix para os erros virarem cards

Conecte a ferramenta de monitoramento em Conexões: cada erro novo vira um card de bug com a origem dela, e o Claude pode já começar a corrigir.

Com o Sentry, o Datadog ou o Zabbix ligado ao projeto, cada erro do sistema no ar vira um card de bug em A fazer, com a origem da ferramenta, o link para o erro e o que ela mandou (a mensagem, o ambiente e, no Sentry, a pilha do erro). O mesmo erro de novo não abre outro card: soma no card aberto. E, se você quiser, o card já nasce com o Claude corrigindo.

Grupo Monitoramento da página Conexões da Aurora Móveis: Sentry Funcionando com Cria cards e o Claude já corrige, Datadog aguardando o primeiro alerta e Zabbix Não ligado com o botão Conectar
O grupo Monitoramento em Conexões: uma linha por ferramenta.

Conectar a ferramenta

  1. Passo 1: Abra Conexões (menu do usuário, logo abaixo de Ambientes) e desça até o grupo Monitoramento.
  2. Passo 2: Na linha da ferramenta, toque em Conectar e, na janela, em Conectar o Sentry (ou o Datadog, ou o Zabbix). O benflow cria um endereço só deste projeto.
  3. Passo 3: Copie o Endereço do benflow e siga o Como ligar no Sentry (ou no Datadog, ou no Zabbix) da janela, que mostra o caminho exato dentro da ferramenta e se recolhe depois do primeiro alerta. No Datadog vem também o Modelo do corpo (custom payload); no Zabbix, os Parâmetros e o Script.
  4. Passo 4: Pronto: a linha fica em Atenção até o primeiro alerta chegar e depois em Funcionando, com a hora do último alerta.

No Sentry

Use uma integração interna (Settings, Developer Settings, Custom Integrations, Create New Integration, Internal Integration) com o endereço em Webhook URL e Alert Rule Action ligado. Em Webhooks, marque issue para todo erro novo virar card; para escolher quais erros (só a produção, só um projeto), deixe desmarcado e crie uma regra de alerta com a ação Send a notification via benflow. O resolvido no Sentry fica no histórico do card. O plugin antigo WebHooks dos alertas também funciona.

Para o benflow conferir que o aviso veio mesmo do Sentry, cole o Client Secret da integração em Assinatura do Sentry (opcional): daí em diante só o aviso assinado é aceito. O plugin antigo WebHooks não assina; com ele, deixe o campo vazio.

No Datadog

Instale a integração Webhooks, crie um webhook com o nome benflow e o endereço do benflow, ligue Use custom payload e cole o modelo da janela. Depois ponha @webhook-benflow na mensagem dos monitores que devem virar card, inclusive os do Error Tracking. Quando o monitor volta ao normal (Recovered), o histórico do card mostra.

No Zabbix

Crie um tipo de mídia Webhook com o nome benflow, cadastre os Parâmetros da janela (o benflow_url leva o endereço do benflow) e cole o Script. Ponha a mídia num usuário e mande os problemas para ele numa ação de gatilho, com a recuperação ligada. O mesmo gatilho no mesmo servidor fica no mesmo card. Para o link do problema funcionar, cadastre a macro {$ZABBIX.URL} com o endereço do seu Zabbix.

O que fazer com os erros

Janela do Sentry da Aurora Móveis com o Endereço do benflow, o Como ligar no Sentry recolhido, os interruptores Criar cards com os erros e O Claude já corrige ligados e o Setor dos cards em Desenvolvimento
A janela da ferramenta: o endereço, o passo a passo e as escolhas.
  • Criar cards com os erros: ligado, cada erro novo vira um card de bug em A fazer, com a prioridade pela gravidade (fatal e crítico viram Urgente; erro vira Alta). Desligado, os alertas só ficam registrados. Na tabela de Conexões, o mesmo interruptor aparece na linha como Cria cards e Sem cards.
  • O Claude já corrige: o card nasce com o trabalho da IA no Claude de quem ligou, como o Iniciar com IA: reproduzir o erro, corrigir a causa e deixar um teste que pegue o caso. Precisa do seu Claude ligado no projeto e de Criar cards com os erros ligado. O trabalho segue o caminho de sempre do card, com a validação e a publicação que o projeto usa.
  • Setor dos cards: o setor em que os cards nascem (ou Sem setor).

Erros repetidos, erros que voltam e o limite por hora

  • O mesmo erro de novo com o card aberto só soma: a lista mostra quantas vezes veio e o histórico do card ganha uma linha O erro aconteceu de novo, no máximo a cada 6 horas.
  • Erro que volta depois do card concluído, fechado ou arquivado abre um card novo, que diz de qual card o erro voltou.
  • No máximo 20 cards por hora no projeto, somando as ferramentas, e 5 trabalhos do Claude por hora. Passou disso, o alerta fica em Alertas recentes sem card, e o Criar card ao lado abre o card quando você quiser (sem chamar o Claude sozinho).
Fim da janela do Sentry da Aurora Móveis: a Assinatura do Sentry com o campo Client Secret e os Alertas recentes, com o ChunkLoadError Resolvido no card 2 e o TypeError do checkout 7 vezes no card 3
Os alertas recentes: quantas vezes cada erro veio, o resolvido e o card de cada um.
O card mostra de onde veio?
Sim. Na origem do card aparece o nome da ferramenta (Sentry, Datadog ou Zabbix), quem abriu é a própria ferramenta, e a descrição traz o link para o erro.
Desconectar apaga os cards?
Não. Desconectar faz o endereço parar de valer e tira a lista de alertas da ferramenta; os cards que já abriram ficam como estão.
Dá para ligar no cadastro?
Dá. No passo das conexões do Começar, marque a ferramenta em Monitoramento de erros (opcional): o projeto já nasce com ela conectada, e o endereço fica em Conexões.

Ainda com dúvida?

Fale com a equipe do benflow: conte o que aconteceu e, se puder, mande um print. Como funciona o suporte