Check sensors-battery

Overview

Reports battery status information including charge percentage, time remaining, and power source (AC or battery). Returns OK if no battery is installed or if metrics cannot be determined.

Important Notes:

  • Run sensors-detect --auto beforehand to scan the system for hardware monitoring chips supported by libsensors / lm_sensors

Data Collection:

  • Uses psutil.sensors_battery() to read battery charge percentage, time remaining, and power plug status

Fact Sheet

Fact

Value

Check Plugin Download

https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/sensors-battery

Nagios/Icinga Check Name

check_sensors_battery

Check Interval Recommendation

Every minute

Can be called without parameters

Yes

Runs on

Cross-platform

Compiled for Windows

No

3rd Party Python modules

psutil

Help

usage: sensors-battery [-h] [-V] [--always-ok] [-c CRIT] [--test TEST]
                       [-w WARN]

Reports battery status information including charge percentage, time
remaining, and power source (AC or battery). Returns OK if no battery is
installed or if metrics cannot be determined.

options:
  -h, --help           show this help message and exit
  -V, --version        show program's version number and exit
  --always-ok          Always returns OK.
  -c, --critical CRIT  CRIT threshold for battery power left, in percent.
                       Default: 5
  --test TEST          For unit tests. Needs "path-to-stdout-file,path-to-
                       stderr-file,expected-retc".
  -w, --warning WARN   WARN threshold for battery power left, in percent.
                       Default: 20

Usage Examples

./sensors-battery --warning 20 --critical 5

Output:

94.13%, 4h 40m left (not plugged in and discharging)

States

  • OK if battery power is above the warning threshold or if the battery is plugged in.

  • OK if no battery is installed.

  • WARN if battery power left is at or below --warning (default: 20%).

  • CRIT if battery power left is at or below --critical (default: 5%).

  • UNKNOWN if the platform is not supported by psutil.

  • --always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics

Name

Type

Description

battery_percent

Percentage

Battery charge level.

battery_secsleft

Seconds

Estimated time remaining on battery.

Troubleshooting

Python module "psutil" is not installed.
Install psutil: pip install psutil or dnf install python3-psutil.

Credits, License