Explore — traces, sessions, flows
L'onglet Explore d'un SIA est votre point d'entrée pour investiguer ce qui s'est passé : lister, filtrer, chercher et inspecter en détail.
Trois grains de lecture
| Vue | Ce que vous voyez |
|---|---|
| Traces | Une exécution technique (un flow) : timeline des spans, I/O, métriques, verdicts. |
| Sessions | Une conversation multi-tours (même session_id) : tous les flows regroupés. |
| Flows | Le DAG des steps reconstruit (Flow Diagram), avec branches et assets. |
Le détail d'une trace
Ouvrir une trace (ou une session) donne un cockpit en sous-onglets : Synthèse (résumé orienté verdict — ce qui s'est passé, répartition du temps avec TTFB / bout-en-bout / P95, coût, ressources, pièces jointes), Exécution (timeline + liste d'étapes filtrable : LLM, outils, erreurs, chemin critique), Scores (verdicts + note A→G + AI Act par article), Modèles (cockpit des appels LLM : tokens, coût, latence, configuration, « où part le coût ») et Metadata. Les pièces jointes et l'audio évalués s'ouvrent en aperçu inline.
Filtrer & chercher
- Recherche plein-texte : par id, contenu, ou valeur d'annotation (indexée par Typesense).
- Filtres typés : le contrôle s'adapte à la colonne : plage min–max (numérique), multi-sélection (texte), opérateur « contient » (liste/array), plage de dates (datetime), seuil (métrique) ou verdict (juge).
- Colonnes personnalisées : ajoutez une colonne pointant un chemin d'annotation
(
annotations.user_email). Elle devient affichable, triable et filtrable. Le sélecteur propose aussi les métriques découvertes et vos colonnes de juge comme choix standards. - Les filtres suivent les colonnes : seules les colonnes actives sont filtrables : ajoutez la colonne, puis filtrez dessus.
Le rôle des annotations
Plus vous enrichissez vos traces d'annotations côté SDK, plus Explore vous en montre : vous retrouvez « toutes les traces de tel utilisateur » ou « toutes les requêtes d'intention refund ».
Flow Diagram & qualité
Le Flow Diagram reconstruit le DAG (graphe d'exécution) de vos steps à partir des parent_span_id ; les cartes sont
colorées par phase et portent les chips d'assets. La qualité de ce rendu dépend de votre
instrumentation : l'onglet Quality mesure en continu si vos données sont exploitables.