DOCA CollectX 遥测部署
部署、运行和排查 CollectX 遥测采集器，确保计数器经导出器送达下游系统。
文档明确限定为只读采集、要求先验证设备支持、禁止臆造配置并将硬件变更路由到安全技能；数据流向和导出后端透明，也未识别凭据需求。因缺少明确的逐步用户确认、权限最小化细节、敏感指标处理和可执行回滚方案，扣分。
SKILL.md、CAPABILITIES.md 和 TASKS.md 具有一致的加载顺序、分层故障分类、前置条件和失败反馈规则。由于仅有静态材料，没有可执行的关键路径测试或真实 CI 覆盖，按静态校准不得超过 10 分，且异常输入和依赖可用性仍依赖现场安装与外部文档，扣分。
受众、触发场景、排除范围、四类 telemetry surface 边界和路由条件描述清楚。因不提供具体配置名称、参数或命令，必须依赖现场 DOCA 安装及公共文档；未提供中文支持或中国大陆网络可达性证据，核心文档依赖 docs.nvidia.com，扣分。
采用 SKILL.md、CAPABILITIES.md、TASKS.md 和 references/details.md 的分层结构，包含依赖、示例问题、限制、相关技能、版本提示和维护归属线索。因作者元数据缺失，skill-card 与 SKILL.md 的许可证表述不完全一致，且缺少明确 changelog 和更新责任/流程，扣分。
能够提供 collector 部署的边界、配置前检查、运行验证、端到端 smoke 和分层调试流程，预期对避免概念混淆有直接价值。因不提供可直接执行的 provider、schema、flag、路径或示例配置，用户仍需大量现场查证，且没有可独立验证的代表性输出，静态评估按上限 7 分并扣分。
证据主要是目标技能目录内的结构化文档、交叉链接和一份 benchmark 报告；报告声称通过评估，但数据集不可用且没有可复现测试材料。具备一定可审计性，但缺少独立复现和多源 corroboration，扣分。
- 不要把本技能用于产品化 DTS 容器、reader/publisher API、DOCA 安装或硬件状态变更；必须先确认目标属于 CollectX 运行时。
- 不要从技能文本记忆 provider、schema、exporter flag 或配置路径；应以目标机 live config、--help 或权威公共文档核对。
- 技能未给出回滚命令或权限模型；执行配置变更前应由操作者确认权限、保存现状并准备可恢复的部署快照。
- 面向中国大陆用户时，应单独验证 docs.nvidia.com 和目标 exporter sink 的网络可达性。
这个 Skill 能做什么，适合哪些场景？
该技能面向已经安装 DOCA 的主机或 NVIDIA BlueField 运维人员，指导其运行自有的 CollectX（clx）遥测采集器。它覆盖提供程序和计数器接入、采集守护进程运行，以及 Prometheus、Fluent Bit、NetFlow、文件或 IPC 导出。技能强调区分 CollectX 采集机制、DOCA Telemetry 读取库、DOCA Telemetry Exporter 发布库和产品化 DTS 容器。具体提供程序名称、模式字段、参数和配置路径必须从实时安装或 NVIDIA 公共文档确认，因此适合需要部署或调试采集链路的用户，不适合安装 DOCA 或操作产品化 DTS 容器。
指导代理确认问题是否属于 CollectX 采集器运行范围；将提供程序和计数器接入采集器形成模式；运行采集守护进程；配置 Prometheus 拉取、Fluent Bit 推送、NetFlow、文件或 IPC 导出；验证计数器是否产生模式行并到达下游；按“守护进程无法启动、无提供程序数据、模式不匹配、导出器静默、下游不一致、传输问题”的层次排查；将读取库、发布库、产品化 DTS、DOCA 安装和硬件状态变更问题转交相应文档或技能。
- 网络运维人员在主机或 BlueField 上部署 CollectX 采集器，并需要把硬件计数器导出到 Prometheus。
- 平台工程师需要将采集器数据推送到 Fluent Bit 或通过 NetFlow、文件、IPC 交给下游系统。
- 运维人员发现采集守护进程已启动，但没有模式行或下游没有指标时进行分层诊断。
- 工程师在提交配置前确认目标设备实际支持某个提供程序或计数器族。
- 用户询问产品化 DOCA Telemetry Service、读取 API 或发布 API 时，需要被路由到对应公共文档或库技能。
这个 Skill 有哪些优点和局限？
- 覆盖从计数器采集到下游导出的完整运行链路。
- 明确区分 CollectX、两个遥测库和产品化 DTS 的边界。
- 包含配置、运行、测试和调试等部署工作流入口。
- 支持 Prometheus、Fluent Bit、NetFlow、文件和 IPC 等导出类别。
- 要求目标主机或 BlueField 已安装并验证 DOCA。
- 不提供具体提供程序名称、模式字段、参数或配置路径。
- 不覆盖 DOCA 安装、读取库和发布库 API，也不覆盖产品化 DTS 容器。
- 来源材料未提供具体命令示例、平台测试结果或独立测试套件信息。
如何安装这个 Skill？
使用 NVIDIA/skills 仓库提供的 skills CLI 安装指定技能：
npx skills add nvidia/skills --skill doca-collectx-deployment --yes
README 未规定其他手动安装步骤。安装后，客户端在下一次加载相关技能时使用它。
如何使用这个 Skill？
先确保主机或 BlueField 已在 /opt/mellanox/doca 提供健康的 DOCA 安装，并且操作者能够运行采集器、访问导出目标和查阅 NVIDIA 公共 DOCA Telemetry/DTS 文档。可向代理提出：“在这台已安装 DOCA 的 BlueField 上部署一个 CollectX 遥测采集器，将计数器通过 Prometheus 导出，并排查为什么下游没有指标。”具体提供程序名、字段、参数和路径应以实时安装和公共文档为准。