Passer au contenu principal
Les breadcrumbs sont disponibles depuis la version 2.11.2 de la gem Ruby.
Les breadcrumbs ont été initialement implémentés dans notre bibliothèque JavaScript front-end avec l’idée qu’ils aideraient à déboguer un problème lorsque vous avez une trace de breadcrumbs avec des actions (utilisateur) menant à l’erreur. Nous avons ensuite réalisé que cela pouvait également être utile pour les requêtes back-end, où vous pouvez ajouter une liste chronologique d’actions menant à l’erreur. Par exemple, en ajoutant des breadcrumbs à travers des arbres de décision qui ne sont pas autrement instrumentés. Breadcrumbs

​
Utilisation

Par défaut, aucun breadcrumb n’est suivi, mais il est très facile de suivre les vôtres. Partout où un événement intéressant, une opération ou un changement d’état se produit dans votre application, vous pouvez laisser un breadcrumb comme ceci : 
Appsignal.add_breadcrumb("Navigation", "https://example.com", "", { :response => 200 }, Time.now.utc)
Appsignal.add_breadcrumb("Network", "[GET] https://example.com", "", { :response => 500 })
Appsignal.add_breadcrumb("UI", "closed modal(change_password)", "User closed modal without actions")
Seuls les 20 derniers breadcrumbs ajoutés seront ajoutés à la transaction en cours.

​
Options du breadcrumb

OptionTypeDescription
categoryStringCatégorie sous laquelle étiqueter l’événement
actionStringInformations contextuelles relatives à l’événement
messageString(facultatif) Un message de log ou autre chaîne à envoyer à AppSignal
metadataObject<String, String>(facultatif) Un objet de métadonnées relatives à l’événement
timeTime object(facultatif) Objet Time qui répond à .to_i, valeur par défaut Time.utc