Aller au contenu principal

Traces

L'écran Traces vous permet de lister les traces récentes de votre tenant, une par span racine, avec leur durée, leur statut, leur nombre de spans et d'erreurs et l'exécution à laquelle elles appartiennent, et d'ouvrir les spans d'une trace. Chemin dans le portail : /observability/traces (menu Observabilité > Traces). Les ingénieurs support et les développeurs l'utilisent pour trouver une requête lente ou en échec.

Ce que montre l'écran​

ZoneContenu
FiltresStatut (ok, error, unset), Service, Identifiant d'exécution.
Tableau TracesColonnes : Début, Nom, Service, Statut, Durée (ms), Spans, Erreurs, Identifiant d'exécution, Identifiant de trace. Du plus récent au plus ancien, sur les dernières 24 heures, jusqu'à 50 traces.
Panneau de détailUn clic sur une ligne charge la trace : chaque span (nom, type, service, dates, durée, statut, attributs autorisés, jetons, coût), le nombre de spans, les erreurs et les événements d'audit de la trace.
État videAucune trace sur la fenêtre : les traces apparaissent dès que le SDK ou les passerelles envoient des spans (POST /v1/telemetry/spans).

Actions​

Bouton ou actionCe qu'il faitAppel APIRôles
FiltrerApplique les filtres remplis.GET /v1/telemetry/traces (status, service, run_id)platform_admin, tenant_admin, auditor, viewer, support_engineer
Actualiser (icône flèche ronde)Recharge la liste.GET /v1/telemetry/tracesMêmes rôles
Clic sur une ligneOuvre le panneau de détail de la trace.GET /v1/telemetry/traces/{trace_id}Mêmes rôles
Réessayer (encadré d'erreur)Renvoie la requête.GET /v1/telemetry/tracesMêmes rôles

Rôles​

RôleAccès
platform_admin, tenant_admin, auditor, viewer, support_engineerOuvrent l'écran et lisent les traces de leur tenant (ROLES de services/control-plane/src/eai/domains/observability/slo.py, contrôlés dans services/control-plane/src/eai/domains/observability/live.py).
Autres rôlesLa section Observabilité est masquée ; la page affiche Vos rôles n'ouvrent pas cette page.

La route exige un contexte de tenant (sinon tenant_required).

Tâches courantes​

Trouver les requêtes en échec du dernier jour​

  1. Filtrer sur les erreurs. Choisissez error dans Statut et cliquez sur Filtrer. Résultat attendu : le tableau liste les traces dont le span racine a échoué, du plus récent au plus ancien. En cas d'échec : Aucune trace sur la fenêtre signifie aucune trace en échec sur les dernières 24 heures.
  2. Ouvrir une trace. Cliquez sur la ligne pour charger ses spans. Résultat attendu : le panneau liste les spans ; le span en erreur montre son status et ses attributs autorisés. En cas d'échec : not_found signifie que la trace n'a plus aucun span ni événement d'audit enregistré.
  3. La suivre dans la piste d'audit. Copiez l'Identifiant de trace et filtrez dessus dans Événements et chaîne. Résultat attendu : les événements d'audit de la requête sont listés. En cas d'échec : vérifiez que l'identifiant de trace a 32 caractères hexadécimaux.

Lister les traces d'une exécution d'agent​

  1. Filtrer sur l'exécution. Collez l'identifiant d'exécution dans Identifiant d'exécution et cliquez sur Filtrer. Résultat attendu : les traces de l'exécution sont listées avec leur durée et leur nombre d'erreurs. En cas d'échec : l'exécution date peut-être de plus de 24 heures ; la liste ne couvre que le dernier jour.

Dépannage​

SymptômeCauseCorrection
Aucune trace sur la fenêtreAucun span reçu sur les dernières 24 heures, ou les filtres excluent tout.Retirez les filtres ; vérifiez que le SDK envoie des spans avec POST /v1/telemetry/spans.
Erreur invalid_request (HTTP 400) à l'ouverture d'une traceL'identifiant de trace n'est pas formé de 32 caractères hexadécimaux.Ouvrez la trace depuis le tableau.
Erreur not_found (HTTP 404) dans le panneau de détailPlus aucun span ni événement d'audit pour cette trace.Les données ont expiré ; repartez de la liste.
Erreur forbidden ou tenant_required (HTTP 403)Aucun rôle d'observabilité, ou pas de tenant.Demandez le rôle viewer ou support_engineer dans votre tenant.

Pages liées​