NetOps Usage Data (Telemetry) data validation

Products

• Network Observability
• CA Performance Management
• Spectrum
• Virtual Network Assurance

Issue/Introduction

How to manually collect the same data collected by the DX NetOps Portal Usage Data report.

How to validate the data collected by the DX NetOps Portal Usage Data report.

Usage Data (Telemetry) documentation topic

Environment

All supported DX NetOps Portal web server releases

Resolution

The following are the steps that will help validate the data from the DX NetOps Portal Usage Data (Telemetry) page.

1. Enable the REST debug in OC.
   
   1. Log into the OC admin website and go to Administration->Debug->Web Server Debug Page (Runtime).
   2. In the list find the "RESTful Web Services" entry. Select it's On radio button.
   3. At the bottom of the page ensure it's set to Max and select the Apply button.
2. Run REST calls from Portal to OC and DA for comparison.
   
   1. Open a terminal on the Portal web server host. Run these curl commands to test the response. Gather and share the output they generate for review.
   2. Run this pointing at the integrated OneClick host defined in the Spectrum DS in Portal.
      
      • Replace <specUser> with any valid Spectrum user.
      • Replace <scheme> with the appropriate value. Either http or https are expected values.
      • Replace <OCHostName> with the OC host.
      • Replace <Port> with the configured OC host port.
      • Enter the user password when prompted.
      • Curl command:
        
        • curl -skv -u <specUser> <scheme>://<OCHostName>:<Port>/spectrum/restful/telemetry/usageTelemetry | xmllint --format -
      • Redirect output to a /tmp/specTelemetry.out file. Change path and file name as needed.
        
        • curl -skv -u <specUser> <scheme>://<OCHostName>:<Port>/spectrum/restful/telemetry/usageTelemetry | xmllint --format - >> /tmp/spectrumTelemetry.out
   3. Run this pointing at the integrated DA DS.
      
      • Replace <DAUser> with any valid Portal user.
      • Replace <scheme> with the appropriate value. Either http or https are expected values.
      • Replace <DAHostName> with the DA host.
      • Replace <Port> with the configured DA host port.
      • Enter the user password when prompted.
      • Curl command:
        • curl -u <DAUser> <scheme>://<DAHostName>:<Port>/genericWS/usagetelemetry | xmllint --format -
      • Redirect output to a /tmp/daTelemetry.out file. Change path and file name as needed.
        • curl -u <DAUser> <scheme>://<DAHostName>:<Port>/genericWS/usagetelemetry | xmllint --format - >> /tmp/daTelemetry.out
3. Gather the logs.
   
   1. When the curl commands are complete gather the following logs. For the localhost logs with dates in the names, gather the ones dated for the same day the tests are run.
      
      1. $SPECROOT/tomcat/logs/catalina.out
      2. $SPECROOT/tomcat/logs/localhost.<currentDate>.log
      3. $SPECROOT/tomcat/logs/localhost_access_log.<currentDate>.txt
4. Disable the OC debug.
   
   1. Same steps as 1 where they were enabled.
   2. This time set the radio button from On to Off.
   3. At the bottom of the page select the Apply button.

When done please share the OC logs and screen output from the curl commands for review.

Note: At this time we don't gather UsageTelemetry data for NFA.