Journal des requêtes
L'écran Journal des requêtes vous permet de lire une ligne par span de votre tenant, construite à partir des
résumés bornés des spans (jamais un prompt ni une sortie), et de la filtrer par niveau, service, trace et texte.
Chemin dans le portail : /observability/logs (menu Observabilité > Journal des requêtes). Les ingénieurs
support et les administrateurs l'utilisent pour lire ce qui s'est passé autour d'une erreur.
Ce que montre l'écran
| Zone | Contenu |
|---|---|
| Filtres | Niveau (error, info), Service, Identifiant de trace, Texte (cherché dans le nom et les attributs du span, 128 caractères au plus). |
| Tableau Journal | Colonnes : Le, Niveau (error quand le span a échoué, sinon info), Service, Message (type d'erreur, ou méthode, route et code de statut, ou nom du span), Durée (ms), Identifiant de trace, Identifiant d'exécution. Du plus récent au plus ancien, sur les dernières 24 heures, jusqu'à 100 lignes. |
| Panneau de détail | Un clic sur une ligne l'affiche en JSON, avec les attributs autorisés du span. |
| État vide | Aucune ligne sur la fenêtre : élargissez la fenêtre ou retirez un filtre. |
Actions
| Bouton ou action | Ce qu'il fait | Appel API | Rôles |
|---|---|---|---|
| Filtrer | Applique les filtres remplis. | GET /v1/telemetry/logs (level, service, trace_id, q) | platform_admin, tenant_admin, auditor, viewer, support_engineer |
| Actualiser (icône flèche ronde) | Recharge le journal. | GET /v1/telemetry/logs | Mêmes rôles |
| Clic sur une ligne | Ouvre le panneau de détail de la ligne. | Aucun | Mêmes rôles |
| Réessayer (encadré d'erreur) | Renvoie la requête. | GET /v1/telemetry/logs | Mêmes rôles |
Rôles
| Rôle | Accès |
|---|---|
platform_admin, tenant_admin, auditor, viewer, support_engineer | Ouvrent l'écran et lisent le journal 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ôles | La 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
Lire les erreurs d'un service
- Filtrer. Choisissez
errordans Niveau, saisissez le service dans Service et cliquez sur Filtrer. Résultat attendu : le journal liste les spans en échec du service, du plus récent au plus ancien. En cas d'échec : Aucune ligne sur la fenêtre signifie aucune erreur sur les dernières 24 heures pour ce service. - Ouvrir une ligne. Cliquez dessus pour lire les attributs (route, code de statut, type d'erreur). Résultat attendu : le panneau montre la ligne et ses attributs. En cas d'échec : fermez puis rouvrez le panneau.
- Ouvrir la trace entière. Copiez l'Identifiant de trace et ouvrez-la dans Traces. Résultat attendu : vous voyez chaque span de la requête. En cas d'échec : voyez le dépannage de la page Traces.
Chercher une route
- Chercher le texte. Saisissez une partie de la route, par exemple
/v1/finops, dans Texte et cliquez sur Filtrer. Résultat attendu : les lignes dont le nom ou les attributs contiennent le texte sont listées. En cas d'échec : une erreurvalidation_errorsignifie que le texte dépasse 128 caractères.
Dépannage
| Symptôme | Cause | Correction |
|---|---|---|
| Aucune ligne sur la fenêtre | Aucun span sur les dernières 24 heures, ou les filtres excluent tout. | Retirez un filtre. |
Erreur validation_error (HTTP 422) | Texte de plus de 128 caractères. | Raccourcissez le texte. |
| Ni prompt ni sortie dans les lignes | Voulu : seuls les attributs autorisés des spans sont enregistrés. | Comportement normal : le journal ne garde jamais le contenu d'un appel. |
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. |