Files
bottom/docs/content/usage/widgets/gpu-graph.md
T
2026-11-21 10:29:56 +00:00

1.6 KiB

GPU Usage Graph Widget

The GPU usage graph widget displays the per-GPU utilization percentage over time.

A picture of an expanded GPU usage graph widget.

Features

The GPU usage graph shows the current GPU utilization for each GPU as a percentage.

The displayed time range can be adjusted through either the keyboard or mouse.

Key bindings

Note that key bindings are generally case-sensitive.

Binding Action
++plus++ Zoom in on chart (decrease time range)
++minus++ Zoom out on chart (increase time range)
++equal++ Reset zoom

Mouse bindings

Binding Action
++"Scroll"++ Scrolling up or down zooms in or out of the graph respectively

How is GPU information gathered?

How we get GPU data depends on the platform:

  • On Linux:
    • NVIDIA: Using the NVML crate
    • AMD: Manually parsing sysfs
    • Intel: Summing per-process engine usage from /proc/<pid>/fdinfo. Note this only includes processes that bottom has permissions to inspect, so it may miss some processes unless run with elevated privileges (which comes with its own set of risks).
  • On Windows:
    • NVIDIA: Using the NVML crate and sysinfo as a fallback.
    • AMD/Intel: Using sysinfo's GPU API
  • On other platforms, we just use sysinfo's GPU API