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

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 :

FiltreTrouve
status:errorLes requêtes qui ont échoué
duration:>1sLes requêtes de plus d’une seconde. Aussi >500ms, <100ms
service:apiLes requêtes traitées par un service
span.name:Les spans portant un nom donné, comme GET /v1/users
Tout attributComme 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

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

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.