Skip to main content

Real-time GPU monitor for NVIDIA DGX Spark and other unified memory (UMA) systems

Project description

sparkstat

Real-time GPU monitoring for NVIDIA DGX Spark and other unified memory (UMA) systems.

sparkstat fills the gap left by nvidia-smi and gpustat on iGPU/UMA machines. On these platforms, nvidia-smi typically reports “Memory-Usage: Not Supported” because iGPUs do not have dedicated framebuffer memory. By combining GPU metrics with /proc/meminfo, sparkstat shows memory that is actually available to GPU workloads.

sparkstat screenshot

Requirements

  • Linux
  • Python 3.9+
  • NVIDIA driver with nvidia-smi

Install

pip install sparkstat
pipx install sparkstat
uv tool install sparkstat
curl -fsSL https://raw.githubusercontent.com/kooyunmo/sparkstat/main/install.sh | sh

Usage

sparkstat           # Single snapshot
sparkstat -i        # Watch mode (3s interval)
sparkstat -i 1      # Watch mode (1s interval)
sparkstat --no-proc # Hide process list

Example output

spark-838f      Fri Apr 10 01:05:26 2026  NVIDIA GB10
═════════════════════════════════════════════════════════
 DGX Spark  ·  121.7GiB Unified Memory (UMA)
───────────────────────────────────────────────────────
 DRAM  [█████░░░░░]  53.8%  65.5GiB / 121.7GiB
 Avail 69.3GiB  (DRAM: 56.2GiB + Swap free: 13.1GiB)
 Swap  [█░░░░░░░░░]  18.1%  2.9GiB / 16.0GiB
───────────────────────────────────────────────────────
 GPU   NVIDIA GB10
 Util  GPU    2%  │  Alloc  51%  │  Temp   46°C
 Pwr     13.2W  │  Clk   2411MHz  │  P-State P0
───────────────────────────────────────────────────────
 Processes  (1 active, 62.2GiB GPU alloc)
     62928  VLLM::EngineCore                62.2GiB
═════════════════════════════════════════════════════════

What it shows

  • DRAM and swap usage
  • Effective available memory for GPU workloads
  • GPU utilization, temperature, power, clock, and P-State
  • Per-process GPU allocation

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sparkstat-0.1.1.tar.gz (7.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sparkstat-0.1.1-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file sparkstat-0.1.1.tar.gz.

File metadata

  • Download URL: sparkstat-0.1.1.tar.gz
  • Upload date:
  • Size: 7.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for sparkstat-0.1.1.tar.gz
Algorithm Hash digest
SHA256 bc1aadf8fa3f572142d93f84c106212eee9b5fc109cd10e9d155e34d8e14d375
MD5 1cd3c12a1671408a66001efefaa4be8d
BLAKE2b-256 e8e1d030f402ce1019b780b5fbe4431aa0b0d2f98e9e23161798aa634a69d1c1

See more details on using hashes here.

Provenance

The following attestation bundles were made for sparkstat-0.1.1.tar.gz:

Publisher: publish.yml on kooyunmo/sparkstat

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sparkstat-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: sparkstat-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 7.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for sparkstat-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0b8ef966507ac7b5adfb5b106582822333929416ed1c1d6f53c5fd7c683e264e
MD5 50dad8379a41ea7c7bf7124682cc51a6
BLAKE2b-256 3cf93e06c150cc3bd3ead4f577bb0b008ab920257d69fd7e12d8ef18c880352d

See more details on using hashes here.

Provenance

The following attestation bundles were made for sparkstat-0.1.1-py3-none-any.whl:

Publisher: publish.yml on kooyunmo/sparkstat

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page