Corrélations

L'écran Corrélations vous permet de voir les événements d'audit de votre tenant regroupés par trace, exécution ou session, pour suivre une requête ou une exécution d'agent à travers tous les services qu'elle a touchés. Chemin dans le portail : /audit/correlations (menu Audit > Corrélations). Les auditeurs, les responsables sécurité et les administrateurs de tenant l'utilisent pendant une investigation.

Ce que montre l'écran

Zone	Contenu
Filtres	Identifiant de trace, Identifiant d'exécution, Identifiant de session.
Tableau Corrélations	Une ligne par clé de corrélation, la plus récente d'abord, jusqu'à 50 : Clé, Type de clé (`trace_id`, `run_id`, `session_id`), Événements, Actions (actions distinctes du groupe), Premier, Dernier.
État vide	Aucune corrélation : filtrez par identifiant de trace ou d'exécution.

Sans filtre, le serveur regroupe les événements par identifiant de trace, par identifiant d'exécution (lu dans le détail de l'événement ou dans une ressource run) et par identifiant de session.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Filtrer	Envoie les filtres remplis.	`GET /v1/audit/correlations` (`trace_id`, `run_id`, `session_id`, `limit`)	`auditor`, `security_officer`, `tenant_admin`, `platform_admin`
Actualiser (icône flèche ronde)	Recharge les groupes.	`GET /v1/audit/correlations`	Mêmes rôles
Événements (menu de la ligne, lignes de type `trace_id`)	Liste les événements d'audit de la trace dans un panneau latéral intitulé Événements (JSON).	`GET /v1/audit/events` (`trace_id`)	Mêmes rôles

Rôles

Rôle	Accès
`auditor`, `security_officer`, `tenant_admin`	Ouvrent l'écran (`portal/src/lib/nav-access.ts`) et lisent les corrélations (`READERS` de `services/control-plane/src/eai/domains/observability/audit_api.py`).
`platform_admin`	Mêmes droits, dans un tenant (sinon `tenant_required`).
Autres rôles	L'entrée est masquée ; la page affiche Vos rôles n'ouvrent pas cette page.

remarque

Avec un filtre, GET /v1/audit/correlations renvoie un dossier de corrélation (key, trace_ids, audit_events, usage_events, runs, spans, multimodal_jobs, counts) au lieu d'une liste de groupes. Le tableau de l'écran ne lit que la liste de groupes : il affiche donc Aucune corrélation après un filtre. Pour lire les événements d'une trace, utilisez l'action Événements de sa ligne, ou le filtre Identifiant de trace de Événements et chaîne.

Tâches courantes

Suivre une requête à travers les services

Ouvrir l'écran. La liste montre les dernières clés de corrélation. Allez dans Audit > Corrélations. Résultat attendu : le tableau liste des clés de type trace_id, run_id et session_id. En cas d'échec : Vos rôles n'ouvrent pas cette page signifie qu'il vous faut le rôle auditor.
Trouver la trace. Cherchez l'identifiant de trace dans la colonne Clé (copié depuis Traces, par exemple). La colonne Actions montre ce qui s'est passé. Résultat attendu : la ligne de la trace, avec son nombre d'événements et ses première et dernière dates. En cas d'échec : cliquez sur Actualiser ; la liste garde les 50 clés les plus récentes.
Lister ses événements. Ouvrez le menu de la ligne et choisissez Événements. Résultat attendu : le panneau latéral montre les événements d'audit de la trace en JSON. En cas d'échec : l'action n'existe que sur les lignes de type trace_id ; pour une exécution, filtrez Acteur ou Ressource dans Événements et chaîne.

Passer en revue l'activité d'une exécution d'agent

Repérer l'exécution. Cherchez la ligne dont le Type de clé est run_id et dont la Clé est l'identifiant de l'exécution. Résultat attendu : Événements, Premier et Dernier donnent la taille et la durée de l'exécution. En cas d'échec : l'identifiant d'exécution vient du détail des événements ; une exécution qui n'a écrit aucun événement d'audit n'est pas listée.
Ouvrir l'exécution. Allez dans Exécutions pour voir ses étapes et son coût. Résultat attendu : le détail de l'exécution correspond à la période du groupe. En cas d'échec : vérifiez que vous êtes dans le tenant de l'exécution.

Dépannage

Symptôme	Cause	Correction
Aucune corrélation juste après Filtrer	Avec un filtre, le serveur renvoie un dossier que le tableau ne liste pas.	Videz les filtres et utilisez l'action Événements, ou le filtre Identifiant de trace de Événements et chaîne.
Aucune corrélation sans filtre	Aucun événement d'audit ne porte d'identifiant de trace, d'exécution ou de session.	Vérifiez que le SDK et les passerelles propagent le contexte de trace.
Pas d'action Événements sur une ligne	La ligne est de type `run_id` ou `session_id`.	Utilisez Événements et chaîne.
Erreur `forbidden` (HTTP 403)	Aucun rôle de lecture de la piste d'audit.	Demandez le rôle `auditor`.
Erreur `tenant_required` (HTTP 403)	Administrateur de plateforme sans tenant.	Connectez-vous à un tenant.

Ce que montre l'écran​

Actions​

Rôles​

Tâches courantes​

Suivre une requête à travers les services​

Passer en revue l'activité d'une exécution d'agent​

Dépannage​

Pages liées​