Browser monitoring é uma funcionalidade em beta do AppSignal Labs. O
pacote
@appsignal/browser é publicado sob a tag beta no npm, e sua
configuração e API ainda podem mudar entre releases beta. Compartilhe seu
feedback na nossa comunidade no Discord.Como os erros são agrupados
O AppSignal agrupa erros relacionados em issues com base na rota relatada e nas configurações de agrupamento da sua aplicação. Ocorrências repetidas podem aparecer como uma única issue para triar. A rota é aquela que o SDK relatou por meio desetRouteTemplate(), ou o caminho da página quando nada foi declarado. Sem um template, /orders/1 e /orders/2 são rotas de erro diferentes. Um mesmo bug pode assim virar duas issues.
Lendo a lista de issues
Cada issue na lista traz:- A classe do erro e a mensagem, com a rota em que aconteceu.
- A versão em que foi introduzido. Se ele aparecer primeiro no seu release mais recente, examine esse deploy.
- Uma tendência para o período selecionado, para que um pico se leia de forma diferente de um fluxo constante.
- O número total de ocorrências no período.
- Quando foi visto pela última vez.
- Para quem está atribuído.
Filtrando por tempo e versão
- Intervalo de tempo. Predefinições de uma hora a 30 dias, ou um intervalo personalizado.
- Versão. Restrinja a lista aos erros relatados por um único release. Combinado com a coluna de introdução, é assim que você confirma se um deploy é o responsável.
Investigando uma issue
Selecione uma issue na lista para abri-la em um painel lateral. O painel tem duas abas:- Sample: uma vez em que o erro aconteceu no navegador de um usuário.
- Logbook: as notas do seu time sobre a issue, com suas mudanças de estado e issues do GitHub vinculadas.
- Error message e Tags.
- O backtrace, para erros lançados pelo seu código.
- Trace service map e Trace timeline.
- Linhas de log relacionadas, quando o back-end está instrumentado.
- Breadcrumbs.
- Leia a mensagem. Ela diz o que falhou. Por exemplo,
POST https://api.example.com/orders: HTTP 503significa que a API de checkout retornou um erro de servidor. - Verifique o backtrace em busca de erros lançados pelo seu código. Ele mostra onde o erro aconteceu no seu código. Se você ver código minificado em vez de nomes de arquivo e linhas legíveis, envie os sourcemaps da versão definida em
appVersion. - Leia os breadcrumbs. Eles mostram eventos antes do erro, como a seleção de um botão ou uma requisição de rede. Se o usuário selecionou Pay pouco antes de
/orderslevar três segundos, verifique primeiro essa requisição à API. - Verifique a versão e as tags. Compare a versão do sample com seus deploys recentes. Use tags definidas com
setTags()para restringir quem foi afetado.
HTTPError ou TimeoutError não tem backtrace. A aba Sample mostra o trace dela em vez disso. Os cards Trace service map e Trace timeline mostram o span de navegador dela. Se o back end estiver instrumentado, os spans dele aparecem ali também, seguidos pelas linhas de log relacionadas. Open full trace page, o ícone ao lado do número da issue, abre a página completa da issue.

O painel lateral de uma requisição com falha: os serviços navegador e Django em um único trace, depois sua linha do tempo e linhas de log relacionadas.
Triagem e notificações
Você pode atribuir, silenciar e mudar o estado dessas issues. Elas também têm suporte a configurações de notificação. Leia mais em Errors. Como erros de front-end ficam no namespacebrowser (veja namespaces), essas configurações são separadas das do seu back end. Se você migrar do @appsignal/javascript, configure as notificações para browser. As configurações para frontend não são transferidas. Leia mais no guia de migração.
Erros que você não vai encontrar aqui
Alguns erros nunca chegam ao SDK. Por exemplo, erros antes deinit() e erros dentro de iframes não instrumentados. Erros opacos de script cross-origin são descartados. Cada um tem uma solução alternativa, listada em erros que não são relatados. Se um erro que você esperava está faltando, percorra a solução de problemas.