Telemetry Collection Configuration

NMX Telemetry supports three levels of the configuration interface, suitable for the various deployment and usage modes:

• Configuration with NVOS/NVUE command line interface for the NVOS/NVUE users

• Configuration via NMX-C for the standalone distributions of NMX cluster applications

• Configuration with custom http interface for the package-based installation

All three levels of the configuration are eventually consistent.

• Configuration unit is a file

  • entire configuration file is saved and loaded, including all the parameters

  • Parameters could be one or many configuration from Telemetry Collection Configuration

  • If parameter is missing default value is implied

• File content must be compliant to Linux INI format (https://en.wikipedia.org/wiki/INI_file), with the following restrictions:

  • format “key = value”

  • No support for sections

  • No support for hierarchy

  • Case insensitive

  • Support for comments

  • No support for duplicate names

  • Support for Quoted values

  • Support for Line continuation

  • Support for Escape characters

Example:

            

            
nvl_telemetry.enabled = true
nvl_telemetry.update_period = 30
        

List of supported configuration parameters. Use Telemetry Collection Configuration to retrieve an up-to-date list of supported parameters.

Configuration workflow reflected in the CLI interface commands:

1. Reveal list of configuration files available to the NMX-C. Should indicate both nmx-telemetry and nmx-controller installed, component "telemetry" present in the description of nmx-controller

   Copy

   Copied!

               
   
               
   nv show cluster apps
           

2. Get the configuration file.

   Copy

   Copied!

               
   
               
   nv action generate sdn config app nmx-telemetry type telemetry
           

3. Locate the copy of configuration file.

   Copy

   Copied!

               
   
               
   nv show sdn config app nmx-telemetry type telemetry file
           

   File location would be similar to the following.

   Copy

   Copied!

               
   
               
   /host/cluster_infra/app_config/nmx-telemetry/telemetry/nmx-telemetry_telemetry_20241202_113751
           

4. Modify the location as needed.

   Copy

   Copied!

               
   
               
   cat /host/cluster_infra/app_config/nmx-telemetry/telemetry/nmx-telemetry_telemetry_20241202_113751
   ...
   vim /host/cluster_infra/app_config/nmx-telemetry/telemetry/nmx-telemetry_telemetry_20241202_113751
           

5. Upload the modified configuration by providing the name of the file

   Copy

   Copied!

               
   
               
   nv action install sdn config app nmx-telemetry type telemetry files nmx-telemetry_telemetry_20241202_113751
           

Mid-level configuration entry point, use NMX-C gRPC to retrieve and update the telemetry configuration.

1. Register the client's identifier "test_client" to enable the gateway to recognize the client.

   Copy

   Copied!

               
   
               
   docker run --network=host fullstorydev/grpcurl -plaintext -d \
       '{ "gatewayId": "test_client", "major_version": "PROTO_MSG_MAJOR_VERSION", "minor_version": "PROTO_MSG_MINOR_VERSION" }' \
       0.0.0.0:9372 nmxc_service.NMXCService.Hello
           

2. Get the telemetry configuration file.

   Copy

   Copied!

               
   
               
   docker run --network=host fullstorydev/grpcurl -plaintext -d \
       '{"configFiles": {"configFile": [{"configFileName": "telemetry"}]},"gatewayId": "test_client"}'\
        0.0.0.0:9372 nmxc_service.NMXCService.GetStaticConfig \
     | jq -r '.staticConfig.configFileContents.configFileContent[] | .configFileContent ' | sed -e 's/   / = /' | sort > telemetry.ini
           

3. Set the configuration file.

   Copy

   Copied!

               
   
               
   docker run --network=host fullstorydev/grpcurl -plaintext -d \
     "$(jq -R -s '{"gatewayId": "test_client","staticConfig": {"configFileContents": {"configFileContent": [{"configFileName": "telemetry","configFileContent": gsub(" = "; "   ")}]}}}' telemetry.ini)" \
     0.0.0.0:9372 nmxc_service.NMXCService.SetStaticConfig
           

Low-level configuration entry point, use the NMX-T runtime configuration interface to retrieve and update the telemetry configuration.

Get the Full Configuration File

• In flatten INI format, compatible with NVOS

            

            
curl http://0.0.0.0:9350/telemetry/config
        

• In JSON structured format

            

            
curl -H "Accept: application/json" http://0.0.0.0:9350/telemetry/config | jq
        

Upload the Full Configuration File

Using the POST method, the entire configuration state is replaced by the content of the file, with missing fields populated by default values.

• In flatten INI format, compatible with NVOS

            

            
curl -X POST --data-binary @telemetry.ini http://0.0.0.0:9350/telemetry/config
        

• In JSON structured format

            

            
curl -X POST -H "Content-Type: application/json" --data @telemetry.json http://0.0.0.0:9350/telemetry/config
        

Partial Configuration Update

Using the PUT method, the configuration state is updated with the file content, while leaving unspecified parameters unchanged.

• In flatten INI format, compatible with NVOS

            

            
curl -X PUT --data-binary $'nvl_tlemetry.enabled = true \n nvl_tlemetry.sample_rate = 120' http://0.0.0.0:9350/telemetry/config
        

• In JSON structured format

            

            
curl -X PUT  -H "Content-Type: application/json"  --data-binary '{"nvl_telemetry":{"enabled": true, "update_period" : 300}}}' http://0.0.0.0:9350/telemetry/config
        

List the Supported Configuration Parameters

Retrieve the list of parameters as a plain table.

            

            
curl http://0.0.0.0:9350/telemetry/config/params