Process to enable CN telemetry
Purpose
Use this procedure to set up CN telemetry on NSP. Some steps in this procedure are only required if third-party NEs are in use.
Deploy CN telemetry
1 |
Open a terminal session to the NSP deployer VM |
2 |
Log in as the root or NSP admin user. |
3 |
Enable the GNMI Telemetry installation option in the NSP deployment; see How do I update the NSP system configuration?. |
Upgrade adaptor suites to 23.11 or later
CN telemetry is supported starting with Release 23.11. To support CN telemetry, adaptor suites from earlier releases must be upgrade to 23.11 or later.
1 |
Enter the following to see the list of installed adaptors: # ./adaptor-suite.bash --list ↵ Enter the NSP admin user credentials when prompted. The output shows the installed adaptor suites: Using log file: log_file INFO: timestamp -> Listing MDM adaptors suites ... INFO: timestamp -> Token requested... INFO: timestamp -> Token acquired INFO: timestamp -> Listing adaptor suites... Installed adaptor suites: list_of_adaptors INFO: timestamp -> Done. |
2 |
Install the new adaptor suite, see How do I install adaptor artifacts that are not supported in the Artifacts view?. Note: it is not necessary to remove the older adaptors when upgrading. |
Remove telemetry adaptors for multi-vendor devices
The upgrade to 23.11 adaptor suites removes the gNMI mappings for Nokia SR OS and SR Linux devices. However, it does not remove the MDM mapping files for multi-vendor devices. To prevent duplicate data collection, remove gNMI/SNMP mapping files for any multi-vendor devices in use in your network.
1 |
Enter the following to see the list of installed telemetry adaptors: # ./adaptor-suite.bash --list-adaptors | grep tele ↵ Enter the NSP admin user credentials when prompted. The output shows the installed adaptors with telemetry filenames: Using log file: log_file INFO: timestamp -> Token requested... INFO: timestamp -> Token acquired INFO: timestamp -> Listing adaptors... list_of_adaptors INFO: timestamp -> Done. |
2 |
Perform How do I uninstall MDM adaptor artifacts? to remove the multi-vendor telemetry adaptors. |
Import and install custom resources
1 |
Obtain the vendor agnostic (va) custom resources artifact bundle from the Nokia NSP software delivery site, in the NSP/<release>/Adaptors folder. |
2 |
Install the artifact bundle from the Artifacts, Artifact Bundles view; see “How do I install an artifact bundle?” in the NSP Network Automation Guide. |
Enable TLS
1 |
Transfer the TLS certificate file for each NE to the following directory on the NSP deployer VM: /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/tls/telemetry See the NE documentation for information about generating NE TLS certificate files. |
2 |
Enter the following to apply the certificates: # /opt/nsp/NSP-CN-DEP-release-ID/bin/nspdeployerctl install --config –-deploy↵ Do not modify or delete files in this directory. |
Check the Telemetry Statistic Search Tool
CN telemetry is enabled for gNMI collection. You can verify the availability of the telemetry types you need in the Telemetry Statistic Search Tool.
1 |
Open the Telemetry Statistic Search Tool and search for your desired telemetry types. If you do not find the definition or mapping you require, or you need to augment an existing telemetry type, contact your Nokia service representative. |