Skip to content

Linux power supply

THIS MODULE IS OBSOLETE.
USE THE PROC PLUGIN - IT IS MORE EFFICIENT


This module monitors variosu metrics reported by power supply drivers
on Linux. This allows tracking and alerting on things like remaining
battery capacity.

Depending on the uderlying driver, it may provide the following charts
and metrics:

  1. Capacity: The power supply capacity expressed as a percentage.
    * capacity_now

  2. Charge: The charge for the power supply, expressed as microamphours.
    * charge_full_design
    * charge_full
    * charge_now
    * charge_empty
    * charge_empty_design

  3. Energy: The energy for the power supply, expressed as microwatthours.
    * energy_full_design
    * energy_full
    * energy_now
    * energy_empty
    * energy_empty_design

  4. Voltage: The voltage for the power supply, expressed as microvolts.
    * voltage_max_design
    * voltage_max
    * voltage_now
    * voltage_min
    * voltage_min_design

configuration

Sample:

battery:
  supply: 'BAT0'
  charts: 'capacity charge energy voltage'

The supply key specifies the name of the power supply device to monitor.
You can use ls /sys/class/power_supply to get a list of such devices
on your system.

The charts key is a space separated list of which charts to try
to display. It defaults to trying to display everything.

notes

  • Most drivers provide at least the first chart. Battery powered ACPI
    compliant systems (like most laptops) provide all but the third, but do
    not provide all of the metrics for each chart.

  • Current, energy, and voltages are reported with a very high precision
    by the power_supply framework. Usually, this is far higher than the
    actual hardware supports reporting, so expect to see changes in these
    charts jump instead of scaling smoothly.

  • If max or full attribute is defined by the driver, but not a
    corresponding min oremptyattribute, then netdata will still providethe correspondingminorempty`, which will then always read as zero.
    This way, alerts which match on these will still work.