Profilo di utilizzo della batteria con Statistiche statistiche batteria e Storico batteria
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento mostra i passaggi di configurazione di base e il flusso di lavoro per lo strumento Batterystats.
e lo script storico della batteria. Per imparare a utilizzare Battery History per
esamina gli schemi di consumo della batteria; consulta l'articolo Analizzare l'utilizzo della batteria con la batteria
Storico.
Batterystats è uno strumento incluso nel framework Android che raccoglie la batteria
sul tuo dispositivo. Puoi utilizzare adb per eseguire il dump
raccolto i dati della batteria nel computer di sviluppo e creare un report
l'analisi utilizzando Battery Historian. Lo storico della batteria converte il report da
Batterystats in una visualizzazione HTML che puoi visualizzare nel tuo browser.
Le statistiche della batteria e la cronologia della batteria sono utili per:
Mostrandoti dove e come i processi attingono corrente dalla batteria.
Identificare le attività nella tua app che possono essere differite o rimosse per migliorare
della batteria.
di Gemini Advanced.
Installazione storico batteria
Puoi utilizzare Docker per installare Battery History. Per installazione alternativa
tra cui la creazione dall'origine, vedi
README sul
pagina GitHub del progetto. Per eseguire l'installazione con Docker, segui questi passaggi:
Installa Docker seguendo le istruzioni nella
Sito web Docker. Qualsiasi
il tipo di abbonamento funziona,
incluso un abbonamento personale senza costi.
Per confermare che Docker sia installato correttamente, apri la riga di comando e
inserisci questo comando:
docker run hello-world
Se Docker è installato correttamente, viene visualizzato un output simile al seguente:
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
78445dd45222: Pull complete
Digest:
sha256:c5515758d4c5e1e838e9cd307f6c6a0d620b5e07e6f927b07d05f6d12a1ac8d7
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal
Avvia l'app Docker Desktop, che è un frontend GUI per Docker, prima
esegui l'immagine Battery Historian. L'esecuzione di questo comando inizializza
i nostri strumenti. Battery Storico non funziona finché non esegui questa operazione almeno una volta.
Esegui Battery History dalla riga di comando durante la prima esecuzione
nel tempo. L'app Docker Desktop non consente di specificare la porta per eseguire il web
che il server web sia attivato. Puoi eseguire questa operazione solo dalla riga di comando. Tuttavia, dopo aver
il container dalla riga di comando, viene creata una voce
Docker Desktop, quindi puoi avviarlo utilizzando la stessa porta listener
da Docker Desktop.
Esegui l'immagine Battery History utilizzando questo comando:
docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
Battery Historian utilizza la porta di tua scelta, come specificato
port_number.
Vai a Battery Historian nel browser per verificare che sia in esecuzione. La
varia a seconda del sistema operativo:
Per Linux e Mac
Battery Historian è disponibile su
http://localhost:port_number.
Per Windows
Dopo aver avviato Docker, ti viene comunicato l'indirizzo IP della macchina
in uso. Ad esempio, se l'indirizzo IP è 123.456.78.90,
Lo storico è disponibile su
http://123.456.78.90:port_number.
Viene quindi visualizzata la pagina iniziale di Battery Historian, dove è possibile caricare
visualizzare le statistiche sulla batteria.
Figura 1. Pagina iniziale di Batteria
Storico..
Raccogli dati con Batterystats
Per raccogliere dati dal tuo dispositivo usando Batterystats e aprirlo in Batteria
Storico, procedi nel seguente modo:
Collega il dispositivo mobile al computer.
Da una finestra del terminale, arresta il server adb in esecuzione eseguendo
seguente comando:
adb kill-server
Riavvia adb e controlla la presenza di dispositivi connessi eseguendo questo comando
.
adb devices
Elenca il tuo dispositivo, come nell'output di esempio che segue.
Figura 2. L'output di adb devices,
mostra un dispositivo connesso
Se non compare alcun dispositivo, assicurati che lo smartphone sia connesso e USB
debug sia attivato e quindi
arresta e riavvia adb.
Reimposta la raccolta dei dati sulla batteria eseguendo questo comando:
adb shell dumpsys batterystats --reset
Il dispositivo raccoglie sempre statistiche sulla batteria e altre informazioni di debug
in background. La reimpostazione cancella i dati raccolti in precedenza sulla batteria. Se
non vengono reimpostate, l'output può essere molto grande.
Scollega il tuo dispositivo dal computer in modo da disegnare solo
corrente della batteria del dispositivo.
Utilizza la tua app ed esegui le azioni per le quali vuoi raccogliere dati. Per
ad esempio scollegati dalla rete Wi-Fi e invia dati al cloud.
Riconnetti lo smartphone.
Assicurati che il tuo smartphone sia riconosciuto ed esegui questo comando:
adb devices
Esegui il comando seguente per scaricare tutti i dati della batteria. L'operazione può richiedere
nel frattempo.
Il file batterystats.txt viene creato nella directory specificata utilizzando
l'argomento facoltativo del percorso. Se non specifichi un percorso, il file viene
creato nella tua home directory.
Crea un report a partire da dati non elaborati.
Per i dispositivi con Android 7.0 e versioni successive:
adb bugreport [path/]bugreport.zip
Per i dispositivi con Android 6.0 e versioni precedenti:
adb bugreport [path/]bugreport.txt
Il completamento della segnalazione di bug può richiedere diversi minuti. Non scollegare il tuo
dispositivo o annulla il processo fino al suo completamento.
Come nel caso di batterystats.txt, questi file vengono creati nella directory
specifica utilizzando l'argomento facoltativo path. Se
non specificano un percorso, vengono creati nella home directory.
Se non è già in esecuzione, esegui Battery Storico utilizzando quanto segue.
:
docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
Per visualizzare i dati in Cronologia batteria, apri Cronologia batteria nel
del browser. Per Mac e Linux, Battery Historian viene eseguita su
http://localhost:port_number. Per Windows, batteria
Lo storico corre a
http://your_IP_address:port_number.
Fai clic su Sfoglia e scegli il file di segnalazione di bug che hai creato.
Fai clic su Invia. Battery Historian apre un grafico creato da
Dati statistici sulla batteria.
Visualizzare i dati con i grafici Storico della batteria
Il grafico Storico della batteria mostra un grafico degli eventi legati all'energia nel tempo.
Ogni riga mostra un segmento a barre colorate quando un componente del sistema è attivo; pertanto,
assorbindo corrente dalla batteria. Il grafico non mostra il livello di carica della batteria
utilizzato dal componente, solo se l'app è attiva. I grafici sono organizzati per
categoria, mostrando una barra per ogni categoria nel tempo, come visualizzato
x del grafico.
Figura 3. Esempio di storico della batteria
grafico.
Aggiungi altre metriche dall'elenco a discesa.
Tieni il puntatore sopra il nome della metrica per visualizzare ulteriori informazioni su
ogni metrica, inclusa una chiave per i colori utilizzati nel grafico.
Tieni il puntatore sopra una barra per visualizzare informazioni più dettagliate al riguardo.
e le statistiche della batteria in un punto specifico della sequenza temporale.
Output aggiuntivo Batterystats
Puoi visualizzare ulteriori informazioni dal file batterystats.txt nel
statistiche dopo il grafico Storico della batteria.
Figura 4. Sezione delle statistiche della batteria
Storico.
La scheda 1Statistiche di sistema include l'intero sistema
quali i livelli del segnale della cella e la luminosità dello schermo. Queste informazioni
offre un quadro generale di ciò che accade con il dispositivo. Questo è
particolarmente utile per assicurarsi che nessun evento esterno influenzi il test.
La scheda 2Statistiche per app include informazioni su
app specifiche. Ordina l'elenco delle app usando il 3
Elenco a discesa Ordina le app per nel riquadro Selezione app. Tu
puoi selezionare un'app specifica per visualizzare le statistiche relative all'utilizzo
Elenco a discesa 4 app.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# Profile battery usage with Batterystats and Battery Historian\n\n| **Warning:** Battery Historian is no longer actively maintained; if possible, consider using [system tracing](/topic/performance/tracing), the [Macrobenchmark power metric](/topic/performance/benchmarking/macrobenchmark-metrics#power), or the [Power Profiler](/studio/profile/power-profiler) to get insights into battery performance.\n\nThis document shows the basic setup steps and workflow for the Batterystats tool\nand the Battery Historian script. To learn how to use Battery Historian to\ninspect battery consumption patterns, see [Analyze power use with Battery\nHistorian](/topic/performance/power/battery-historian).\n\nBatterystats is a tool included in the Android framework that collects battery\ndata on your device. You can use [`adb`](/studio/command-line/adb) to dump the\ncollected battery data to your development machine and create a report you can\nanalyze using Battery Historian. Battery Historian converts the report from\nBatterystats into an HTML visualization that you can view in your browser.\n\nBatterystats and Battery Historian are useful for the following:\n\n- Showing you where and how processes are drawing current from the battery.\n- Identifying tasks in your app that can be deferred or removed to improve battery life.\n\n| **Note:** To use Batterystats and Battery Historian, you need a mobile device with [USB debugging](/studio/debug/dev-options) enabled.\n\nInstall Battery Historian\n-------------------------\n\nYou can use Docker to install Battery Historian. For alternative installation\nmethods, including building from source, see the\n[README](https://github.com/google/battery-historian) on the\nproject's GitHub page. To install using Docker, do the following:\n\n1. Install Docker by following the instructions on the\n [Docker website](https://docs.docker.com/desktop). Any\n [subscription](https://docker.com/pricing) type works,\n including a free Personal subscription.\n\n2. To confirm Docker is correctly installed, open the command line and\n enter the following command:\n\n docker run hello-world\n\n If Docker is correctly installed, it displays an output like this: \n\n Unable to find image 'hello-world:latest' locally\n latest: Pulling from library/hello-world\n 78445dd45222: Pull complete\n Digest:\n sha256:c5515758d4c5e1e838e9cd307f6c6a0d620b5e07e6f927b07d05f6d12a1ac8d7\n Status: Downloaded newer image for hello-world:latest\n\n Hello from Docker!\n This message shows that your installation appears to be working correctly.\n\n To generate this message, Docker took the following steps:\n 1. The Docker client contacted the Docker daemon.\n 2. The Docker daemon pulled the \"hello-world\" image from the Docker Hub.\n 3. The Docker daemon created a new container from that image which runs the\n executable that produces the output you are currently reading.\n 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal\n\n3. Launch the Docker Desktop app---which is a GUI frontend for Docker---before\n you run the Battery Historian image. Running this initializes the Docker\n tools. Battery Historian doesn't run until you do this at least once.\n\n4. Run Battery Historian from the command line when running it for the first\n time. The Docker Desktop app doesn't let you specify the port to run the web\n server on. You can only do this from the command line. However, after you\n successfully run the container from the command line, an entry is created in\n Docker Desktop, and then you can launch it using the same listener port\n from Docker Desktop.\n\n5. Run the Battery Historian image using the following command:\n\n ```\n docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999\n ```\n\n Battery Historian uses the port of your choice, as specified using\n \u003cvar translate=\"no\"\u003eport_number\u003c/var\u003e.\n | **Note:** If you're using a Windows machine, you might need to enable virtualization in your BIOS. Check the documentation for your motherboard for more information about how to enable virtualization. If you can run the [Android Emulator](/studio/run/emulator), then virtualization is already enabled.\n6. Navigate to Battery Historian in your browser to confirm it's running. The\n address varies depending on your operating system:\n\n For Linux and Mac\n : Battery Historian is available at\n `http://localhost:`\u003cvar translate=\"no\"\u003eport_number\u003c/var\u003e.\n\n For Windows\n : After you start Docker, it tells you the IP address of the machine it\n is using. For example, if the IP address is 123.456.78.90, Battery\n Historian is available at\n `http://123.456.78.90:`\u003cvar translate=\"no\"\u003eport_number\u003c/var\u003e.\n\n \u003cbr /\u003e\n\n It then displays the Battery Historian start page, where you can upload and\n view battery statistics.\n **Figure 1.** The start page for Battery Historian.\n\nGather data with Batterystats\n-----------------------------\n\nTo collect data from your device using Batterystats and open it in Battery\nHistorian, do the following:\n\n1. Connect your mobile device to your computer.\n\n2. From a Terminal window, shut down your running `adb` server by running the\n following command:\n\n adb kill-server\n\n3. Restart `adb` and check for connected devices by running the following\n command.\n\n adb devices\n\n It lists your device, similar to the following example output.\n **Figure 2.** The output of `adb devices`, showing one connected device\n\n If it doesn't list any devices, make sure your phone is connected and [USB\n debugging](/studio/debug/dev-options#Enable-debugging) is enabled, and then\n stop and restart `adb`.\n4. Reset battery data gathering by running the following command:\n\n adb shell dumpsys batterystats --reset\n\n The device is always collecting Batterystats and other debugging information\n in the background. Resetting erases previous battery collection data. If you\n don't reset, the output can be very large.\n5. Disconnect your device from your computer so that you are only drawing\n current from the device's battery.\n\n6. Use your app and perform actions for which you want to collect data for. For\n example, disconnect from Wi-Fi and send data to the cloud.\n\n7. Reconnect your phone.\n\n8. Make sure your phone is recognized and run the following command:\n\n adb devices\n\n9. Dump all battery data by running the following command. This can take a\n while.\n\n ```\n adb shell dumpsys batterystats \u003e [path/]batterystats.txt\n ```\n\n The `batterystats.txt` file is created in the directory you specify using\n the optional path argument. If you don't specify a path, the file is\n created in your home directory.\n10. Create a report from raw data.\n\n For devices running Android 7.0 and higher:\n :\n\n ```\n adb bugreport [path/]bugreport.zip\n ```\n\n For devices running Android 6.0 and lower:\n :\n\n ```\n adb bugreport [path/]bugreport.txt\n ```\n\n \u003cbr /\u003e\n\n Bugreport can take several minutes to complete. Don't disconnect your\n device or cancel the process until it's complete.\n\n As with `batterystats.txt`, these files are created in the directory you\n specify using the optional \u003cvar translate=\"no\"\u003epath\u003c/var\u003e argument. If you\n don't specify a path, they are created in your home directory.\n\n If it's not already running, run Battery Historian using the following\n command: \n\n ```\n docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999\n ```\n11. To view your data in Battery Historian, open the Battery Historian in your\n browser. For Mac and Linux, Battery Historian runs at\n `http://localhost:`\u003cvar translate=\"no\"\u003eport_number\u003c/var\u003e. For Windows, Battery\n Historian runs at\n `http://`\u003cvar translate=\"no\"\u003eyour_IP_address\u003c/var\u003e`:`\u003cvar translate=\"no\"\u003eport_number\u003c/var\u003e.\n\n12. Click **Browse** and then choose the bugreport file you created.\n\n13. Click **Submit**. Battery Historian opens a chart created from your\n Batterystats data.\n\nView data with Battery Historian charts\n---------------------------------------\n\nThe Battery Historian chart graphs power-relevant events over time.\n\nEach row shows a colored bar segment when a system component is active and thus\ndrawing current from the battery. The chart doesn't show how much battery is\nused by the component---only whether the app is active. Charts are organized by\ncategory, showing a bar for each category over time, as displayed on the\n*x*-axis of the chart.\n**Figure 3.** Example of a Battery Historian chart.\n\n1. Add additional metrics from the drop-down list.\n2. Hold the pointer over the metric name to see more information about each metric, including a key for the colors used in the chart.\n3. 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.\n\nAdditional Batterystats output\n------------------------------\n\nYou can view additional information from the `batterystats.txt` file in the\nstats section after the Battery Historian chart.\n**Figure 4.** The stats section of Battery Historian.\n\nThe 1 **System Stats** tab includes system-wide\nstatistics, such as cell signal levels and screen brightness. This information\nprovides an overall picture of what's happening with the device. This is\nespecially useful to make sure no external events are affecting your test.\n\nThe 2 **App Stats** tab includes information about\nspecific apps. Sort the list of apps using the 3\n**Sort apps by** drop-down list in the **App Selection** pane. You\ncan select a specific app to view stats for using the\n4 apps drop-down list."]]
