Come join our live training webinar every other Wednesday at 11am PST and hear LogicMonitor experts explain best practices and answer common questions. We understand these are uncertain times, and we are here to help!
LogicMonitor uses the VMware API to provide comprehensive monitoring of VMware vCenter or standalone ESXi hosts. In this support article, we outline how to set up ESXi host and/or vCenter server monitoring.
As highlighted in the next two sections, the process of creating a user varies depending upon whether you intend to monitor standalone ESXi hosts or a vCenter server.
The following set of steps walk you through the process of creating a read-only user for an ESXi host that has rights to use the VMware API.
Note: Your credentials for ESXi hosts will be in the format of username/password (e.g. logicmonitor/pass123).
If vCenter is integrated with Active Directory (AD), you will find a group in vCenter that has a corresponding group in AD. Simply create a user with read-only permissions for your vCenter environment in AD and add it to the corresponding AD group. Your credentials for vCenter will be in the format of [email protected] (e.g. [email protected]) with its password.
If vCenter is not integrated with AD, you will create a new read-only using a process similar to that for creating an ESXi host user (described in the previous set of steps). However, it’s important to note that a key difference between ESXi host and vCenter is that vCenter credentials are formatted as [email protected] (e.g. [email protected]) with password.
Within LogicMonitor, you need to define the properties esx.user and esx.pass on the global, group or device level, matching the read only user you created in vSphere.
For LogicMonitor to provide ESXi hardware monitoring, you need to add the individual ESXi hosts to LogicMonitor – hardware status is not available by monitoring only vCenter.
No further configuration is needed to activate hardware monitoring – if you do not see hardware monitoring within LogicMonitor, check that hardware status is available from the Virtual Infrastructure client. If not, then either:
Some of the VMware DataSources are capable of pulling in vCenter tags as instance properties. This is optional and can be enabled by setting a device property named esx.tags to true. Currently the tag integration only works on DataSources applied to vCenter devices. DataSources that currently support this functionality are:
The tags will show up as instance-level properties on your VM instances, with the following format: auto.tag_category = tag.
vCenter allows multiple clusters to have the same name as long as each cluster is in a different VMware Datacenter within the vCenter. However, within LogicMonitor, this translates to duplicate instance names which is not supported (i.e duplicate instances are not discovered).
To ensure unique instance names and therefore discovery of all relevant clusters, add the custom property of esx.instanceformat to the host and assign it a value of “dedupe” (case insensitive). This property prepends the cluster name with the VMware Datacenter name (i.e. <datacenter> / <cluster>) in order to avoid duplicate instance names.
Note: If this property is set on a host that has already been running for a while, it will force history loss on that host (and only that host).
If you are using a proxy for your Collector access, then you will need to exclude these hosts from being proxied by your Collector or the Collector will not be able to access the VMware API. This is done by adding a value to the proxy.exclude setting found in your Collector’s agent.conf file that reflect these hosts, proxy.exclude=hostname1|hostname2|hostname3|…, where the various hostnames represent the IPs/hostnames for the various ESXi or vCenter hosts that have been added into LogicMonitor and are being monitored by the Collector.
If the Collector is not able to access the VMware API and your ESXi/vCenter device has been added via its hostname, edit the device to use its IP instead and repeat these configuration edits if needed.
If your vCenter or ESXi hosts are configured to expose their API on nonstandard ports, you can set the property esx.url with an appropriate URL (e.g. https://192.168.1.100:8443/sdk).
If your hardware is monitored using the VMware_vCenter_Alerts DataSource and it is reporting 0 as its status code, it is in an unknown state as mentioned in the description for the state datapoint. In this case, we recommend you refer to VMware’s documentation for configuring a VMware alarm (or use another supported monitoring method for hardware monitoring).
The state datapoint description contains the following output format as a reference:
If monitoring of this hardware is supported by VMware and an alarm is configured in VMware, the VMware_vCenter_Alerts DataSource has alerts set for status codes 2 and 3.
Note: The VMware_vCenter_Alerts DataSource monitors only alerts for ESX hosts in vCenter. Additional alerts not associated with an ESX host will not be discovered.
DataSources are split into two categories, those that apply directly to the ESXi hosts and those that apply to vCenter.
Over time, LogicMonitor has released three separate suites for VMware monitoring, each suite intended to (largely) deprecate the LogicModules in the previous suite. In general, we try to provide updates (rather than replacements) for existing modules when making improvements, but this isn’t always feasible.
In the following table, we’ve provided a list of DataSources included in each generation. Each row of the table represents equivalent DataSources across the generations.
Note: Because module names are changed each time we deprecate an existing suite in favor of a new suite, there will be no issue importing the new set of modules if you are currently using the previous set. However, because this does mean that your hosts will be queried by the Collector more frequently, we recommend that the existing modules eventually be disabled manually or deleted.
Once discovered, VMware monitoring will not be automatically removed from a device, in order to prevent the loss of data due to a temporary failure. If you have removed vCenter from a windows server, or otherwise wish to remove VMware monitoring from a device in LogicMonitor, there are two options:
In This Article