Passer au contenu principal
Lors du débogage d’un problème dans une interface utilisateur, il peut être utile de savoir quels événements se sont produits avant le déclenchement de l’erreur. Les fils d’Ariane (breadcrumbs) sont une liste chronologique des événements de votre application, qui est remplie au fur et à mesure qu’un utilisateur parcourt votre application, et qui est envoyée avec un Span chaque fois qu’une erreur est interceptée par la bibliothèque. Cela vous permet de rassembler des informations utiles pour reproduire des erreurs difficiles à déboguer, en retraçant le parcours d’un utilisateur dans votre application. Fils d'Ariane

​
Utilisation

Par défaut, aucun fil d’Ariane n’est suivi, mais il est très facile de suivre les vôtres. Vous pouvez également utiliser l’un de nos plugins de fils d’Ariane pour collecter automatiquement certains types de fils d’Ariane. Partout où un événement, une opération ou un changement d’état intéressant se produit dans votre application, vous pouvez laisser un fil d’Ariane comme ceci : 
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
});
Lorsqu’une erreur est levée et interceptée par la bibliothèque AppSignal, ou qu’un Span est transmis à appsignal.send(), la liste actuelle des fils d’Ariane est ajoutée au Span en cours et envoyée au serveur. La liste des fils d’Ariane est ensuite vidée.

​
Options des fils d’Ariane

OptionTypeDescription
categoryStringCatégorie pour étiqueter l’événement
actionStringInformations contextuelles liées à l’événement
messageString(optionnel) Un message de journal ou une autre chaîne à envoyer à AppSignal
metadataObject<String, String>(optionnel) Un objet de métadonnées liées à l’événement

​
Plugins

Plusieurs plugins sont disponibles pour permettre la collecte automatique des fils d’Ariane, et d’autres seront ajoutés au fil du temps : Vous avez une bonne idée de plugin de fils d’Ariane ? Contactez-nous ou laissez une issue sur GitHub !