ch row shows a colored bar segment when a system component is active and
thus drawing current from the battery. The chart doesn't show how much battery
is used by the component—only whether the app is active. Charts are organized
by category, showing a bar for each category over time, as displayed on the
_x_ -axis of the chart.

![Example of a Battery Historian
chart](/static/topic/performance/images/batteryhistorian_chart_2x.png)
**Figure 3.** Example of a Battery Historian chart.

  1. Add additional metrics from the drop-down list. 
  2. Hold the pointer over the metric name to see more information about each metric, including a key for the colors used in the chart. 
  3. Hold the pointer over a bar to see more detailed information about that metric and the battery stats at a specific point on the timeline. 

##  Additional Batterystats output

You can view additional information from the ` batterystats.txt ` file in the
stats section after the Battery Historian chart.

![The stats section of Battery
Historian](/static/topic/performance/images/batteryhistorian_additionalstats_2x.png)
**Figure 4.** The stats section of Battery Historian.

The  1  **System Stats** tab includes system-wide statistics, such as cell
signal levels and screen brightness. This information provides an overall
picture of what's happening with the device. This is especially useful to make
sure no external events are affecting your test.

The  2  **App Stats** tab includes information about specific apps. Sort the
list of apps using the  3  **Sort apps by** drop-down list in the **App
Selection** pane. You can select a specific app to view stats for using the  4
apps drop-down list.

Content and code samples on this page are subject to the licenses described in
the [ Content License ](/license) . Java and OpenJDK are trademarks or
registered trademarks of Oracle and/or its affiliates.

Last updated 2024-01-22 UTC.

[{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing
the information I need" },{ "type": "thumb-down", "id":
"tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{
"type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type":
"thumb-down", "id": "samplesCodeIssue", "label":"Samples / code issue" },{
"type": "thumb-down", "id": "otherDown", "label":"Other" }]  [{ "type":
"thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type":
"thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type":
"thumb-up", "id": "otherUp", "label":"Other" }]

  * [ ![X](/_static/android/images/logo-x.svg) X ](//x.com/AndroidDev)

Follow @AndroidDev on X

  * [ ![YouTube](//www.gstatic.com/images/icons/material/product/2x/youtube_48dp.png) YouTube ](//www.youtube.com/user/androiddevelopers)

Check out Android Developers on YouTube

  * [ ![LinkedIn](/_static/android/images/logo-linkedin.svg) LinkedIn ](//www.linkedin.com/showcase/androiddev)

Connect with the Android Developers community on LinkedIn

  * ###  More Android 

    * [ Android ](//www.android.com)
    * [ Android for Enterprise ](//www.android.com/enterprise/)
    * [ Security ](//www.android.com/security-center/)
    * [ Source ](//source.android.com)
    * [ News ](/news)
    * [ Blog ](//android-developers.googleblog.com/)
    * [ Podcasts ](/podcasts)
  * ###  Discover 

    * [ Gaming ](/games)
    * [ Machine Learning ](/ml)
    * [ Privacy ](/privacy)
    * [ 5G ](/training/connectivity/5g)
  * ###  Android Devices 

    * [ Large screens ](/large-screens)
    * [ Wear OS ](/wear)
    * [ ChromeOS devices ](/chrome-os)
    * [ Android for cars ](/cars)
    * [ Android TV ](/tv)
  * ###  Releases 

    * [ Android 14 ](/about/versions/14)
    * [ Android 13 ](/about/versions/13)
    * [ Android 12 ](/about/versions/12)
    * [ Android 11 ](/about/versions/11)
    * [ Android 10 ](/about/versions/10)
    * [ Pie ](/about/versions/pie)
    * [ Oreo ](/about/versions/oreo)
    * [ Nougat ](/about/versions/