Collecteur d'événements vCenter

Rversion finale: Washingtondc

Mis à jour 1 févr. 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 ordinateur virtuel qui existe dans la CMDB. Lorsqu’un événement portant la mention « CreatedEvent » se produit dans son nom, par exemple 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, Discovery peut mettre à jour l’enregistrement existant sans lancer une autre analyse.

Le collecteur d’événements vCenter prend en charge Domain Separation en héritant du domaine du MID Server spécifié dans le contexte du collecteur d’événements. Toutefois, la configuration du MID Server multidomaine n’est pas prise en charge.

Pour connaître les versions prises en charge de vCenter, reportez-vous à la section Discovery pour VMware vCenter .

Mode de traitement des événements vCenter

Le MID Server écoute les événements vCenter configurés dans le formulaire Collecteur d’événements vCenter. Lorsque l’un de ces événements est renvoyé par 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 qu’une notification par e-mail.

Remarque :

Si le MID Server est mis en pause lorsqu’un événement vCenter se produit, le MID Server continue de traiter 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 traités par le système de base lorsqu’il Détection est activé. Si vous avez mis à niveau votre instance à partir d’une version antérieure, il se peut que les événements par défaut ne soient pas ajoutés avec les 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 éteint 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	L’ordinateur virtuel a été alimenté 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 de la défaillance de l’hôte d’origine.	Aucun
VmPoweredOffEvent	L’ordinateur virtuel a été mis 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 la mise hors tension de l’ordinateur virtuel.	Aucun
VmPowerOffOnIsolationEvent	L’ordinateur virtuel a été mis hors tension sur un hôte isolé dans une grappe HA.	Aucun
VmShutdownOnIsolationEvent	L’ordinateur virtuel a été arrêté sur un hôte isolé dans une grappe HA.	Aucun
VmSuspendedEvent (Événement suspendu)	L’ordinateur virtuel est suspendu. Cet événement est envoyé une fois la suspension de l’ordinateur virtuel terminée.	Aucun
VmRelocatedEvent	L’ordinateur virtuel a été déplacé hors ligne (soit suspendu, soit hors tension). 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. Fait évoluer les relations.	Aucun
VmMigratedEvent	L’une des situations suivantes ou les deux se produisent : La machine virtuelle a été migrée à chaud, avec vMotion, vers un autre serveur ESX. Le stockage de l’ordinateur virtuel a été migré à chaud. Met uniquement à jour la relation et la Deep Discovery.	Aucun
DrsVmMigratedEvent	Migration d’une VM recommandée par un DRS. Fait évoluer les relations.	Aucun
VmRemovedEvent	L’instance d’ordinateur virtuel a été supprimée de vCenter.	Aucun
VmClonedEvent	L’ordinateur virtuel a été cloné avec succès. Crée de nouveaux enregistrements et effectue une détection rapide.	Ordinateurs virtuels VMware - vCenter
VmCreatedEvent	L’ordinateur virtuel a été créé avec succès. Crée de nouveaux enregistrements et effectue une détection rapide.	Ordinateurs virtuels VMware - vCenter
VmDeployedEvent	L’ordinateur virtuel a été déployé avec succès. Crée de nouveaux enregistrements et effectue une détection rapide.	Ordinateurs virtuels VMware - vCenter
VMdiscoveredEvent (événement détecté)	Le vCenter détecte avec succès l’ordinateur virtuel. Crée de nouveaux enregistrements et effectue une détection rapide.	Ordinateurs virtuels VMware - vCenter
VmRegisteredEvent	L’ordinateur virtuel a été enregistré avec succès. Crée de nouveaux enregistrements et effectue une détection rapide.	Ordinateurs virtuels VMware - vCenter
VmReconfiguredEvent	L’ordinateur virtuel a été reconfiguré. Crée de nouveaux enregistrements et effectue une détection rapide.	Ordinateurs virtuels VMware - vCenter
VmInstanceUuidAssignedEvent	Un nouvel UUID d’instance a été affecté à l’ordinateur virtuel. Met à jour l’UUID d’instance d’ordinateur virtuel.	Aucun
VmRenamedEvent	L’ordinateur virtuel a été renommé avec succès. Modifie le nom.	Aucun
VmUuidAssignedEvent	Un nouvel UUID du BIOS a été affecté à l’ordinateur virtuel. 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 réseau VMware-VM.	Cartes réseau des ordinateurs virtuels VMware - vCenter
VmMacChangedEvent	L’adresse MAC d’un ordinateur virtuel a été modifiée. Affecte une adresse MAC à l’événement et déclenche la sonde réseau VMware-VM.	Cartes réseau des ordinateurs virtuels VMware - vCenter
VmGuestShutdownEvent*	L’ordinateur virtuel invité s’arrête.	Aucun
VmStoppingEvent (événement d’arrêt)	L’ordinateur virtuel s’est arrêté.	Aucun
VmResetEvent	Réinitialisation de l’ordinateur virtuel.	Aucun
Événements de grappe
Événement créé par grappe	Une grappe a été créée.	Grappes VMware - vCenter
Événement reconfiguré par grappe	Une grappe a été reconfigurée.	Grappes VMware - vCenter
Événement détruit par grappe	Une grappe a été détruite.	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) 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étectées.	Banques de données VMware - vCenter
NASDatastoreCreatedEvent	Une banque de données de stockage en réseau (NAS) 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é développée.	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 pool de ressources
ResourcePoolDestroyedEvent	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	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 Collecteur d’événements vCenter

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

Avant de commencer

Avant de configurer les collecteurs d’événements, procédez comme suit :

Déployez et démarrez un MID Server.
Assurez-vous que le MID Server a accès à vCenter.
Exécutez 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 à une seule 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 dans le système Discovery de base, vous devez créer une action de script pour traiter les événements. Pour obtenir des instructions, consultez Actions des scripts. En tant que 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 ni ne supprimez cette action de script.

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

Procédure

Accédez à la Tous > 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 de la souris 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 Événement 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 rechercher les événements non affichés.

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

Les liens connexes de 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 du 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 tant que le collecteur n’est pas 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 collecteur a échoué avec une erreur. Remarque : Le MID Server 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, par exemple Démarrer ou Arrêter. Ce champ s’affiche uniquement lorsque la valeur du champ État est définie sur Erreur.
Exécuter sur	Emplacement d’exécution de cette collection. Les options possibles sont MID Server spécifique ou Grappe de MID Servers spécifique.
Serveur MID	Nom du MID Server désigné si vous avez sélectionné MID Server spécifique dans le champ Exécuter sur . Le nom de la grappe de MID Servers désignée si vous avez sélectionné une grappe de MID Servers spécifique. Si vous avez sélectionné l’option de grappe MID Server, 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 MID Server sur lequel le collecteur 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.