hw.acpi.battery
Plugin: freebsd.plugin Module: hw.acpi.battery
Overview
Read the remaining battery capacity that the ACPI battery driver reports for all batteries combined.
The plugin reads the hw.acpi.battery.units and hw.acpi.battery.life sysctls. When the host has several batteries, the kernel combines them into one capacity percentage.
This collector is supported on all platforms.
This collector only supports collecting metrics from a single instance of this integration.
Default Behavior
Auto-Detection
The module stops on hosts without the ACPI battery driver, where the hw.acpi.battery sysctls do not exist. When the driver reports no batteries, the chart is removed; when it cannot read a valid capacity, the chart shows a gap.
Performance Impact
The default configuration for this integration is not expected to impose a significant performance impact on the system.
Setup
Prerequisites
No action required.
Configuration
Options
Config options
| Option | Description | Default | Required |
|---|---|---|---|
| hw.acpi.battery | Enable or disable the battery capacity metric. | yes | no |
via File
The configuration file name for this integration is netdata.conf.
Configuration for this specific integration is located in the [plugin:freebsd] section within that file.
The file format is a modified INI syntax. The general structure is:
[section1]
option1 = some value
option2 = some other value
[section2]
option3 = some third value
You can edit the configuration file using the edit-config script from the
Netdata config directory.
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config netdata.conf
Examples
There are no configuration examples.
Alerts
The following alerts are available:
| Alert name | On metric | Description |
|---|---|---|
| power_supply_capacity | powersupply.capacity | Percentage of remaining power supply capacity |
Metrics
Metrics grouped by scope.
The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.
Per power device
All ACPI batteries combined into one device.
Labels:
| Label | Description |
|---|---|
| device | Always acpi_battery, because the kernel combines every battery into one reading. |
Metrics:
| Metric | Description | Dimensions | Unit |
|---|---|---|---|
| powersupply.capacity | Battery Capacity | capacity | percentage |
Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.