UPS Monitor ¶
Continuously tracks UPS battery levels, power status, load conditions and runtime estimates — with automated shutdown procedures to protect VMs and hosts during extended power outages.
Features¶
-
Real-time Status Monitoring
Continuous tracking of voltage, frequency, load percentage and battery levels.
-
Critical Power Alerts
Immediate notifications for power failures, low battery and UPS malfunctions.
-
Runtime Estimation
Calculates remaining backup power time based on current load conditions.
-
Proactive Warnings
Early alerts for UPS maintenance needs and battery degradation indicators.
-
Automatic Shutdown
Graceful shutdown procedures for VMs and hosts during extended power outages, with failover-aware ordering to preserve critical systems longest.
-
SNMP-based Polling
Connects to UPS devices via SNMP with configurable scan schedule. Auto-detection of brand profiles.
-
Notifier Integration
Send alerts via any configured notification channel (Telegram, Slack, email, and more) using the Notifier configuration.
Why¶
Why integrate UPS into cv4pve-admin instead of NUT alone?
Graceful shutdown of VMs, not just hosts
Coordinated shutdown sequence preserves critical VMs longest — the orchestration knows about hosts AND guests, not only the host.
Multi-vendor via SNMP
Auto-detected device profiles cover the major UPS brands — one module for the whole fleet, no per-vendor agent on every PVE node.
Alerts before the silence
Battery low, runtime dropping, hardware fault — surfaced via Notifier on any configured channel before the power actually goes out.
Trends spot a dying battery
Battery health degrades slowly. Charts of runtime/load over time make the "this UPS won't last another outage" call obvious.
Sections¶
- Dashboard — real-time status cards for all monitored UPS devices
- Devices — manage UPS device configurations — add, edit, test connectivity, trigger an on-demand scan
- Trends — historical charts of power metrics over time
Devices¶
Each UPS device is configured with:
| Field | Description |
|---|---|
| Name | Friendly name for the UPS device |
| Host | SNMP hostname or IP address |
| Port | SNMP port (default: 161) |
| Profile | SNMP device profile (auto-detected brand) |
| Location | Physical location label |
| Managed Nodes | Proxmox nodes managed by this UPS (empty = all nodes) |
Per-device actions:
- Scan Now — immediately poll the UPS for current readings
- Test Connection — verify SNMP connectivity to the device