Grupos de erros e agregação

Aprenda como o Zenovay agrupa inteligentemente erros semelhantes para reduzir ruído e acelerar a depuração.

Onde encontrar grupos de erros

Abra o painel de controle do seu site a partir de Domains e selecione a aba Errors. A aba tem duas subabas:

• Errors — a lista agrupada de erros de JavaScript e rede (este artigo).
• Frustration — rage clicks, dead clicks e outros sinais de frustração.

O rastreamento de erros está disponível no plano Pro e superior.

Como funciona o agrupamento de erros

Agrupamento por impressão digital

Em vez de mostrar cada ocorrência individual, o Zenovay colapsa erros idênticos em um único grupo usando uma impressão digital derivada de:

1. Tipo de erro — TypeError, ReferenceError, etc.
2. Mensagem de erro — o padrão da mensagem
3. Stack trace — os frames superiores da pilha de chamadas

Duas ocorrências com a mesma impressão digital caem no mesmo grupo, para que um único erro recorrente apareça uma vez com uma contagem de ocorrências, não milhares de vezes.

Exemplo

Essas duas ocorrências são agrupadas juntas:

// Erro 1: ID de usuário 123
TypeError: Cannot read property 'name' of undefined
    at getUserName (user.js:45:12)
    at renderProfile (profile.js:78:5)

// Erro 2: ID de usuário 456
TypeError: Cannot read property 'name' of undefined
    at getUserName (user.js:45:12)
    at renderProfile (profile.js:78:5)

Mesmo grupo porque:

• Mesmo tipo de erro (TypeError)
• Mesma mensagem
• Mesmo local da stack trace

Lista de grupos de erros

Cada grupo na lista mostra:

Métrica	Descrição
Ocorrências	Número total de vezes que o erro foi acionado
Usuários	Visitantes únicos afetados
Primeira visualização	Quando o grupo foi registrado pela primeira vez
Última visualização	Ocorrência mais recente
Categoria	JavaScript, Rede, Recurso ou Personalizado
Severidade	Crítico, Alto, Médio ou Baixo
Status	Não resolvido, Investigando, Resolvido ou Ignorado

Painel de detalhe do grupo

Clique em um grupo para abrir seu painel de detalhes, que inclui:

• Exemplos de ocorrências — detalhes completos (mensagem, frames de stack, breadcrumbs) para instâncias recentes
• Gráfico de frequência — ocorrências ao longo do tempo
• Páginas afetadas — onde o erro ocorre mais
• Detalhamento de navegador e dispositivo — quais navegadores, sistemas operacionais e dispositivos são afetados
• Insights — orientação específica da categoria sobre por que o erro acontece, onde procurar e como corrigi-lo

Fluxo de trabalho de status de erros

Tipos de status

Status	Descrição
Não resolvido	Erros novos ou ainda abertos — padrão
Investigando	Você está investigando ativamente
Resolvido	A correção foi implantada e o erro deve parar
Ignorado	Problema conhecido que você não planeja corrigir (p. ex. ruído de terceiros)

Alterar status

No painel de detalhes de um grupo de erros, use os botões de status para marcá-lo como Investigando, Resolvido ou Ignorado. Marcar um grupo como Resolvido ou Ignorado o remove da visualização padrão Não resolvido para que sua lista permaneça focada no que está realmente aberto.

Alterar o status requer um papel de equipe com acesso de edição ao site. Visualizadores podem navegar pelos grupos de erros, mas não podem alterar seu status.

Filtragem & Busca

A lista de erros pode ser reduzida com:

Filtro	Opções
Status	Todos, Não resolvido, Investigando, Resolvido, Ignorado
Categoria	JavaScript, Rede, Recurso, Personalizado
Severidade	Crítico, Alto, Médio, Baixo
Intervalo de datas	Hoje, Ontem, 7 / 14 / 30 / 90 dias, Todos os tempos

Uma caixa de busca filtra grupos por mensagem de erro ou tipo. Os intervalos de datas disponíveis dependem da janela de retenção de dados do seu plano.

Supressão de grupos ruidosos

Se um grupo for puro ruído (p. ex. uma ocorrência única de uma extensão do navegador), marque-o como Ignorado no seu painel de detalhes. Grupos ignorados caem da visualização padrão Não resolvido para que sua lista permaneça focada, mas seu histórico é mantido em caso de querer revisitá-lo mais tarde. Se mudar de ideia, mude o status de volta para Não resolvido ou Investigando.

Melhores práticas

Fluxo de trabalho de triagem

1. Revisar regularmente — verifique erros não resolvidos como parte da sua rotina.
2. Priorizar por impacto — um grupo afetando muitos usuários geralmente importa mais do que a contagem bruta de ocorrências.
3. Vitórias rápidas primeiro — resolva correções fáceis imediatamente para reduzir o ruído.
4. Usar status consistentemente — mantenha a lista Não resolvido para coisas que genuinamente precisam de atenção; ignore ruído conhecido de terceiros.
5. Observar picos — configure alertas de desempenho para saber proativamente sobre novos picos de erros.

Agrupamento eficaz

• Mantenha os source maps atualizados para que as stack traces permaneçam legíveis.
• Use mensagens de erro consistentes e descritivas no seu código.
• Adicione contexto a erros rastreados manualmente (personalizados).

Solução de problemas

Muitos grupos

Causas:

• Mensagens de erro altamente dinâmicas (muitos dados variáveis no texto da mensagem)
• Source maps faltantes
• Erros de scripts de terceiros

Soluções:

• Use mensagens de erro estáveis e normalizadas
• Carregue source maps
• Marque ruído de terceiros como Ignorado

Erros não agrupados

Verifique:

• Um stack trace está disponível no erro
• Os erros compartilham o mesmo local de origem
• O tipo de erro e a mensagem combinam

Próximas etapas

• Análise de Stack Trace
• Erros de JavaScript
• Source Maps & JS Errors
• Alertas de desempenho