Lire la consommation dans la console

L’onglet Usage répond à la question « qu’est-ce qui a été consommé, par qui, et pour combien ». Cette page décrit ce qu’il montre, ce que ses chiffres ne disent pas, et le rapprochement qu’il ne fait pas.

Comme les onglets des comptes et des plans, il n’existe que dans les consoles construites en profil hébergé : la consommation se lit dans le journal des requêtes facturables, que le profil fermé n’écrit pas. La console est réservée aux administrateurs (livre blanc sécurité V3, section 6.2). Ce que cet écran montre sont des métadonnées d’usage, stockées dans la base, chez vous : ni le contenu des requêtes ni le code n’y figurent (livre blanc sécurité V3, section 8.3).

Ce que l’écran montre

Quatre totaux sur la période choisie (tokens entrants, tokens sortants, nombre de requêtes, coût), puis deux graphiques :

• les volumes de tokens en barres empilées, avec le nombre de requêtes en courbe sur un second axe ;
• le coût, en aires.

Il n’y a pas de tableau : aucune ligne par appel, aucun export. Ce que vous voyez est un agrégat.

Choisir la période et la finesse

Quatre finesses (hour, day, week, month) et un sélecteur de période. Le défaut est la journée en cours.

La finesse choisie détermine le pas des graphiques : une journée se découpe en heures, une semaine ou un mois en jours, une heure en minutes. Les intervalles sans appel sont affichés à zéro et non omis, pour que la courbe ne paraisse pas continue là où il n’y a rien.

Les intervalles sont replacés dans l’heure locale de votre navigateur. Deux personnes dans deux fuseaux ne voient pas la même découpe pour la même journée.

Le sélecteur de période s’arrête à la période en cours : il n’y a pas de futur à afficher.

Filtrer

Deux filtres, User et Model, chacun avec une entrée « tout » (All Users, All Models).

Leurs valeurs viennent de deux endroits différents :

• la liste des comptes vient du référentiel des comptes. Un compte qui n’a jamais rien appelé y figure ;
• la liste des modèles vient du journal des requêtes. Un modèle déclaré mais jamais appelé n’y figure pas ; un modèle appelé puis supprimé y figure encore.

Comment le coût est calculé

Pour chaque appel journalisé, le coût est le nombre de tokens entrants multiplié par le prix d’un token entrant du modèle, plus la même chose en sortie. Les prix sont ceux déclarés sur le modèle au moment de l’affichage, en nano-euros par token. Voir Déclarer un modèle servi par la passerelle.

Trois conséquences à connaître avant de présenter ces chiffres :

1. Un changement de tarif change le passé. Le coût n’est pas figé au moment de l’appel : il est recalculé à chaque affichage avec le prix du jour. Modifier le prix d’un modèle change ce que la console affiche pour les mois écoulés.
2. Un modèle sans prix coûte zéro. Un prix laissé à zéro à la déclaration, ou un modèle appelé puis supprimé, produisent un coût nul. Un total anormalement bas se diagnostique là. L’écran signale par un bandeau les appels qu’il n’a pas pu chiffrer (compteurs de tokens absents, ou modèle sans prix déclaré). Un prix mis à zéro n’est pas un prix manquant : il ne déclenche pas le bandeau et coûte zéro.
3. Il n’y a pas de conversion de devise. Les montants sont en euros, tels que les prix déclarés les expriment.

Les très petits montants sont affichés avec jusqu’à huit décimales : sur une heure et quelques appels, un coût s’écrit en fractions de centime.

Le rapprochement avec le plafond

Cet écran ne connaît pas les plafonds. C’est l’onglet Caps qui rapproche la dépense d’un compte du plafond qui va le bloquer.

Deux différences empêchent de lire l’un pour l’autre :

• le plafond porte sur le mois calendaire en cours, quelle que soit la période que vous regardez ici ;
• le plafond est comparé à la dépense d’un compte, alors que cet écran agrège par défaut tout le monde.

Les deux écrans répondent à deux questions différentes. Celui-ci répond à « qu’est-ce qui a été consommé, par qui, sur quels modèles », sur une période que vous choisissez, avec des courbes. L’onglet Caps répond à « qui va être bloqué ce mois-ci », sans courbe, sur le mois calendaire.

Voir Plafonner la dépense d’un client pour les plafonds et les refus qu’ils produisent.