> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Breadcrumbs

<Tip>
  Les breadcrumbs sont disponibles depuis la version `2.11.2` de la gem Ruby.
</Tip>

Les breadcrumbs ont été initialement implémentés dans notre [bibliothèque JavaScript front-end](/front-end/breadcrumbs) 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.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/frontend/breadcrumbs.svg?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=1f7cb85f6a8662c46a42a3aa90340eb4" alt="Breadcrumbs" width="648" height="366" data-path="assets/images/screenshots/frontend/breadcrumbs.svg" />

## 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 :

<CodeGroup>
  ```ruby Ruby theme={null}
  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")
  ```
</CodeGroup>

Seuls les 20 derniers breadcrumbs ajoutés seront ajoutés à la transaction en cours.

## Options du breadcrumb

| Option   | Type                     | Description                                                                |
| -------- | ------------------------ | -------------------------------------------------------------------------- |
| category | String                   | Catégorie sous laquelle étiqueter l'événement                              |
| action   | String                   | Informations contextuelles relatives à l'événement                         |
| message  | String                   | (facultatif) Un message de log ou autre chaîne à envoyer à AppSignal       |
| metadata | `Object<String, String>` | (facultatif) Un objet de métadonnées relatives à l'événement               |
| time     | Time object              | (facultatif) Objet Time qui répond à `.to_i`, valeur par défaut `Time.utc` |