A aba Erros transforma os relatos de erro do seu site em uma lista curta: uma linha por erro, com a frequência e o número de visitas que o encontraram no período escolhido. Relatos que não vêm do seu próprio código nem de visitantes reais ficam fora dos números, então a lista começa pelo que precisa da sua atenção.
O rastreamento de erros está incluído no Pro, Scale e Enterprise. Seu plano define até onde vai o histórico de erros: 60 dias no Pro, 120 dias no Scale e 180 dias no Enterprise.
Onde encontrar
Abra seu site em Domínios e selecione Erros no grupo Confiabilidade da barra lateral. A aba tem duas subabas: Erros (este artigo) e Frustração, para cliques de raiva e cliques sem resposta.
Se o rastreamento de erros estiver desativado para o site, a aba informa isso. Quem pode editar o site vê Ativar rastreamento de erros; veja Rastreamento de Erros JavaScript.
O resumo e os blocos
Uma frase no topo resume o período: quantos erros precisam de atenção, quantos são novos, quantos voltaram a ocorrer depois de resolvidos e quantos relatos ficaram ocultos como ruído. Ela é montada a partir dos números, então sempre corresponde à lista.
| Bloco | O que conta |
|---|---|
| Precisam de atenção | Erros abertos (novos ou em andamento) que ocorreram neste período. Ruído e erros ignorados não entram. |
| Novos | Erros vistos pela primeira vez neste período que ainda precisam de atenção. |
| Visitas afetadas | Pelo menos este número de visitas encontrou um desses erros. Repetições do mesmo erro em menos de uma hora são guardadas uma vez, e visitas de bots ficam de fora. |
| Eventos de erro | Relatos de erro deste período, sem ruído e sem erros ignorados. A variação compara com o período logo antes, até o mesmo horário do dia. Quando esse período fica fora do histórico de erros do seu plano, o bloco mostra Sem comparação. |
Cada número da aba vale para o período escolhido, no fuso horário do seu site. O gráfico abaixo mostra os relatos por hora, dia ou semana: erros reais em cor, ruído em cinza claro. Selecione Ruído na legenda para ocultá-lo.
A lista
Escolha uma visualização no topo da lista:
- Precisam de atenção (o padrão): erros abertos, ordenados por visitas afetadas.
- Todos os problemas: todos os erros do período, seja qual for o status.
- Ocultos com a contagem: os relatos que ficam fora como ruído.
Cada erro tem um título legível, como "HTTP 500 de /api/checkout", "Não foi possível carregar /img/hero.webp de cdn.example.com" ou "Página não encontrada: /old-pricing". A linha mostra o tipo, a página onde mais ocorre, quando foi visto pela primeira vez, uma linha de tendência do período e o status. O selo Novo marca uma primeira ocorrência, Voltou a ocorrer um erro que se repetiu depois de resolvido, e uma porcentagem mostra uma variação notável em relação ao período anterior.
Use Filtros para restringir a lista por Status, Tipo (JavaScript, Requisição, Arquivo, Página não encontrada, Personalizado) e Ordenar por (Maior impacto, Mais eventos, Mais recentes, Novos primeiro). A busca encontra erros pela mensagem ou pelo endereço. Um botão abaixo da lista mostra os próximos 25 erros. No celular, a lista mostra um cartão por erro.
O que conta como ruído
Esses relatos ficam fora dos números e da lista, mas continuam disponíveis para consulta. Abra Ocultos para vê-los; o rodapé da lista mostra cada motivo com a contagem.
Repetições de um erro na mesma hora são contadas, mas não guardadas. Quando a Zenovay por isso não consegue verificar cada relato de um erro, o erro continua na lista com Possível ruído e o motivo provável, para que um erro real não seja ocultado como ruído.
| Motivo | Exemplo |
|---|---|
| Bots e scanners | Todos os relatos vieram de visitas marcadas como bots. |
| Scanners de segurança | A mensagem contém um teste de ataque típico, como injeção de script. |
| Extensões do navegador | O erro ocorreu dentro de uma extensão que um visitante instalou. |
| Scripts de outros domínios | "Script error." é tudo o que um navegador informa sobre um script de outro domínio. |
| Mensagens inofensivas do navegador | "ResizeObserver loop" ou uma requisição cancelada. |
| Problemas de conexão | A rede do visitante caiu ou mudou, por exemplo "Failed to fetch". |
| Outros sites | Todos os relatos vieram de outro host, como uma implantação de pré-visualização. |
| Arquivos de terceiros | Um arquivo ou uma requisição em outro domínio falhou, como um pixel de rastreamento. |
Os detalhes de um erro
Selecione um erro para abrir os detalhes, como painel lateral no desktop e como painel de baixo para cima no celular. Eles mostram:
- os eventos e as visitas do período, a primeira e a última ocorrência e os relatos desde a primeira ocorrência,
- O que isso significa em palavras simples (ou Por que está oculto para ruído),
- Relatos ao longo do tempo no período,
- URLs com falha para arquivos, requisições e páginas inexistentes, com seus relatos,
- Páginas afetadas e Navegadores e dispositivos,
- Relatos recentes, cada um com o stack trace e as ações do visitante antes do erro.
Pressione Esc para fechar o painel. Envie seus source maps para ver os nomes originais dos arquivos nos stack traces; veja Source maps para erros JS.
Mudar o status
Se você pode editar o site, use os botões dos detalhes:
| Status | Quando usar |
|---|---|
| Aberto | O erro precisa de atenção. Erros novos começam aqui; Reabrir volta a este status. |
| Em andamento | Alguém está cuidando dele. Selecione Marcar em andamento. |
| Resolvido | A alteração está no ar. Selecione Resolver. Se o erro ocorrer de novo, ele volta com o selo Voltou a ocorrer. |
| Ignorado | Você não pretende agir. Selecione Ignorar; erros ignorados continuam ocultos mesmo que ocorram de novo. |
Para mudar vários erros de uma vez, marque as caixas de seleção e use a barra no fim da lista: até 25 erros por alteração. Quem tem acesso só de leitura vê a mesma lista sem as ações.
Painéis compartilhados e exportação
Quando a aba Erros é compartilhada em um painel público, ele mostra a mesma visualização em modo somente leitura, com os erros abertos ou todos. No painel da sua equipe, a exportação lista os erros filtrados com os números do período. Veja Exportando Dados de Análise.