Open Telemetry 导出

遥测技术使您能够收集、发送和分析大量数据，例如流量统计信息、端口状态、设备健康状况和配置以及事件。这些数据可帮助您监控交换机的性能、健康状况和行为、流量模式和 QoS。

配置 Open Telemetry

Cumulus Linux 支持 Open Telemetry (OTEL) 导出。您可以使用 OTLP 导出指标，例如接口计数器、缓冲区统计信息、直方图收集、平台统计信息和路由指标到外部收集器，以进行分析和可视化。

Cumulus Linux 支持在配备 Spectrum-2 ASIC 及更高版本的交换机上进行 Open Telemetry 导出。

要启用 Open Telemetry

cumulus@switch:~$ nv set system telemetry export otlp state enabled 
cumulus@switch:~$ nv config apply

当您启用 Open Telemetry 时，交换机默认收集系统信息指标并将其导出到配置的外部收集器。此外，您可以启用 Open Telemetry 以收集和导出接口统计信息、缓冲区统计信息、直方图数据、控制平面统计信息、平台统计信息和路由指标。

接口统计信息

当您为接口统计信息启用 Open Telemetry 时，交换机会导出所有配置接口上的接口统计信息

cumulus@switch:~$ nv set system telemetry interface-stats export state enabled
cumulus@switch:~$ nv config apply

您可以调整接口统计信息的采样间隔（以秒为单位）。您可以指定介于 1 到 86400 之间的值。默认值为 1。

cumulus@switch:~$ nv set system telemetry interface-stats sample-interval 100
cumulus@switch:~$ nv config apply

您可以启用这些额外的接口统计信息

入口缓冲区流量类别（0 到 15）和出口缓冲区优先级组（0 到 7）的流量类别和交换机优先级指标
用于接口 PHY 指标的 PHY

流量类别和交换机优先级

当您启用这些设置时，交换机会为定义的优先级组和流量类别导出 interface_pg 和 interface_tc 计数器

cumulus@switch:~$ nv set system telemetry interface-stats ingress-buffer priority-group 4
cumulus@switch:~$ nv set system telemetry interface-stats egress-buffer traffic-class 12
cumulus@switch:~$ nv config apply

您可以为特定交换机优先级值在所有配置的接口上启用额外的交换机优先级接口统计信息收集

cumulus@switch:~$ nv set system telemetry interface-stats switch-priority 4
cumulus@switch:~$ nv config apply

PHY

当您启用此设置时，交换机会导出 nvswitch_interface_phy 和 nvswitch_interface_raw 接口 PHY 计数器

cumulus@switch:~$ nv set system telemetry interface-stats class phy state enabled
cumulus@switch:~$ nv config apply

要显示接口统计信息配置，请运行 nv show system telemetry interface-stats 命令。

缓冲区统计信息

当您为缓冲区统计信息启用 Open Telemetry 时，交换机会导出接口和交换机缓冲区占用率和水位线指标。

cumulus@switch:~$ nv set system telemetry buffer-stats export state enabled 
cumulus@switch:~$ nv config apply

要显示缓冲区统计信息配置，请运行 nv show system telemetry buffer-stats 命令。

控制平面统计信息

当您为控制平面统计信息启用 Open Telemetry 时，交换机会导出控制平面数据包的附加计数器

cumulus@switch:~$ nv set system telemetry control-plane-stats export state enabled
cumulus@switch:~$ nv config apply

您可以调整控制平面统计信息的采样间隔（以秒为单位）。您可以指定介于 1 到 86400 之间的值。默认值为 1。

cumulus@switch:~$ nv set system telemetry control-plane-stats sample-interval 100
cumulus@switch:~$ nv config apply

要显示控制平面统计信息配置，请运行 nv show system telemetry control-plane-stats 命令。

直方图数据

当您为直方图数据启用 Open Telemetry 时，您的缓冲区、计数器和延迟直方图收集配置定义了交换机导出的数据

cumulus@switch:~$ nv set system telemetry histogram export state enabled
cumulus@switch:~$ nv config apply

要显示直方图数据配置，请运行 nv show system telemetry histogram 命令。

平台统计信息

当您启用平台统计信息 Open Telemetry 时，交换机会导出有关 CPU、磁盘、文件系统、内存和传感器运行状况的数据。要全局启用所有平台统计信息

cumulus@switch:~$ nv set system telemetry platform-stats export state enabled
cumulus@switch:~$ nv config apply

如果您不想启用所有平台统计信息，则可以启用或禁用单个平台遥测组件或调整单个组件的采样间隔。默认采样间隔为 60 秒。

CPU

cumulus@switch:~$ nv set system telemetry platform-stats class cpu state enabled
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set system telemetry platform-stats class cpu sample-interval 100
cumulus@switch:~$ nv config apply

磁盘

cumulus@switch:~$ nv set system telemetry platform-stats class disk state enabled
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set system telemetry platform-stats class disk sample-interval 100
cumulus@switch:~$ nv config apply

文件系统

cumulus@switch:~$ nv set system telemetry platform-stats class file-system state enabled
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set system telemetry platform-stats class file-system sample-interval 100
cumulus@switch:~$ nv config apply

内存

cumulus@switch:~$ nv set system telemetry platform-stats class memory state enabled
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set system telemetry platform-stats class memory sample-interval 100
cumulus@switch:~$ nv config apply

环境传感器

cumulus@switch:~$ nv set system telemetry platform-stats class environment-sensors state enabled
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set system telemetry platform-stats class environment-sensors sample-interval 100
cumulus@switch:~$ nv config apply

要显示平台统计信息配置，请运行 nv show system telemetry platform-stats 命令。

路由指标

要为第 3 层路由指标启用 Open Telemetry，请启用 OTEL 路由服务

cumulus@switch:~$ nv set system telemetry router export state enabled
cumulus@switch:~$ nv config apply

要导出任何路由指标，您必须首先启用 OTEL 路由服务。

要启用跨所有 VRF 的 BGP 对等体状态统计信息的收集和导出

cumulus@switch:~$ nv set system telemetry router bgp export state enabled
cumulus@switch:~$ nv config apply

要启用特定 VRF 下所有 BGP 对等体的统计信息收集和导出，请运行 nv set system telemetry router vrf <vrf-id> bgp export state enabled 命令；例如

cumulus@switch:~$ nv set system telemetry router vrf RED bgp export state enabled
cumulus@switch:~$ nv config apply

要启用特定 VRF 下特定 BGP 对等体的统计信息收集和导出，请运行 nv set system telemetry router vrf <vrf-id> bgp peer <peer-id> export state enabled 命令；例如

cumulus@switch:~$ nv set system telemetry router vrf RED bgp peer swp1 export state enabled
cumulus@switch:~$ nv config apply

要启用跨所有 VRF 的 IP 路由表的统计信息收集和导出

cumulus@switch:~$ nv set system telemetry router rib export state enabled
cumulus@switch:~$ nv config apply

要启用特定 VRF 的 IP 路由表的统计信息收集和导出，请运行 nv set system telemetry router vrf <vrf-id> rib export state enabled 命令；例如：

cumulus@switch:~$ nv set system telemetry router vrf RED rib export state enabled
cumulus@switch:~$ nv config apply

您可以调整路由指标的采样间隔（以秒为单位）。您可以指定 10 的倍数，最大为 60。默认值为 10。

cumulus@switch:~$ nv set system telemetry router sample-interval 30
cumulus@switch:~$ nv config apply

您可以使用 nv set telemetry router bgp export state disabled 命令禁用跨所有 VRF 的 BGP 导出，并使用 nv set telemetry router vrf <vrf-name> bgp export state enabled 命令仅为特定 VRF 启用 BGP 导出。您还可以使用 nv set telemetry router vrf <vrf-name> bgp export state disabled 命令禁用 VRF 中所有对等体的 BGP 导出，并使用 nv set telemetry router vrf <vrf-name> bgp peer <peer> export state enabled 命令仅为 VRF 中的特定对等体启用遥测。

要显示路由指标配置设置，请运行 nv show system telemetry router 命令。

gRPC OTLP 导出

要配置 Open Telemetry 导出目标

通过提供收集器目标 IP 地址或主机名来配置 gRPC 以与收集器通信。如果通信端口与默认端口 8443 不同，请指定要使用的端口
```
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.100 port 4317
cumulus@switch:~$ nv config apply
```

配置 X.509 证书以保护 gRPC 连接

cumulus@switch:~$ nv set system telemetry export otlp grpc cert-id <certificate>
cumulus@switch:~$ nv config apply

默认情况下，OTLP 导出处于需要证书的安全模式。对于没有配置证书的连接，您必须使用 nv set system telemetry export otlp grpc insecure enabled 命令启用 insecure 模式。

自定义导出

默认情况下，交换机将全局启用的所有统计信息（使用 nv set system telemetry <statistics> 命令）导出到所有配置的 OTLP 目标。如果您想将不同的指标导出到不同的 OTLP 目标，您可以自定义导出，方法是指定一个统计信息组来控制您导出的统计信息以及目标的采样间隔。

统计信息组默认继承全局 OTLP 导出配置。统计信息组下更具体的配置，例如启用或禁用统计信息类型或更改采样间隔，将覆盖任何全局 OTLP 配置。

以下示例

配置 STAT-GROUP1 以导出所有平台统计信息 (platform-stats)，但不导出接口统计信息 (interface-stats)。
将 STAT-GROUP1 配置应用于 OTLP 目标 10.1.1.100。

cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP1 platform-stats export state enabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP1 interface-stats export state disabled
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.100 stats-group STAT-GROUP1
cumulus@switch:~$ nv config apply

以下示例

配置 STAT-GROUP2 从全局遥测配置继承所有统计信息配置，但将 router 统计信息的采样间隔更改为 100
将 STAT-GROUP2 配置应用于 OTLP 目标 10.1.1.200。

cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP2 router sample-interval 100
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.200 stats-group STAT-GROUP2
cumulus@switch:~$ nv config apply

以下示例

配置 STAT-GROUP3 以禁用直方图 (histogram) 和缓冲区 (buffer-stats) 统计信息，并启用除磁盘状态之外的所有平台统计信息(platform-stats)
将 STAT-GROUP3 配置应用于 OTLP 目标 10.1.1.30。

cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 buffer-stats export state disabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 histogram export state disabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 platform-stats export state enabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 platform-stats class disk state disabled
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.30 stats-group STAT-GROUP3
cumulus@switch:~$ nv config apply

显示遥测导出配置

要显示遥测导出配置，请运行 nv show system telemetry export 命令

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

要显示 OTLP gRPC 目标配置，请运行 nv show system telemetry export otlp grpc destination 命令。

静态标签

您可以将静态标签应用于交换机和各个接口，以配置设备和接口角色的描述。导出的 OTLP 数据包括这些标签名称和描述。

Cumulus Linux 最多支持 10 个设备标签和 10 个接口标签。
标签名称和描述字符串可以包含字母数字字符，以及下划线、句点或破折号。如果字符串中包含空格，请将整个字符串用双引号或单引号括起来。

要配置交换机设备标签 Data_Center_Location 和一个字符串，将其标识为 Data_Center_B 的一部分

cumulus@switch:~$ nv set system telemetry label "Data Center Location" description "Data Center B"
cumulus@switch:~$ nv config apply

使用 nv show system telemetry label 命令验证设备标签配置

cumulus@switch:~$ nv show system telemetry label
                      description  
--------------------  -------------
Data Center Location  Data Center B

要配置交换机接口标签 interface_swp10_label，描述为 Server 10 connection

cumulus@switch:~$ nv set interface swp10 telemetry label "interface_swp10_label" description "Server 10 connection"
cumulus@switch:~$ nv config apply

使用 nv show system telemetry label 命令验证配置

cumulus@switch:~$ nv show system telemetry label
                      description  
--------------------  -------------
Data Center Location  Data Center B

使用 nv show interface <interface> telemetry label 命令验证接口标签配置

cumulus@switch:~$ nv show interface swp10 telemetry label
                       description         
---------------------  --------------------
interface_swp10_label  Server 10 connection

遥测数据格式

Cumulus Linux 以本节定义的格式导出统计信息和直方图数据。

系统信息格式

当您使用 nv set system telemetry export otlp state enabled 命令启用 Open Telemetry 时，交换机默认将以下系统信息指标导出到配置的 OTEL 收集器

名称	描述
`node_boot_time_seconds`	节点启动时间，以 Unix 时间戳表示。
`node_time_seconds`	自纪元 (1970) 以来的系统时间，以秒为单位。
`node_os_info`	操作系统和镜像信息，例如名称和版本。

接口统计信息格式

交换机导出到 OTEL 收集器的接口统计信息数据样本是 gauge 流，其中包括作为属性的接口名称和 asDouble exemplar 中报告的统计信息值。

接口统计信息

名称	描述
`nvswitch_interface_oper_state`	接口操作状态，以位图形式表示：(None[0], Up[1], Down[2], Invalid[4], Error[8])
`nvswitch_interface_dot3_control_in_unknown_opcodes`	输入 802.3 未知操作码计数器。
`nvswitch_interface_dot3_in_pause_frames`	输入 802.3 暂停帧计数器。
`nvswitch_interface_dot3_out_pause_frames`	输出 802.3 暂停帧计数器。
`nvswitch_interface_dot3_stats_alignment_errors`	802.3 对齐错误计数器。
`nvswitch_interface_dot3_stats_carrier_sense_errors`	802.3 接口载波侦听错误计数器。
`nvswitch_interface_dot3_stats_deferred_transmissions`	802.3 延迟传输计数器。
`nvswitch_interface_dot3_stats_excessive_collisions`	802.3 过度冲突计数器。
`nvswitch_interface_dot3_stats_fcs_errors`	802.3 FCS 错误计数器。
`nvswitch_interface_dot3_stats_frame_too_longs`	802.3 过大帧大小计数器。
`nvswitch_interface_dot3_stats_internal_mac_receive_errors`	802.3 内部 MAC 接收错误计数器。
`nvswitch_interface_dot3_stats_internal_mac_transmit_errors`	802.3 内部 MAC 传输错误计数器。
`nvswitch_interface_dot3_stats_late_collisions`	802.3 晚期冲突计数器。
`nvswitch_interface_dot3_stats_multiple_collision_frames`	802.3 多次冲突帧计数器。
`nvswitch_interface_dot3_stats_single_collision_frames`	802.3 单次冲突帧计数器。
`nvswitch_interface_dot3_stats_sqe_test_errors`	802.3 SQE 测试错误计数器。
`nvswitch_interface_dot3_stats_symbol_errors`	802.3 符号错误计数器。
`nvswitch_interface_performance_marked_packets`	接口性能标记数据包，标记为 `ece` 或 `ecn`。
`nvswitch_interface_discards_ingress_general`	接口入口通用丢弃计数器。
`nvswitch_interface_discards_ingress_policy_engine`	接口入口策略引擎丢弃计数器。
`nvswitch_interface_discards_ingress_vlan_membership`	接口入口 VLAN 成员资格过滤器丢弃计数器。
`nvswitch_interface_discards_ingress_tag_frame_type`	接口入口 VLAN 标签过滤器丢弃计数器。
`nvswitch_interface_discards_egress_vlan_membership`	接口出口 VLAN 成员资格过滤器丢弃计数器。
`nvswitch_interface_discards_loopback_filter`	接口环回过滤器丢弃计数器。
`nvswitch_interface_discards_egress_general`	接口出口通用丢弃计数器。
`nvswitch_interface_discards_egress_link_down`	接口出口链路断开丢弃计数器。
`nvswitch_interface_discards_egress_hoq`	接口出口队首超时丢弃。
`nvswitch_interface_discards_port_isolation`	接口端口隔离过滤器丢弃。
`nvswitch_interface_discards_egress_policy_engine`	接口出口策略引擎丢弃。
`nvswitch_interface_discards_ingress_tx_link_down`	接口入口传输链路断开丢弃。
`nvswitch_interface_discards_egress_stp_filter`	接口出口生成树过滤器丢弃。
`nvswitch_interface_discards_egress_hoq_stall`	接口出口队首停顿丢弃。
`nvswitch_interface_discards_egress_sll`	接口出口交换机生命周期限制丢弃。
`nvswitch_interface_discards_ingress_discard_all`	接口入口总丢弃。
`nvswitch_interface_tx_stats_pkts64octets`	传输的总数据包数，长度为 64 字节。
`nvswitch_interface_tx_stats_pkts65-to127octets`	传输的总数据包数，长度为 64 字节。
`nvswitch_interface_tx_stats_pkts256-to511octets`	传输的总数据包数，长度为 256-511 字节。
`nvswitch_interface_tx_stats_pkts512-to1023octets`	传输的总数据包数，长度为 512-1023 字节。
`nvswitch_interface_tx_stats_pkts1024-to1518octets`	传输的总数据包数，长度为 1024-1518 字节。
`nvswitch_interface_tx_stats_pkts1519-to2047octets`	传输的总数据包数，长度为 1519-2047 字节。
`nvswitch_interface_tx_stats_pkts2048-to4095octets`	传输的总数据包数，长度为 2048-4095 字节。
`nvswitch_interface_tx_stats_pkts4096-to8191octets`	传输的总数据包数，长度为 4096-8191 字节。
`nvswitch_interface_tx_stats_pkts8192-to10239octets`	传输的总数据包数，长度为 8192-10239 字节。
`nvswitch_interface_ether_stats_pkts64octets`	接收的总数据包数，长度为 64 字节。
`nvswitch_interface_ether_stats_pkts65to127octets`	接收的总数据包数，长度为 65-127 字节。
`nvswitch_interface_ether_stats_pkts128to255octets`	接收的总数据包数，长度为 128-255 字节。
`nvswitch_interface_ether_stats_pkts256to511octets`	接收的总数据包数，长度为 256-511 字节。
`nvswitch_interface_ether_stats_pkts512to1023octets`	接收的总数据包数，长度为 512-1023 字节。
`nvswitch_interface_ether_stats_pkts1024to1518octets`	接收的总数据包数，长度为 1024-1518 字节。
`nvswitch_interface_ether_stats_pkts1519to2047octets`	接收的总数据包数，长度为 1519-2047 字节。
`nvswitch_interface_ether_stats_pkts2048to4095octets`	接收的总数据包数，长度为 2048-4095 字节。
`nvswitch_interface_ether_stats_pkts4096to8191octets`	接收的总数据包数，长度为 4096-8191 字节。
`nvswitch_interface_ether_stats_pkts8192to10239octets`	接收的总数据包数，长度为 8192-10239 字节。
`nvswitch_interface_carrier_up_changes_total`	接口的载波启动转换总数。
`nvswitch_interface_carrier_last_change_time_ms`	接口上次载波更改的时间，以 Unix 纪元时间戳表示，精度为毫秒。
`nvswitch_interface_carrier_down_changes_total`	接口的载波断开转换总数。
`nvswitch_interface_carrier_changes_total`	接口的载波更改总数。
`nvswitch_interface_mtu_bytes`	接口的运行 MTU，以字节为单位。
`nvswitch_interface_info`	提供有关接口的信息：MAC 地址、双工模式、ifalias、接口名称、操作状态。
`nvswitch_interface_iface_id`	接口的 ifindex。
`nvswitch_interface_flags`	为接口设置的内核设备标志，以表示内核 `net_device` 标志位掩码的整数形式。
`nvswitch_interface_proto_down`	接口协议关闭状态。
`nvswitch_interface_oper_aggregate_speed`	连接接口的速度，以比特/秒为单位。
`nvswitch_interface_number_of_lanes`	接口使用的通道数。

流量类别

当您配置 nv set system telemetry interface-stats egress-buffer traffic-class <class> 命令时，交换机收集并导出以下额外的接口流量类别统计信息

名称	描述
`nvswitch_interface_tc_tx_bc_frames`	接口出口流量类别传输广播帧计数器。
`nvswitch_interface_tc_tx_ecn_marked_tc`	接口出口流量类别传输 ECN 标记计数器。
`nvswitch_interface_tc_tx_frames`	接口出口流量类别传输帧计数器。
`nvswitch_interface_tc_tx_mc_frames`	接口出口流量类别传输组播帧计数器。
`nvswitch_interface_tc_tx_no_buffer_discard_uc`	接口出口流量类别传输单播无缓冲区丢弃计数器。
`nvswitch_interface_tc_tx_octet`	接口出口流量类别传输字节计数器。
`nvswitch_interface_tc_tx_queue`	接口出口流量类别传输队列计数器。
`nvswitch_interface_tc_tx_uc_frames`	接口出口流量类别传输单播帧计数器。
`nvswitch_interface_tc_tx_wred_discard`	接口出口流量类别传输 WRED 丢弃计数器。

优先级组

当您配置 nv set system telemetry interface-stats ingress-buffer priority-group <priority> 命令时，交换机收集并导出以下额外的接口优先级组统计信息

名称	描述
`nvswitch_interface_pg_rx_buffer_discard`	接口入口优先级组接收缓冲区丢弃计数器。
`nvswitch_interface_pg_rx_frames`	接口入口优先级组接收帧计数器。
`nvswitch_interface_pg_rx_octets`	接口入口优先级组接收字节计数器。
`nvswitch_interface_pg_rx_shared_buffer_discard`	接口入口优先级组接收共享缓冲区丢弃计数器。
`nvswitch_interface_pg_rx_uc_frames`	接口接收优先级组单播帧计数器。
`nvswitch_interface_pg_rx_mc_frames`	接口接收优先级组组播帧计数器。
`nvswitch_interface_pg_rx_bc_frames`	接口接收优先级组广播帧计数器。
`nvswitch_interface_pg_tx_octets`	接口接收优先级组传输字节计数器。
`nvswitch_interface_pg_tx_uc_frames`	接口接收优先级组传输单播帧计数器。
`nvswitch_interface_pg_tx_mc_frames`	接口接收优先级组传输组播帧计数器。
`nvswitch_interface_pg_tx_bc_frames`	接口接收优先级组传输广播帧计数器。
`nvswitch_interface_pg_tx_frames`	接口接收优先级组传输帧计数器。
`nvswitch_interface_pg_rx_pause`	接口接收优先级组接收暂停计数器。
`nvswitch_interface_pg_rx_pause_duration`	接口接收优先级组接收暂停持续时间计数器。
`nvswitch_interface_pg_tx_pause`	接口接收优先级组传输暂停计数器。
`nvswitch_interface_pg_tx_pause_duration`	接口接收优先级组传输暂停持续时间计数器。
`nvswitch_interface_pg_rx_pause_transition`	接口接收优先级组接收暂停转换计数器。
`nvswitch_interface_pg_rx_discard`	接口接收优先级组接收丢弃计数器。

交换机优先级

当您配置 nv set system telemetry interfaces-stats switch-priority <priority> 命令时，交换机收集并导出以下额外的接口交换机优先级统计信息

名称	描述
`nvswitch_interface_sp_rx_bc_frames`	交换机优先级的接收广播计数器
`nvswitch_interface_sp_rx_discard`	交换机优先级的接收丢弃计数器
`nvswitch_interface_sp_rx_frames`	交换机优先级的接收帧计数器。
`nvswitch_interface_sp_rx_mc_frames`	交换机优先级的接收组播帧计数器。
`nvswitch_interface_sp_rx_octets`	交换机优先级的接收字节计数器。
`nvswitch_interface_sp_rx_pause`	交换机优先级的接收暂停计数器。
`nvswitch_interface_sp_rx_pause_duration`	交换机优先级的接收暂停持续时间计数器。
`nvswitch_interface_sp_rx_pause_transition`	交换机优先级的接收暂停转换计数器。
`nvswitch_interface_sp_rx_uc_frames`	交换机优先级的接收单播帧计数器。
`nvswitch_interface_sp_tx_bc_frames`	交换机优先级的传输广播帧计数器。
`nvswitch_interface_sp_tx_frames`	交换机优先级的传输帧计数器。
`nvswitch_interface_sp_tx_mc_frames`	交换机优先级的传输组播帧计数器。
`nvswitch_interface_sp_tx_octets`	交换机优先级的传输字节计数器。
`nvswitch_interface_sp_tx_pause`	交换机优先级的传输暂停计数器。
`nvswitch_interface_sp_tx_pause_duration`	交换机优先级的传输暂停持续时间。
`nvswitch_interface_sp_tx_uc_frames`	交换机优先级的传输单播帧计数器。

PHY

当您配置 nv set system telemetry interface-stats class phy state enabled 命令时，交换机收集并导出以下额外的接口统计信息

名称	描述
`nvswitch_interface_time_since_last_clear`	自上次清除计数器事件以来的毫秒数。
`nvswitch_interface_phy_received_bits`	接收到的流量总量（比特）。
`nvswitch_interface_phy_symbol_errors`	FEC 校正算法未校正的或 FEC 未激活时的错误比特。
`nvswitch_interface_phy_effective_errors`	应用 FEC 后的错误数。
`nvswitch_interface_phy_raw_errors`	在通道 0 到通道 7 上识别出的错误比特。当启用 FEC 时，此感应对应于已校正的错误。
`nvswitch_interface_raw-ber`	raw_ber_coef_laneX*10^(raw_ber_magnitude)

▼ interface_oper_state 的 JSON 数据示例

            {
              "name": "nvswitch_interface_oper_state",
              "description": "NVIDIA Ethernet Switch Interface operational state",
              "gauge": {
                "dataPoints": [
                  {
                     "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp61s0"
                        }
                      }
                    ],
                    "timeUnixNano": "1722458198491000000",
                    "asDouble": 1
                  },
                  {
                    "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp1"
                        }
                      }
                    ],
                    "timeUnixNano": "1722458198491000000",
                    "asDouble": 2
                  }
                ]
              },

▼ interface_dot3_stats_fcs_errors 的 JSON 数据示例

            {
              "name": "nvswitch_interface_dot3_stats_fcs_errors",
              "description": "NVIDIA Ethernet Switch Interface dot3 stats fcs errors counter",
              "gauge": {
                "dataPoints": [
                  {
                    "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp1"
                        }
                      }
                    ],
                    "timeUnixNano": "1722458205491000000",
                    "asDouble": 0
                  }
                ]
              },

缓冲区统计信息格式

当您配置 nv set system telemetry buffer-stats export state enable 命令时，交换机会收集并导出以下接口和交换机、缓冲区占用率和水位线统计信息

名称	描述
`nvswitch_interface_shared_buffer_port_pg_curr_occupancy`	当前缓冲区占用率。
`nvswitch_interface_shared_buffer_port_pg_watermark`	最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_pg_desc_curr_occupancy`	描述符的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_port_pg_desc_watermark`	描述符的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_pg_watermark_recorded_max`	自 sdk_stats 运行以来记录的最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_pg_desc_watermark_recorded_max`	自 sdk_stats 运行以来记录的描述符的最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_ingress_pool_curr_occupancy`	入口池的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_ingress_pool_watermark`	入口池的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_ingress_pool_desc_curr_occupancy`	入口池描述符的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_ingress_pool_desc_watermark`	入口池描述符的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_ingress_pool_watermark_recorded_max`	自 sdk_stats 运行以来记录的入口池最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_ingress_pool_desc_watermark_recorded_max`	自 sdk_stats 运行以来记录的入口池描述符最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_tc_curr_occupancy`	流量类别的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_port_tc_watermark`	流量类别的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_tc_desc_curr_occupancy`	描述符的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_port_tc_desc_watermark`	描述符的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_tc_watermark_recorded_max`	自 sdk_stats 运行以来记录的最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_port_tc_desc_watermark_recorded_max`	自 sdk_stats 运行以来记录的 TC 描述符的最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_egress_pool_curr_occupancy`	出口池的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_egress_pool_watermark`	出口池的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_egress_pool_desc_curr_occupancy`	出口池描述符的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_egress_pool_desc_watermark`	出口池描述符的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_egress_pool_watermark_recorded_max`	自 sdk_stats 运行以来记录的出口池最高最大缓冲区占用率。
`nvswitch_interface_shared_buffer_egress_pool_desc_watermark_recorded_max`	自 sdk_stats 运行以来记录的池描述符的最高最大出口池缓冲区占用率。
`nvswitch_interface_shared_buffer_mc_port_curr_occupancy`	组播端口的当前缓冲区占用率。
`nvswitch_interface_shared_buffer_mc_port_watermark`	组播端口的最大缓冲区占用率。
`nvswitch_interface_shared_buffer_mc_port_watermark_max`	自 sdk_stats 运行以来记录的组播端口的最高最大缓冲区占用率。
`nvswitch_shared_buffer_mc_sp_curr_occupancy`	组播交换优先级的当前缓冲区占用率。
`nvswitch_shared_buffer_mc_sp_watermark`	组播交换优先级的最大缓冲区占用率。
`nvswitch_shared_buffer_mc_sp_watermark_max`	自 sdk_stats 运行以来记录的组播交换优先级的最高最大缓冲区占用率。
`nvswitch_shared_buffer_pool_curr_occupancy`	当前池缓冲区占用率。
`nvswitch_shared_buffer_pool_watermark`	最大池缓冲区占用率
`nvswitch_shared_buffer_pool_watermark_max`	自 sdk_stats 运行以来记录的组播交换优先级的最高最大池缓冲区占用率。
`nvswitch_interface_headroom_buffer_pg_curr_occupancy`	端口缓冲区的当前预留空间缓冲区占用率。
`nvswitch_interface_headroom_buffer_pg_watermark`	端口缓冲区的最大池预留空间缓冲区占用率。
`nvswitch_interface_headroom_buffer_pg_watermark_recorded_max`	自 sdk_stats 运行以来记录的端口缓冲区的最高最大预留空间缓冲区占用率。
`nvswitch_interface_headroom_buffer_shared_curr_occupancy`	端口共享缓冲区的当前预留空间缓冲区占用率。
`nvswitch_interface_headroom_shared_buffer_shared_watermark`	端口共享缓冲区的最大预留空间缓冲区占用率。
`nvswitch_interface_headroom_shared_buffer_shared_watermark_recorded_max`	自 sdk_stats 运行以来记录的端口共享缓冲区的最高最大预留空间缓冲区占用率。
`nvswitch_interface_headroom_buffer_shared_pool_curr_occupancy`	端口共享池缓冲区的当前预留空间缓冲区占用率
`nvswitch_interface_headroom_shared_buffer_shared_pool_watermark`	端口共享池缓冲区的最大预留空间缓冲区占用率。
`nvswitch_interface_headroom_shared_buffer_shared_pool_watermark_recorded_max`	端口共享池缓冲区的最高最大预留空间缓冲区占用率。

控制平面统计信息格式

当您启用控制平面统计信息遥测时，交换机将导出以下统计信息

名称	描述
`nvswitch_control_plane_tx_packets`	控制平面发送数据包。
`nvswitch_control_plane_tx_bytes`	控制平面发送字节。
`nvswitch_control_plane_rx_packets`	控制平面接收数据包。
`nvswitch_control_plane_rx_bytes`	控制平面接收字节。
`nvswitch_control_plane_rx_buffer_drops`	控制平面接收缓冲区丢弃。
`nvswitch_control_plane_trap_rx_packets`	控制平面陷阱组接收数据包。
`nvswitch_control_plane_trap_rx_event_count`	控制平面陷阱组接收事件。
`nvswitch_control_plane_trap_rx_drop`	控制平面陷阱组接收丢弃。
`nvswitch_control_plane_trap_rx_bytes`	控制平面陷阱组接收字节。
`nvswitch_control_plane_trap_group_rx_packets`	控制平面陷阱组接收数据包。
`nvswitch_control_plane_trap_group_rx_bytes`	控制平面陷阱组接收字节。
`nvswitch_control_plane_trap_group_pkt_violations`	控制平面陷阱组数据包违规。

▼ nvswitch_control_plane_trap_rx_drop 的 JSON 数据示例

            {
              "name": "nvswitch_control_plane_trap_rx_drop",
              "description": "NVIDIA Ethernet Switch trap t_drops counter",
              "sum": {
                "dataPoints": [
                  {
                    "attributes": [
                      {
                        "key": "group",
                        "value": {
                          "stringValue": "25"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729836350747000000",
                    "timeUnixNano": "1729839232747000000",
                    "asDouble": 0
                  },
                  {
                    "attributes": [
                      {
                        "key": "group",
                        "value": {
                          "stringValue": "3"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729836350747000000",
                    "timeUnixNano": "1729839232747000000",
                    "asDouble": 0
                  },
                  {
                    "attributes": [
                      {
                        "key": "group",
                        "value": {
                          "stringValue": "5"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729836350747000000",
                    "timeUnixNano": "1729839232747000000",
                    "asDouble": 0
                  },
                  {
                    "attributes": [
                      {
                        "key": "group",
                        "value": {
                          "stringValue": "53"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729836350747000000",
                    "timeUnixNano": "1729839232747000000",
                    "asDouble": 0
                  },
                  {
                    "attributes": [
                      {
                        "key": "group",
                        "value": {
                          "stringValue": "78"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729836350747000000",
                    "timeUnixNano": "1729839232747000000",
                    "asDouble": 1
                  },
                  {
                    "attributes": [
                      {
                        "key": "group",
                        "value": {
                          "stringValue": "80"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729836350747000000",
                    "timeUnixNano": "1729839232747000000",
                    "asDouble": 1
                  }
                ],
                "aggregationTemporality": 2,
                "isMonotonic": true
              },
              "metadata": [
                {
                  "key": "prometheus.type",
                  "value": {
                    "stringValue": "counter"
                  }
                }
              ]
            }

平台统计信息格式

当您全局启用平台统计信息遥测，或者当您为单个组件启用遥测时，交换机将导出以下统计信息

CPU

CPU 统计信息包括 CPU 核心数和操作模式（用户、系统、空闲、iowait、irq、softirq、steal、guest、guest_nice）。

名称	描述
`node_cpu_core_throttles_total`	CPU 核心被节流的总次数。
`node_cpu_frequency_max_hertz`	CPU 线程的最大频率（赫兹）。
`node_cpu_frequency_min_hertz`	CPU 线程的最小频率（赫兹）。
`node_cpu_guest_seconds_total`	CPU 在每种模式下用于 guest 的秒数。
`node_cpu_package_throttles_total`	CPU 封装被节流的总次数。
`node_cpu_scaling_frequency_hertz`	当前缩放的 CPU 线程频率（赫兹）。
`node_cpu_scaling_frequency_max_hertz`	最大缩放的 CPU 线程频率（赫兹）。
`node_cpu_scaling_frequency_min_hertz`	最小缩放的 CPU 线程频率（赫兹）。
`node_cpu_seconds_total`	CPU 在每种模式下花费的秒数。

磁盘

名称	描述
`node_disk_ata_rotation_rate_rpm`	ATA 磁盘旋转速率，单位为 RPM。（SSD 为 0）。
`node_disk_ata_write_cache`	ATA 磁盘写入缓存是否存在。
`node_disk_ata_write_cache_enabled`	ATA 磁盘写入缓存状态（启用或禁用）。
`node_disk_discard_time_seconds_total`	所有 discard 操作花费的总秒数。
`node_disk_discarded_sectors_total`	成功 discard 的扇区总数。
`node_disk_discards_completed_total`	完成的 discard 操作总数。
`node_disk_discards_merged_total`	合并的 discard 操作总数。
`node_disk_flush_requests_time_seconds_total`	所有 flush 请求花费的总秒数。
`node_disk_flush_requests_total`	成功完成的 flush 请求总数。
`node_disk_info`	来自 `/sys/block/<block_device>` 的磁盘信息。
`node_disk_io_now`	正在进行的 I/O 操作数。
`node_disk_io_time_seconds_total`	I/O 期间花费的总秒数。
`node_disk_io_time_weighted_seconds_total`	I/O 期间花费的加权秒数。
`node_disk_read_bytes_total`	成功读取的字节总数。
`node_disk_read_time_seconds_total`	所有读取操作花费的总秒数。
`node_disk_reads_completed_total`	成功完成的读取操作总数。
`node_disk_reads_merged_total`	合并的读取操作总数。
`node_disk_write_time_seconds_total`	所有写入操作花费的总秒数。
`node_disk_writes_completed_total`	成功完成的写入操作总数。
`node_disk_writes_merged_total`	合并的写入操作数。
`node_disk_written_bytes_total`	成功写入的字节总数。

文件系统

名称	描述
`node_filesystem_avail_bytes`	文件系统中非 root 用户可用的空间（字节）。
`node_filesystem_device_error`	获取给定设备的统计信息时是否发生错误。
`node_filesystem_files`	文件系统文件节点总数。
`node_filesystem_files_free`	文件系统可用文件节点总数。
`node_filesystem_free_bytes`	文件系统可用空间（字节）。
`node_filesystem_readonly`	文件系统只读状态。
`node_filesystem_size_bytes`	文件系统大小（字节）。

内存

名称	描述
`node_memory_Active_anon_bytes`	`/proc/meminfo` Active_anon 字节。
`node_memory_Active_bytes`	`/proc/meminfo` Active 字节。
`node_memory_Active_file_bytes`	`/proc/meminfo` Active_file 字节。
`node_memory_AnonHugePages_bytes`	`/proc/meminfo` AnonHugePages 字节。
`node_memory_AnonPages_bytes`	`/proc/meminfo` AnonPages 字节。
`node_memory_Bounce_bytes`	`/proc/meminfo` Bounce 字节。
`node_memory_Buffers_bytes` `/proc/meminfo` Buffers 字节。
`node_memory_Cached_bytes`	`/proc/meminfo` Cached 字节。
`node_memory_CommitLimit_bytes`	`/proc/meminfo` CommitLimit 字节。
`node_memory_Committed_AS_bytes`	`/proc/meminfo` Committed_AS 字节。
`node_memory_DirectMap1G_bytes`	`/proc/meminfo` DirectMap1G 字节。
`node_memory_DirectMap2M_bytes`	`/proc/meminfo` DirectMap2M 字节。
`node_memory_DirectMap4k_bytes`	`/proc/meminfo` DirectMap4k 字节。
`node_memory_Dirty_bytes`	`/proc/meminfo` Dirty 字节。
`node_memory_FileHugePages_bytes`	`/proc/meminfo` FileHugePages 字节。
`node_memory_FilePmdMapped_bytes`	`/proc/meminfo` FilePmdMapped 字节。
`node_memory_HardwareCorrupted_bytes`	`/proc/meminfo` HardwareCorrupted 字节。
`node_memory_HugePages_Free`	`/proc/meminfo` HugePages_Free。
`node_memory_HugePages_Rsvd`	`/proc/meminfo` HugePages_Rsvd。
`node_memory_HugePages_Surp`	`/proc/meminfo` HugePages_Surp。
`node_memory_HugePages_Total`	`/proc/meminfo` HugePages_Total。
`node_memory_Hugepagesize_bytes`	`/proc/meminfo` Hugepagesize 字节。
`node_memory_Hugetlb_bytes`	`/proc/meminfo` Hugetlb 字节。
`node_memory_Inactive_anon_bytes`	`/proc/meminfo` Inactive_anon 字节。
`node_memory_Inactive_bytes`	`/proc/meminfo` Inactive 字节。
`node_memory_Inactive_file_bytes`	`/proc/meminfo` Inactive_file 字节。
`node_memory_KReclaimable_bytes`	`/proc/meminfo` KReclaimable 字节。
`node_memory_KernelStack_bytes`	`/proc/meminfo` KernelStack 字节。
`node_memory_Mapped_bytes`	`/proc/meminfo` Mapped 字节。
`node_memory_MemAvailable_bytes`	`/proc/meminfo` MemAvailable 字节。
`node_memory_MemFree_bytes`	`/proc/meminfo` MemFree 字节。
`node_memory_MemTotal_bytes`	`/proc/meminfo` MemTotal 字节。
`node_memory_Mlocked_bytes`	`/proc/meminfo` Mlocked 字节。
`node_memory_NFS_Unstable_bytes`	`/proc/meminfo` NFS_Unstable 字节。
`node_memory_PageTables_bytes`	`/proc/meminfo` PageTables 字节。
`node_memory_Percpu_bytes`	`/proc/meminfo` Percpu 字节。
`node_memory_SReclaimable_bytes`	`/proc/meminfo` SReclaimable 字节。
`node_memory_SUnreclaim_bytes`	`/proc/meminfo` SUnreclaim 字节。
`node_memory_SecPageTables_bytes`	`/proc/meminfo` SecPageTables 字节。
`node_memory_ShmemHugePages_bytes`	`/proc/meminfo` ShmemHugePages 字节。
`node_memory_ShmemPmdMapped_bytes`	`/proc/meminfo` ShmemPmdMapped 字节。
`node_memory_Shmem_bytes`	`/proc/meminfo` Shmem 字节。
`node_memory_Slab_bytes`	`/proc/meminfo` Slab 字节。
`node_memory_SwapCached_bytes`	`/proc/meminfo` SwapCached 字节。
`node_memory_SwapFree_bytes`	`/proc/meminfo` SwapFree 字节。
`node_memory_SwapTotal_bytes`	`/proc/meminfo` SwapTotal 字节。
`node_memory_Unevictable_bytes`	`/proc/meminfo` Unevictable 字节。
`node_memory_VmallocChunk_bytes`	`/proc/meminfo` VmallocChunk 字节。
`node_memory_VmallocTotal_bytes`	`/proc/meminfo` VmallocTotal 字节。
`node_memory_VmallocUsed_bytes`	`/proc/meminfo` VmallocUsed 字节。
`node_memory_WritebackTmp_bytes`	`/proc/meminfo` WritebackTmp 字节。
`node_memory_Writeback_bytes`	`/proc/meminfo` Writeback 字节。
`node_memory_Zswap_bytes`	`/proc/meminfo` Zswap 字节。
`node_memory_Zswapped_bytes`	`/proc/meminfo` Zswapped 字节。

环境传感器

名称	描述
`nvswitch_env_fan_cur_speed`	当前风扇速度（RPM）。
`nvswitch_env_fan_dir`	风扇方向（0：前到后，1：后到前）。
`nvswitch_env_fan_max_speed`	风扇最大速度（RPM）。
`nvswitch_env_fan_min_speed`	风扇最小速度（RPM）。
`nvswitch_env_fan_state`	风扇状态（0：不存在，1：正常，2：失败，3：不良）。
`nvswitch_env_psu_capacity`	PSU 容量（瓦特）。
`nvswitch_env_psu_current`	PSU 电流（安培）。
`nvswitch_env_psu_power`	PSU 功率（瓦特）。
`nvswitch_env_psu_state`	PSU 状态（0：不存在，1：正常，2：失败，3：不良）。
`nvswitch_env_psu_voltage`	PSU 电压（伏特）。
`nvswitch_env_temp_crit`	临界温度阈值（摄氏度）。
`nvswitch_env_temp_current`	当前温度（摄氏度）。
`nvswitch_env_temp_max`	最高温度阈值（摄氏度）。
`nvswitch_env_temp_min`	最低温度阈值（摄氏度）。
`nvswitch_env_temp_state`	温度传感器状态（0：不存在，1：正常，2：失败，3：不良）。

▼ PSU 和温度传感器遥测的 JSON 数据示例

        {
          "name": "nvswitch_platform_environment_psu_state",
          "description": "PSU state. 0:ABSENT 1:OK 2:FAILED 3:BAD",
          "gauge": {
            "dataPoints": [
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Power Supply Unit 1"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 1
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Power Supply Unit 2"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU2"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 3
              }
                    "value": {
                      "stringValue": "Power Supply Unit 1"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 1
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Power Supply Unit 2"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU2"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 3
              }
            ]
          },
          "metadata": [
            {
              "key": "prometheus.type",
              "value": {
                "stringValue": "gauge"
              }
            }
          ]
        },
        {
          "name": "nvswitch_platform_environment_temp_crit",
          "description": "Critical temperature in Centigrade.",
          "gauge": {
            "dataPoints": [
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Asic Temp Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp4"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 120
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 0"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp5"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 1"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp6"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 2"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp7"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 3"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp8"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 4"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp9"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 5"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp10"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Package Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 100
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Main Board Ambient Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp3"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 85
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "PSU1 Temp Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU1Temp1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 85
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "PSU2 Temp Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU2Temp1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 0
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Port Ambient Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp2"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 85
              }
            ]
          },
          "metadata": [
            {
              "key": "prometheus.type",
              "value": {
                "stringValue": "gauge"
              }
            }
          ]
        },
        {
          "name": "nvswitch_platform_environment_temp_current",
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Port Ambient Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp2"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 85
              }
            ]
          },
          "metadata": [
            {
              "key": "prometheus.type",
              "value": {
                "stringValue": "gauge"
              }
            }
          ]
        },
        {
          "name": "nvswitch_platform_environment_temp_current",
          "description": "Current temperature in Centigrade.",
          "gauge": {
            "dataPoints": [
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Asic Temp Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp4"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 50
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 0"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp5"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 52
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 1"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp6"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 69
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 2"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp7"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 55
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 3"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp8"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 54
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 4"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp9"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 52
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Core Sensor 5"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp10"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 52
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "CPU Package Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 69
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Main Board Ambient Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp3"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 24.687
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "PSU1 Temp Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU1Temp1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 24.531
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "PSU2 Temp Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "PSU2Temp1"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 0
              },
              {
                "attributes": [
                  {
                    "key": "description",
                    "value": {
                      "stringValue": "Port Ambient Sensor"
                    }
                  },
                  {
                    "key": "name",
                    "value": {
                      "stringValue": "Temp2"
                    }
                  }
                ],
                "timeUnixNano": "1729113543218000000",
                "asDouble": 22.312
              }
            ]
          },
          "metadata": [
            {
              "key": "prometheus.type",
              "value": {
                "stringValue": "gauge"
              }
            }
          ]
        },

路由指标格式

当您启用第 3 层路由指标遥测时，交换机将导出以下统计信息

名称	描述
`nvrouting_bgp_peer_state`	BGP 对等体状态：`Established`、`Idle`、`Connect`、`Active`、`OpenSent`。
`nvrouting_bgp_peer_fsm_established_transitions`	对等会话 BGP 对等体状态转换为 `Established` 状态的次数。
`nvrouting_bgp_peer_rib_adj_in_ipv4_unicast`	从 BGP 邻居接收的 IPv4 单播路由数，应用任何策略之后。此计数是邻居的策略后 Adj-RIB-In 中存在的路由数。
`nvrouting_bgp_peer_rib_adj_in_ipv6_unicast`	从 BGP 邻居接收的 IPv6 单播路由数，应用任何策略之后。此计数是邻居的策略后 Adj-RIB-In 中存在的路由数。
`nvrouting_bgp_peer_rib_adj_in_l2vpn_evpn`	从 BGP 邻居接收的 EVPN 路由数，应用任何策略之后。此计数是邻居的策略后 Adj-RIB-In 中存在的路由数。
`nvrouting_bgp_peer_socket_in_queue`	要从 BGP 邻居接收的消息数（已排队）。
`nvrouting_bgp_peer_socket_out_queue`	要发送到 BGP 邻居的消息数（已排队）。
`nvrouting_bgp_peer_rx_updates`	从邻居接收的 BGP 消息数。
`nvrouting_bgp_peer_tx_updates`	发送到邻居的 BGP 消息数。
`nvrouting_rib_count`	每个路由源的 IP 路由表中的路由数。
`nvrouting_rib_count_ipv6`	跟踪每个路由源的 IPv6 RIB 路由计数。
`nvrouting_rib_count_connected`	跟踪 IPv4 RIB 连接路由总数。
`nvrouting_rib_count_bgp`	跟踪 IPv4 RIB BGP 路由总数。
`nvrouting_rib_count_kernel`	跟踪 IPv4 RIB 内核路由总数。
`nvrouting_rib_count_static`	跟踪 IPv4 RIB 静态路由总数。
`nvrouting_rib_count_pbr`	跟踪 IPv4 RIB PBR 路由总数。
`nvrouting_rib_count_ospf`	跟踪 IPv4 RIB OSPF 路由总数。
`nvrouting_rib_count_connected_ipv6`	跟踪 IPv6 RIB 连接路由总数。
`nvrouting_rib_count_bgp_ipv6`	跟踪 IPv6 RIB BGP 路由总数。
`nvrouting_rib_count_kernel_ipv6`	跟踪 IPv6 RIB 内核路由总数。
`nvrouting_rib_count_static_ipv6`	跟踪 IPv6 RIB 静态路由总数。
`nvrouting_rib_count_pbr_ipv6`	跟踪 IPv6 RIB PBR 路由总数。
`nvrouting_rib_count_ospf_ipv6`	跟踪 IPv6 RIB OSPF 路由总数。

▼ BGP 对等体指标的 JSON 数据示例

INFO:root:Received metrics export request
INFO:root:Metric name: nvrouting_bgp_peer_state
INFO:root:Metric:
name: "nvrouting_bgp_peer_state"
description: "Tracks BGP peer state information (Established:1,Idle:2,Connect:3, Active:4, Opensent:5 )"
gauge {
  data_points {
    start_time_unix_nano: 1738017981273381011
    time_unix_nano: 1738017981275774678
    as_int: 1
    attributes {
      key: "peer-id"
      value {
        string_value: "swp17.100"
      }
    }
    attributes {
      key: "state"
      value {
        string_value: "Established"
      }
    }
    attributes {
      key: "vrf"
      value {
        string_value: "default"
      }
    }
  }
  data_points {
    start_time_unix_nano: 1738017981273381011
    time_unix_nano: 1738017981275774678
    as_int: 1
    attributes {
      key: "peer-id"
      value {
        string_value: "swp17.101"
      }
    }
    attributes {
      key: "state"
      value {
        string_value: "Established"
      }
    }
    attributes {
      key: "vrf"
      value {
        string_value: "default"
      }
    }
  }
 
INFO:root:Metric name: nvrouting_bgp_peer_fsm_established_transitions
INFO:root:Metric:
name: "nvrouting_bgp_peer_fsm_established_transitions"
description: "Tracks BGP peer state transitions to the Established state"
gauge {
  data_points {
    start_time_unix_nano: 1738017981273393225
    time_unix_nano: 1738017981275785883
    as_int: 1
    attributes {
      key: "peer-id"
      value {
        string_value: "swp16.100"
      }
    }
    attributes {
      key: "state"
      value {
        string_value: "Established"
      }
    }
    attributes {
      key: "vrf"
      value {
        string_value: "default"
      }
    }
  }
  data_points {
    start_time_unix_nano: 1738017981273393225
    time_unix_nano: 1738017981275785883
    as_int: 1
    attributes {
      key: "peer-id"
      value {
        string_value: "swp18.101"
      }
    }
    attributes {
      key: "state"
      value {
        string_value: "Established"
      }
    }
    attributes {
      key: "vrf"
      value {
        string_value: "default"
      }
    }
  }

▼ RIB 计数指标的 JSON 数据示例

name: "nvrouting_rib_count_bgp_ipv6"
description: "Total Number of ipv6 BGP routes in Zebra"
gauge {
  data_points {
    start_time_unix_nano: 1738016804524747485
    time_unix_nano: 1738016804529163046
    as_int: 2062
    attributes {
      key: "vrf"
      value {
        string_value: "vrf2"
      }
    }
  }
  data_points {
    start_time_unix_nano: 1738016804524747485
    time_unix_nano: 1738016804529163046
    as_int: 2062
    attributes {
      key: "vrf"
      value {
        string_value: "vrf6"
      }
    }
  }

直方图数据格式

交换机导出到 OTEL 收集器的直方图数据样本是直方图数据点，其中包括直方图桶（箱）计数和每个桶的相应队列长度大小边界。如果配置了延迟和计数器直方图数据，也会导出。

如果在采样间隔期间流量类别中没有传输任何数据包，则延迟直方图桶计数不会在导出的遥测数据中递增。

对于每个已启用入口和出口缓冲区、延迟和计数器直方图收集的接口，交换机都会发送一个包含以下名称的样本

名称	描述
`nvswitch_histogram_interface_egress_buffer`	直方图接口出口缓冲区队列深度。
`nvswitch_histogram_interface_ingress_buffer`	直方图接口入口缓冲区队列深度。
`nvswitch_histogram_interface_counter`	直方图接口计数器数据。
`nvswitch_histogram_interface_latency`	直方图接口延迟数据。

▼ interface_ingress_buffer 的 JSON 数据示例

            {
              "name": "nvswitch_histogram_interface_ingress_buffer",
              "description": "NVIDIA Ethernet Switch Histogram Interface Ingress Buffer Queue Depth",
              "unit": "bytes",
              "histogram": {
                "dataPoints": [
                  {
                    "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp1s1"
                        }
                      },
                      {
                        "key": "pg",
                        "value": {
                          "intValue": "0"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729839231624809212",
                    "timeUnixNano": "1729839231628434909",
                    "count": "1019165",
                    "bucketCounts": [
                      "1019165",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0"
                    ],
                    "explicitBounds": [
                      863,
                      295775,
                      590687,
                      885599,
                      1180511,
                      1475423,
                      1770335,
                      2065247,
                      2360159
                    ]
                  },

▼ interface_egress_buffer 的 JSON 数据示例

{
              "name": "nvswitch_histogram_interface_egress_buffer",
              "description": "NVIDIA Ethernet Switch Histogram Interface Egress Buffer Queue Depth",
              "unit": "bytes",
              "histogram": {
                "dataPoints": [
                  {
                    "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp1s1"
                        }
                      },
                      {
                        "key": "tc",
                        "value": {
                          "intValue": "0"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729839232707032279",
                    "timeUnixNano": "1729839232709312158",
                    "count": "1077334",
                    "bucketCounts": [
                      "1077334",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0"
                    ],
                    "explicitBounds": [
                      863,
                      1180511,
                      2360159,
                      3539807,
                      4719455,
                      5899103,
                      7078751,
                      8258399,
                      9438047
                    ]
                  }

▼ interface_counter 的 JSON 数据示例

            {
              "name": "nvswitch_histogram_interface_counter",
              "description": "NVIDIA Ethernet Switch Histogram Interface Counter",
              "unit": "counter",
              "histogram": {
                "dataPoints": [
                  {
                    "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp1s1"
                        }
                      },
                      {
                        "key": "type",
                        "value": {
                          "stringValue": "crc"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729839235935525147",
                    "timeUnixNano": "1729839235937099838",
                    "count": "1033926",
                    "bucketCounts": [
                      "1033926",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0"
                    ],
                    "explicitBounds": [
                      99999,
                      1337499,
                      2574999,
                      3812499,
                      5049999,
                      6287499,
                      7524999,
                      8762499,
                      9999999
                    ]
                  },

▼ interface_latency 的 JSON 数据示例

            {
              "name": "nvswitch_histogram_interface_latency",
              "description": "NVIDIA Ethernet Switch Histogram Interface Latency",
              "unit": "packets",
              "histogram": {
                "dataPoints": [
                  {
                    "attributes": [
                      {
                        "key": "interface",
                        "value": {
                          "stringValue": "swp1s1"
                        }
                      },
                      {
                        "key": "tc",
                        "value": {
                          "intValue": "0"
                        }
                      }
                    ],
                    "startTimeUnixNano": "1729839233815168456",
                    "timeUnixNano": "1729839233818493910",
                    "bucketCounts": [
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0",
                      "0"
                    ],
                    "explicitBounds": [
                      319,
                      831,
                      1343,
                      1855,
                      2367,
                      2879,
                      3391,
                      3903,
                      4415
                    ]
                  },

静态标签格式

设备静态标签在 OTLP 数据的资源指标部分中导出

▼ 静态设备标签的 JSON 数据示例

接口静态标签作为每个接口的指标属性导出。

▼ 静态接口标签的 JSON 数据示例

      "metrics": [ 
          "name": "nvswitch_interface_iface_id", 
          "description": "Network device property: iface_id", 
          "gauge": { 
            "dataPoints": [ 
              { 
                "attributes": [ 
                  { 
                    "key": "interface", 
                    "value": { 
                      "stringValue": "swp10" 
                    } 
                  } 
                ], 
                "timeUnixNano": "1727942163835000000", 
                "asDouble": 13 
              }, 
              { 
                "attributes": [ 
                  { 
                    "key": "interface_swp10_label", 
                    "value": { 
                      "stringValue": "swp10_label_string" 
                    } 
                  }

显示遥测健康指标

要显示遥测健康信息，请运行 nv show system telemetry health 命令

cumulus@switch:~$ nv show system telemetry health
                                     operational
---------------------------          -----------
service-status    
  nv-telemtry-service                active                      
  platform-stats-service             active
  histogram-export-service           active
  sdk-stats-service                  active
  routing-telemtry-service           inactive
internal-metrics 
  process 
    cpu-seconds                      3020
    memory-rss-kilobytes             182812672
    runtime-heap-alloc-bytes         28617960
    runtime-total-alloc-bytes        915541979208
    runtime-total-sys-memory-bytes   151368752
    uptime-seconds                   65313
[receivers]                          otlp/global
[receivers]                          prometheus/global
processors
  [memory-limiter]                   memory_limiter/1
  [batch]                            batch/1
[exporters]                          otlp/global

Export Destination Status
=======================
    Destination         Connectivity          Export Counter       Drop Counter
    -----------         ------------          --------------       ------------
    11.0.10.2:4317      Pass                  51534586             7087

Cumulus Linux Open Telemetry 还提供由收集器公开的一组内部指标，以监控其性能和行为。这些指标对于了解收集器的健康状况和效率至关重要。

要显示有关遥测健康内部指标的信息，请运行 nv show system telemetry health internal-metrics 命令

cumulus@switch:~$ nv show system telemetry health internal-metrics
                                     operational
------------------------             -----------
process        
  cpu-seconds                        029
  memory-rss-kilobytes               182812672
  runtime-heap-alloc-bytes           28617960
  runtime-total-alloc-bytes          915541979208
  runtime-total-sys-memory-bytes     151368752
  uptime-seconds                     65313
[receivers]                          otlp/global
[receivers]                          prometheus/global
processors
  [memory-limiter]                   memory_limiter/1
  [batch]                            batch/1
[exporters]                          otlp/global

要显示有关遥测健康内部指标进程的信息，请运行 nv show system telemetry health internal-metrics process 命令

cumulus@switch:~$ nv show system telemetry health internal-metrics process
                                   operational
------------------------           -----------
cpu-seconds                        029
memory-rss-kilobytes               182812672
runtime-heap-alloc-bytes           28617960
runtime-total-alloc-bytes          915541979208
runtime-total-sys-memory-bytes     151368752
uptime-seconds                     65313

要显示有关遥测健康内部指标接收器的信息，请运行 nv show system telemetry health internal-metrics receivers 命令

cumulus@switch:~$ nv show system telemetry health internal-metrics receivers
Receivers            Accepted Metric Points      Refused Metric Points
---------            ----------------------      ---------------------
otlp/global          4967144                     0
prometheus/global    46989135                    0

要显示有关遥测健康内部指标处理器器的信息，请运行 nv show system telemetry health internal-metrics processors 命令

cumulus@switch:~$ nv show system telemetry health internal-metrics processors
  Memory-limiter
  ==============
    memory_limiter/1
     Accepted Metric Points: 25002370
     Dropped Metric Points: 0
     Inserted Metric Points: 0
     Refused Metric Points: 0

  Batch Processor
  ===============
    batch/1
     Batch Send Size Bucket 10: 828620
     Batch Send Size Bucket 25: 828620
     Batch Send Size Bucket 50: 828620
     Batch Send Size Bucket 75: 828620
     Batch Send Size Bucket 100: 828620
...

要显示有关遥测健康内部指标导出器的信息，请运行 nv show system telemetry health internal-metrics exporters 命令

cumulus@switch:~$ nv show system telemetry health internal-metrics exporters
Exporters       Enqueue Failed Metric Points   Queue Capacity   Queue Size   Send Failed Metric Points   Sent Metric Points
---------       ----------------------------   --------------   ----------   -------------------------   ------------------
otlp/global     0                              1000             0            7087                        52000844

Open Telemetry 导出

配置 Open Telemetry

接口统计信息

缓冲区统计信息

控制平面统计信息

直方图数据

平台统计信息

路由指标

gRPC OTLP 导出

自定义导出

显示遥测导出配置

静态标签

遥测数据格式

系统信息格式

接口统计信息格式

缓冲区统计信息格式

控制平面统计信息格式

平台统计信息格式

路由指标格式

直方图数据格式

静态标签格式

显示遥测健康指标

产品

解决方案

学习