How do I prepare for telemetry collection?

Purpose

Use this procedure to ensure that all the telemetry types and counters you need are available in your NSP.

This procedure assumes that devices you want to collect telemetry from are already managed.

Telemetry artifacts

Telemetry artifacts include vendor agnostic (that is, NSP) device telemetry artifacts, device telemetry adaptation bundles, and telemetry YANG definition files. There is no dependency between NSP and device-specific telemetry definitions, and no requirement to install both. If the telemetry counters you need to collect are present in the NSP telemetry definitions, you do not need device-specific telemetry.

Device telemetry adaptation is dependent on telemetry YANG definition files. Before you install a device telemetry adaptation bundle, review the telemetry definitions in the YANG collection to see if the counters you need are present. If the required counters are present in the YANG files, that is, if the counters are supported, the YANG files must be installed before the device adaptation bundle.

Nokia recommends that you only install the telemetry YANG files required for your use cases.

Steps
 
1 

Verify that you have obtained all the artifact bundles required for telemetry for your NEs.

2 

Starting with Release 25.8, vendor agnostic telemetry artifacts are packaged in adaptation artifact bundles, therefore they are already present when you are managing the device.

However, in certain cases, specific vendor-agnostic telemetry adaptation bundles are available and may need to be installed individually; see the artifact guide. If a vendor agnostic telemetry bundle is required, install it; see “How do I install an artifact bundle?” in the NSP Network Automation Guide.

3 

Use the Telemetry Statistic Search Tool to see if the telemetry types you need are installed with the NSP (vendor agnostic):

  1. Open the NSP Help Center. From the Help Center home screen, navigate to Reference, Statistic Search, Telemetry Statistic Search.

  2. Enter search terms in the Counter Name field to filter on the counters you need.

    Enter additional filters as needed to narrow the search.

  3. Click on each row to see the Info panel. Verify whether the selected statistic is the one you need.

  4. If the telemetry types you need are found, they are vendor-agnostic telemetry types and the required adaptation is present. This procedure is complete.

  5. If the telemetry type is not found, proceed to the next step.

4 

Extract the files from the YANG telemetry zip and look for the telemetry types:

  1. View the list of telemetry files. The filenames provide information about the telemetry types included in the file.

  2. Open the file and search for terms relevant to the counters you need. A counter, where present, will be found in a leaf element. A list of telemetry types is provided in the leaf.

  3. If you find a telemetry type you need, install the YANG file using yang-file.bash; see “How do I manage MDM model definitions?” in the NSP System Administrator Guide.

  4. 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.

5 

Obtain any required device telemetry adaptation bundles from the Nokia Support Portal and install them from the Artifacts, Artifact Bundles view; see “How do I install an artifact bundle?” in the NSP Network Automation Guide.

Note: Device telemetry adaptation bundles are for gNMI-capable devices only.

6 

Open the Telemetry Statistic Search Tool and search for your desired telemetry types to confirm that all are present.

End of steps