Collecteur d'événements vCenter

Rversion finale: Xanadu

Mis à jour 1 août 2024

11 minutes de lecture

Le collecteur d'événements vCenter est une extension du MID Server qui écoute les événements liés à vCenter et met à jour la CMDB en conséquence.

Le collecteur d'événements permet de mettre à jour la CMDB en modifiant les ordinateurs virtuels, en plus des mises à jour détectées par Discovery. Un changement apporté à un ordinateur virtuel est envoyé en tant qu'événement du serveur vCenter au collecteur d'événements vCenter. Lorsqu'un événement est reçu, la CMDB est mise à jour en conséquence. La détection vCenter n'a pas besoin d'être entièrement réexécutée. Pour certains événements, tels que les événements de mise sous tension et de mise hors tension, Discovery n'a pas besoin de s'exécuter à nouveau. Pour la plupart des événements, Discovery s'exécute uniquement sur la ressource vCenter nécessaire.

Par exemple, si un ordinateur virtuel est désactivé, le serveur vCenter envoie l’événement VmPoweredOffEvent. Le collecteur d’événements vCenter reçoit et traite l’événement , et la CMDB est mise à jour pour indiquer que l’état de l’ordinateur virtuel correspondant est désactivé.

Important :

Avec cette extension, Discovery peut uniquement modifier l’état d’un VM qui existe dans la CMDB. Lorsqu’un événement avec « CreatedEvent » se produit dans son nom, tel que VmCreatedEvent, Discovery analyse cet ordinateur virtuel, puis crée le CI à l’aide des données qu’il collecte. Lorsqu’un nouvel événement impliquant ce CI se produit, Découverte peut mettre à jour l’enregistrement existant sans lancer une autre analyse.

Le collecteur d’événements vCenter prend en charge Séparation de domaine en héritant le domaine du MID Server spécifié dans le contexte du collecteur d’événements. Toutefois, il ne prend pas en charge la configuration de serveur MID multidomaine.

Reportez-vous à la section Détection pour VMware vCenter pour connaître les versions prises en charge de vCenter.

Comment les événements vCenter sont traités

Le MID Server est à l’écoute des événements vCenter configurés dans le formulaire du collecteur d’événements vCenter. Lorsque l’un de ces événements est renvoyé à partir de vCenter, l’instance analyse la charge utile à l’aide d’une règle métier qui convertit l’événement vCenter en événement système (sysevent). L’instance utilise ensuite ce sysevent pour effectuer des tâches, telles que la notification par e-mail.

Remarque :

Si le MID Server est mis en pause lorsqu’un événement vCenter se produit, il traite toujours l’événement. Dans ce cas, il est possible que le collecteur d’événements affiche l’état Démarré.

Les sysevents qui en résultent contiennent les valeurs suivantes :

Nom : nom de l’événement système créé à partir de l’événement vCenter. Cette valeur est toujours automation.vcenter.
Parm1 : événement vCenter qui a été renvoyé. Cet événement doit être associé à un enregistrement de collecteur d’événements.
Parm2 : données d’événement fournies par vCenter, au format JSON.

Figure 1. Entrées de journal pour les événements vCenter

Événements vCenter pris en charge

Les événements suivants sont les seuls événements vCenter gérés par le système de base lorsqu’il Découverte est activé. Si vous avez mis à niveau votre instance à partir d’une version antérieure, il est possible que les événements par défaut ne soient pas ajoutés aux versions ultérieures. Pour utiliser les événements manquants, ajoutez-les manuellement.

Tableau 1. Événements vCenter
Nom d'événement	Description	Lance la sonde
Événements d’ordinateur virtuel
VmPoweredOnEvent	L’ordinateur virtuel a été mis sous tension à partir de l’état hors tension ou repris à partir de l’état suspendu. Cet événement est envoyé lorsque l’ordinateur virtuel est mis sous tension. Il ne tient pas compte du temps nécessaire pour démarrer le système d’exploitation hôte.	Aucun
DrsVmPoweredOnEvent	La machine virtuelle a été alimentée par un calendrier de ressources distribuées (DRS), qui équilibre la charge de travail entre les ressources disponibles.	Aucun
VmRestartedOnAlternateHostEvent	L’ordinateur virtuel a été redémarré sur un autre hôte en raison d’une défaillance de l’hôte d’origine.	Aucun
VmPoweredOffEvent	La machine virtuelle a été mise hors tension. Si le système d’exploitation hôte est arrêté, cet événement est envoyé après l’arrêt du système d’exploitation hôte et l’entrée de l’ordinateur virtuel dans l’état hors tension.	Aucun
VmPowerOffOnIsolationEvent	La machine virtuelle a été mise hors tension sur un hôte isolé dans un cluster HA.	Aucun
VmShutdownOnIsolationEvent	La machine virtuelle a été arrêtée sur un hôte isolé dans une grappe HA.	Aucun
VmSuspendedEvent (Événement suspendu de l’ordinateur virtuel)	L’ordinateur virtuel est suspendu. Cet événement est envoyé une fois la suspension de l’ordinateur virtuel terminée.	Aucun
VmRelocatedEvent	La machine virtuelle a été déplacée hors ligne (suspendue ou désactivée). Une migration de l’ordinateur virtuel vers un hôte différent ou la migration de tout stockage utilisé par l’ordinateur virtuel déclenche l’événement. Déplace les relations.	Aucun
VmMigratedEvent (en anglais seulement)	L’une ou l’autre des situations suivantes, ou les deux : La machine virtuelle a été migrée à chaud, avec vMotion, vers un autre serveur ESX. Le stockage de la machine virtuelle a été migré à chaud. Met uniquement à jour la relation et Deep Discovery.	Aucun
DrsVmMigratedEvent	Migration d’un VM recommandée par un DRS. Déplace les relations.	Aucun
VmRemovedEvent	L’instance de VM a été supprimée de vCenter.	Aucun
VmClonedEvent (en anglais seulement)	La machine virtuelle a été clonée avec succès. Crée de nouveaux enregistrements et effectue une découverte rapide.	Ordinateurs virtuels VMware - vCenter
VmCreatedEvent	Le VM a été créé avec succès. Crée de nouveaux enregistrements et effectue une découverte rapide.	Ordinateurs virtuels VMware - vCenter
VmDeployedEvent (en anglais seulement)	Le VM a été déployé avec succès. Crée de nouveaux enregistrements et effectue une découverte rapide.	Ordinateurs virtuels VMware - vCenter
VMdiscoveredEvent (en anglais seulement)	Le vCenter détecte l’ordinateur virtuel. Crée de nouveaux enregistrements et effectue une découverte rapide.	Ordinateurs virtuels VMware - vCenter
VmRegisteredEvent (Événement enregistré)	Le VM a été correctement enregistré. Crée de nouveaux enregistrements et effectue une découverte rapide.	Ordinateurs virtuels VMware - vCenter
VmReconfiguredEvent	La machine virtuelle a été reconfigurée. Crée de nouveaux enregistrements et effectue une découverte rapide.	Ordinateurs virtuels VMware - vCenter
VmInstanceUuidAssignedEvent	Un nouvel UUID d’instance a été affecté à l’ordinateur virtuel. Met à jour l’UUID d’instance du VM.	Aucun
VmRenamedEvent	Le VM a été renommé avec succès. Modifie le nom.	Aucun
VmUuidAssignedEvent	Un nouvel UUID du BIOS a été affecté à la machine virtuelle. Ajoute l’UUID de l’ordinateur virtuel.	Aucun
VmMacAssignedEvent	Une nouvelle adresse MAC a été affectée à l’ordinateur virtuel. Affecte une adresse MAC à l’événement et déclenche la sonde de cartes réseau VMware-VM.	Cartes réseau des ordinateurs virtuels VMware - vCenter
VmMacChangedEvent	L’adresse MAC d’un VM a été modifiée. Affecte une adresse MAC à l’événement et déclenche la sonde de cartes réseau VMware-VM.	Cartes réseau des ordinateurs virtuels VMware - vCenter
VmGuestShutdownEvent*	L’ordinateur virtuel invité s’arrête.	Aucun
VmStoppingEvent (en anglais seulement)	Le VM s’est arrêté.	Aucun
VmResettingEvent	L’ordinateur virtuel s’est réinitialisé.	Aucun
Événements de grappes
GrappeCreatedEvent	Une grappe a été créée.	Grappes VMware - vCenter
Événement ClusterReconfigured	Une grappe a été reconfigurée.	Grappes VMware - vCenter
Événement détruit par grappe	Un cluster a été détruit.	Aucun
Événements de banque de données
DatastoreRenamedEvent	Une banque de données a été renommée.	Aucun
VMFSDatastoreCreatedEvent	Une banque de données VMFS (VMFS File System) a été créée.	Banques de données VMware - vCenter
Banque de donnéesDiscoveredEvent	Un hôte a été ajouté à VirtualCenter et des banques de données ont été découvertes.	Banques de données VMware - vCenter
NASDatastoreCreatedEvent	Une banque de données NAS (Network Attached Storage ) a été créée.	Banques de données VMware - vCenter
LocalDatastoreCreatedEvent	Une banque de données locale a été créée.	Banques de données VMware - vCenter
VMFSDatastoreExpandedEvent	Une banque de données a été agrandie.	Banques de données VMware - vCenter
DatastoreDestroyed Event	Une banque de données a été supprimée de VirtualCenter.	Aucun
Événements réseau
DVPortgroupCreatedEvent	Un groupe de ports a été créé.	Réseaux VMware - vCenter
DVPortgroupRenamedEvent	Un groupe de ports a été renommé.	Aucun
DVPortgroupDestroyedEvent	Un groupe portuaire a été détruit.	Aucun
Événements de pools de ressources
ResourcePoolDestroyedEvent (en anglais seulement)	Un pool de ressources a été détruit.	Aucun
ResourcePoolCreatedEvent	Un pool de ressources a été créé.	Grappes VMware - vCenter
ResourcePoolMovedEvent	Un pool de ressources a été déplacé.	Grappes VMware - vCenter
ResourcePoolReconfiguredEvent	Un pool de ressources a été reconfiguré.	Grappes VMware - vCenter
Événements DVS
DvsCreatedEvent (en anglais seulement)	Un commutateur virtuel distribué a été créé.	Réseaux VMware - vCenter
DvsRenamedEvent	Un commutateur virtuel distribué a été renommé.	Aucun
DvsDestroyedEvent	Un commutateur virtuel distribué a été détruit.	Aucun
Événements de centre de données
Centre de donnéesCreatedEvent	Un centre de données a été créé.	Centres de données VMware - vCenter
Centre de donnéesRenamedEvent	Un centre de données a été renommé.	Aucun

Configurer et exécuter l’extension du collecteur d’événements vCenter

Configurez l’extension du collecteur d’événements vCenter dans le module Serveur MID, puis ajoutez ou supprimez les événements pris en charge.

Avant de commencer

Avant de configurer les collecteurs d’événements, effectuez les tâches suivantes :

Déployez et démarrez un serveur MID.
Assurez-vous que le MID Server a accès au vCenter.
Exécuter Discovery sur vCenter.

Rôle requis : agent_admin, admin

Pourquoi et quand exécuter cette tâche

Plusieurs Serveurs MID peuvent écouter la même instance vCenter et vous pouvez ajouter plusieurs collecteurs d’événements pour différents vCenter en un seul Serveur MID. Assurez-vous de configurer les événements sur l’enregistrement du collecteur d’événements qui spécifient le fichier .Serveur MID

Remarque :

Vous pouvez ajouter des événements au collecteur d’événements vCenter. Toutefois, tous les événements ne sont pas pris en charge par les gestionnaires d’événements du système de base. Si vous souhaitez gérer des événements autres que ceux pris en charge par le système de découverte de base, vous devez créer une action des scripts pour traiter les événements. Pour obtenir des instructions, consultez Actions des scripts. À titre de référence, l’instance traite les événements vCenter dans le système de base avec une action de script appelée Discovery: Process vCenter events. Ne modifiez pas ou ne supprimez pas cette action des scripts.

Pour configurer l’extension de processeur d’événements vCenter :

Procédure

Accédez à la Tout > Serveur MID > Extensions > Collecteurs d'événements vCenter.
Cliquez sur Nouveau ou ouvrez une extension existante.
Renseignez les champs de la table comme il convient.
Cliquez avec le bouton droit dans la barre d’en-tête, puis cliquez sur Enregistrer dans le menu contextuel.
La liste connexe Événement vCenter s’affiche, contenant les événements par défaut que le système est configuré pour gérer.
Pour sélectionner un autre événement vCenter, cliquez sur Modifier dans la liste connexe des événements vCenter et recherchez l’événement.

La zone de liste double n’affiche pas tous les événements disponibles dans la liste d’ouverture. Utilisez le filtre pour parcourir les événements non affichés.

Sous Liens connexes, cliquez sur Démarrer pour enregistrer les événements dans cette collection et démarrer le collecteur.

Les liens connexes contenus dans ce formulaire fonctionnent comme suit :

Tableau 2. Commandes disponibles dans l'extension de processeur d'événements vCenter
Lien connexe	Description
Début	Démarre le collecteur s'il n'est pas en cours d'exécution. L'extension se connecte au serveur vCenter spécifié en énumérant les informations d'identification VMware dans l'ensemble d'informations d'identification jusqu'à ce qu'une connexion soit établie. Ensuite, l'extension indique au serveur vCenter de fournir les événements spécifiés dans le contexte du collecteur.
Arrêter	Arrête l'exécution du collecteur sur le MID Server configuré. Aucune action n'est effectuée si l'extension n'est pas en cours d'exécution.
Redémarrer	Arrête, puis démarre le collecteur sur le MID Server configuré.
Test	Teste les paramètres pour la validité. Si l'adresse IP, le nom d'hôte et l'ensemble d'événements sont valides, le test renvoie un état réussi. Si l'un des paramètres est incorrect, une erreur s'affiche. L'exécution d'un test n'affecte aucune extension en cours d'exécution.
Mettre à jour les paramètres	Envoie des paramètres mis à jour au collecteur. Les changements que vous apportez au collecteur pendant l'exécution du MID Server ne prennent pas effet immédiatement lorsqu'ils sont enregistrés. Si vous cliquez sur ce contrôle et que le collecteur n'est pas en cours d'exécution, aucune mise à jour n'est effectuée. Dans le cas de l'extension vCenter, le collecteur vérifie d'abord la validité des paramètres. Si les paramètres sont valides, l'extension se déconnecte du serveur vCenter et se reconnecte aux nouveaux paramètres.


Champ	Description
Nom	Nom unique pour cette extension de collecteur d’événements vCenter pour faciliter l’identification.
Description brève	Description de ce collecteur.
Extension	[Lecture seule] Le type de collecteur est automatiquement défini sur vCenterExtension.
Statut	Ce champ se remplit automatiquement avec l’état du collecteur. Ce champ est vide jusqu’à ce que le collecteur soit démarré. Après avoir envoyé une commande au collecteur, l’une des valeurs suivantes s’affiche : A démarré : le collecteur est en cours d'exécution. Est arrêté : le collecteur n'est pas en cours d'exécution. Hors-ligne : le MID Server est en panne. Erreur : Le module de collection a échoué avec une erreur. Remarque : Le serveur MID continue de traiter les événements vCenter, même s’il est en pause. L’état du collecteur d’événements peut s’afficher comme Démarré.
Message d'erreur	Message décrivant toute erreur qui entraîne l’échec d’une commande, telle que Start ou Stop. Ce champ s’affiche uniquement lorsque la valeur du champ État est Erreur.
Exécuter sur	Emplacement d’exécution de cette collection. Les options possibles sont Serveur MID spécifique ou Grappe de serveurs MID spécifique.
Serveur MID	Nom du Serveur MID désigné si vous avez sélectionné Serveur MID spécifique dans le champ Exécuter sur . Nom de la grappe de Serveur MID désignée si vous avez sélectionné Grappe de Serveur MID spécifique. Si vous avez sélectionné l’option de grappe de Serveur MID, un algorithme détermine quel serveur de la grappe exécute le collecteur.
vCenter	Adresse IP ou nom d’hôte du serveur vCenter.
Exécution sur	[Lecture seule] Nom du Serveur MID sur lequel le module de collection est en cours d’exécution. Ce champ affiche le nom du MID Server même si ce dernier est en panne. Si le collecteur est arrêté par l’utilisateur, ce champ est vide.