gpustat(1)
Display GPU utilization and memory usage for NVIDIA GPUs in a formatted table.
Synopsis
gpustat [OPTION]... [--watch | --json]Description
gpustat monitors NVIDIA GPU status including utilization percentage, memory consumption, temperature, and running processes. It provides a quick overview similar to nvidia-smi but with a cleaner, more readable output format.
The tool displays real-time GPU metrics in a table format, showing per-GPU stats and the processes running on each GPU. It requires NVIDIA drivers and the NVIDIA Management Library (NVML) to be installed.
Common options
| Flag | What it does |
|---|---|
--watch | Refresh display every second (continuous monitoring mode) |
--watch-color | Use colors in watch mode for better readability |
--json | Output data in JSON format instead of formatted table |
-c, --no-color | Disable colored output |
-p, --show-pid | Show process IDs (PIDs) of GPU processes |
-a, --show-all-processes | Show all GPU processes instead of just the top ones |
-n, --new-format | Use new output format with enhanced layout |
-i GPUS, --gpuids GPUS | Specify which GPUs to monitor (comma-separated list) |
--no-header | Hide column headers from output |
-u, --unit | Specify memory unit (MB or GB) |
Examples
Show current GPU status once with a clean formatted table
gpustatContinuously monitor GPU status, updating every second (press Ctrl+C to exit)
gpustat --watchMonitor GPUs in watch mode with color-coded output for better visibility
gpustat --watch-colorOutput GPU statistics in JSON format for parsing by scripts or tools
gpustat --jsonDisplay GPU status with process IDs of running GPU-accelerated applications
gpustat -pShow status only for GPUs 0 and 1 (useful on systems with many GPUs)
gpustat -i 0,1Log GPU status without color codes to a file for archival or analysis
gpustat --no-color | tee gpu_log.txtMonitor GPU status every 2 seconds using the watch command without header repetition
watch -n 2 gpustat --no-header