NAME¶

gpu-plot - continuously update and plot critical GPU parameters as a function of time

SYNOPSIS¶

gpu-plot [--help | --about]
gpu-plot [--no_fan] [--stdin] [--simlog] [--ltz] [--sleep N] [--debug]

CONFIGURATION¶

In order to get maximum capability of these utilities, you should be running with a kernel that provides support of the GPUs you have installed. If using AMD GPUs, installing the latest amdgpu driver package or the latest ROCm release, may provide additional capabilities. If you have Nvidia GPUs installed, nvidia-smi must also be installed in order for the utility reading of the cards to be possible. Writing to GPUs is currently only possible for AMD GPUs, and only with compatible cards and with the the AMD ppfeaturemask set to 0xfffd7fff. This can be accomplished by adding amdgpu.ppfeaturemask=0xfffd7fff to the GRUB_CMDLINE_LINUX_DEFAULT value in /etc/default/grub and executing sudo update-grub.

DESCRIPTION¶

gpu-plot will continuously plot a trend of critical GPU parameters for all compatible GPUs.

OPTIONS¶

--about

Will display details about gpu-plot.

--ltz

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

--no_fan

Will exclude fan information from the display. Useful with watercooled GPUs.

--stdin

Will read data from stdin. This is useful to display plots of a logfile save with gpu-mon.

--simlog

When used with the --stdin option, it will simulate the reading of data from the logfile at a rate define by --sleep.

--sleep N

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

--debug

Will output additional useful debug/troubleshooting details to a log file.

-h, --help

Display help text and exit.

EXAMPLES¶

gpu-plot --sleep 5 --ltz

Will open a Gtk window that will display plots of operation parameters for all compatible GPU's that updates every 5s. Time stamps displayed will use local time zone.

cat logfile | gpu-plot --stdin --simlog --sleep 1

Will open a Gtk window that will display plots of the GPU operation data in the specified logfile to simulate streamed data with a 1 sec interval.

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.

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

Special driver file for each AMD GPU required for some rickslab-gpu-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¶

cat(1), gpu-mon(1) amdgpu(4), nvidia-smi(1), update-grub(8), update-pciids(8), lspci(8)

AVAILABILITY¶

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