Coletor de eventos do vCenter

Versão de lançamento: Zurich

Atualizado 31 de jul. de 2025

11 min. de leitura

O Coletor de eventos do vCenter é uma extensão do MID Server que detecta eventos relacionados ao vCenter e atualiza o CMDB de acordo.

O coletor de eventos permite que o CMDB seja atualizado com mudanças nas máquinas virtuais (VMs), além das atualizações detectadas pela Descoberta. Uma mudança em uma VM é enviada como um evento do servidor vCenter para o coletor de eventos do vCenter. Quando um evento é recebido, o CMDB é atualizado de acordo. A Descoberta completa do vCenter não precisa ser executada novamente. Para alguns eventos, como eventos ligados e desligados, a Descoberta não precisa ser executada novamente. Para a maioria dos eventos, a Descoberta é executada somente no recurso vCenter necessário.

Por exemplo, se uma VM estiver desligada, o servidor vCenter enviará o evento VmPoweredOffEvent. O coletor de eventos do vCenter recebe e processa o evento e o CMDB é atualizado para refletir que o estado da VM correspondente está definido como desativado.

Importante:

Com esta extensão, a Descoberta só pode modificar o estado de uma VM que existe no CMDB. Quando ocorre um evento com "CreatedEvent" em seu nome, como VmCreatedEvent, a Descoberta verifica essa VM e cria o IC usando os dados coletados. Quando ocorre um novo evento envolvendo esse IC, a Descoberta pode atualizar o registro existente sem iniciar outra verificação.

O coletor de eventos do vCenter dá suporte à separação de domínio herdando o domínio do Mid Server especificado no contexto do coletor de eventos. No entanto, ele não oferece suporte à configuração de MID Server de vários domínios.

Consulte Discovery for VMware vCenter para obter versões compatíveis do vCenter.

Como os eventos do vCenter são processados

O MID Server escuta os eventos do vCenter configurados no formulário do Coletor de eventos do vCenter. Quando um desses eventos é retornado do vCenter, a instância analisa a carga com uma regra de negócios que converte o evento do vCenter em um evento do sistema (sysevent). A instância usa esse evento do sistema para executar tarefas, como notificação por e-mail.

Nota:

Se o MID Server estiver pausado quando ocorrer um evento do vCenter, o MID Server ainda processará o evento. Nesse caso, é possível que o coletor de eventos exiba um status de Iniciado.

Os eventos do sistema resultantes contêm estes valores:

Nome: nome do evento do sistema criado a partir do evento do vCenter. Este valor é sempre automation.vcenter.
Parm1: evento do vCenter que foi retornado. Este evento deve ser associado a um registro do coletor de eventos.
Parm2: dados do evento fornecidos pelo vCenter, no formato JSON.

Figura 1. Entradas de registro para eventos do vCenter

Eventos do vCenter compatíveis

Os eventos a seguir são os únicos eventos do vCenter tratados pelo sistema de base quando Descoberta está ativado. Se você fez upgrade da sua instância de uma versão anterior, talvez não tenha os eventos padrão adicionados com versões posteriores. Para usar os eventos ausentes, adicione-os manualmente.

Tabela 1. Eventos do vCenter
Nome do evento	Descrição	Inicia probe
Eventos de VM
VmPoweredOnEvent	A VM foi ligada a partir do estado desligado ou reiniciada a partir do estado suspenso. Este evento é enviado quando a VM é ligada. Ele não considera o tempo que pode levar para inicializar o sistema operacional do host.	Nenhum
DrsVmPoweredOnEvent	A VM foi ativada por uma programação de recursos distribuídos (DRS), que equilibra a carga de trabalho entre os recursos disponíveis.	Nenhum
VmRestartedOnAlternateHostEvent	A VM foi reiniciada em outro host porque o host original falhou.	Nenhum
VmPoweredOffEvent	A VM foi desligada. Se o SO do host for encerrado, este evento será enviado depois que o SO do host for encerrado e a VM entrar no estado desligado.	Nenhum
VmPowerOffOnIsolationEvent	A VM foi desligada em um host isolado em um cluster de HA.	Nenhum
VmShutdownOnIsolationEvent	A VM foi desligada em um host isolado em um cluster de HA.	Nenhum
VmSuspendedEvent	A VM está suspensa. Este evento é enviado após a conclusão da suspensão da VM.	Nenhum
VmRelocatedEvent	A VM foi realocada enquanto estava off-line (suspensa ou desligada). Uma migração de VM da VM para um host diferente ou a migração de qualquer armazenamento usado pela VM aciona o evento. Move os relacionamentos.	Nenhum
VmMigratedEvent	Ocorre um ou ambos: A VM foi migrada a quente, com o vMotion, para outro servidor ESX. O armazenamento da VM foi migrado a quente. Apenas atualiza o relacionamento e a Descoberta profunda.	Nenhum
DrsVmMigratedEvent	Migração de uma VM recomendada por um DRS. Move os relacionamentos.	Nenhum
VmRemovedEvent	A instância de VM foi excluída do vCenter.	Nenhum
VmClonedEvent	A VM foi clonada com sucesso. Cria novos registros e executa a Descoberta rápida.	VMWare - VMs do vCenter
VmCreatedEvent	A VM foi criada com sucesso. Cria novos registros e executa a Descoberta rápida.	VMWare - VMs do vCenter
VmDeployedEvent	A VM foi implantada com sucesso. Cria novos registros e executa a Descoberta rápida.	VMWare - VMs do vCenter
VmDiscoveredEvent	O vCenter descobriu a VM com sucesso. Cria novos registros e executa a Descoberta rápida.	VMWare - VMs do vCenter
VmRegisteredEvent	A VM foi registrada com sucesso. Cria novos registros e executa a Descoberta rápida.	VMWare - VMs do vCenter
VmReconfiguredEvent	A VM foi reconfigurada. Cria novos registros e executa a Descoberta rápida.	VMWare - VMs do vCenter
VmInstanceUuidAssignedEvent	Um novo UUID de instância foi atribuído à VM. Atualiza o UUID da instância da VM.	Nenhum
VmRenamedEvent	A VM foi renomeada com sucesso. Muda o nome.	Nenhum
VmUuidAssignedEvent	Um novo BIOS UUID de instância foi atribuído à VM. Adiciona o UUID da VM.	Nenhum
VmMacAssignedEvent	Um novo endereço MAC foi atribuído à VM. Atribui o endereço MAC ao evento e dispara a probe de NICs da VM do VMware.	VMWare - VM NICs do vCenter
VmMacChangedEvent	O endereço MAC de uma VM foi alterado. Atribui o endereço MAC ao evento e dispara a probe de NICs da VM do VMware.	VMWare - VM NICs do vCenter
VmGuestShutdownEvent*	A VM convidada foi desligada.	Nenhum
VmStoppingEvent	A VM parou.	Nenhum
VmResettingEvent	A VM foi redefinida.	Nenhum
Eventos de cluster
ClusterCreatedEvent	Um cluster foi criado.	VMware - Clusters do vCenter
ClusterReconfiguredEvent	Um cluster foi reconfigurado.	VMware - Clusters do vCenter
ClusterDestroyedEvent	Um cluster foi destruído.	Nenhum
Eventos do repositório de dados
DatastoreRenamedEvent	Um repositório de dados foi renomeado.	Nenhum
VMFSDatastoreCreatedEvent	Um repositório de dados do Sistema de arquivos da VM (VMFS) foi criado.	VMWare - Repositórios de Dados do vCenter
DatastoreDiscoveredEvent	Um host foi adicionado ao VirtualCenter e os Repositórios de dados foram descobertos.	VMWare - Repositórios de Dados do vCenter
NASDatastoreCreatedEvent	Um repositório de dados de Armazenamento conectado à rede (NAS) foi criado.	VMWare - Repositórios de Dados do vCenter
LocalDatastoreCreatedEvent	Um repositório de dados local foi criado.	VMWare - Repositórios de Dados do vCenter
VMFSDatastoreExpandedEvent	Um repositório de dados foi expandido.	VMWare - Repositórios de Dados do vCenter
DatastoreDestroyedEvent	Um datastore foi removido do VirtualCenter.	Nenhum
Eventos de rede
DVPortgroupCreatedEvent	Um grupo de portas foi criado.	VMWare - Redes do vCenter
DVPortgroupRenamedEvent	Um grupo de portas foi renomeado.	Nenhum
DVPortgroupDestroyedEvent	Um grupo de portas foi destruído.	Nenhum
Eventos do Resourcepool
ResourcePoolDestroyedEvent	Um grupo de recursos foi destruído.	Nenhum
ResourcePoolCreatedEvent	Um grupo de recursos foi criado.	VMware - Clusters do vCenter
ResourcePoolMovedEvent	Um grupo de recursos foi movido.	VMware - Clusters do vCenter
ResourcePoolReconfiguredEvent	Um grupo de recursos foi reconfigurado.	VMware - Clusters do vCenter
Eventos de DVS
DvsCreatedEvent	Um comutador virtual distribuído foi criado.	VMWare - Redes do vCenter
DvsRenamedEvent	Um comutador virtual distribuído foi renomeado.	Nenhum
DvsDestroyedEvent	Um comutador virtual distribuído foi destruído.	Nenhum
Eventos do Datacenter
DatacenterCreatedEvent	Um datacenter foi criado.	VMWare - Datacenters do vCenter
DatacenterRenamedEvent	Um datacenter foi renomeado.	Nenhum

Configurar e executar a extensão do coletor de eventos do vCenter

Configure a extensão do coletor de eventos do vCenter no módulo do MID Server e adicione ou remova eventos compatíveis.

Antes de Iniciar

Antes de configurar os coletores de eventos, execute estas tarefas:

Implante e inicie um MID Server.
Certifique-se de que o MID Server tenha acesso ao vCenter.
Execute a descoberta no vCenter.

Função necessária: agent_admin, administrador

Por Que e Quando Desempenhar Esta Tarefa

Vários MID Servers podem escutar a mesma instância do vCenter e você pode adicionar vários Coletores de eventos para diferentes vCenter a um único MID Server. Certifique-se de configurar os eventos no registro do coletor de eventos que especificam o MID Server correto.

Nota:

Você pode adicionar eventos ao coletor de eventos do vCenter. No entanto, nem todos os eventos são compatíveis com os manipuladores de eventos do sistema de base. Se quiser processar eventos diferentes dos compatíveis no sistema da Descoberta base, você deverá criar uma ação de script para processar os eventos. Para obter instruções, consulte Ações de script. Como referência, a instância processa os eventos do vCenter no sistema de base com uma ação de script chamada Discovery: Process vCenter events. Não edite ou exclua esta ação de script.

Para configurar a extensão do processador de evento do vCenter:

Procedimento

Navegar até Tudo > MID Server > Extensões > Coletores de Eventos vCenter.
Clique em Novo ou abra uma extensão existente.
Preencha os campos, conforme apropriado da tabela.
Clique com o botão direito do mouse na barra de cabeçalho e clique em Salvar no menu de contexto.
A lista relacionada ao Evento do vCenter é exibida, contendo os eventos padrão para os quais o sistema está configurado.
Para selecionar um evento diferente do vCenter, clique em Editar na lista relacionada ao Evento do vCenter e procure o evento.

A interface de caixa de listagem dupla não exibe todos os eventos disponíveis na lista de abertura. Use o filtro para procurar eventos não exibidos.

Em Links relacionados, clique em Iniciar para salvar os eventos nesta coleção e iniciar o coletor.

Os Links relacionados neste formulário funcionam da seguinte forma:

Tabela 2. Comandos disponíveis na extensão do processador de eventos do vCenter
Link relacionado	Descrição
Início	Inicia o coletor se ele não estiver em execução. A extensão se conecta ao servidor vCenter especificado enumerando as credenciais do VMware no conjunto de credenciais até que uma conexão possa ser feita. Em seguida, a extensão faz com que o servidor vCenter forneça os eventos especificados no Contexto do coletor.
Parar	Interrompe o coletor em execução no MID Server configurado. Nenhuma ação vai ser realizada se a extensão não estiver em execução.
Reiniciar	Interrompe e depois inicia o coletor no MID Server configurado.
Teste	Testa os parâmetros quanto à validade. Se o endereço IP, o nome do host e o conjunto de eventos forem válidos, o teste vai retornar um status bem-sucedido. Se algum dos parâmetros estiver incorreto, um erro vai ser mostrado. A execução de um teste não afeta as extensões em execução no momento.
Atualizar parâmetros	Envia parâmetros atualizados para o coletor. As mudanças feitas no coletor enquanto o MID Server está em execução não têm efeito imediato quando são salvas. Se você clicar neste controle quando o coletor não estiver em execução, nenhuma atualização será feita. No caso da extensão do vCenter, o coletor testa primeiro os parâmetros em relação à validade. Se os parâmetros forem válidos, a extensão vai ser desconectada do servidor vCenter e reconectada com os novos parâmetros.


Campo	Descrição
Nome	Um nome exclusivo para esta extensão do coletor de eventos do vCenter para facilitar a identificação.
Descrição resumida	Uma descrição deste coletor.
Extensão	[Somente leitura] O tipo de coletor é definido automaticamente como vCenterExtension.
Status	Este campo é preenchido automaticamente com o status do coletor. Este campo ficará em branco até que o coletor seja iniciado. Depois de emitir um comando para o coletor, você verá um destes valores: Iniciado: o coletor está em execução. Parado: o coletor não está em execução. Off-line: o MID Server está inativo. Erro: o coletor falhou com um erro. Nota: O MID Server continua a processar os eventos do vCenter, mesmo se estiver pausado. O status do coletor de eventos pode ser exibido como Iniciado.
Mensagem de erro	Mensagem que descreve qualquer erro que causa falha em um comando, como Iniciar ou Parar. Este campo é exibido somente quando o valor no campo Status for Erro.
Executar nos(as)	Local para executar esta coleção. As opções possíveis são MID Server específico ou Cluster de MID Server específico.
MID Server	O nome do MID Server designado se você selecionou o MID Server específico no campo Executar em. O nome do cluster do MID Server designado se você selecionou Cluster de MID Server específico. Se você selecionou a opção de cluster do MID Server, um algoritmo determinará qual servidor no cluster executa o coletor.
vCenter	O endereço IP ou nome do host do servidor vCenter.
Executando no(a)	[Somente leitura] O nome do MID Server no qual o coletor está sendo executado. Este campo mostra o nome do MID Server mesmo se o MID Server estiver inativo. Se o coletor for interrompido pelo usuário, este campo estará vazio.