VMware NSX Monitoring
Overview
LogicMonitor’s VMware NSX monitoring package leverages the VMware NSX Data Center for vSphere API to monitor and alert on metrics for manager, controllers, and edges.
Compatibility
As of October 2020, LogicMonitor’s VMware NSX package is known to be compatible with NSX for vSphere API 6.4. It may work with earlier versions, but this has not been explicitly tested.
As VMware releases newer versions of VMware NSX, LogicMonitor will test and extend coverage as necessary.
Setup Requirements
Add Resources Into Monitoring
Add your VMware NSX Manager host into monitoring. For more information on adding resources into monitoring, see Adding Devices.
Obtain Credentials
LogicMonitor uses basic authentication to query the NSX for vSphere API and must provide the appropriate credentials in order to successfully access the NSX resource’s data. The NSX Manager requires port 443/TCP to be open between host and Collector for REST API requests.
These credentials must belong to a user account that has been assigned the following minimum permissions:
| Role | Description |
| Read-only | All API calls made in this package are compatible with read-only access. |
Please refer to VMware NSX documentation for additional information on configuring users and roles.
Assign Properties to Resources
The following custom properties must be set on the VMware NSX resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.
| Property | Value |
| nsx.api.user | REST API username |
| nsx.api.pass | REST API password |
| system.categories | VMware_NSX (this value will be automatically added by the addCategory_VMware_NSX PropertySource) |
Import LogicModules
From the LogicMonitor public repository, import all VMware NSX LogicModules, which are listed in the LogicModules in Package section of this support article. If these LogicModules are already present, ensure you have the most recent versions.
Once the LogicModules are imported (assuming all previous setup requirements have been met), modules will be automatically applied to devices through Active Discovery.
Considerations/Warnings
When monitoring NSX Edge interfaces, note that the API updates values for traffic every five minutes. For this reason, we do not recommend customizing the data collection intervals of associated DataSources to anything more frequent than every five minutes. Doing so will result in duplicate values in polls.
Troubleshooting
The modules in this package are designed with a debug mode embedded in the data collection scripts. If issues occur, turn on debug mode by setting the variable debug to “true” to get more information in the output when testing the script in the Collector Debug Facility. For more information on testing scripts in the Collector Debug Facility, see Script Troubleshooting.
LogicModules in Package
LogicMonitor’s package for VMware NSX consists of the following LogicModules. For full coverage, please ensure that all of these LogicModules are imported into your LogicMonitor platform.
Note: This package includes ConfigSources (configuration file monitoring LogicModules). If the ability to monitor and alert on configuration files is not currently available in your LogicMonitor platform and you would like to learn more, reach out to your customer success manager. For more information on ConfigSources, see Creating ConfigSources.
| Display Name | Type | Description |
| addCategory_VMware_NSX | PropertySource | Checks for working API credentials and adds “VMware_NSX” to the system.categories property. |
| VMware_NSX_ManagerInfo | PropertySource | Adds basic info for NSX Manager using VMware NSX for vSphere API 6.4. |
| NSX Manager Component Status | DataSource | Provides information about NSX manager component status. |
| NSX Manager Utilization | DataSource | Provides information about NSX manager CPU, memory, and disk utilization. |
| NSX Controllers | DataSource | Provides information about NSX controller usage statistics and node failover status. |
| NSX Controllers Uptime | DataSource | Provides information about NSX controller uptime and sync status. |
| NSX Controller Cluster Configs | ConfigSource | NSX controller cluster info including DNS, NTP, and syslog. |
| NSX Edge Health | DataSource | Provides information about NSX edge state and status. |
| NSX Edge Interfaces | DataSource | Provides information about NSX edge interface statistics. |
| NSX Edge Configs | ConfigSource | NSX edge configuration info including firewall, NAT, routing, bridging, loadbalancer, DHCP, high availability, and SSL VPN. |
When setting static datapoint thresholds on the various metrics tracked by this package’s DataSources, LogicMonitor follows the technology owner’s best practice KPI recommendations. If necessary, we encourage you to adjust these predefined thresholds to meet the unique needs of your environment. For more information on tuning datapoint thresholds, see Tuning Static Thresholds for Datapoints.