rdmatop 0.1.1

A real-time TUI monitor for RDMA network interfaces
rdmatop-0.1.1 is not a library.
Visit the last successful build: rdmatop-0.1.32

rdmatop

Crates.io License

htop, but for RDMA traffic — a real-time TUI monitor for RDMA network interfaces.

Monitors per-device throughput (Gbps, packets/s, drops), RDMA read/write counters, retransmits, health events, and shows which processes are using each RDMA device — all via RDMA netlink, the same interface used by rdma statistic.

Requirements

  • Linux (netlink-based — macOS/Windows are not supported)
  • RDMA-capable NICs (e.g., Mellanox/NVIDIA ConnectX, AWS EFA)

Installation

cargo install rdmatop

Or build from source:

make         # cargo build
make install # cargo install

Usage

rdmatop

Examples

Use rdmatop to monitor RDMA traffic while running GPU communication benchmarks:

  • NCCL — collective communication
  • NIXL — point-to-point KV cache transfer
  • NVSHMEM — one-sided GPU communication
  • RDMA Statistics — shell-based RDMA stats

How It Works

  1. Device enumeration — RDMA_NLDEV_CMD_GET via netlink to discover all RDMA devices
  2. HW counters — RDMA_NLDEV_CMD_STAT_GET per device/port, same as rdma statistic show
  3. Process detection — RDMA_NLDEV_CMD_RES_QP_GET to map QPs → PIDs, enriched with /proc data
  4. Throughput — Two snapshots per interval, delta / elapsed for rates

License

Apache-2.0