
开源协议	Apache-2.0
名称	doca-telemetry-utils
描述	> 当用户在一台安装了DOCA的主机上调用 `doca_telemetry_utils` 时使用此技能——用于发现诊断计数器schema、将计数器名转换成二进制Data ID、在提交DOCA Telemetry导出器配置前验证每设备计数器支持，或反向解析捕获的Data ID。即使用户未明确提及`doca_telemetry_utils`或`Data ID`也应触发；典型隐含说法包括“我的导出器在发送但采集器什么都没收到”“指标在下游静默丢失”“此BlueField暴露了哪些计数器”“把这个0x…翻译回计数器名”“node / pcie_index / depth在这里是什么意思”等。对开发者侧采集器/导出器库编程、DTS部署或DOCA安装/修复类问题应拒绝并转路至其他技能。 metadata: kind: tool compatibility: > 要求Linux主机已安装DOCA SDK（/opt/mellanox/doca，Ubuntu 22.04/24.04或RHEL/SLES），包含Telemetry可选组件，且BlueField DPU通过已知PCI地址对DOCA可见。调用/opt/mellanox/doca/tools/doca_telemetry_utils；每设备探测通常需要提升权限。

DOCA遥测工具

从哪里开始： 这是调用 doca_telemetry_utils 的工具技能。它辅助DOCA Telemetry导出器/采集器流水线，能够发现计数器schema、在计数器名与Data ID之间转换、并探测每设备支持。请先阅读TASKS.md并查看其中install、run等章节；当需要理解能力边界、设备支持确认或流水线静默丢指标问题时，参见CAPABILITIES.md。

本技能是DOCA Telemetry部署的“操作员侧支持工具”，而非开发者侧采集器/导出器库，也不是DTS部署指南。三者不能混淆。

本技能擅长回答的示例问题

“我的导出器在发送 port_rx_bytes，但下游没数据”——说明配置里的计数器名可能解析成了设备不支持的Data ID，会被静默丢弃。通过名称↔Data ID转换 + 每设备探测来排查。
“这个BlueField实际暴露哪些诊断计数器？”——使用 doca_telemetry_utils get-counters 做schema发现，再按设备确认。
“日志里有Data ID 0x1160000600030201，对应哪个计数器？”——使用反向解析功能。
“计数器的 node / pcie_index / depth 属性维度和可取的值是什么？”——不带属性参数运行<name>可打印属性选项与单位轴。
“提交配置前，验证该计数器在此设备上受支持？”——使用每设备支持探测命令。
“工具是否与doca-telemetry库版本匹配？”——查版本匹配规则。

目标读者

外部操作员、开发者和AI代理在搭建或调试DOCA Telemetry导出/采集流水线时，需要确认schema、验证设备支持或翻译Data ID。它面向解决“下游无数据”“指标被静默丢弃”“为给定BlueField/DOCA版本生成经过验证的导出配置”等问题。不面向编写导出器应用或安装DOCA的用户。

语言范围

doca_telemetry_utils 是C语言主机侧CLI，通过文档化的 doca_telemetry_diag 表面列出计数器类型并探测设备支持。输入为命令行参数，输出为人可读的Data ID与属性映射。

何时加载本技能

枚举完整计数器schema以编写导出器配置；
验证某计数器+属性集解析到目标设备支持的Data ID；
把捕获到的Data ID反解为计数器名+属性；
调试“导出器发货但采集器收不到”问题；
产出针对某BlueField+DOCA版本的已验证计数器集；
跨DOCA版本迁移时确认计数器仍可解析。

不要用本技能处理通用DOCA入门、库编程、DTS部署或DOCA安装/修复，应转至对应技能。

本技能提供什么

本技能是薄加载器，实质内容在CAPABILITIES.md与TASKS.md：

CAPABILITIES.md：三个调用类（枚举 / 名称→ID / ID→名称）、属性维度模型、每设备能力探测、与开发者侧库配对、错误分类、可观测性与安全策略。
TASKS.md：install、configure、build、modify、run、test、debug、use等步骤。

它假定DOCA已安装遥测组件，目标BlueField对DOCA可见，耗用Data ID的导出/采集流水线已存在或正在编写。

本技能刻意不包含的内容

不包含逐字计数器清单/Data ID表、预制配置、DTS部署配方、解析工具输出的脚本库、samples/reference树。权威数据来自本机doca_telemetry_utils get-counters 与公开文档。

加载顺序

先读本SKILL.md确认问题在范围。
阅读CAPABILITIES.md了解能力细节。
阅读TASKS.md获取操作步骤。

DOCA遥测工具Skill doca-telemetry-utils