Skip to content

Latest commit

 

History

History
74 lines (55 loc) · 2.36 KB

README.md

File metadata and controls

74 lines (55 loc) · 2.36 KB
Raw

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
  1. Charge: The charge for the power supply, expressed as microamphours.
  • charge_full_design
  • charge_full
  • charge_now
  • charge_empty
  • charge_empty_design
  1. Energy: The energy for the power supply, expressed as microwatthours.
  • energy_full_design
  • energy_full
  • energy_now
  • energy_empty
  • energy_empty_design
  1. 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 or emptyattribute, then netdata will still provide the correspondingminorempty`, which will then always read as zero. This way, alerts which match on these will still work.

analytics