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.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.

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 atributodata-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:
Adicionando seus próprios breadcrumbs
Registre qualquer outra coisa que valha a pena saber comaddBreadcrumb():
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.queryParamsAllowlistos remove por padrão dos breadcrumbs de navigation e defetch/XMLHttpRequest. O breadcrumb do carregamento inicial do documento é uma exceção. - Chamadas
fetcheXMLHttpRequestbloqueadas. Chamadas que correspondem aprivacy.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.
beforeBreadcrumb.
Lendo breadcrumbs de rede
Um breadcrumb de rede se lê como método, URL e status sempre que uma resposta chegou, incluindo respostas404 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”.

O botão Open trace em um breadcrumb de rede que carrega um trace ID.
Timing-Allow-Origin. Essa é uma restrição do navegador, não do AppSignal.