Aller au contenu principal

SLO et budgets d'erreur

L'écran SLO et budgets d'erreur vous permet de vérifier, pour chaque service de la plateforme, la part restante de son budget d'erreur de disponibilité et de latence sur la fenêtre choisie, et permet à un administrateur de plateforme de changer les objectifs. Chemin dans le portail : /observability/slo (menu Observabilité > SLO et budgets d'erreur). Les administrateurs de plateforme et de tenant, les ingénieurs support, les auditeurs et les lecteurs l'utilisent pour savoir si un service consomme son budget trop vite.

Ce que montre l'écran​

ZoneContenu
Fenêtre (minutes)15, 60 (par défaut), 360 ou 1440. Envoyée dans window_minutes.
Tableau SLOUne ligne par service (control_plane_api, model_gateway, tool_gateway, realtime) : Service, Statut (burning quand un taux de consommation dépasse 1, sinon healthy), Requêtes, Erreurs (5xx), Au-delà de la cible de latence, Cible de disponibilité, Budget de disponibilité restant, Consommation du budget de disponibilité, Budget de latence restant, Consommation du budget de latence.
Panneau de détailUn clic sur une ligne l'affiche en JSON, avec la Cible de latence (s) du service.
Consoles d'exploitation (administrateurs de plateforme seulement)Liens Ouvrir la console vers Opik (traces IA), Grafana (si le client en exploite un, EAI_GRAFANA_URL ; jamais déployé par la plateforme) et OpenSearch Dashboards (journaux), ou la raison pour laquelle une console n'est pas configurée. Les machines et les services se suivent dans le Navin Manager.
État videAucune mesure : les mesures apparaissent dès que l'API sert des requêtes.

Un taux de consommation supérieur à 1 épuise le budget plus vite que l'objectif ne le permet. Les mesures sont gardées en mémoire par chaque réplica de l'API pendant EAI_SLO_RETENTION_MINUTES (1440 par défaut) : l'écran montre le réplica qui a répondu. Un administrateur de plateforme voit toute la plateforme ; les autres lecteurs voient leur propre tenant.

Actions​

Bouton ou actionCe qu'il faitAppel APIRôles
Fenêtre (minutes)Recharge les budgets pour la nouvelle fenêtre.GET /v1/telemetry/slo (window_minutes)platform_admin, tenant_admin, auditor, viewer, support_engineer
Actualiser (icône flèche ronde)Recharge les budgets.GET /v1/telemetry/sloMêmes rôles
Clic sur une ligneOuvre le panneau de détail.AucunMêmes rôles
Modifier les objectifs (menu de la ligne)Ouvre le formulaire Objectif de disponibilité (par défaut 0.995), Cible de latence (s) (par défaut 2), Objectif de latence (par défaut 0.95), Raison, et enregistre les objectifs du service.PUT /v1/telemetry/slo/targets/{service}platform_admin
Ouvrir la console (Consoles d'exploitation)Ouvre la console dans un nouvel onglet.GET /v1/platform-manager/console (liens)platform_admin

Rôles​

RôleAccès
platform_adminLit les budgets de toute la plateforme, modifie les objectifs et voit les Consoles d'exploitation.
tenant_admin, auditor, viewer, support_engineerLisent les budgets de leur tenant (ROLES de services/control-plane/src/eai/domains/observability/slo.py, section Observabilité de portal/src/lib/nav-access.ts).
Autres rôlesLa section Observabilité est masquée ; la page affiche Vos rôles n'ouvrent pas cette page.
attention

Un objectif changé ici s'applique tout de suite sur le réplica qui l'a écrit et sous 30 secondes sur les autres (cache des objectifs enregistrés) ; il est audité avec les valeurs avant et après. Remplissez Raison pour que le changement puisse être expliqué plus tard.

Tâches courantes​

Vérifier que les services tiennent leurs objectifs​

  1. Choisir la fenêtre. Une fenêtre courte montre un incident en cours, une longue la tendance. Choisissez 60 ou 1440 dans Fenêtre (minutes). Résultat attendu : une ligne par service avec ses budgets. En cas d'échec : slo_window_invalid signifie que la fenêtre dépasse la rétention des réplicas.
  2. Lire le statut. Une ligne burning a un taux de consommation supérieur à 1. Résultat attendu : chaque service est healthy. En cas d'échec : pour un service burning, ouvrez Métriques en direct et Traces pour trouver les requêtes en échec.

Changer l'objectif de latence d'un service​

  1. Lire l'objectif actuel. Notez la Cible de disponibilité de la ligne et ouvrez le panneau de détail pour la Cible de latence (s) : le formulaire de modification s'ouvre avec les valeurs par défaut, pas les valeurs actuelles. Résultat attendu : vous connaissez les valeurs à garder. En cas d'échec : cliquez sur Actualiser.
  2. Modifier. Ouvrez le menu de la ligne, choisissez Modifier les objectifs, remplissez Objectif de disponibilité (de 0.5 à moins de 1), Cible de latence (s) (plus de 0, jusqu'à 300), Objectif de latence (de 0.5 à moins de 1) et Raison, puis cliquez sur Modifier les objectifs. Résultat attendu : le message Terminé apparaît et les budgets sont recalculés avec les nouveaux objectifs. En cas d'échec : forbidden signifie que vous n'êtes pas administrateur de plateforme ; validation_error signale une valeur hors bornes.

Dépannage​

SymptômeCauseCorrection
Erreur slo_window_invalid (HTTP 422) : « La fenêtre SLO doit être comprise entre 1 et ... minutes. »La fenêtre dépasse EAI_SLO_RETENTION_MINUTES.Choisissez une fenêtre plus courte, ou augmentez le réglage.
Erreur slo_targets_invalid (HTTP 500)Les réglages EAI_SLO_* de la plateforme sont mal formés.Corrigez EAI_SLO_AVAILABILITY_TARGETS ou EAI_SLO_LATENCY_TARGETS_SECONDS (un service=valeur par service).
Erreur slo_service_unknown (HTTP 404)Le service n'est pas l'un des quatre services de la plateforme.Modifiez l'une des lignes listées.
Erreur tenant_required ou slo_scope_forbidden (HTTP 403)Un lecteur de tenant sans tenant, ou qui lit un autre tenant.Connectez-vous à votre tenant.
Les chiffres changent d'une actualisation à l'autreChaque réplica garde ses propres mesures.Utilisez les tableaux de bord Grafana pour la vue de la flotte.
Consoles d'exploitation absentesVous n'êtes pas administrateur de plateforme.Normal : la section n'est affichée qu'à platform_admin.

Pages liées​