4.8 KiB
DaSiWa System Monitor
A compact, non-intrusive system telemetry bar integrated directly into the ComfyUI top toolbar.
Overview
The System Monitor displays real-time resource utilization in the ComfyUI header area. A DaSiWa settings button sits directly beside the monitor and is the home for settings shared by DaSiWa nodes as they are added.
The current settings are stored in the browser, so they remain active after a ComfyUI page reload:
- Show system monitor: hides or shows the monitor while keeping the settings button available.
- Lite: the default compact fixed-width, color-coded toolbar meters. Each meter shows a label, a numeric value, and a proportional background fill representing 0–100% usage.
- Full: a spacious monitor panel with every available metric, its current value and detail, plus a live graph covering the most recent 60 telemetry samples (normally about one minute).
Display Modes
Lite (default)
Lite keeps the monitor in the toolbar as compact, fixed-width meters. It is intended for continuous at-a-glance monitoring while working in ComfyUI.
Full
Full opens a larger panel directly below the monitor controls. It shows all available CPU, memory, disk, and GPU metrics at once, including each metric's detailed value and a graph of the most recent 60 telemetry samples. The settings button remains available above the panel to switch back to Lite or disable the monitor.
Metrics
| Metric | Description | Color |
|---|---|---|
| CPU | Overall CPU utilization across all threads | Blue (#38bdf8) |
| RAM | Physical memory usage | Purple (#a78bfa) |
| SWAP | Swap space (Linux) or Pagefile (Windows) | Amber (#f59e0b) |
| DISK | Root disk usage | Pink (#fb7185) |
| GPU0 Util | GPU 0 compute utilization | Green (#4ade80) |
| GPU0 VRAM | GPU 0 video memory usage | Cyan (#22d3ee) |
| GPU0 Temp | GPU 0 temperature in °C | Orange (#fb923c) |
Additional GPUs appear as GPU1, GPU2, etc., each with Util, VRAM, and Temp chips.
Tooltips
Hover over any metric chip to see detailed information:
- CPU: Thread count
- RAM/SWAP: Used / Total in human-readable units (MiB/GiB)
- DISK: Mount path, used / total
- GPU: Device ID, name, and exact VRAM used / total
GPU Support
| Platform | Vendor | Detection Method |
|---|---|---|
| Linux | NVIDIA | nvidia-smi query |
| Linux | AMD | rocm-smi JSON output |
| Linux | Intel | DRM/sysfs device tree |
| Windows | NVIDIA | nvidia-smi if available, otherwise CIM Win32_VideoController |
| Windows | AMD | CIM Win32_VideoController fallback |
| Windows | Intel | CIM Win32_VideoController fallback |
When multiple GPUs of the same vendor exist, each receives a sequential index starting at 0. If a specific GPU tool is unavailable, the system gracefully degrades to generic device enumeration.
Responsive Behavior
When toolbar width is insufficient to display all metrics, lower-priority chips are hidden first. The priority order (highest to lowest):
- CPU
- RAM
- GPU metrics (Util, VRAM, Temp per GPU)
- SWAP
- DISK
A ResizeObserver monitors window changes and adjusts visibility dynamically without user interaction. Full mode uses a scrollable panel and collapses to one metric column on narrow screens.
Backend Requirements
- psutil — Cross-platform system metrics (CPU, RAM, swap, disk). Included in project dependencies.
- nvidia-smi — Optional, bundled with NVIDIA drivers.
- rocm-smi — Optional, part of ROCm toolkit for AMD GPUs.
- No additional GPU tools required on Windows beyond standard drivers.
API Endpoints
The backend exposes two REST endpoints for external consumption:
/dasiwa/system-monitor— Full system snapshot (JSON)/dasiwa/system-monitor/gpus— GPU-specific data only (JSON)
Additionally, updates are broadcast via WebSocket event dasiwa.system_monitor approximately once per second.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| Monitor shows "Loading..." | Backend route not registered | Ensure nodes/system_monitor.py is imported in __init__.py |
| No GPU metrics shown | Missing GPU query tool | Verify nvidia-smi --query-gpu=index,name --format=csv runs successfully |
| Swap shows "n/a" | No swap configured | Normal behavior; indicates swap/pagefile is disabled |
| Panel overlaps other toolbar items | Insufficient toolbar width | Lower-priority metrics auto-hide; check browser developer console for errors |
Disabling
Use the settings button next to the monitor and disable Show system monitor. The setting is browser-local and does not stop the lightweight backend telemetry endpoint or WebSocket event; this keeps re-enabling instant without requiring a ComfyUI restart.