When standard logging doesn't provide enough information to determine the root cause for a problem, enabling debug may be necessary.
This will detail the steps necessary to enable, manage and disable the Spectrum OneClick Tomcat web server debug for the Performance Management integration.
Helps to determine possible causes for various issues related to the product integration
All supported Spectrum releases integrated with all supported Performance Management releases
Enable Debug
Option A: Through the OneClick Administration web UI in a browser.
Option B: Use when debug is needed through a tomcat restart. Often useful for debugging tomcat full sync to Portal upon tomcat restart.
<param-value>NetqosEventLog@NetqosEventLog@com.ca.im.netqos.integration.web.servlet.NetqosIntegrationBootstrapServlet.PCIntegration@off; NetqosAlarmSyncTrackingLog@NetqosAlarmSyncTrackingLog@com.ca.im.netqos.integration.web.servlet.NetqosIntegrationBootstrapServlet.PCIntegrationAlarmSyncTracking@off;
NetqosSyncLog@NetqosSyncLog@com.ca.im.netqos.integration.web.servlet.NetqosIntegrationBootstrapServlet.PCIntegrationSync@off;</param-value>
<param-value>NetqosEventLog@NetqosEventLog@com.ca.im.netqos.integration.web.servlet.NetqosIntegrationBootstrapServlet.PCIntegration@off; NetqosAlarmSyncTrackingLog@NetqosAlarmSyncTrackingLog@com.ca.im.netqos.integration.web.servlet.NetqosIntegrationBootstrapServlet.PCIntegrationAlarmSyncTracking@off;
NetqosSyncLog@NetqosSyncLog@com.ca.im.netqos.integration.web.servlet.NetqosIntegrationBootstrapServlet.PCIntegrationSync@on;</param-value>
Managing Debug
Disabling Debug
Option A: Disable debug enabled through the UI.
Option B: Disable debug via service restart.
Option c: Disable debug enabled through web.xml file edits.
Turn on DM debug for DataSourcePull and DataSourcePush. Ideally use the web URL method as follows:
Change DataSourcePull and DataSourcePush from INHERITED to DEBUG and click the "Update" button at the top of the screen
If unable to access those URLs it can be enabled manually. It requires editing the (default path shown) /opt/CA/PerformanceCenter/DM/resources/log4j2.properties file. Doing so requires a restart of the Device Manager (caperfcenter_devicemanager) service. If that is restarted the Portal web UI Console service (caperfcenter_console) will also need to be restarted.
To do so open the file for editing and uncomment these lines as needed:
#logger.DataSourcePull.name = com.ca.im.portal.dm.productsync.DataSourcePull
#logger.DataSourcePull.level = DEBUG
#logger.DataSourcePush.name = com.ca.im.portal.dm.productsync.DataSourcePush
#logger.DataSourcePush.level = DEBUG
This will generate logging in the Portal machine /opt/CA/PerformanceCenter/DM/logs/DMService.log file.
Note: To disable Debug back to the original /opt/CA/PerformanceCenter/DM/resources/log4j2.properties file
On the Portal web page Manage Data Sources select Spectrum and Perform a Full or Incremental Resynchronization to generate the logging.