Métriques en direct

L'écran Métriques en direct vous permet de suivre, sans rafraîchir, les requêtes, erreurs et la latence p95 de la dernière minute, les nouvelles traces et les changements d'incident de votre tenant, poussés par le serveur (Server-Sent Events). Chemin dans le portail : /observability/metrics (menu Observabilité > Métriques en direct). Les ingénieurs support et les administrateurs le gardent ouvert pendant un déploiement ou un incident.

Ce que montre l'écran

Zone	Contenu
Badge de connexion	En direct tant que le flux est ouvert, Reconnexion pendant que le portail le rouvre.
Cartes	Requêtes (1 min), Erreurs (1 min), Taux d'erreur, Latence p95 (ms) de la dernière minute.
Onglet Graphique en direct	Requêtes, erreurs et latence p95 : un point par tick du flux serveur (fenêtre de la dernière minute). En attente de la première mesure jusqu'au premier tick.
Onglet Nouvelles traces	Spans racines reçus depuis l'ouverture de la page : Début, Nom, Statut, Durée (ms), Identifiant de trace. L'onglet affiche leur nombre.
Onglet Changements d'incident	Incidents créés ou modifiés depuis l'ouverture de la page : Mis à jour, Titre, Gravité, Statut, Modification (created ou updated). L'onglet affiche leur nombre.

L'onglet est gardé dans l'adresse (?tab=traces, ?tab=incidents).

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Ouverture de l'écran	Ouvre le flux pour 300 secondes ; le serveur envoie un événement metrics à chaque tick (toutes les 2 secondes par défaut), un événement trace par nouveau span racine et un événement incident par changement d'incident.	GET /v1/telemetry/stream (timeout=300)	platform_admin, tenant_admin, auditor, viewer, support_engineer
Reconnexion automatique	Quand le flux se ferme (délai écoulé ou perte réseau), le portail attend 3 secondes et le rouvre avec l'en-tête Last-Event-ID, sans perdre d'événement.	GET /v1/telemetry/stream	Mêmes rôles
Graphique en direct, Nouvelles traces, Changements d'incident	Changent d'onglet.	Aucun	Mêmes rôles

L'écran n'a aucun bouton qui modifie des données.

Rôles

Rôle	Accès
platform_admin, tenant_admin, auditor, viewer, support_engineer	Ouvrent l'écran et suivent le flux de leur tenant (ROLES de services/control-plane/src/eai/domains/observability/slo.py, repris par 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.

Le flux exige un contexte de tenant : les lignes sont celles du tenant de l'appelant.

Tâches courantes

Surveiller un déploiement

1. Ouvrir l'écran. Allez dans Observabilité > Métriques en direct avant le début du déploiement. Résultat attendu : le badge affiche En direct et les cartes se remplissent en quelques secondes. En cas d'échec : si le badge reste sur Reconnexion, vérifiez le chemin réseau vers le Control Plane (un proxy ne doit pas mettre en mémoire tampon text/event-stream).
2. Suivre le graphique. Dans Graphique en direct, surveillez les courbes Erreurs (1 min) et Latence p95 (ms) pendant le déploiement de la nouvelle version. Résultat attendu : la courbe des erreurs reste plate et la latence reste sous sa cible. En cas d'échec : ouvrez Nouvelles traces et poursuivez dans Traces pour trouver les requêtes en échec.

Suivre un incident

1. Ouvrir l'onglet Changements d'incident. Chaque incident créé ou modifié apparaît sans rafraîchissement. Résultat attendu : le compteur de l'onglet augmente quand un incident change, avec Modification à created ou updated. En cas d'échec : Aucun incident créé ou modifié depuis l'ouverture de la page. signifie que rien n'a encore changé.
2. Ouvrir l'incident. Allez dans Incidents pour agir. Résultat attendu : l'incident montre le même statut. En cas d'échec : vérifiez que vous avez un rôle de la section sécurité.

Dépannage

Symptôme	Cause	Correction
Badge bloqué sur Reconnexion	Le flux ne peut pas s'ouvrir : réseau, mise en tampon par un proxy, ou réponse en erreur.	Vérifiez le proxy (pas de mise en tampon pour text/event-stream) et votre session.
En attente de la première mesure persiste	Aucun tick reçu pour l'instant.	Attendez quelques secondes ; rechargez la page.
Cartes à zéro	Aucun span racine dans la dernière minute.	Normal quand le tenant n'a pas de trafic ; les traces arrivent par POST /v1/telemetry/spans.
Erreur forbidden ou tenant_required (HTTP 403) sur le flux	Aucun rôle d'observabilité, ou pas de tenant.	Demandez le rôle viewer ou support_engineer dans votre tenant.

Pages liées

• SLO et budgets d'erreur
• Traces
• Journal des requêtes
• Incidents
• Brique métriques
• Brique chaîne de télémétrie