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.

Les traces arrivent dès que votre app les envoie : cochez Traces en copiant le prompt de configuration, 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. 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.

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.

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.