Pular para o conteúdo principal
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.
Um breadcrumb é uma entrada em um rastro ordenado no tempo do que aconteceu no navegador antes de um erro. Reconstruir um bug de front-end apenas a partir de um stack trace costuma ser adivinhação. Ele mostra a rota anterior e no que o usuário clicou. Também mostra requisições e avisos ou erros do console. Breadcrumbs são coletados automaticamente após init(). Até 25 breadcrumbs do buffer de contexto de erro acompanham cada erro relatado, incluindo um breadcrumb para esse próprio erro. Você os lê no sample da issue.

Onde os breadcrumbs aparecem

  • Erros de navegador: no sample do erro.
  • Performance traces do navegador: na seção Breadcrumbs do trace.
  • O back-end de um trace de navegador: a parte de back-end do trace mostra os mesmos breadcrumbs do navegador. Isso funciona quando uma requisição do navegador continua no seu back-end por meio de distributed tracing.
A seção Breadcrumbs de um performance trace no AppSignal, listando breadcrumbs de navegação, rede, long task, clique e erro, com os detalhes de tempo de uma requisição de rede mostrados em um tooltip.

Requisições de rede mostram método, URL, status e duração em uma única linha.

O que é coletado

Estas categorias automáticas podem aparecer junto com um relatório de erro: As opções breadcrumbs podem desligar a coleta de network, console, click e long_task. navigation, visibility e error não têm um interruptor separado.

Rotulando elementos

Breadcrumbs de seleção descrevem o elemento como uma pessoa o reconheceria, e não pela sua posição na página. O AppSignal primeiro procura um atributo data-breadcrumb. Caso contrário, usa o tipo do elemento e seu texto, como button "Submit". Se nada ajudar, usa a tag e o ID, como input#cvc. Quando o rótulo automático não ajuda, ou quando o texto visível é algo que você prefere não enviar, defina o seu próprio:
O atributo é lido no elemento ou em qualquer um de seus ancestrais, então rotular um contêiner cobre tudo dentro dele.

Adicionando seus próprios breadcrumbs

Registre qualquer outra coisa que valha a pena saber com addBreadcrumb():
Seus próprios breadcrumbs acompanham os erros, qualquer que seja a categoria que você lhes dê.

O que o SDK não captura automaticamente

  • Corpos de requisição e resposta. O SDK não os lê nas chamadas de rede. Se um payload importa para depurar, adicione apenas as partes de que você precisa com addBreadcrumb().
  • Cookies. O SDK não lê nem escreve nenhum.
  • Parâmetros de query na maioria dos campos de URL criados pelo SDK. privacy.queryParamsAllowlist os remove por padrão dos breadcrumbs de navigation e de fetch/XMLHttpRequest. O breadcrumb do carregamento inicial do documento é uma exceção.
  • Chamadas fetch e XMLHttpRequest bloqueadas. Chamadas que correspondem a privacy.networkBlocklist, e chamadas para o próprio endpoint do AppSignal, não deixam breadcrumb. Também nunca são relatadas como requisições com falha. O breadcrumb do carregamento inicial do documento não é coberto pela blocklist.
  • Texto e elementos que você mascarou. Leia mais em mascarando e bloqueando elementos da página.
Para filtrar ou ocultar breadcrumbs individuais no momento em que são registrados, use beforeBreadcrumb.

Lendo breadcrumbs de rede

Um breadcrumb de rede se lê como método, URL e status sempre que uma resposta chegou, incluindo respostas 404 e 500. Um sufixo (error) significa que nenhuma resposta chegou. A causa pode ser uma falha de DNS, uma conexão recusada ou uma requisição bloqueada. Uma requisição que enviou um header traceparent também registra seu trace ID no breadcrumb. A linha dela mostra um botão Open trace e, ao selecioná-lo, você abre a linha do tempo do trace relacionado. A linha do tempo só mostra spans de back-end se o serviço receptor estiver instrumentado. Ela também só os mostra se o trace estiver dentro do seu período de retenção de dados. Caso contrário, ela mostra “No backend spans found for this request”.
Card de breadcrumbs com duas requisições de rede, uma navegação e um erro. O ponteiro está sobre o ícone ao lado de GET /api/boom/, que retornou 500, e seu tooltip mostra "Open trace".

O botão Open trace em um breadcrumb de rede que carrega um trace ID.

Requisições cross-origin não relatam detalhamento de tempos, a menos que o servidor envie um cabeçalho Timing-Allow-Origin. Essa é uma restrição do navegador, não do AppSignal.