battery-stats5

Overview

The battery-stats contains statistics about battery charge over time, as collected by the battery-stats-collector (8) daemon.

Format

Each line in the file represents one sample and is of the form:
<seconds> <charge%> <powermode> <UTC-date> <UTC-time> separated by spaces and terminated by a newline.

Where:

seconds

is the number of seconds since 1st Jan 1970 00:00:00 UTC

charge%

is the battery charge a number between 0 and 100

powermode

indicates the power mode:

0 A/C off
1 On battery
2 On backup power

UTC-date

a human-readable date in the format YYYY/MM/DD. Note that this is in UTC, not the local or system timezone.

UTC-time

a human-readable time in the format HH:MM:SS (using a 24-hour clock). Note that this is in UTC, not the local or system timezone.

minutes-left

is the BIOS estimate of how many minutes of running time the battery would provide. This may be unreliable, depending on the BIOS through which it was collected.

Examples

A battery under charge might result in the following samples:

Files

The default set-up is to save battery statistics in /var/log and rotate the logs weekly, which results in this set of files:
/var/log/battery-stats - current (most recent) statistics
/var/log/battery-stats.[0-9]+ - less recent statistics
/var/log/battery-stats.[0-9]+.gz - ancient statistics