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:
- Capacity: The power supply capacity expressed as a percentage.
- capacity_now
- Charge: The charge for the power supply, expressed as microamphours.
- charge_full_design
- charge_full
- charge_now
- charge_empty
- charge_empty_design
- Energy: The energy for the power supply, expressed as microwatthours.
- energy_full_design
- energy_full
- energy_now
- energy_empty
- energy_empty_design
- Voltage: The voltage for the power supply, expressed as microvolts.
- voltage_max_design
- voltage_max
- voltage_now
- voltage_min
- voltage_min_design
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.
-
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
orfull
attribute is defined by the driver, but not a correspondingmin or
emptyattribute, then netdata will still provide the corresponding
minor
empty`, which will then always read as zero. This way, alerts which match on these will still work.