UPS Monitor ¶
Continuously tracks UPS battery levels, power status, load conditions and runtime estimates — with alerts when the UPS runs on battery or its charge or runtime drops below the configured thresholds.
Features¶
-
Real-time Status Monitoring
Continuous tracking of battery charge and voltage, input/output voltage, load percentage, temperature and power source.
-
Critical Power Alerts
Notifications when the UPS switches to battery, the battery charge falls below the low or shutdown threshold, or the estimated runtime drops below the configured minutes.
-
Runtime Estimation
Reads the UPS's own runtime estimate and alerts when it falls below the configured threshold.
-
SNMP-based Polling
Connects to UPS devices via SNMP v2c 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?
Every reading kept
Each scan stores status, battery, voltages, load, temperature and runtime — expand a device to see its reading history, retained for Max Days Logs.
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
On battery, battery low, runtime dropping — surfaced via Notifier on any configured channel before the power actually goes out.
Trends spot a dying battery
Battery health degrades slowly. Charts of battery charge, load, input voltage and temperature 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 |
|---|---|
| Enabled | Include the device in the scheduled scan (default: on) |
| Name | Friendly name for the UPS device |
| Host | IP address of the UPS SNMP agent |
| Port | SNMP port (default: 161) |
| Community | SNMP v2c community string (default: public) |
| Profile | SNMP device profile (auto = detect the brand from the device, or pick one explicitly) |
| Location | Physical location label |
| Description | Free-text notes |
| Managed Nodes | Proxmox nodes powered by this UPS (empty = all nodes) — informational |
| Identification | Manufacturer, Model, Firmware Version, Serial Number — filled from the device with Retrieve Info |
Per-device actions:
- Scan Now — immediately poll the UPS for current readings
- Test Connection — verify SNMP connectivity to the device