Teddy-Kun / 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, CP_STAT), sensors, fdinfo, and AMDGPU driver.

Usage

cargo run -- [options ..]

Option

USAGE:
    cargo run -- [options ..] or <amdgpu_top> [options ..]

FLAGS:
   -d, --dump
       Dump AMDGPU info (name, clock, chip_class, VRAM, PCI, VBIOS)
   -J
       Output JSON formatted data
   -s <i64>, --ms <i64>
       Refresh period in milliseconds, used for `-J` option
   -p <i32>, --pid <i32>
       Specification of PID, used for `-J` option

OPTIONS:
   -i <u32>
       Select GPU instance

Command

key
g	toggle GRBM
r	toggle GRBM2
c	toggle CP_STAT (Prefetch Parser, Micro Engine, Scratch Memory, ..)
p	toggle PCI
v	toggle VRAM/GTT Usage
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, .AppImage

Build from source

Dependencies:

• libdrm2
• libdrm-amdgpu1

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

Library

• Cursive
• 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.