Once you have finished Installing the Management Pack (Nagios XI) and Configuring the Management Pack (Nagios XI), check the Collection State and Collection Status for the adapter instance on the Solutions page. If they show as Not Collecting or No Data Receiving , respectively, the following troubleshooting topics can help you diagnose and correct common problems with your adapter instance.
- Test Connection Errors
- Adapter and Collector Log Files
Test Connection Errors
When Creating an Adapter Instance (Nagios XI), click Test Connection after entering all of your configuration settings to ensure vROps can connect to the specified host.
The following errors are possible:
Bad API Key
Error Message: Unable to establish a valid connection to the target system. Unable to retrieve data from the API. Error requesting data from the API: ["Invalid API Key"].
Bad Host/Port
Error Message: Unable to establish a valid connection to the target system. Unable to retrieve data from the API. Network is unreachable, or connection timed out. Ensure Host and Port are correct.
Illegal Host
Error Message: Unable to establish a valid connection to the target system. ‘Host’ is invalid. Accepted Host formats are: [Host Name, Fully Qualified Domain Name, IPv4, IPv6].
Unable to Retrieve Data from the API
Problem: This error is possible when your server does not have SSL configured, but the adapter instance advanced setting SSL Configuration is set to ‘No Verify’ or ‘Verify’.
Cause: When the server settings and adapter instance settings do not match, API responses will return no information.
Solution: Log in to the Nagios XI web interface and verify that your server has SSL enabled.
Adapter and Collector Log Files
You can review adapter errors in the adapter and collector log files, which can be viewed in the vROps UI or in an external log viewer.
- Adapter log files are located in the $VCOPS_BASE/user/log/adapters/NagiosAdapter/ folder.
- Collector log files are located in the $VCOPS_BASE/user/log/ folder.
To set the base log level for the collector in vROps:
- Navigate to Administration > Support > Logs.
- Expand the MASTER folder, then select the COLLECTOR folder.
- Click the Edit Properties icon.
- In the Root logger level drop-down menu, select the desired option.
- The default logging level is warning.
- To troubleshoot issues, set the logging level to info.
- To view detailed messages, including micro steps, queries, and returned results, set the logging level to debug.
For more information about viewing log files and modifying levels, refer to the vROps online help.