# Traces

Source: https://instatus.com/help/fr/observability/traces

Une trace est une requête, suivie à travers chaque service qu’elle touche. Chaque étape est un span : un appel HTTP, une requête de base de données, un appel à un autre service. Les traces montrent où une requête lente a passé son temps et où une requête en erreur a échoué.

Ouvrez **Observability** → **Traces** sur votre page de statut. Chaque ligne est une requête.

![L’explorateur de traces, avec la durée des requêtes au fil du temps et une ligne par requête](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Trouver](https://instatus.com/help/fr/observability/traces#trouver-les-requêtes-lentes-et-en-erreur) | status:error, duration:>1s, service: |
| [Ouvrir](https://instatus.com/help/fr/observability/traces#ouvrir-une-trace) | Cliquer sur une ligne pour voir sa cascade |
| [Corriger](https://instatus.com/help/fr/observability/traces#corriger-une-requête-en-erreur) | Copier un prompt de correction pour votre agent de code |
| [Logs](https://instatus.com/help/fr/observability/traces#ouvrir-une-trace) | Passer aux logs d’une requête |

Les traces arrivent dès que votre app les envoie : cochez **Traces** en [copiant le prompt de configuration](https://instatus.com/help/fr/observability/send-logs#option-1--copier-un-prompt), ou utilisez l’auto-instrumentation.

## Lire le graphique

Chaque point est une requête, placée selon son moment et sa durée. Les points rouges ont échoué. Au-dessus du graphique :

- **Traces** : le nombre de requêtes trouvées.
- **Erreurs** : combien ont échoué, et leur part.
- **p50**, **p95**, **p99** : la moitié, 95 % et 99 % des requêtes ont été plus rapides que cette valeur.

Faites glisser sur le graphique pour zoomer sur une fenêtre de temps.

## Trouver les requêtes lentes et en erreur

Utilisez le champ de recherche comme sur la page [Logs](https://instatus.com/help/fr/observability/logs#filtrer). Ces filtres sont faits pour les traces :

| Filtre          | Trouve                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | Les requêtes qui ont échoué                                |
| `duration:>1s`  | Les requêtes de plus d’une seconde. Aussi `>500ms`, `<100ms` |
| `service:api`   | Les requêtes traitées par un service                     |
| `span.name:`    | Les spans portant un nom donné, comme `GET /v1/users`    |
| Tout attribut   | Comme `http.route:` ou `http.response.status_code:` |

Le texte libre cherche dans les noms de spans. **Spans racines** est activé par défaut, chaque requête apparaît donc une fois. Désactivez-le pour lister chaque span séparément.

Le bouton de téléchargement exporte la liste en CSV.

## Ouvrir une trace

Cliquez sur une ligne. La trace s’ouvre avec chaque span sur une frise, imbriqué sous le span qui l’a appelé. Les barres longues montrent où est passé le temps.

![Une trace qui traverse trois services, avec un appel lent à Okta en bas de la cascade](https://instatus.com/help/observability/trace-waterfall.png)

Dans cet exemple, le chargement d’une page prend 842 ms. La cascade montre pourquoi : `web` appelle `api`, `api` appelle `sso`, et `sso` attend Okta pendant 468 ms.

- Cliquez sur un span pour voir ses attributs, comme la route, le code de statut ou la requête de base de données.
- **N logs de ce span** ouvre les logs écrits pendant ce span.
- **N logs** en haut ouvre chaque log de la requête, dans tous les services.
- **Copier l'ID de trace** copie l’ID, pour le partager ou le rechercher avec `trace_id:`.
- Utilisez **↑** **↓** ou **J** **K** pour passer à la trace précédente ou suivante, et **Échap** pour fermer.

## Corriger une requête en erreur

Les spans en échec sont en rouge. **Erreurs seulement** masque ceux qui ont fonctionné, pour que l’échec ressorte dans une longue trace.

![Une requête en échec, avec les spans en erreur en rouge et un bouton pour copier un prompt de correction](https://instatus.com/help/observability/trace-error.png)

**Copier le prompt de correction** copie une description de la requête en échec : les spans, leurs erreurs et attributs. Collez-la dans votre agent de code, dans le projet de votre app : il a tout ce qu’il faut pour trouver la cause.

- [Métriques](https://instatus.com/help/fr/observability/metrics): Repérer ce qui a changé, le plus grand changement en premier
- [Logs](https://instatus.com/help/fr/observability/logs): Rechercher, filtrer et suivre vos logs en direct
