layout-3 layout-6 layout-1 layout-top
NVIDIA Docs Hubchevron_right NVIDIA Networkingchevron_right Networking Softwarechevron_right Switch Softwarechevron_right Cumulus Linuxchevron_right

NVUE Command Reference

layout-top layout-6 layout-1

Telemetry

nv show interface <interface-id> telemetry

Shows the histogram configuration settings for the specified interface and operational data.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry

nv show interface <interface-id> telemetry bw-gauge

Shows the bandwidth gauge setting for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry bw-gauge
        operational  applied
------  -----------  -------
enable  on           on

nv show interface <interface-id> telemetry histogram

Shows histogram details for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram

nv show interface <interface-id> telemetry histogram ingress-buffer

Shows ingress queue depth histogram samples collected for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram ingress-buffer

nv show interface <interface-id> telemetry histogram ingress-buffer priority-group

Shows the ingress queue depth histogram samples collected for all priority groups at the configured interval for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram ingress-buffer priority group

nv show interface <interface-id> telemetry histogram ingress-buffer priority-group <pg-id>

Shows the ingress queue depth histogram samples collected at the configured interval for the specified priority group and interface.

Command Syntax

Syntax Description
<interface-id> The interface name.
<pg-id> The priority group ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram ingress-buffer priority-group 0
Time      0-863     864:2303    2304:3743  3744:5183   5184:6623   6624:8063   8064:9503 9. 504:10943   10944:12383 
12384:* 
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 
08:56:19  978065        0          0           0           0            0           0           0             0
08:56:20  978532        0          0           0           0            0           0           0             0

nv show interface <interface-id> telemetry histogram ingress-buffer priority-group <pg-id> threshold

Show the configured interval set for ingress queue depth histogram samples.

Command Syntax

Syntax Description
<interface-id> The interface name.
<pg-id> The priority group ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram ingress-buffer priority-group 0 threshold

nv show interface <interface-id> telemetry histogram ingress-buffer priority-group <pg-id> snapshot

Shows the snapshot collected for the ingress queue depth histogram samples.

Command Syntax

Syntax Description
<interface-id> The interface name.
<pg-id> The priority group ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram ingress-buffer priority-group 0 snapshot
Sl.No  Date-Time            Bin-0   Bin-1    Bin-2    Bin-3    Bin-4    Bin-5    Bin-6    Bin-7     Bin-8     Bin-9
-----  -------------------  ------  -------  -------  -------  -------  -------  -------  --------  --------  ---------
0      -                    (<864)  (<2304)  (<3744)  (<5184)  (<6624)  (<8064)  (<9504)  (<10944)  (<12384)  (>=12384)
1      2023-12-13 11:02:44  980318  0        0        0        0        0        0        0         0         0
2      2023-12-13 11:02:43  980318  0        0        0        0        0        0        0         0         0
3      2023-12-13 11:02:42  980318  0        0        0        0        0        0        0         0         0
4      2023-12-13 11:02:41  980318  0        0        0        0        0        0        0         0         0
5      2023-12-13 11:02:40  980488  0        0        0        0        0        0        0         0         0
6      2023-12-13 11:02:39  980149  0        0        0        0        0        0        0         0         0
7      2023-12-13 11:02:38  979809  0        0        0        0        0        0        0         0         0
8      2023-12-13 11:02:37  980488  0        0        0        0        0        0        0         0         0
9      2023-12-13 11:02:36  980318  0        0        0        0        0        0        0         0         0

nv show interface <interface-id> telemetry histogram egress-buffer

Shows the egress queue depth histogram samples collected at the configured interval for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram egress-buffer

nv show interface <interface-id> telemetry histogram egress-buffer traffic-class

Shows the ingress queue depth histogram samples collected for all traffic classes at the configured interval for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram egress-buffer traffic class

nv show interface <interface-id> telemetry histogram egress-buffer traffic-class <tc-id>

Shows the egress queue depth histogram samples collected at the configured interval for the specified traffic class and interface.

Command Syntax

Syntax Description
<interface-id> The interface name.
<tc-id> The traffic class ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram egress-buffer traffic class 4

nv show interface <interface-id> telemetry histogram egress-buffer traffic-class <tc-id> threshold

Shows the configured interval set for egress queue depth histogram samples.

Command Syntax

Syntax Description
<interface-id> The interface name.
<tc-id> The traffic class ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram egress-buffer traffic class 4 threshold

nv show interface <interface-id> telemetry histogram egress-buffer traffic-class <tc-id> snapshot

Shows the snapshot collected for the egress queue depth histogram samples.

Command Syntax

Syntax Description
<interface-id> The interface name.
<tc-id> The traffic class ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram egress-buffer traffic class 4 snapshot

nv show interface <interface-id> telemetry histogram counter

Shows the counter histogram samples collected at the configured interval for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram counter

nv show interface <interface-id> telemetry histogram counter counter-type

Shows the counter histogram samples collected at the configured interval for all counter types for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram counter counter-type

nv show interface <interface-id> telemetry histogram counter counter-type <counter-type-id>

Shows the counter histogram samples collected at the configured interval for the specified counter type for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.
<counter-type-id> The counter type ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram counter counter-type rx-packet

nv show interface <interface-id> telemetry histogram counter counter-type <counter-type-id> threshold

Shows the configured interval set for counter histogram samples for the specified counter type.

Command Syntax

Syntax Description
<interface-id> The interface name.
<counter-type-id> The counter type ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram counter counter-type rx-packet threshold

nv show interface <interface-id> telemetry histogram counter counter-type <counter-type-id> snapshot

Shows the snapshot collected for the counter histogram samples for the specified counter type.

Command Syntax

Syntax Description
<interface-id> The interface name.
<counter-type-id> The counter type ID.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram counter counter-type rx-packet snapshot

nv show interface <interface-id> telemetry histogram latency

Shows the latency histogram details for the interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram latency

nv show interface <interface-id> telemetry histogram latency traffic-class

Shows the latency histogram samples collected for all traffic classes for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram latency traffic-class

nv show interface <interface-id> telemetry histogram latency traffic-class <tc-id>

Shows the latency histogram samples collected for the specified traffic class on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.
tc-id The traffic class ID.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram latency traffic-class 2

nv show interface <interface-id> telemetry histogram latency traffic-class <tc-id> threshold

Shows the configured interval set for latency histogram samples for the specified traffic class on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.
tc-id The traffic class ID.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram latency traffic-class 2 threshold

nv show interface <interface-id> telemetry histogram latency traffic-class <tc-id> snapshot

Shows the snapshot collected for latency histogram samples for the specified traffic class on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.
tc-id The traffic class ID.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show interface swp1 telemetry histogram latency traffic-class 2 snapshot

nv show system telemetry bw-gauge

Shows a summary of the bandwidth gauge for all interfaces.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry bw-gauge.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry bw-gauge

nv show system telemetry bw-gauge interface

Shows a summary of the bandwidth for all interfaces with bandwidth gauge enabled.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry bw-gauge interface.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry bw-gauge interface
Interface  Tx (Mbps)  Rx (Mbps)
---------  ---------  ---------
swp1       4          4

nv show system telemetry export

Shows telemetry export configuration on the switch.

  • Cumulus Linux supports open telemetry export on switches with the Spectrum-4 ASIC only in Cumulus Linux 5.10.0 and later.
  • Open telemetry export is a beta feature in Cumulus Linux 5.10.0.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry export
                    applied   pending 
------------------  --------  --------
vrf                 default   default 
otlp                                  
  state             disabled  disabled
  grpc                                
    insecure  disabled  disabled
    port            8443      8443    
    [destination]

nv show system telemetry export otlp gRPC

Shows OTLP gRPC export configuration on the switch.

  • Cumulus Linux supports open telemetry export on switches with the Spectrum-4 ASIC only in Cumulus Linux 5.10.0 and later.
  • Open telemetry export is a beta feature in Cumulus Linux 5.10.0.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry export otlp gRPC
          applied 
--------  --------
insecure  disabled
port      8443

nv show system telemetry export otlp gRPC destination

Shows OTLP gRPC destination configuration on the switch.

  • Cumulus Linux supports open telemetry export on switches with the Spectrum-4 ASIC only in Cumulus Linux 5.10.0 and later.
  • Open telemetry export is a beta feature in Cumulus Linux 5.10.0.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry export otlp gRPC destination

nv show system telemetry export otlp gRPC destination <destination>

Shows specific OTLP gRPC destination configuration on the switch.

  • Cumulus Linux supports open telemetry export on switches with the Spectrum-4 ASIC only in Cumulus Linux 5.10.0 and later.
  • Open telemetry export is a beta feature in Cumulus Linux 5.10.0.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry export otlp gRPC destination 10.1.1.100
      applied  pending
----  -------  -------
port           4317

nv show system telemetry hft

Shows the high frequency telemetry configuration.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry hft
profile
==========
    Profile   traffic-class  counter       sample-interval
    --------  -------------  ------------  ---------------
    profile2  0              rx-byte       1000           
              1              tx-byte                      
              2                                           
              3                                           
              4                                           
              5                                           
              6                                           
              7                                           
              8                                           
              9                                           
    standard  3              rx-byte       5000           
                             tc-occupancy                 
                             tx-byte
...

nv show system telemetry hft profile

Shows the high frequency telemetry profiles configured on the switch.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry hft profile
Profile   traffic-class  counter       sample-interval
--------  -------------  ------------  ---------------
profile2  0              rx-byte       1000           
          1              tx-byte                      
          2                                           
          3                                           
          4                                           
          5                                           
          6                                           
          7                                           
          8                                           
          9                                           
standard  3              rx-byte       5000           
                         tc-occupancy                 
                         tx-byte

nv show system telemetry hft profile <profile-id>

Shows the configuration settings for a specific profile:

Command Syntax

Syntax Description
<profile-id> The name of the profile. High frequency telemetry uses profiles for data collection. A profile is a set of configurations. Cumulus Linux provides a default profile called standard. You can create a maximum of four new profiles (four profiles in addition to the default profile).

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry hft profile profile2
                 operational  applied
---------------  -----------  -------
sample-interval  1000         1000   
[traffic-class]  0            0      
[traffic-class]  1            1      
[traffic-class]  2            2      
[traffic-class]  3            3      
[traffic-class]  4            4      
[traffic-class]  5            5      
[traffic-class]  6            6      
[traffic-class]  7            7      
[traffic-class]  8            8      
[traffic-class]  9            9      
[counter]        rx-byte      rx-byte
[counter]        tx-byte      tx-byte

nv show system telemetry hft target

Shows the high frequency telemetry configured targets.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry hft target
applied
-------
local

nv show system telemetry hft job

Shows information for all data collection jobs, such as the start time, duration, status, and ports on which the data is collected.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry hft job
Job Id      Start Time               Duration(s)        Profile     Ports    Status  

---------   --------------           ------------       ---------   -------   ---------  

1           10-05-2024 09:00:00      20                 standard    all       complete 
2           12-05-2024 09:00:00      20                 standard    all       complete 
3           15-05-2024 09:00:00      20                 standard    all       complete 
4           16-05-2024 09:00:00      20                 standard    all       complete 
5           17-05-2024 09:00:00      20                 standard    all       complete 
6           19-05-2024 09:00:00      20                 standard    all       complete 
7           19-05-2024 12:00:00      20                 standard    all       running 
8           20-05-2024 09:00:00      20                 standard    all       pending

nv show system telemetry hft job <job-id>

Shows information about a specific high frequency telemetry data collection job.

Command Syntax

Syntax Description
<job-id> The high frequency telemetry data collection job ID.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry hft job 1 
                       operational
---------------------  ----------------- 
start-time             01-01-2024 12:00:00 
duration               20 
traffic-class          3 
counter                tx-byte,rx-byte,tc-occupancy 
sample-interval        5000 
ports                  swp1-swp64 
status                 pending 
target                 scp://abc@server1:/hft-data

nv show system telemetry histogram

Shows telemetry histogram configuration settings and operational data.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry histogram.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry histogram

nv show system telemetry histogram ingress-buffer

Shows ingress queue length histogram configuration settings and operational data.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry histogram ingress-buffer.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry histogram ingress-buffer

nv show system telemetry histogram egress-buffer

Shows egress queue length histogram configuration settings and operational data.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry histogram egress-buffer.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry histogram egress-buffer

nv show system telemetry histogram counter

Shows counter histogram configuration settings and operational data.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry histogram counter.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry histogram counter

nv show system telemetry histogram interface

Shows a list of the interfaces with enabled histograms.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry histogram interface.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry histogram interface
Interface         ingress-buffer          egress-buffer            counter 
--------------------------------------------------------------------------------------- 
swp1              0,1,2                   -                        tx-byte,rx-byte 
swp2              -                       0,1,8                    tx-byte,tx-byte

nv show system telemetry histogram latency

Shows latency Histogram configuration and operational data.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry histogram latency.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show system telemetry histogram latency

nv show system telemetry interface-stats

Shows telemetry interface statistics configuration.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry interface-stats
                 applied   pending 
---------------  --------  --------
sample-interval  1         1       
export                             
  state          enabled  enabled

nv show system telemetry interface-stats egress-buffer

Shows the telemetry interface statistics egress buffer configuration.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry interface-stats egress-buffer

nv show system telemetry interface-stats export

Shows if interface statistics export is enabled or disabled.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry interface-stats export
      applied   pending 
-----  --------  --------
state  enabled  enabled

nv show system telemetry interface-stats ingress-buffer

Shows telemetry interface statistics ingress buffer configuration.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show system telemetry interface-stats ingress-buffer

nv show system telemetry snapshot-file

Shows histogram snapshot file configuration and operational data.

In Cumulus Linux 5.9 and earlier, this command is nv show service telemetry snapshot-file.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system telemetry snapshot-file

    Copyright © 2024  NVIDIA Corporation