Performance

Lisez dans la console les graphiques de performance des hôtes, machines virtuelles et datastores, choisissez une période et collectez avec Prometheus.

Kyvernon conserve dans le contrôleur des échantillons de performance des hôtes, des machines virtuelles et des datastores, et la console les dessine sous forme de graphiques sur l'onglet de l'objet. Les agents d'hôte envoient les échantillons toutes les 20 secondes, et le contrôleur les agrège en périodes plus longues.

Dans la console

Dans l'inventaire, sélectionnez un hôte, une machine virtuelle ou un datastore, et ouvrez l'onglet Surveillance.

:::screen host-monitor

Choisissez la période sous Période. Chaque période a son propre échantillonnage et est conservée pour une durée limitée :

Période	Échantillonnage	Conservée pendant
Temps réel (dernière heure)	20 secondes	1 heure
Dernier jour	5 minutes	1 jour
Dernière semaine	30 minutes	7 jours
Dernier mois	2 heures	30 jours
Dernière année	1 jour	365 jours

Pour une autre étendue de temps, choisissez Période personnalisée, saisissez Du et Au, et sélectionnez Afficher la période. Les échantillons sont ajustés à la plage. La fin doit être postérieure au début.
Lisez les graphiques. Une machine virtuelle a les sections Processeur, Mémoire, Disque et Réseau, par exemple Consommation du processeur, Processeur prêt, Latence du disque et Paquets abandonnés. Un datastore a les sections Espace et Performances. Sélectionnez une série dans la légende pour la masquer ou l'afficher.

:::screen vm-monitor

Sélectionnez Afficher sous forme de tableau pour lire les valeurs avec Minimum, Moyenne, Maximum et Dernière valeur. Sélectionnez Actualiser pour relire les graphiques ; la ligne à côté indique quand ils ont été lus pour la dernière fois et avec quel échantillonnage.

Les graphiques sont conservés par hôte, par machine virtuelle et par datastore. Un cluster, un datacenter, un dossier ou un réseau n'affiche pas de graphique propre : ouvrez l'un de ses membres. Une machine virtuelle hors tension n'envoie aucun échantillon, donc ses graphiques montrent les périodes pendant lesquelles elle a fonctionné. Les échantillons des cœurs, des disques et des cartes réseau individuels sont conservés pour la période en temps réel.

Résultat

Les graphiques montrent les compteurs de l'objet pour la période choisie. Un compteur a un nom de la forme group.name.rollup, par exemple cpu.usage.average, et les groupes sont cpu, mem, disk, net, datastore, virtualDisk, sys et rescpu. La consommation rend compte de l'utilisation à partir des mêmes données, et une alarme réagit aux événements.

L'administrateur contrôle ce qui est conservé avec la section [metrics] de la configuration du contrôleur : si les données de performance sont conservées ou non, la taille du fichier de métriques, combien de temps les graphiques d'un objet supprimé restent (7 jours par défaut) et si les échantillons sont envoyés vers un point de terminaison OpenTelemetry. Rien ne quitte le contrôleur sans cette configuration. Les clés se trouvent dans la référence de configuration.

Automatisation

Avec la CLI

Shell

kyvernon metrics counters
kyvernon metrics available vm-42 --interval 300
kyvernon metrics query --entity vm-42 --counter cpu.usage.average --interval 300 --max-samples 12

--interval est la période d'échantillonnage en secondes : 20, 300, 1800, 7200 ou 86400. --entity et --counter acceptent des listes séparées par des virgules. --instance est vide pour l'agrégat, * pour toutes les instances comme chaque disque, ou une instance précise. --start est exclusif et --end inclusif, tous deux au format RFC 3339. La réponse est orientée colonnes, avec timestamps et values par série, ce qui convient à la création de graphiques.

Avec l'API

GET /v1/metrics/counters et GET /v1/metrics/intervals listent les compteurs et les périodes. GET /v1/metrics/entities/{id}/available?interval=<seconds> liste les compteurs qui ont des données pour un objet. GET /v1/metrics/query renvoie des échantillons avec entity, counter, interval, start, end, instance et maxSamples, et POST /v1/metrics/query accepte les mêmes paramètres dans un corps JSON. Une requête renvoie les données des objets que l'appelant peut voir. Une requête qui ne nomme aucun objet ni compteur, demande trop d'échantillons ou utilise une période non prise en charge échoue avec un identifiant de message du domaine metrics ; consultez error.metrics_query_too_large.

Avec Prometheus

GET /metrics/perf répond au format texte de Prometheus avec l'échantillon le plus récent de chaque série, pour les hôtes, les machines virtuelles et les datastores que le jeton a le droit de voir. Chaque métrique est nommée kyvernon_perf_<group>_<name>_<unit>, par exemple kyvernon_perf_cpu_usage_percent, et porte les étiquettes entity, entity_type, name et instance. Créez un jeton d'API pour un utilisateur disposant d'un accès en lecture et donnez-le à Prometheus comme identifiant bearer, avec /metrics/perf comme chemin de métriques du job de collecte et l'adresse de votre contrôleur comme cible, par exemple controller.example.com:8443. Un administrateur peut autoriser les collectes sans jeton avec le paramètre anonymous de la section [metrics] ; laissez-le désactivé tant que le réseau n'est pas fermé.

La consommation rend compte de l'utilisation à partir des mêmes données.
Les alarmes réagissent aux événements.