Consommation

Établissez dans la console le rapport de consommation des machines virtuelles et des locataires par jour ou par mois, et téléchargez-le en CSV.

Le registre de consommation enregistre, pour chaque machine virtuelle et chaque jour, ce qu'elle a consommé. Un rapport additionne les lignes par machine virtuelle ou par locataire, par jour, par mois ou pour toute la période. Les chiffres sont des données commerciales, donc vous avez besoin du privilège Kyvernon.Usage.Read sur la racine ; le rôle en lecture seule ne le détient pas. Sans lui, la page affiche Vous n’avez pas l’autorisation d’afficher la consommation.

Dans la console

Ouvrez la page d'accueil (Accueil) et sélectionnez Consommation sous Raccourcis. Pour établir un rapport sur une partie de l'inventaire, ouvrez plutôt un dossier ou un cluster et sélectionnez son onglet Consommation ; seules les machines virtuelles qu'il contient comptent.

:::screen usage

:::screen cluster-usage

Choisissez la période sous Période : Ce mois-ci, Le mois dernier, 30 derniers jours ou Personnalisée. Une période personnalisée a Du et Au, et la fin ne doit pas précéder le début.
Choisissez Regrouper par : Machine virtuelle ou Locataire. Un locataire est un groupe de ressources ou un dossier, et une ligne de locataire additionne les machines virtuelles qu'il contient.
Choisissez la Ventilation : Total, Par mois ou Par jour.
Lisez les totaux au-dessus du tableau, puis les lignes. Les colonnes sont VM (pour les locataires), Heures sous tension, Heures vCPU, Heures de RAM (GiB), GiB-heures provisionnés, GiB-heures utilisés, Réseau entrant (GiB) et Réseau sortant (GiB).
Sélectionnez Télécharger le CSV pour enregistrer le rapport en CSV. Le fichier contient les mêmes lignes que le tableau.

Les jours sont en UTC, et un rapport couvre des jours entiers, du premier au dernier jour inclus. Un rapport peut couvrir dix ans au plus. Les heures comptent des intervalles de 20 secondes, et le stockage compte quel que soit l'état d'alimentation de la machine virtuelle. Le registre conserve 400 jours par défaut ; l'administrateur modifie cette valeur avec ledger_retention_days dans la section [metrics] de la configuration du contrôleur.

Résultat

Le tableau montre la consommation de chaque machine virtuelle ou locataire pour la période, et le fichier CSV la contient pour un système de facturation. Une ligne a la période, le nom du groupe et les chiffres ci-dessus ; ramGibHours compte la mémoire configurée tant que la machine virtuelle est sous tension.

Automatisation

Avec la CLI

Shell

kyvernon usage report --from 2026-11-01 --to 2026-11-30 --group-by tenant --period month
kyvernon usage report --from 2026-11-01 --to 2026-11-30 --group-by vm --period total --csv
kyvernon usage day 2026-11-12

--group-by est vm, tenant, resourcePool, folder ou host, et --period est day, month ou total. --scope <folder-id> ne compte que les machines virtuelles d'un dossier, d'un cluster ou d'un groupe de ressources. usage day affiche le résumé d'un jour, le même document que reçoivent les webhooks.

Avec l'API

GET /v1/usage accepte from, to, groupBy, period, scope et format, qui vaut json ou csv. GET /v1/usage/days/{day} renvoie le résumé d'un jour. Une date, une plage, un groupe, une période, un format ou une portée invalide échoue avec un identifiant de message du domaine usage, par exemple error.usage_bad_range.

Résumé quotidien pour la refacturation

Une fois par jour, le contrôleur envoie le résumé de la veille aux abonnés de webhooks, sous le type CloudEvents kyvernon.usage.daily_summary. Abonnez-vous avec le type d'événement UsageDailySummary et sans filtre de locataire ; consultez les webhooks. Si le contrôleur était arrêté, il envoie les jours manqués, sept au plus. Un système de facturation peut stocker chaque résumé selon son identifiant d'événement usage-<day> et ignorer les doublons.

Le trafic compte et limite le trafic réseau d'un serveur.
Les performances tracent les graphiques des mêmes machines virtuelles.