Quackdoc / amdgpu_top

Tool to display AMDGPU usage

AMDGPU_TOP

amdgpu_top is tool that display AMD GPU utilization, like umr or clbr/radeontop or intel_gpu_top.
The tool displays information gathered from performance counters (GRBM, GRBM2), sensors, fdinfo, and AMDGPU driver.

Simple TUI (like nvidia-smi, rocm-smi)	TUI	GUI

Usage

cargo run -- [options ..]

Option

FLAGS:
   -d, --dump
       Dump AMDGPU info (Specifications, VRAM, PCI, ResizableBAR, VBIOS, Video caps)
   --list
       Display a list of AMDGPU devices (can be combined with "-d" option)
   -J, --json
       Output JSON formatted data
   --gui
       Launch GUI mode
   --smi
       Launch Simple TUI mode (like nvidia-smi, rocm-smi)
   -h, --help
       Print help information

OPTIONS:
   -i <u32>
       Select GPU instance
   --pci <String>
       Specifying PCI path (domain:bus:dev.func)
   -u <u64>, --update-process-index <u64>
       Update interval in seconds of the process index for fdinfo (default: 5s)

Commands for TUI

key
f	toggle fdinfo
n	toggle Sensors
m	toggle GPU Metrics
h	change update interval (high = 100ms, low = 1000ms)
q	Quit
P	sort fdinfo by pid
M	sort fdinfo by VRAM usage
G	sort fdinfo by GFX usage
M	sort fdinfo by MediaEngine usage
R	reverse sort

Installation

Packages

• Releases
  • .deb (generated by cargo-deb)
  • .AppImage (generated by cargo-appimage)
• AUR
• OpenMandriva to install run sudo dnf install amdgpu_top
• Nix

Build from source

Dependencies:

• libdrm2
• libdrm-amdgpu1

git clone https://github.com/Umio-Yasuno/amdgpu_top
cd amdgpu_top
cargo install --locked --path .

without GUI

cargo install --locked --path . --no-default-features --features="tui"

Used library

• Cursive
• egui
• libdrm-amdgpu-sys-rs

Reference

• Tom St Denis / umr · GitLab
• Mesa3D
  • src/gallium/drivers/radeonsi/si_gpu_load.c · main · Mesa / mesa · GitLab
• AMD Documentation
  • R6xx_R7xx_3D.pdf
  • CIK_3D_registers_v2.pdf
  • MI200 Performance Counters: Listing
  • MI200 Performance Counters: Abbreviations
• https://github.com/AMDResearch/omniperf/tree/v1.0.4/src/perfmon_pub
• https://github.com/freedesktop/mesa-r600_demo
• radeonhd:r6xxErrata
• Linux Kernel AMDGPU Driver
  • libdrm_amdgpu API
    • /drivers/gpu/drm/amd/amdgpu/amdgpu_kms.c
  • amdgpu_allowed_register_entry
    • /drivers/gpu/drm/amd/amdgpu/{cik,nv,vi,si,soc15,soc21}.c

Alternatives

If amdgpu_top is not enough for you or you don't like it, try the following applications.

• clbr/radeontop
  • View your GPU utilization, both for the total activity percent and individual blocks.
• Syllo/nvtop
  • GPUs process monitoring for AMD, Intel and NVIDIA
• Tom St Denis / umr · GitLab
  • User Mode Register Debugger for AMDGPU Hardware
• GPUOpen-Tools/radeon_gpu_profiler
  • for developer
  • Radeon GPU Profiler (RGP) is a tool from AMD that allows for deep inspection of GPU workloads.