Disponível nos planos Observe .
O recurso de rastreamento de console captura erros de console JavaScript que seus usuários estão enfrentando durante uma sessão. Você pode visualizar erros de console ao lado de uma reprodução de gravação e dar zoom out para visualizar uma tendência ou outras gravações do mesmo erro ocorrendo para ver se há um problema mais generalizado. Ao aplicar um filtro de Erro, você também pode refinar seus dados de sessão com base em erros de console. Isso permite que você identifique problemas em seu site, investigue a causa e priorize uma correção.
Todos os Sites inicialmente têm o rastreamento de console desativado por padrão. Depois que um membro da equipe com permissões de Admin ativou o rastreamento de console nas configurações do seu Site, as sessões futuras começarão a capturar logs de console.
Este artigo abordará o seguinte:
- Como ativar e desativar o rastreamento de console
- Como visualizar erros no console do player de gravações
- Como aplicar o filtro de Erro à sua lista de gravações
- Quais tipos de erros são capturados
- Perguntas frequentes sobre o rastreamento de console
Os dados de gravações não podem ser exportados quando um filtro de Erro é aplicado
Quando um filtro de Erro é aplicado à sua Lista de Reprodução de Gravações, atualmente não é possível exportar esses dados. Se você tentar exportar dados de gravações com o filtro aplicado, verá a seguinte mensagem: Algo deu errado. Por favor, ajuste seus filtros e tente novamente.
Como ativar e desativar o rastreamento de console
Permissões de administrador são necessárias para fazer alterações no rastreamento de console
Você precisará ter níveis de permissão de Admin para ativar ou desativar o rastreamento de console nas configurações do seu site. Você pode verificar quais membros da equipe têm o nível de permissão de Admin necessário visitando sua página de equipe.
Visite sua página de Sites & Organizações.
Clique no ícone de configurações do site para visitar a página de configurações do seu site.
Clique na seção Segmentação de sessão e rastreamento na página de configurações do seu site.
Clique em Capturar erros de JavaScript e logs de console para ativar ou desativar isso, depois clique em Salvar alterações.
Como visualizar erros no console do player de gravações
Visite a sua página de Gravações.
Clique em Reproduzir em qualquer gravação na lista de reprodução.
Dentro do reprodutor de Gravações, clique no ícone Abrir console para mostrar o console de Gravações.
Na aba Informações da Sessão, você pode ver se ocorreram erros de console na gravação atual e o número de erros. Você também poderá visualizar esses erros no console de Gravações acima da linha do tempo de reprodução.
Quando você se depara com um erro de console em uma reprodução de gravação, você também pode ver uma tendência ou gravações do mesmo erro ocorrendo ao clicar no ícone de erro na barra de ferramentas de reprodução e selecionar Ver tendência ou o ícone de reprodução de gravações.
Quando o rastreamento de console está desativado, você verá a mensagem mostrada abaixo pedindo para ativar o rastreamento de console. Se você tiver níveis de permissão de Administrador níveis de permissão, clicar em Ativar rastreamento de console ligará o rastreamento de console. Para desligá-lo novamente, siga os passos na seção Como ativar ou desativar o rastreamento de console acima.
Você também pode criar problemas no Jira que serão integrados diretamente dos erros de console gerados para a sua conta Jira. Nós abordamos isso em Integração do Hotjar com o Jira.
Como aplicar o filtro de Erro à sua lista de Gravações
O filtro de Erro refina os dados da sua sessão com base em se ocorreu ou não um erro de console JavaScript. Você pode refinar ainda mais este filtro especificando condições para o texto do erro e URL da página. Isso inclui se o texto do erro e a URL da página contém, é, não é, ou não contém. Atualmente, o filtro de Erro está disponível apenas com a ferramenta de Gravações.
Quais tipos de erros são capturados
Atualmente, estamos capturando erros JavaScript não capturados que foram lançados via:
-
window.addEventListener('error', errorCapture.onError);
Isso ocorre quando houve um erro ao carregar um arquivo externo ou ao usar um recurso. Como uma imagem, ou se um script tem um erro de execução.
-
window.addEventListener('unhandledrejection', errorCapture.onUnhandledRejection);
Isso pode ocorrer quando uma Promessa JavaScript que não tem um manipulador de rejeição é rejeitada.
Perguntas frequentes sobre o rastreamento de console
O que acontece com o rastreamento do console se eu rebaixar meu plano?
Ao rebaixar para um plano que não suporta rastreamento de console, a captura de erros não funcionará mais e nenhuma informação do console será registrada. A opção de rastreamento do console será cinza nas configurações do seu site, e a caixa de seleção relacionada permanecerá 'marcada' ou 'desmarcada' com base no que foi configurado no momento do rebaixamento.
Se você atualizar seu Site Hotjar para um plano Observe Scale no futuro, o recurso de rastreamento do console será retomado com base nas suas configurações previamente salvas. O rastreamento do console não funcionará a menos que o Site esteja em um plano Observe Scale, independentemente das configurações cinza. Erros que ocorrem enquanto o site está em um plano não-Scale não serão registrados mesmo que a caixa de seleção esteja 'marcada'.
Posso ver uma visão geral de todos os erros que ocorrem no meu site?
Não existe uma lista completa de todos os erros, mas seu Painel tem uma seção onde você pode ver os Principais erros do console ocorrendo em seus dados de sessão. Essa informação é visível em forma de gráfico de barras/pizza ou gráfico de linhas.