Installing and locating specific telemetry types

Purpose

This use case shows how to use NSP to set up and locate the telemetry types needed for a sample use case.

In this scenario, we want to start monitoring the aggregate dropped packet count for egress traffic on VPRN SAPs on SR OS devices. We need to install the required files and confirm the telemetry types we’ll need to create subscriptions for.

Steps
 

Obtain the required vendor agnostic (va) CR bundles from the Nokia NSP software download site:

  1. Choose the release, Adaptors, and the adaptor type.

    For this example, we’ll choose 23.11, Adaptors, Nokia_SROS.

  2. The list of available downloads is displayed. Choose the zip file with va and cr in the filename.

    For this example, we’ll choose nsp-telemetry-cr-va-sros-1.0.0-rel.10.zip.

View the figure

Install the artifact bundle from the Artifacts, Artifact Bundles view; see “How do I install an artifact bundle?” in the NSP Network Automation Guide.

The telemetry types in the va bundle are now available in the Telemetry Statistic Search Tool.


Check the Telemetry Statistic Search Tool:

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

  2. Enter “aggregate-dropped” in the Counter Name field. The search tool filters for telemetry types with aggregate-dropped in the counter name.

    Enter additional filters as needed to narrow the search.

  3. Click on each row to see the Info panel. Verify whether the selected telemetry type will monitor the counters you need.

  4. If the telemetry type is found, you are ready to set up your subscriptions.

For our example, the telemetry type we need is not installed yet. Next, we’ll check the telemetry yang files. After the telemetry yang files have been installed, we can also install cut-through telemetry files.


Perform the sequence in Step 1 to obtain the telemetry yang files for the NE family.

For this example, we’ll download nsp-telemetry-yang-sros-23_11.zip.


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

  1. View the list of telemetry files. The filename sros-service-vprn-telemetry.yang suggests it could contain the telemetry types we need.

  2. Open the file and search for “aggregate”. The desired counter is present in a leaf element. The telemetry type appears in the list:

    graphic
  3. Install the yang file using yang-file.bash; see “How do I manage MDM model definitions?” in the NSP System Administrator Guide.


Now that the yang file we need has been installed, we can install cut-through CRs.

Obtain the SR OS cut-through (ct) CR bundles from the Nokia Nokia NSP software download site and install them from the Artifacts, Artifact Bundles view; see “How do I install an artifact bundle?” in the NSP Network Automation Guide.

Note: Cut-through telemetry types are for gNMI-capable devices only.


Check the Telemetry Statistic Search Tool :

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

  2. Enter “aggregate-dropped-packets” in the Counter Name field to verify that the artifacts have loaded successfully.

  3. Click on each row to see the Info panel and obtain further details about the counter, such as device types and releases supported.

End of steps

We’re done

The counters we need are available in the NSP, and we have the information we need to configure a subscription.