This Grafana dashboard visualises live status and performance metrics from the APC Smart-UPS 1500 via apcupsd and Prometheus.
🔋 Battery Charge
- Metric:
apcupsd_battery_charge_percent - Description: Current battery charge percentage (0–100%).
- Interpretation:
- Near 100% when fully charged and running on mains.
- Falls during a power outage if the UPS is supplying load.
⏳ Estimated Runtime
- Metric:
apcupsd_time_left_minutes - Description: Estimated number of minutes remaining on battery at current load.
- Interpretation:
- Updates dynamically depending on power draw.
- Should drop steadily if mains power is lost.
⚡ Battery Voltage (Actual & Nominal)
- Metrics:
apcupsd_battery_voltage(e.g.27.1 V)apcupsd_nominal_battery_voltage(e.g.24.0 V)- Description:
- Actual measured voltage vs. expected design voltage.
- Interpretation:
- Nominal remains constant (UPS specification).
- Actual should stay above nominal under load or drop slowly on battery.
🔌 UPS Status
- Metric:
apcupsd_status - Description: Operational mode of the UPS.
- Values:
1→ONLINE(Running on mains)2→ON BATTERY(Mains failed)0→OTHER/UNKNOWN- Recommendation: Apply value mappings in Grafana for readability.
🔁 Transfer Count
- Metric:
apcupsd_transfer_count - Description: Number of times the UPS has switched from mains to battery.
- Interpretation:
- Should increment only during genuine power interruptions.
- Use to track power quality over time.
🕐 Battery Time Used (Cumulative)
- Metric:
apcupsd_cumulative_battery_time_seconds - Description: Total cumulative time the UPS has operated on battery.
- Interpretation:
- Useful for long-term monitoring and battery wear estimation.
- Can be used to build alerts (e.g. frequent outages or prolonged use).
🧠 Data Collection Details
- Metrics are gathered via:
apcaccess(fromapcupsd)- Exported via textfile collector:
/var/lib/node_exporter/textfile_collector/ups_status.prom - Updated via cron or service using
/usr/local/bin/export-ups-status-prometheus.sh
🔔 Possible Alerts (Optional)
Not set at this time.
- Battery charge <
40% - UPS status =
2(ON BATTERY) for > 60s - Estimated runtime <
10 minutes