Utilisation et facturation
Ce que Kisenon mesure, l'allocation gratuite et la façon dont la console l'affiche.
Kisenon mesure ce que vous utilisez réellement et l'agrège par organisation. La console affiche votre utilisation, et l'utilisation au-delà de votre allocation mensuelle gratuite est facturée selon le contrat tarifaire — voir Statut de facturation 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 | branches-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 dès qu'il s'arrête, de sorte qu'un projet qui dort la majeure partie de la journée coûte une fraction de ce que coûte un projet qui tourne à plein régime. Le stockage et le nombre de branches sont stables dans leurs fenêtres d'échantillonnage, une cadence plus grossière convient donc.
Les échantillons s'agrègent en une seule vue par organisation du calcul, du stockage et de l'utilisation des branches pour le cycle de facturation courant — les nombres que rend la page de facturation.
Le palier gratuit
Chaque organisation démarre avec une allocation mensuelle gratuite. Un
plafond du nombre de projets peut aussi être appliqué 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, créer un autre projet
renvoie free_allowance_exhausted (HTTP 403). Les organisations disposant d'un
moyen de paiement enregistré sont sans plafond. Le plafond exact est un paramètre de
déploiement plutôt qu'un nombre codé en dur, il peut donc être ajusté au fil du temps.
À 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 cette période. »
- 95 % — un avertissement ambre pour ajouter un moyen de paiement avant que le service ne soit interrompu.
- 100 % — un état rouge d'épuisement : le calcul peut être suspendu jusqu'à ce qu'un moyen de paiement soit ajouté.
Chaque bannière peut être fermée pour la session et renvoie vers Add a payment method.
La page de facturation de l'organisation
Chaque organisation dispose d'une page de facturation à /orgs/{id}/billing, accessible
depuis la navigation de l'organisation. Lorsque des données d'utilisation sont disponibles, elle rend, par
dimension, une barre utilisé / allocation (verte sous 80 %, ambre 80–95 %, rouge
à/au-dessus de 95 %) plus un marqueur facultatif de fin de période projetée, une
ligne de facture projetée, et le plan et le moyen de paiement courants.
Gérer la facturation
La facturation en libre-service est active. Une fois un moyen de paiement enregistré, la page de facturation de l'organisation (Settings → Billing) affiche un bouton Manage billing qui ouvre le Customer Portal hébergé par Stripe. Dans le portail, vous pouvez :
- Mettre à jour ou remplacer le moyen de paiement.
- Consulter les factures et reçus.
- Modifier votre adresse de facturation et vos identifiants fiscaux.
- Résilier.
Avant l'ajout d'une carte, la page affiche à la place un bouton Checkout (ajouter un moyen de paiement) ; les deux sont mutuellement exclusifs.
Qui le peut : uniquement le owner de l'organisation ou le rôle billing — pas admin, member ni viewer.
À titre de référence, le plan de contrôle expose :
POST /v1/billing/portal-session → { url }qui renvoie une URL vers le Customer Portal ; le portail vous ramène toujours ensuite à la page de facturation de l'organisation.
Coût par projet (showback)
La page de facturation inclut une carte Cost by project qui décompose votre utilisation par projet. Elle rapporte quatre dimensions mesurées par projet :
| Dimension | Unité |
|---|---|
| Calcul | CU-heures |
| Stockage | Go-mois |
| Branches | branches-mois |
| Sortie réseau | Go |
Un basculement Include credits & discounts commute la vue entre brut et net — la vue nette applique une allocation au prorata de l'allocation gratuite et de la remise sur volume. C'est un filtre d'affichage : le pied de page affiche toujours le sous-total brut, l'allocation gratuite, la remise sur volume et le total net.
Les données sont à granularité journalière : la période est indexée par une date de début
complète (YYYY-MM-DD). L'utilisation est tirée d'un magasin de mesure global, de sorte que les coûts
d'un projet restent visibles même après la suppression du projet.
Statut de facturation
L'utilisation mesurée est collectée par projet, agrégée par organisation et facturée via Stripe selon le contrat tarifaire :
- L'utilisation dans votre allocation mensuelle gratuite n'est pas facturée ; l'utilisation au-delà est mesurée à l'unité, avec une remise automatique sur volume en cas d'usage intensif.
- L'endpoint de facturation du plan de contrôle (
/v1/billing/customer) alimente la bannière d'utilisation et la page de facturation de l'organisation — elles lisent la même source, de sorte que les deux reflètent les nombres réels du cycle courant. - Ajoutez un moyen de paiement depuis la page de facturation de l'organisation pour lever le plafond de projets du palier gratuit et continuer au-delà de l'allocation gratuite.
Voir aussi
- Organisations — l'unité à laquelle l'utilisation s'agrège.
- Endpoints — la suspension à l'inactivité est ce qui maintient les CU-heures basses.
- Tarification — l'allocation gratuite, les tarifs à l'unité et la remise sur volume.