| Metric | NUT Var | Unit | Description |
|---|---|---|---|
nut_exporter_info |
Metadata about the exporter. | ||
nut_server_info |
Metadata about the NUT server. | ||
nut_ups_info |
Metadata about the UPS. | ||
nut_info |
Metadata about the NUT server. (Deprecated, use nut_server_info instead.) | ||
nut_ups_status |
ups.status |
UPS status. Check for a specific status with the "status" label. | |
nut_beeper_status |
ups.beeper.status |
If the beeper is enabled. Unknown (0), enabled (1), disabled (2) or muted (3). | |
nut_uptime_seconds |
device.uptime |
seconds |
Device uptime. |
nut_load |
ups.load |
Load. (0-1) | |
nut_temperature_celsius |
ups.temperature |
celsius |
UPS temperature |
nut_battery_charge |
battery.charge |
Battery level. (0-1) | |
nut_battery_charge_low |
battery.charge.low |
Battery level threshold for low state. (0-1) | |
nut_battery_charge_warning |
battery.charge.warning |
Battery level threshold for warning state. (0-1) | |
nut_battery_charge_restart |
battery.charge.restart |
Battery level threshold for restarting after power-off. (0-1) | |
nut_battery_runtime_seconds |
battery.runtime |
seconds |
Battery runtime. |
nut_battery_runtime_low_seconds |
battery.runtime.low |
seconds |
Battery runtime threshold for state low. |
nut_battery_runtime_restart_seconds |
battery.runtime.restart |
seconds |
Battery runtime threshold for restart after power-off. |
nut_delay_shutdown_seconds |
ups.delay.shutdown |
seconds |
Interval to wait after shutdown with delay command. |
nut_delay_start_seconds |
ups.delay.start |
seconds |
Interval to wait before (re)starting the load. |
nut_battery_voltage_volts |
battery.voltage |
volts |
Battery voltage. |
nut_battery_voltage_nominal_volts |
battery.voltage.nominal |
volts |
Battery voltage (nominal). |
nut_battery_voltage_high_volts |
battery.voltage.high |
volts |
Battery voltage for full (charge level calculation). |
nut_battery_voltage_low_volts |
battery.voltage.low |
volts |
Battery voltage for empty (charge level calculation). |
nut_battery_temperature_celsius |
battery.temperature |
celsius |
Battery temperature. |
nut_input_voltage_volts |
input.voltage |
volts |
Input voltage. |
nut_input_voltage_nominal_volts |
input.voltage.nominal |
volts |
Input voltage (nominal). |
nut_input_voltage_minimum_volts |
input.voltage.minimum |
volts |
Input voltage (minimum seen). |
nut_input_voltage_maximum_volts |
input.voltage.maximum |
volts |
Input voltage (maximum seen). |
nut_input_transfer_low_volts |
input.transfer.low |
volts |
Input lower transfer threshold. |
nut_input_transfer_high_volts |
input.transfer.high |
volts |
Input upper transfer threshold. |
nut_input_current_amperes |
input.current |
amperes |
Input current. |
nut_input_current_nominal_amperes |
input.current.nominal |
amperes |
Input current (nominal). |
nut_input_frequency_hertz |
input.frequency |
hertz |
Input frequency. |
nut_input_frequency_nominal_hertz |
input.frequency.nominal |
hertz |
Input frequency (nominal). |
nut_input_frequency_low_hertz |
input.frequency.low |
hertz |
Input frequency (low). |
nut_input_frequency_high_hertz |
input.frequency.high |
hertz |
Input frequency (high). |
nut_output_voltage_volts |
output.voltage |
volts |
Output voltage. |
nut_output_voltage_nominal_volts |
output.voltage.nominal |
volts |
Output voltage (nominal). |
nut_output_current_amperes |
output.current |
amperes |
Output current. |
nut_output_current_nominal_amperes |
output.current.nominal |
amperes |
Output current (nominal). |
nut_output_frequency_hertz |
output.frequency |
hertz |
Output frequency. |
nut_output_frequency_nominal_hertz |
output.frequency.nominal |
hertz |
Output frequency (nominal). |
nut_power_watts |
ups.power |
watts |
Apparent power. |
nut_power_nominal_watts |
ups.power.nominal |
watts |
Apparent power (nominal). |
nut_real_power_watts |
ups.realpower |
watts |
Real power. |
nut_real_power_nominal_watts |
ups.realpower.nominal |
watts |
Real power (nominal). |
nut_status |
ups.status |
UPS status. Unknown (0), on line (1, "OL"), on battery (2, "OB"), or low battery (3, "LB"). (Deprecated, use nut_ups_status instead.) | |
nut_battery_volts |
battery.voltage |
volts |
Battery voltage. (Deprecated, use nut_battery_voltage_volts instead.) |
nut_input_volts |
input.voltage |
volts |
Input voltage. (Deprecated, use nut_input_voltage_volts instead.) |
nut_output_volts |
output.voltage |
volts |
Output voltage. (Deprecated, use nut_output_voltage_volts instead.) |
(Generated by running with PRINT_METRICS_AND_EXIT=true.)
Feel free to suggest adding more metrics (including a printout of what the variable and value looks like for your UPS)!
The nut_ups_status metric family describes a set of statuses, specified in the status label. The meanings of the different statuses is shown below.
| Status | Description |
|---|---|
OL |
Online |
OB |
On battery |
LB |
Low battery (critical) |
CHRG |
Charging |
RB |
Replace battery |
FSD |
Forced shutdown |
BYPASS |
Battery bypass |
SD |
Shutdown |
CP |
Cable power |
BOOST |
Boosted voltage |
OFF |
Off |
Which statuses different UPSes support varies, but OL (online) and OB (on battery) is (almost?) always supported.
To check if a specific UPS is unavailable, use something like: absent(nut_status{job="...", ups="..."})