NAME¶

amdgpu-monitor - continuously update a table with the state of all compatible AMD GPUs

SYNOPSIS¶

amdgpu-monitor [--help | --about]
amdgpu-monitor [--gui] [--no_fan] [--plot] [--ltz] [--sleep N] [--debug] [--pdebug]

CONFIGURATION¶

All amdgpu-utils require that compatible GPU cards and drivers are installed and that the feature to access them is enabled. This can be accomplished by adding amdgpu.ppfeaturemask=0xfffd7fff to the GRUB_CMDLINE_LINUX_DEFAULT value in /etc/default/grub and executing update-grub.

DESCRIPTION¶

amdgpu-monitor will continuously display the current state of all compatible AMD GPUs. The default behavior is to update a text based table in the current window until Ctrl-C is pressed. Command line options can alter this behaviour allowing the use of GUI, modifying update interval, excluding fans, writing to a log, selecting UTC or local time zone, and engaging a graphical display of real-time trends of relevant parameters.

OPTIONS¶

--about

Will display details about amdgpu-monitor.

--gui

The table of relevant parameters will be updated in a Gtk window instead of a text table in the terminal window.

--log

Write all monitor data to a logfile. The real-time display will indicate that logging is enabled and will show the filename used.

--ltz

Use local time zone instead of UTC for displays and logging.

--no_fan

Will exclude fan information from the display. Useful with water cooled GPUs.

--pdebug

Will enable debug output for the amdgpu-plot plotting utility.

--plot

Open and write to, amdgpu-plot, the amdgpu-util plotting utility.

--sleep N

Specifies N, the number of seconds to sleep between updates.

--debug

Will display additional details useful in troubleshooting.

-h, --help

Display help text and exit.

EXAMPLES¶

amdgpu-monitor --sleep 5 --log

Will display a continuously updating table of GPU operating parameters updating with an interval of 5 sec. All parameters will be written to a logfile which will be indicated in the table. The displayed parameters include GPU model, load percentage, power, power cap, energy consumption, temperature, voltage, fan speed, Sclk frequency/p-state, Mclk frequency/pstate, and performance mode. Updating of the table will continue until ctrl-c is pressed.

amdgpu-monitor --gui

Will open a new Gtk window and display basic parameters updated with the default interval.

amdgpu-monitor --plot

Will open 2 new Gtk windows. One will display the basic parameters and the second will display a continuously updating plot of these parameters. It is suggested that this method be used if both displays are desired, instead of executing both amdgpu-monitor and amdgpu-plot as the later will result in twice the reads of GPU data.

FILES¶

/usr/share/misc/pci.ids

The system list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It can be updated with the update-pciids command.

~/.amdgpu-utils/amd_pci_id.txt

A locally updated list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It is preferred to use the system PCI ID file. If this the local file exists, it will be used instead of the system file and can be removed with amdgpu-pciid --remove_local command.

/sys/class/drm/card*/device/pp_od_clk_voltage

Special driver file for each GPU required for amdgpu-utils.

/etc/default/grub

The grub defaults file where amdgpu.ppfeaturemask needs to be set.

BUGS¶

Known to not work well with Fiji ProDuo cards and will issue warning messages for Fiji Nano cards. Please report any additional bugs/issues at https://github.com/Ricks-Lab/amdgpu-utils

SEE ALSO¶

amdgpu-plot(1), amdgpu(4), update-grub(8), update-pciids(8), lspci(8)

AVAILABILITY¶

The amdgpu-monitor command is part of the amdgpu-utils package and is available from https://github.com/Ricks-Lab/amdgpu-utils