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
 

Open a terminal session to the NSP deployer VM


Log in as the root or NSP admin user.


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.

 

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.


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.

 

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.


Perform How do I uninstall MDM adaptor artifacts? to remove the multi-vendor telemetry adaptors.

Import and install custom resources
 

Obtain the vendor agnostic (va) custom resources artifact bundle from the Nokia NSP software delivery site, in the NSP/<release>/Adaptors folder.


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
 

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.


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.

 

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.