Triagem de erros automatizada, pronta antes do standup
O Okou é um agente de IA para DevOps que automatiza a triagem diária de erros. Toda manhã, ele coleta os erros não resolvidos do Sentry e do Axiom, os deduplica entre as duas fontes e abre issues atribuídas no GitHub com stack traces completos antes do standup, economizando de 20 a 30 minutos de revisão manual dos engenheiros.
O que é triagem de erros?
Triagem de erros, também chamada de bug triage ou incident triage, é o processo de agrupar, priorizar e atribuir os erros de produção para que os engenheiros saibam o que corrigir primeiro. O Okou atua como um agente de IA de SRE entre Sentry, Axiom e GitHub: ele deduplica erros, aplica limites, anexa stack traces e atribui os responsáveis pelo código. O resultado é uma automação consistente de triagem diária de erros com menos fadiga de alertas.
Por que a triagem manual de erros gera fadiga de alertas
Toda manhã, um engenheiro precisa abrir o Sentry, percorrer os alertas não resolvidos, cruzar com o Axiom, identificar o que é novo ou duplicado, decidir o que é sério, abrir issues no GitHub e encontrar o responsável certo. Essa primeira passada repetitiva custa de 20 a 30 minutos de tempo de engenharia focado e gera fadiga de alertas antes mesmo do trabalho de verdade começar. O Okou roda às 8h45 e conclui a mesma triagem antes que alguém abra o laptop.
Como o Okou automatiza a triagem diária de erros
Passo 1: conecte suas ferramentas
Passo 2: peça ao Okou
Passo 3: leve mais longe
Integrações com Sentry, GitHub e Axiom para triagem de erros
Este fluxo é uma integração entre Sentry e GitHub com um agente no meio: o Okou lê do Sentry, confere a mesma janela de tempo no Axiom e escreve no GitHub. Cada conector é autorizado separadamente e fica limitado ao que o fluxo realmente usa, então o acesso de leitura aos seus dados de erro nunca significa acesso de escrita aos seus repositórios.
Integração com o Sentry: os erros que o Okou lê
ObrigatórioO Okou lê o seu rastreamento de erros no Sentry pela API de issues e consulta os erros não resolvidos nos ambientes que você indicar, ordenados por frequência. De cada um ele lê o título e o culprit, a contagem de eventos e de usuários afetados, o nível e os horários de primeira e última ocorrência, e depois busca o evento mais recente para obter o stack trace completo com as tags de release e ambiente. Isso cobre o que a decisão de triagem precisa: o que quebrou, com que frequência, onde e desde quando. Neste fluxo a integração com o Sentry é somente leitura: o Okou nunca resolve, mescla ou reatribui suas issues do Sentry, e o registro que ele escreve vai para o GitHub.
Integração com o GitHub: as issues que o Okou abre
ObrigatórioTodo erro que passa do seu limite vira uma issue no repositório que você indicar ao Okou. A issue traz o título do erro, o stack trace, a contagem de ocorrências e de usuários afetados, os horários de primeira e última ocorrência e um link de volta para a issue do Sentry, para os dados originais ficarem a um clique. O Okou aplica as labels que você definir e atribui o code owner dos arquivos citados no stack trace. O acesso de escrita se limita aos repositórios que você autorizar, e abrir issues é tudo o que ele faz: sem commits, sem pull requests, sem mexer nas configurações do repositório.
Integração com o Axiom: os logs do Axiom que o Okou cruza
OpcionalO Axiom é opcional e se justifica pela deduplicação. Se a sua gestão de logs já roda no Axiom, o Okou a lê na mesma passagem: ele roda uma consulta APL nos datasets que você escolher, limitada à mesma janela de tempo da leitura do Sentry, e compara esses logs do Axiom com as assinaturas de erro que já tem. Isso pega o caso em que uma mesma falha aparece duas vezes em formatos diferentes e acrescenta o contexto no nível da requisição em torno da falha, que o evento do Sentry sozinho não carrega. Sem o Axiom o fluxo roda do início ao fim mesmo assim, e a deduplicação passa a se apoiar só nos dados do Sentry.
Okou vs. triagem manual vs. regras de alerta do Sentry
A triagem diária de erros é a primeira camada da resposta automatizada a incidentes. Os times automatizam do Sentry ao GitHub com o Okou, concluindo a primeira passada repetitiva antes que um problema exija um gerenciamento de incidentes com IA mais amplo.
Triagem manual
Um engenheiro revisa o Sentry e o Axiom, identifica duplicados, decide a severidade, abre issues e encontra um responsável. É flexível, mas repete os mesmos 20 a 30 minutos de trabalho toda manhã.
Regras de alerta do Sentry
As regras notificam o time quando um limite é ultrapassado. São úteis para a detecção, mas o time ainda precisa correlacionar logs, deduplicar erros, criar issues no GitHub e atribuir responsáveis.
A automação de workflow do Okou para o Sentry
O Okou roda a automação do Sentry de ponta a ponta: consulta, deduplicação entre fontes, aplicação de limites, criação de issues, anexação de stack traces e atribuição aos responsáveis pelo código. As execuções sob demanda e pós-deploy usam o mesmo workflow.
Dicas para melhores resultados
Perguntas frequentes
Como fazer a triagem de erros do Sentry e transformá-los em issues do GitHub?
Para criar issues no GitHub a partir do Sentry automaticamente, conecte o Sentry e o GitHub ao Okou e então dê a ele um agendamento ou um prompt sob demanda. O Okou consulta os erros não resolvidos, aplica filtros de ocorrências e de ambiente, cria uma issue por erro que se qualifica, anexa o stack trace e os horários, e atribui um responsável pelo código.
Como deduplicar erros entre o Sentry e o Axiom?
Sim. O Okou compara assinaturas de erro, stack traces, mensagens e tempo entre o Sentry e o Axiom, e então mescla os eventos correspondentes em um único registro de triagem. Cada fonte de origem permanece vinculada para investigação.
Como reduzir a fadiga de alertas do monitoramento de erros?
Limite a triagem à produção, defina um limite de ocorrências, deduplique o mesmo erro entre as ferramentas e encaminhe os erros de baixo volume para um resumo em vez de criar uma issue. Isso mantém a fila focada nos erros que exigem ação.
O Okou pode rodar a triagem de erros após cada deploy?
Sim. Crie uma automação que inicie o workflow de triagem de erros após um deploy ou merge na main, opcionalmente aguarde uma breve janela de observação e então verifique o Sentry em busca de novos erros de produção e abra as issues que se qualificam.
Quais ferramentas a automação de triagem de erros precisa?
Sentry e GitHub são obrigatórios: o Sentry fornece os dados dos erros e o GitHub recebe as issues atribuídas. O Axiom é opcional, mas adiciona contexto de logs e melhora a deduplicação entre fontes.
Quais permissões a integração entre Sentry e GitHub precisa?
O Sentry precisa de acesso de leitura a issues e eventos dos projetos que você tria. O GitHub precisa de permissão de escrita de issues nos repositórios que vão recebê-las. O Axiom, se você usar, precisa de acesso de consulta aos datasets indicados. Cada conector é autorizado separadamente no Okou, e revogar um não afeta os outros.
O Okou pode abrir issues em mais de um repositório do GitHub?
Pode. Informe qual serviço ou projeto corresponde a qual repositório e o Okou encaminha cada issue de acordo: erros de frontend vão para o repositório web e erros de API para o do backend. Esse mapeamento fica no prompt, então você pode mudá-lo sem reconfigurar o conector do GitHub.
O Okou muda alguma coisa no Sentry?
Não. Aqui a integração com o Sentry é somente leitura: o Okou consulta issues e eventos e não escreve nada de volta. Os status das suas issues, as atribuições e o histórico de resoluções ficam exatamente como seu time deixou. A única coisa que o Okou cria é a issue no GitHub.
Rode sua primeira triagem do Sentry
Conecte o Sentry, o GitHub e, opcionalmente, o Axiom. Use o mesmo prompt de triagem diária para ver o workflow em ação sem precisar reconstruí-lo manualmente.