en	# 10 Virtual machine monitoring
pt-br	# 10. Monitoramento de máquina virtual

en	#### Overview Zabbix can use [low-level discovery](/manual/discovery/low_level_discovery) rules to automatically discover VMware hypervisors and virtual machines, and create hosts to monitor them based on pre-defined [host prototypes](/manual/discovery/low_level_discovery/host_prototypes). Zabbix also includes [ready-to-use templates](/manual/config/templates_out_of_the_box/vmware) for monitoring VMware vCenter or ESXi hypervisors. The minimum required VMware vCenter or vSphere version is 5.1.
pt-br	#### Visão geral O Zabbix pode usar regras de [descoberta de baixo nível](/manual/discovery/low_level_discovery) para descobrir automaticamente hipervisores VMware e máquinas virtuais, e criar hosts para monitorá-los com base em [prototipos de host](/manual/discovery/low_level_discovery/host_prototypes) predefinidos. O Zabbix também inclui [templates prontos para uso](/manual/config/templates_out_of_the_box/vmware) para monitorar o VMware vCenter ou hipervisores ESXi. A versão mínima exigida do VMware vCenter ou vSphere é 5.1.

en	#### Data collection Virtual machine monitoring consists of two steps: 1. Zabbix *vmware collector* processes collect virtual machine data - the processes obtain necessary information from VMware web services over the SOAP protocol, pre-process it, and store it in Zabbix server shared memory. 2. Zabbix *poller* processes retrieve data using Zabbix simple check [VMware monitoring item keys](/manual/vm_monitoring/vmware_keys). Zabbix divides collected data into VMware configuration data and VMware performance counter data. Both types of data are collected independently by the *vmware collector* processes. The following statistics are available based on the VMware performance counter information: - Datastore - Disk device - CPU - Power - Network interface - Custom performance counter items For the complete list of items that obtain data from VMware performance counters, see [*VMware monitoring item keys*](/manual/vm_monitoring/vmware_keys#footnotes). Note that the frequency of VMware event retrieval depends on the polling interval of [vmware.eventlog](/manual/vm_monitoring/vmware_keys#vmware.eventlog), but cannot be less then 5 seconds.
pt-br	#### Coleta de dados O monitoramento de máquinas virtuais consiste em duas etapas: 1. Os processos *vmware collector* do Zabbix coletam dados da máquina virtual - os processos obtêm as informações necessárias dos serviços web do VMware pelo protocolo SOAP, pré-processam e armazenam na memória compartilhada do servidor Zabbix. 2. Os processos *poller* do Zabbix recuperam os dados usando as chaves de item de verificação simples do Zabbix [VMware monitoring item keys](/manual/vm_monitoring/vmware_keys). O Zabbix divide os dados coletados em dados de configuração do VMware e dados de contadores de desempenho do VMware. Ambos os tipos de dados são coletados independentemente pelos processos *vmware collector*. As seguintes estatísticas estão disponíveis com base nas informações dos contadores de desempenho do VMware: - Datastore - Disco - CPU - Energia - Interface de rede - Itens de contador de desempenho personalizados Para a lista completa de itens que obtêm dados dos contadores de desempenho do VMware, consulte [*VMware monitoring item keys*](/manual/vm_monitoring/vmware_keys#footnotes). Observe que a frequência de recuperação de eventos do VMware depende do intervalo de polling do [vmware.eventlog](/manual/vm_monitoring/vmware_keys#vmware.eventlog), mas não pode ser inferior a 5 segundos.

en	#### Configuration If Zabbix server is compiled from [sources](/manual/installation/install#configure_the_sources), it must be compiled with the `--with-libcurl --with-libxml2` configuration options to enable virtual machine monitoring. Zabbix packages are compiled with these options already enabled. The following Zabbix server configuration file parameters can be modified for virtual machine monitoring: - [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) ::: noteclassic It is recommended to enable more collectors than the number of monitored VMware services; otherwise, the retrieval of VMware performance counter statistics might be delayed by the retrieval of VMware configuration data (which takes a while for large installations). <br><br> Generally, the value of `StartVMwareCollectors` should not dip below `2` and should not exceed twice the amount of monitored VMware services: Amount of services < `StartVMwareCollectors` < (Amount of services \* 2). For example, when monitoring one VMware service, set `StartVMwareCollectors` to `2`; when monitoring three services, set `StartVMwareCollectors` to `5`. <br><br> Note that the required number of collectors also depends on the scope of the VMware environment, and the `VMwareFrequency` and `VMwarePerfFrequency` configuration parameters. ::: - [`VMwareCacheSize`](/manual/appendix/config/zabbix_server#vmwarecachesize) - [`VMwareFrequency`](/manual/appendix/config/zabbix_server#vmwarefrequency) - [`VMwarePerfFrequency`](/manual/appendix/config/zabbix_server#vmwareperffrequency) - [`VMwareTimeout`](/manual/appendix/config/zabbix_server#vmwaretimeout) ::: noteimportant To support datastore capacity metrics, ensure that the value of the VMware `vpxd.stats.maxQueryMetrics` key is set to at least `64`. For more information, see the [*VMware Knowledge Base* article](https://kb.vmware.com/s/article/2107096). :::
pt-br	#### Configuração Se o Zabbix server for compilado a partir dos [códigos-fonte](/manual/installation/install#configure_the_sources), ele deve ser compilado com as opções de configuração `--with-libcurl --with-libxml2` para habilitar o monitoramento de máquinas virtuais. Os pacotes do Zabbix já são compilados com essas opções habilitadas. Os seguintes parâmetros do arquivo de configuração do Zabbix server podem ser modificados para o monitoramento de máquinas virtuais: - [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) ::: noteclassic Recomenda-se habilitar mais coletores do que o número de serviços VMware monitorados; caso contrário, a obtenção das estatísticas dos contadores de desempenho do VMware pode ser atrasada pela obtenção dos dados de configuração do VMware (o que pode demorar em instalações grandes). <br><br> Geralmente, o valor de `StartVMwareCollectors` não deve ser inferior a `2` e não deve exceder o dobro da quantidade de serviços VMware monitorados: Quantidade de serviços < `StartVMwareCollectors` < (Quantidade de serviços \* 2). Por exemplo, ao monitorar um serviço VMware, defina `StartVMwareCollectors` como `2`; ao monitorar três serviços, defina `StartVMwareCollectors` como `5`. <br><br> Observe que o número necessário de coletores também depende do escopo do ambiente VMware e dos parâmetros de configuração `VMwareFrequency` e `VMwarePerfFrequency`. ::: - [`VMwareCacheSize`](/manual/appendix/config/zabbix_server#vmwarecachesize) - [`VMwareFrequency`](/manual/appendix/config/zabbix_server#vmwarefrequency) - [`VMwarePerfFrequency`](/manual/appendix/config/zabbix_server#vmwareperffrequency) - [`VMwareTimeout`](/manual/appendix/config/zabbix_server#vmwaretimeout) ::: noteimportant Para suportar métricas de capacidade do datastore, certifique-se de que o valor da chave VMware `vpxd.stats.maxQueryMetrics` esteja definido como pelo menos `64`. Para mais informações, consulte o artigo da [*Base de Conhecimento da VMware*](https://kb.vmware.com/s/article/2107096). :::

en	##### Discovery Zabbix can use low-level discovery rules (for example, *vmware.hv.discovery\[{$VMWARE.URL}\]*) to automatically discover VMware hypervisors and virtual machines. Moreover, Zabbix can use host prototypes to automatically generate real hosts for the discovered entities. For more information, see [*Host prototypes*](/manual/discovery/low_level_discovery/host_prototypes).
pt-br	##### Descoberta O Zabbix pode usar regras de descoberta de baixo nível (por exemplo, *vmware.hv.discovery\[{$VMWARE.URL}\]*) para descobrir automaticamente hipervisores VMware e máquinas virtuais. Além disso, o Zabbix pode usar protótipos de host para gerar automaticamente hosts reais para as entidades descobertas. Para mais informações, consulte [*Protótipos de host*](/manual/discovery/low_level_discovery/host_prototypes).

en	##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example).

en	#### Extended logging The data collected by the *vmware collector* processes can be logged for detailed debugging using debug level 5. The debug level can be configured in the [server](/manual/appendix/config/zabbix_server#debuglevel) and [proxy](/manual/appendix/config/zabbix_proxy#debuglevel) configuration files or using the runtime control option `-R log_level_increase="vmware collector,N"`, where "N" is the process number. For example, to increase the debug level from 4 to 5 for all *vmware collector* processes, run the following command: zabbix_server -R log_level_increase="vmware collector" To increase the debug level from 4 to 5 for the second *vmware collector* process, run the following command: zabbix_server -R log_level_increase="vmware collector,2" When extended logging of VMware collector data is no longer required, it is recommended to decrease the debug level to default (3) by running the `-R log_level_decrease` command.
pt-br	#### Log estendido Os dados coletados pelos processos *vmware collector* podem ser registrados para depuração detalhada usando o nível de depuração 5. O nível de depuração pode ser configurado nos arquivos de configuração do [server](/manual/appendix/config/zabbix_server#debuglevel) e do [proxy](/manual/appendix/config/zabbix_proxy#debuglevel) ou usando a opção de controle em tempo de execução `-R log_level_increase="vmware collector,N"`, onde "N" é o número do processo. Por exemplo, para aumentar o nível de depuração de 4 para 5 para todos os processos *vmware collector*, execute o seguinte comando: zabbix_server -R log_level_increase="vmware collector" Para aumentar o nível de depuração de 4 para 5 para o segundo processo *vmware collector*, execute o seguinte comando: zabbix_server -R log_level_increase="vmware collector,2" Quando o log estendido dos dados do VMware collector não for mais necessário, recomenda-se diminuir o nível de depuração para o padrão (3) executando o comando `-R log_level_decrease`.

en	#### Troubleshooting - In case of unavailable metrics, please ensure that they are not made unavailable or turned off by default in recent VMware vSphere versions, or if some limits are not placed on performance-metric database queries. For more information, see [ZBX-12094](https://support.zabbix.com/browse/ZBX-12094). - If `config.vpxd.stats.maxQueryMetrics` is invalid or exceeds the maximum number of characters permitted error, add a `config.vpxd.stats.maxQueryMetrics` parameter to the vCenter Server settings. The value of this parameter should be the same as the value of `maxQuerysize` in VMware's *web.xml* file. For more information, see [*VMware Knowledge Base* article](https://kb.vmware.com/s/article/2107096). - If you suspect your Zabbix installation is using too much memory, see [Profiling excessive memory usage with tcmalloc](/manual/installation/known_issues#profiling-excessive-memory-usage-with-tcmalloc).
pt-br	#### Solução de problemas - Em caso de métricas indisponíveis, certifique-se de que elas não estejam indisponíveis ou desativadas por padrão nas versões recentes do VMware vSphere, ou se alguns limites não foram definidos para consultas ao banco de dados de métricas de desempenho. Para mais informações, consulte [ZBX-12094](https://support.zabbix.com/browse/ZBX-12094). - Se `config.vpxd.stats.maxQueryMetrics` for inválido ou exceder o número máximo de caracteres permitidos, adicione um parâmetro `config.vpxd.stats.maxQueryMetrics` nas configurações do vCenter Server. O valor deste parâmetro deve ser o mesmo que o valor de `maxQuerysize` no arquivo *web.xml* da VMware. Para mais informações, consulte o [artigo da *Base de Conhecimento da VMware*](https://kb.vmware.com/s/article/2107096). - Se você suspeitar que sua instalação do Zabbix está usando muita memória, consulte [Perfilando uso excessivo de memória com tcmalloc](/manual/installation/known_issues#profiling-excessive-memory-usage-with-tcmalloc).