proxmox-monitor/backlog.md

Feature Backlog — proxmox-monitor

Completed

Power Control

• Start/stop/restart buttons per row on VMs and LXCs.
• Power action uses /api2/extjs endpoint with empty body {}.
• Instant UI refresh via direct state sync + rAF flush for status messages.
• Status: done (merged to main)

Console Link

• Console button per row opens Proxmox web UI console in new tab.
• URL format: /?console=lxc|qemu&vmid={id}&node={node}&resize=scale&xtermjs=1
• Browser session cookies handle Proxmox auth automatically in new tab.
• Status: done (merged to main)

Manual Refresh

• Button in dashboard header that calls mutate() on all SWR caches
• Status: done (merged to main)

Custom Poll Interval

• Number input in header (milliseconds) that updates polling in real-time.
• Replaced SWR polling with a manual setInterval effect.
• Status: done (merged to main)

Quick Wins (low effort, high value)

Group by Node

• Collapse/expand VMs/LXCs by node with toggle

Uptime Duration

• Format uptime seconds to "3d 4h 12m" via formatUptime() helper
• Note: node card already shows uptime as raw seconds

Search / Filter

• Client-side text input filtering table rows by name/node/status
• Note: VMList and LXCList have consoleUrl type defs ready for filtering

Medium Effort

Storage Usage

• Show disk usage per Proxmox storage backend (like node cards)
• Note: disk.total is not populated in the API (always 0) — needs pvesh or extra API calls

Status Change Alert

• Toast/banner when a VM state changes between polls

Resource Allocation

• Show vCPU count, total disk size alongside usage stats
• Note: disk.total is not populated by Proxmox API — only disk.used is available

Per-VM IP Addresses

• Fetch guest network IP addresses (extra API call needed)

Per-VM CPU/Memory Trend

• Periodic polling to build a small trend chart

Larger Features

Cluster Status

• HA, quorum, and failover info per cluster

Network Health

• Network interfaces and link status per node

Recent Proxmox Events

• Audit log / recent events from the Proxmox cluster

Docker Deployment

• Dockerfile + docker-compose for easy hosting

Health Check Endpoint

• /api/health for reverse proxy / uptime monitoring