Pular para o conteúdo principal
Ao depurar um problema em uma UI, pode ser útil saber quais eventos ocorreram antes do erro ser lançado. Breadcrumbs são uma lista de eventos da sua aplicação ordenada por tempo, que é preenchida conforme o usuário navega pela aplicação, e é enviada junto com um Span sempre que um erro é capturado pela biblioteca. Isso permite que você reúna informações úteis para reproduzir erros difíceis de depurar, refazendo o caminho do usuário pela aplicação. Breadcrumbs

Uso

Por padrão, nenhum breadcrumb é rastreado, mas é muito fácil rastrear os seus. Como alternativa, você pode usar um dos nossos plugins de breadcrumbs para coletar automaticamente alguns tipos de breadcrumbs. Sempre que um evento, operação ou mudança de estado interessante ocorrer na sua aplicação, você pode deixar um breadcrumb assim:
import Appsignal from "@appsignal/javascript";

const appsignal = new Appsignal({
  key: "YOUR FRONTEND API KEY",
});

appsignal.addBreadcrumb({
  category: "", // e.g. "UI", "Network", "Navigation", "Console"
  action: "", // e.g "The user clicked a button", "HTTP 500 from http://blablabla.com"
  metadata: {}, // key/value metadata in <String, String> format
});
Quando um erro é lançado e capturado pela biblioteca AppSignal, ou um Span é passado para appsignal.send(), a lista atual de breadcrumbs é adicionada ao Span atual e enviada para o servidor. A lista de breadcrumbs é então esvaziada.

Opções de breadcrumb

OpçãoTipoDescrição
categoryStringCategoria sob a qual rotular o evento
actionStringInformações contextuais relacionadas ao evento
messageString(opcional) Uma mensagem de log ou outra string para enviar ao AppSignal
metadataObject<String, String>(opcional) Um objeto de metadados relacionado ao evento

Plugins

Há vários plugins disponíveis para habilitar a coleta automática de breadcrumbs, e mais serão adicionados com o tempo: Tem uma boa ideia para um plugin de breadcrumbs? Entre em contato conosco ou abra uma issue no GitHub!