Synthèse

L'écran Synthèse vous permet de voir les dépenses de votre tenant sur une période, regroupées par jour, agent, modèle, fournisseur, type d'usage, projet ou tenant, avec côte à côte le coût estimé, mesuré et facturé. Chemin dans le portail : /finops/summary (menu FinOps > Synthèse, titre de page Synthèse FinOps). Les analystes FinOps, les administrateurs de tenant et les auditeurs l'utilisent pour suivre les dépenses et repérer les agents ou les modèles les plus coûteux.

Ce que montre l'écran

Zone	Contenu
Regrouper par	Regroupement des dépenses : Jour (par défaut), Agent, Modèle, Fournisseur, Type d'usage, Projet, Tenant. Envoyé dans le paramètre group_by.
Du et Au	Dates facultatives. Le portail envoie from à 00:00:00 UTC et to à 23:59:59 UTC des jours choisis. Une date vide ne fixe aucune borne.
Carte Total	Somme du coût Mesuré des groupes affichés, dans la devise du tenant renvoyée par le serveur (currency de la réponse, fixée dans Réglages FinOps).
Section Dépenses	Histogramme à trois barres par groupe : Estimé, Mesuré et Facturé.
Tableau	Une ligne par groupe. Colonnes : le groupe (libellé du regroupement choisi), Événements, Jetons, Estimé, Mesuré, Facturé.
État vide	Aucune dépense sur cette période : l'usage apparaît dès que la passerelle sert des requêtes.

Les trois coûts viennent du registre des coûts : Estimé est calculé avant un appel, Mesuré après l'appel à partir des grilles tarifaires, et Facturé est rempli par le rapprochement avec l'export du fournisseur.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Regrouper par	Recharge l'histogramme et le tableau avec le nouveau regroupement.	GET /v1/finops/summary (group_by, from, to)	Lecteurs de la section FinOps
Du / Au	Recharge l'histogramme et le tableau pour la nouvelle période.	GET /v1/finops/summary	Lecteurs de la section FinOps
Réessayer (encadré d'erreur)	Renvoie la requête après une erreur.	GET /v1/finops/summary	Lecteurs de la section FinOps

L'écran est en lecture seule : il ne crée ni ne modifie rien.

Rôles

Rôle	Accès
finops, tenant_admin, auditor	Ouvrent l'écran (section FinOps de portal/src/lib/nav-access.ts) et lisent la synthèse (READ_ROLES de services/control-plane/src/eai/domains/finops/__init__.py).
platform_admin	Ouvre l'écran et passe tous les contrôles de rôle, mais la route exige un contexte de tenant : sans tenant, le serveur répond tenant_required.
developer, viewer, security_officer	Autorisés par l'API (READ_ROLES), mais le menu du portail ne leur ouvre pas la section FinOps : la page affiche Vos rôles n'ouvrent pas cette page.

remarque

Le menu masque ce que vos rôles ne peuvent pas ouvrir, mais le Control Plane reste l'autorité : chaque appel est vérifié à nouveau côté serveur.

Tâches courantes

Trouver les agents les plus coûteux du mois

1. Ouvrir l'écran. La synthèse est le point d'entrée de l'analyse des dépenses. Allez dans FinOps > Synthèse. Résultat attendu : l'histogramme montre les dépenses regroupées par Jour. En cas d'échec : si la page affiche Vos rôles n'ouvrent pas cette page, demandez le rôle finops à un administrateur.
2. Regrouper par agent. Choisissez Agent dans Regrouper par pour obtenir une ligne par agent. Résultat attendu : la première colonne du tableau s'intitule Agent et liste les identifiants d'agent. En cas d'échec : un encadré d'erreur avec le code forbidden signifie que votre jeton n'a aucun rôle de lecture FinOps.
3. Limiter la période au mois. Mettez Du au premier jour du mois et laissez Au vide : la période va jusqu'à maintenant. Résultat attendu : la carte Total affiche la dépense mesurée du mois. En cas d'échec : si Aucune dépense sur cette période s'affiche, vérifiez que la passerelle a servi des requêtes sur cette période.
4. Lire le tableau. Comparez la colonne Mesuré entre agents pour repérer les plus coûteux, puis ouvrez Événements d'usage filtré sur l'identifiant de l'agent pour voir les appels. Résultat attendu : les événements d'usage de l'agent sont listés. En cas d'échec : vérifiez l'identifiant d'agent copié depuis le tableau.

Comparer coût estimé, mesuré et facturé par jour

1. Garder le regroupement par jour. Il montre un groupe de barres par jour. Choisissez Jour dans Regrouper par. Résultat attendu : un groupe de barres par jour avec les trois coûts. En cas d'échec : cliquez sur Réessayer dans l'encadré d'erreur.
2. Regarder les barres Facturé. Une barre Facturé absente signifie que l'export du fournisseur de ce jour n'est pas encore rapproché. Résultat attendu : Facturé est proche de Mesuré les jours déjà rapprochés. En cas d'échec : importez l'export du fournisseur et lancez le rapprochement dans Rapprochement.

Dépannage

Symptôme	Cause	Correction
Vos rôles n'ouvrent pas cette page	Vos rôles ne sont pas parmi platform_admin, tenant_admin, finops, auditor.	Demandez le rôle finops à un administrateur de tenant dans Membres et rôles.
Erreur forbidden (HTTP 403) : « Vous n'avez pas le rôle requis pour cette opération. »	Le jeton n'a aucun rôle de READ_ROLES.	Reconnectez-vous avec un compte qui détient un rôle de lecture FinOps.
Erreur tenant_required (HTTP 403) : « Cette opération exige un contexte de tenant. »	Vous êtes administrateur de plateforme sans tenant.	Connectez-vous à un tenant pour lire ses dépenses.
Erreur finops_group_by_invalid (HTTP 400)	Une valeur de group_by hors de tenant, project, agent, model, provider, usage_type, day (possible seulement par l'API).	Utilisez l'une des valeurs de Regrouper par.
Aucune dépense sur cette période	Aucun événement d'usage sur la période.	Élargissez Du et Au, ou vérifiez la passerelle dans Événements d'usage.
Facturé reste à zéro	Aucun export fournisseur n'a été rapproché sur la période.	Lancez le rapprochement dans Rapprochement.

Pages liées

• Événements d'usage
• Grilles tarifaires
• Rapprochement
• Réglages FinOps
• Vue d'ensemble
• Brique registre des coûts
• Brique comptage des jetons