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

# Fils d'Ariane

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.

<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="Fils d'Ariane" width="648" height="366" data-path="assets/images/screenshots/frontend/breadcrumbs.svg" />

## 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](#plugins) 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 :

<CodeGroup>
  ```js JavaScript theme={null}
  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
  });
  ```
</CodeGroup>

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

| Option   | Type                     | Description                                                                 |
| -------- | ------------------------ | --------------------------------------------------------------------------- |
| category | String                   | Catégorie pour étiqueter l'événement                                        |
| action   | String                   | Informations contextuelles liées à l'événement                              |
| message  | String                   | (optionnel) Un message de journal ou une autre chaîne à envoyer à AppSignal |
| metadata | `Object<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 :

* [`@appsignal/plugin-breadcrumbs-console`](https://github.com/appsignal/appsignal-javascript/tree/develop/packages/plugin-breadcrumbs-console)
* [`@appsignal/plugin-breadcrumbs-network`](https://github.com/appsignal/appsignal-javascript/tree/develop/packages/plugin-breadcrumbs-network)

Vous avez une bonne idée de plugin de fils d'Ariane ? Contactez-nous ou [laissez une issue sur GitHub](https://github.com/appsignal/appsignal-javascript/issues) !