Utilisation et facturation
Ce que Kisenon mesure, l'allocation gratuite et comment la console l'affiche.
Kisenon mesure ce que vous utilisez réellement et l'agrège par organisation. Aujourd'hui, la console affiche votre utilisation ; elle ne la facture pas encore — voir Statut alpha ci-dessous.
Ce que nous mesurons
Le plan de contrôle échantillonne trois dimensions par projet et les agrège par organisation :
| Dimension | Unité | Comment c'est mesuré |
|---|---|---|
| Calcul | CU-heures | Recalculé chaque minute à partir du temps d'exécution côté serveur de chaque endpoint (Postgres now()), regroupé par heure et pondéré par la taille de calcul. |
| Stockage | Go-mois | Interrogé toutes les 5 minutes à partir de la taille par projet de la couche de stockage. |
| Branches | branche-mois | Échantillonné une fois par jour à 02:00 UTC par projet. |
Le calcul est celui qui bouge : un endpoint qui se suspend à l'inactivité cesse d'accumuler des CU-heures au moment où il s'arrête, donc un projet qui dort la majeure partie de la journée coûte une fraction de celui qui tourne à plein régime. Le stockage et le nombre de branches sont stables dans leurs fenêtres d'échantillonnage, donc une cadence plus grossière convient.
Les échantillons s'agrègent en une vue unique, par organisation, de l'utilisation du calcul, du stockage et des branches pour le cycle de facturation courant — les chiffres que rend la page de facturation.
Le palier gratuit
Le palier gratuit de l'alpha est appliqué sous forme de plafond du nombre de
projets par organisation. Lorsque le plafond est activé, une organisation
sans moyen de paiement enregistré est limitée à un nombre fixe de projets ; une
fois atteint, la création d'un autre projet renvoie free_allowance_exhausted
(HTTP 403). Les organisations ayant un moyen de paiement enregistré ne sont pas
plafonnées. Le plafond exact est un paramètre de déploiement plutôt qu'un
nombre codé en dur, et peut donc être ajusté à mesure que l'alpha évolue.
À mesure que l'utilisation mesurée d'un cycle grimpe, la console affiche une
bannière croissante au-dessus du contenu principal à trois seuils — les mêmes
pourcentages 80 / 95 / 100 que le plan de contrôle enregistre dans son
journal de notifications par cycle :
- 80 % — un avis jaune : « Vous avez utilisé plus de 80 % de votre palier gratuit pour cette période. »
- 95 % — un avertissement orange pour ajouter un moyen de paiement avant que le service ne soit interrompu.
- 100 % — un état rouge d'épuisement : le calcul peut être mis en pause jusqu'à ce qu'un moyen de paiement soit ajouté.
Chaque bannière peut être fermée pour la session et renvoie vers Ajouter un moyen de paiement.
La page de facturation de l'organisation
Chaque organisation possède une page de facturation à /orgs/{id}/billing,
accessible depuis la navigation de l'organisation. Quand les données
d'utilisation sont disponibles, elle rend, par dimension, une barre utilisé /
allocation (verte sous 80 %, orange 80–95 %, rouge à/au-dessus de 95 %) plus
un marqueur optionnel de fin de période projetée, une ligne de facture projetée
ainsi que le plan et le moyen de paiement actuels.
Statut alpha
La facturation n'est pas encore active. Il n'y a aucun moyen de paiement à ajouter, aucune facture à payer et aucun flux de paiement :
- Les échantillons mesurés ci-dessus sont collectés et stockés, et la console
les expose, mais l'endpoint de facturation du plan de contrôle
(
/v1/billing/customer) n'est pas câblé dans l'alpha. - Comme cet endpoint ne renvoie rien aujourd'hui, la bannière d'utilisation se rend toujours comme nulle (0 % utilisé) et la page de facturation se rabat sur un espace réservé « Bientôt disponible » plutôt que de lever une erreur.
- Le traitement des paiements n'est qu'un échafaudage en mode test Stripe. Le champ client Stripe, le déclencheur NOTIFY de facturation et la route du portail propriétaire/facturation sont tous des stubs réservés — pas de vraies cartes, pas de vraies factures.
Quand la facturation arrivera, ces surfaces s'allumeront sans réécriture : la bannière et la page de facturation lisent déjà depuis le même endpoint, donc elles commencent à afficher de vrais chiffres dès qu'il renvoie des données.
Liens connexes
- Organisations — l'unité à laquelle l'utilisation s'agrège.
- Endpoints — la suspension à l'inactivité est ce qui maintient les CU-heures basses.
- Statut alpha — ce qui est activé ou non pour l'instant.