Power Status Reference

All parameters, thresholds, and configuration options for the Power Status check in octoja.

Written By Erdinc Akay

Last updated About 2 months ago

Power Status Reference

The Power Status check monitors the device's power source and battery level, alerting on low battery or loss of mains power.

Configuration fields

FieldTypeRequiredDefaultDescription
Warn on battery powerBooleanNoYesRaise a warning when the device is running on battery power (raises at most a Warning, never a Critical result)
Warning battery level (%)Number (%)No30Battery charge at or below this value triggers a warning
Critical battery level (%)Number (%)No10Battery charge at or below this value triggers a critical result
Warning battery health (%)Number (%)No80Battery health at or below this value triggers a warning
Critical battery health (%)Number (%)No50Battery health at or below this value triggers a critical result

In the check editor, the battery level fields appear under the Battery Thresholds header and the battery health fields under the Battery Health header.

Collected metrics

  • Power source (AC / Battery / Unknown)
  • Battery level (%)
  • Battery health (%)
  • Battery name
  • Estimated runtime (minutes, if available)

Platform support

PlatformSupported
WindowsYes
LinuxYes
macOSYes

Notes

  • Battery monitoring requires a battery the operating system reports as such (laptop batteries; on Linux, a device the kernel exposes under /sys/class/power_supply with type=Battery). Devices with type=UPS are not monitored for charge or health — a UPS-type supply only causes the reported power source to be AC.
  • Devices without a battery report "No battery detected — running on AC power." and return an OK result.
  • If a warning threshold is set lower than its critical threshold, the check silently swaps the two values at runtime.
  • The check runs every 5 minutes by default.

See also: Configure a Power Status Check