DOCA 遥测工具 - NVIDIA 文档

本文档提供有关 doca_telemetry_utils 工具用法的说明。

简介

doca_telemetry_utils 工具可用于显示所有可用计数器，并生成可在其他 DOCA 工具中使用的计数器 ID。

此工具简化了计数器管理，从而更容易识别、配置和验证特定设备的计数器支持。

先决条件

必须在主机上安装 fwctl 驱动程序

操作系统	命令
基于 Deb 的 ¹	搜索软件包复制已复制！ `apt-cache search fwctl` 安装软件包复制已复制！ `sudo apt install <package-name>`
基于 RPM	搜索软件包复制已复制！ `dnf search fwctl` 安装软件包复制已复制！ `sudo dnf install <package-name>`

在 Ubuntu 20.04 上，fwctl 驱动程序在系统启动时不会自动加载。要加载它，请在每次重启后运行命令 modprobe mlx5_fwctl。

安装 DOCA 遥测工具

要安装 doca_telemetry_utils

在基于 deb 的发行版上，运行

复制
已复制！

            
            sudo apt-get install doca-telemetry-utils

在基于 RPM 的发行版上，运行

复制
已复制！

            
            sudo dnf install doca-telemetry-utils

描述

doca_telemetry_utils 工具可以与计数器名称或计数器数据 ID 一起使用。

使用计数器名称

当提供计数器名称时，doca_telemetry_utils 会显示关联的数据 ID 和其他详细信息

以下是使用名为 global_icmc_hit 的计数器运行的示例

复制
已复制！

            
            Data ID: 0x1180000200000000
Name: global_icmc_hit
Unit: ICMC

信息

对于需要参数的计数器，仅使用计数器名称运行该工具会显示所需的选项。

使用 port_rx_bytes 运行

复制
已复制！

            
            [fill_data_id] Per-port counter 0x10200001 (port_rx_bytes) needs exactly 1 argument (local_port), 0 given.

在这种情况下，您必须提供所需的参数并重新运行命令。

指定参数 local_port 的示例

复制
已复制！

            
            Data ID: 0x1020000100000000
Name: port_rx_bytes
Unit: RX_PORT
local_port: 0

使用数据 ID

当提供数据 ID 时，doca_telemetry_utils 会显示计数器名称和其他详细信息

使用数据 ID 0x1180000200000000 运行的示例

复制
已复制！

            
            Data ID: 0x1180000200000000
Name: global_icmc_hit
Unit: ICMC

检查设备上的计数器支持

要检查特定设备是否支持特定计数器，请使用设备的 PCIe 地址。

要检查设备 08:00.0 是否支持 global_icmc_hit 计数器

复制
已复制！

            
            Data ID: 0x1180000200000000
Name: global_icmc_hit
Unit: ICMC
Data ID 0x1180000200000000 is supported on device 08:00.0

执行

要运行 doca_telemetry_utils

复制
已复制！

            
            Usage: doca_telemetry_utils [DOCA Flags] [Program Args]
DOCA Flags:
  -h, --help                 Print a help synopsis
 
Program Args:
	Name to Data ID:
    	    doca_telemetry_utils [<device PCI>] <name> [relevant properties]
    		* To get the options for 'relevant properties' run with 'name' alone.
	Data ID to name:
        	 doca_telemetry_utils [<device PCI>] <DATA_ID>
 
[<device PCI>] - optional argument.
	* If the optional argument <device PCI> is provided, this device will be tested for support of this counter.
	* Run with option 'get-counters' to get all the available names.

示例

名称到数据 ID

复制
已复制！

            
            doca_telemetry_utils port_rx_bytes

名称到具有相关选项的数据 ID

复制
已复制！

            
            doca_telemetry_utils port_rx_bytes 0

名称到具有设备 PCIe 的数据 ID

复制
已复制！

            
            doca_telemetry_utils 08:00.0 port_rx_bytes 0

数据 ID 到名称

复制
已复制！

            
            doca_telemetry_utils 0x1020000100000000

数据 ID 到具有设备 PCIe 的名称

复制
已复制！

            
            doca_telemetry_utils 08:00.0 0x1020000100000000

本页内容