doca-collectx-deployment

Deploy and operate CollectX-based DOCA telemetry collectors with provider wiring and exporter configuration.

3.2k|370|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill doca-collectx-deployment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doca-collectx-deployment
Source: https://github.com/NVIDIA/skills/tree/main/skills/doca-collectx-deployment
Command: npx skills add https://github.com/NVIDIA/skills --skill doca-collectx-deployment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Standing up a DOCA telemetry collector involves four easily-confused surfaces — the CollectX collection mechanism, the doca-telemetry reader library, the doca-telemetry-exporter publisher library, and the productized DTS container — and misconfiguring any stage silently drops metrics. This Skill guides agents through deploying, wiring, and debugging a CollectX-based collector on a host or BlueField without inventing provider names, schema fields, flags, or config paths.

Core Features & Use Cases

  • Four-surface decomposition: Separates the clx collection mechanism from the reader library, publisher library, and productized DTS container before any config guidance, routing out-of-scope questions to the correct owner.
  • Pipeline and exporter workflows: Step-by-step verbs (configure, run, test, debug) covering providers/counters, schema, collector daemon, and export backends (Prometheus pull, Fluent Bit push, NetFlow, file/IPC).
  • Layered error taxonomy and safety policy: Six-layer diagnosis ladder (collector won't start through transport failure), gate-before-commit provider probing, and end-to-end smoke testing before declaring deployment.
  • Use Case: An operator's collector daemon runs but their Prometheus consumer shows nothing — the Skill walks the layered ladder (no provider rows, schema mismatch, exporter silent, downstream skew) to isolate the failing layer instead of guessing.

Quick Start

Ask your agent to help you deploy a CollectX-based DOCA telemetry collector on your BlueField and ship counters to a Prometheus endpoint.

Frequently Asked Questions about doca-collectx-deployment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a CollectX telemetry collector on BlueField?

Follow the configure, run, and test workflow: decompose the four telemetry surfaces first, gate provider/counter support against the live device before committing config, pick an export backend, then launch the daemon and run the end-to-end smoke test confirming the consumer receives rows.

What export backends does a DOCA CollectX collector support?

CollectX collectors support Prometheus (pull), Fluent Bit (push), NetFlow (push), and file/IPC (local) export backends. The exact enable flags and config paths come from the live collector config and the public DOCA Telemetry/DTS guides, not from memory.

Why does my DOCA collector run but produce no schema rows?

This is the layer-2 no-provider-rows symptom: the provider is not enabled or the device does not expose the counter under the chosen dimensions. Re-run the per-device support probe before committing the counter to the collector config.

What is the difference between CollectX, doca-telemetry, and DTS?

CollectX (clx) is the collection framework this Skill covers; doca-telemetry is the hardware-counter reader library; doca-telemetry-exporter is the application-side publisher library; DTS is the productized container, which is out of scope and routed to public NVIDIA docs.

Can this skill configure the productized DOCA Telemetry Service container?

No. The productized DTS container — its packaged config schema, built-in providers, kubelet manifest, and NGC image — is externally productized and out of scope. The Skill routes those questions to the public DTS guide on docs.nvidia.com.

Why did my telemetry pipeline go quiet after a config change?

Any edit to providers, schema, cadence, or export backends is a deploy event that re-opens the support gate and requires re-running the five-step end-to-end smoke test. Editing config without re-walking the smoke loop is the canonical silent-failure cause.