VMware vSphere monitoring
Setting up Dynatrace monitoring of a VMware platform is easy using ActiveGate as a communication gateway.
ActiveGate receives the data from VMware and sends it to the Dynatrace Cluster.
OneAgent, which is installed on each virtual machine, provides complementary data about your infrastructure health.
Flow of monitoring data from your VMware platform to Dynatrace:
The following applies to VMware only. For other virtualization platforms, you only need to install OneAgent for virtualized host monitoring, as the monitoring of virtualization management layers is supported only for VMware.
Once Dynatrace OneAgent is installed and process monitoring is activated on a virtual machine, you can see what's happening in your operating system—specifically, how your host-based processes behave and communicate.
Dynatrace collects information related to virtualized CPU usage, memory consumption, and storage-related activities. Dynatrace also detects virtual machine migrations (vMotion) and the creation of new virtual machines.
Follow the steps below to set up monitoring on the virtualization management layer of your VMware vCenter or standalone ESXi hosts.
Read-only access to vCenter server, or access to the standalone ESXi host.
Install and configure ActiveGate
Install an Environment ActiveGate in your data center before connecting Dynatrace to your VMware platform.
For Dynatrace Managed you can use the embedded ActiveGate running on the cluster node. However, the Cluster ActiveGate is typically used to forward RUM and/or Synthetic monitoring data to the Dynatrace Cluster. We recommend that you don't overutilize this ActiveGate with another type of monitoring data. Depending on the VMware size, you might consider using a dedicated ActiveGate per environment.
For virtualization monitoring, the
vmware_monitoring_enabled property in
custom.properties must be set to
true (default value).
See Customize ActiveGate properties for details.
Connect Dynatrace to your VMware platform
To connect Dynatrace to your VMware platform
In the Dynatrace menu, go to Settings > Cloud and virtualization > VMware, and select Connect new instance.
Select the IP address or name of the vCenter server or standalone ESXi host you want to monitor (skip the
Check the network/proxy settings.
If you get a communication error even though the data provided is correct, it might be because of your network/proxy settings. We recommend that you revise the network/proxy settings when adding a new VMware integration.
optional You can also bypass the proxy for connecting with vCenter or ESXi when configuring the VMware integration. Modify ActiveGate configuration to exclude a specific host from the proxy.
Enter the associated user credentials so that ActiveGate can sign in and collect monitoring data. The required privileges for this user are view and read-only access. Administrator-level access isn't required to enable monitoring (no changes to your VMware settings are required).
You don’t need to add ESXi hosts individually if they're managed by a vCenter server.
ActiveGate version 1.268+ Specify a filter condition to limit the number of monitored clusters:
$prefix(parameter)—property value starts with
$eq(parameter)—property value exactly matches
$suffix(parameter)—property value ends with
$contains(parameter)—property value contains
Select Test connection to verify that the entered data has successfully connected to your vCenter.Credentials
The credentials are no longer validated automatically, so it's important to provide valid credentials that connect to your vCenter. If you provide invalid credentials, Dynatrace will still attempt to connect to your vCenter, which can create unnecessary network traffic.
If your credentials for a particular vCenter change over time and you forget to update them in the settings, Dynatrace will detect five failed attempts to connect to your vCenter. After this, this setting will be disabled to prevent your VMware account from being blocked.
Select Save changes.Time synchronization
Differences in system time can lead to missing VMware metrics. For Dynatrace to properly display monitoring data, synchronize time settings on all monitored host environments and vCenters with an NTP server.
To cover your entire virtual infrastructure, repeat these steps for all other vCenter servers or standalone ESXi hosts in your environment.
Limit VMware infrastructure monitoring
After you set up VMware monitoring, you might want to limit which infrastructural elements (such as hosts and VMs) should actually be monitored by Dynatrace. To do this, you can use the permissions mechanism available in VMware. For more information, see Limit VMware infrastructure monitoring using permissions.
Troubleshoot VMware connection
Option 1 - vCentre Event Console
- In the Dynatrace menu, go to Settings > Cloud and virtualization > VMware, and select Test connection.
- In the vSphere web client, go to Event Console. For details, see View Events in the vSphere Web Client.
Check for events related to the user that is setup in Dynatrace credentials. With correct network setup and correct credentials, you should expect a pair of UserLoginSessionEvent and UserLogoutSessionEvent entries from the IPs of one or more ActiveGates that have VMWare monitoring enabled and that have tested the connection.
Check for errors visible in the events. If there is no entry at all or no entry for the ActiveGate you were expecting, check you network setup.
Option 2 - VMware PowerCLI (Windows only)
If you're using an ActiveGate deployed on a Windows machine, use the following procedure to verify that your VMware infrastructure is working. These commands should be executed on the server where the ActiveGate is installed.
- Install VMware PowerCLI.
- Enable script execution in PowerShell.
1Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
- Connect to the vSphere server using your Dynatrace credentials.
1Connect-VIServer -Server <vsphere_address> -Protocol https -User <username> -Password <password>
- Test the connection.
Monitoring invalid credentials
Dynatrace version 1.275+
When the invalid credentials disablement mechanism is triggered, Dynatrace generates an event to alert you that the credentials used for VMware monitoring are invalid. The event remains active for up to 6 hours and will automatically close after this period.
The event may close earlier if the affected credentials are corrected or completely removed from the settings. Alternatively, you can manually close the problem if you consider it resolved or irrelevant.
Configure vSphere monitoring using Settings API
You can use the Settings API to configure VMware vSphere monitoring.