Événements

Lisez et filtrez la liste des événements dans la console, partagez une vue filtrée, ajoutez vos propres événements et sachez combien de temps ils restent.

Un événement est l'enregistrement de ce qui est arrivé à un objet : une machine virtuelle a été mise sous tension, un hôte s'est déconnecté, une adresse a été modifiée. Kyvernon enregistre des événements pour chaque modification, quelle que soit l'interface qui l'a faite. Un événement a un type comme VmPoweredOnEvent, une gravité, l'objet, l'utilisateur et l'heure. Vous voyez les événements des objets que vous avez le droit de voir, ce qui demande System.View.

Dans la console

Pour les derniers événements, ouvrez l'onglet Événements dans le volet en bas de chaque page. Pour la liste complète, ouvrez la page d'accueil (Accueil) et sélectionnez Événements sous Raccourcis.

:::screen events

Le tableau a les colonnes Heure, Gravité, Message, Objet et Utilisateur. Les gravités sont Information, Avertissement et Erreur. L'objet est un lien vers l'objet concerné par l'événement.

Dans le formulaire Filtrer les événements, choisissez l'Objet : saisissez du texte pour chercher des hôtes, des machines virtuelles, des datastores, des réseaux et plus. Pour un cluster ou un dossier, Inclure les objets qu’il contient affiche aussi les événements de tout ce qu'il contient.
Saisissez un Type d’événement, ou plusieurs séparés par des virgules, par exemple VmPoweredOnEvent. Choisissez la Gravité minimale qui vous intéresse, et une Période : Dernière heure, Dernier jour, Dernière semaine ou Période personnalisée avec Du et Au.
Sélectionnez Appliquer le filtre. Le filtre s'exécute sur le plan de contrôle, donc une liste filtrée contient les événements correspondants les plus récents et pas seulement une partie de la page non filtrée. Une ligne à côté des boutons donne le nombre d'événements correspondants.
Sélectionnez Charger les événements plus anciens pour remonter plus loin, 100 événements à la fois. Effacer le filtre supprime le filtre.

L'adresse de la page conserve le filtre, donc une vue filtrée survit à un rechargement, et vous pouvez la partager ou la mettre en favori. Pour ajouter un événement de votre part, sélectionnez Ajouter un événement, choisissez l'Objet, écrivez le Message et sélectionnez Ajouter l'événement. L'événement est enregistré comme événement utilisateur sur cet objet, avec votre nom d'utilisateur, pour des notes comme le début d'une fenêtre de maintenance. Vous avez besoin du privilège Global.LogEvent sur l'objet.

:::screen events-add

Résultat

La liste affiche les événements correspondants, du plus récent au plus ancien. Les événements d'un objet supprimé restent dans la liste avec le nom que l'objet avait, pour les utilisateurs qui détiennent System.View sur la racine.

Le contrôleur conserve les événements 90 jours, et au plus 1,000,000 d'entre eux. Au-delà de la limite de taille de l'historique que l'administrateur fixe dans la configuration du contrôleur avec history_max_bytes, les événements les plus anciens et les tâches terminées sont supprimés en premier. Les enregistrements d'audit sont conservés à part et plus longtemps ; consultez Sessions et audit.

Automatisation

Avec la CLI

Shell

kyvernon events list --desc --limit 50
kyvernon events list --target vm-42 --recursive --event-type VmPoweredOnEvent,VmPoweredOffEvent
kyvernon events log vm-42 "Maintenance window agreed with the owner"

events list affiche d'abord les événements les plus anciens ; --desc affiche d'abord les plus récents, et --after prend le curseur next de la page précédente. Les autres filtres sont --user, --begin et --end au format RFC 3339, et --chain <id>, qui regroupe les événements et, avec kyvernon tasks list --chain, les tâches d'une même action. events log ajoute à un objet un événement utilisateur de type GeneralUserEvent, par exemple pour noter une modification faite en dehors de Kyvernon. kyvernon events post --body-file event.json publie un événement typé.

Avec l'API

GET /v1/events liste les événements avec target, recursive, eventType, user, chainId, begin, end, minSeverity, order, limit et after. POST /v1/events/user ajoute un événement utilisateur avec entityId et message, et POST /v1/events publie un événement typé ; les deux demandent Global.LogEvent. La gravité est info, warning, error ou user. Le service gRPC EventService liste aussi les événements.

Les alarmes lèvent un état quand un événement d'un type donné se produit.
Les webhooks livrent les événements à d'autres systèmes.
Les tâches montrent les opérations derrière les événements.