--- name: "battery-stats" section: "5" platform: "linux" package: "battery-stats" version: "0.5.6-2.1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/battery-stats" --- # battery-stats(5) collected battery statistics ## NAME battery-stats - collected battery statistics ## DESCRIPTION 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:\ \ \ \ \ \ 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. ## EXAMPLE A battery under charge might result in the following samples: 1032651245 27 1 2002/09/21 23:34:05 94\ 1032651275 28 1 2002/09/21 23:34:35 97\ 1032651305 29 1 2002/09/21 23:35:05 100\ 1032651335 30 1 2002/09/21 23:35:35 103\ 1032651365 30 1 2002/09/21 23:36:05 106 ## 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 ## SEE ALSO [**battery-graph**(1)](/battery-graph/1.md), [**battery-stats-collector**(8)](/battery-stats-collector/8.md). ## AUTHOR Karl E. Jorgensen \