Membuat profil penggunaan baterai dengan Batterystats dan Battery Historian

Panduan ini menunjukkan langkah-langkah penyiapan dasar dan alur kerja untuk alat Batterystats dan skrip Battery Historian. Untuk mempelajari cara menggunakan Battery Historian untuk memeriksa pola penggunaan baterai, baca Menganalisis penggunaan daya dengan Battery Historian.

Batterystats adalah alat yang disertakan dalam framework Android yang mengumpulkan data baterai di perangkat. Anda dapat menggunakan adb untuk menghapus data baterai yang dikumpulkan ke mesin pengembangan dan membuat laporan yang dapat dianalisis menggunakan Battery Historian. Battery Historian mengonversi laporan dari Batterystats menjadi visualisasi dalam bentuk HTML yang dapat Anda lihat di browser.

Efektif untuk:

• Menunjukkan cara proses menggunakan daya dari baterai dan juga tempat berlangsungnya proses tersebut.
• Mengidentifikasi tugas di aplikasi Anda yang dapat ditangguhkan atau bahkan dihapus untuk meningkatkan masa pakai baterai.

Menginstal Battery Historian

Cara termudah untuk menginstal Battery Historian adalah dengan menggunakan Docker. Untuk metode penginstalan alternatif, termasuk mem-build dari sumber, lihat Read Me pada halaman GitHub project. Untuk menginstal menggunakan Docker, lakukan hal berikut:

1. Instal Docker Community Edition dengan mengikuti petunjuk di situs Docker.

2. Untuk mengonfirmasi Docker telah terinstal dengan benar, buka command line dan masukkan perintah berikut:

   docker run hello-world
   

   Jika Docker sudah terinstal dengan benar, Anda akan melihat output seperti ini:

   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
   

3. Jalankan image Battery Historian menggunakan perintah berikut:

   docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.0 --port 9999
   

   Battery Historian akan menggunakan port yang Anda pilih, seperti yang ditentukan menggunakan port_number.

4. Buka Battery Historian di browser Anda untuk memastikannya berjalan. Alamat dapat bervariasi tergantung sistem operasi Anda:

   Untuk Linux dan Mac

   Battery Historian tersedia di http://localhost:port_number.

   Untuk Windows

   Docker akan memberi tahu alamat IP dari mesin yang digunakannya segera setelah aplikasi tersebut Anda mulai. Jadi, misalnya, jika alamat IP adalah 123.456.78.90, Battery Historian tersedia di http://123.456.78.90:port_number

   Anda akan melihat halaman awal Battery Historian, tempat Anda dapat mengupload dan melihat statistik baterai.

   

Mengumpulkan data dengan Batterystats

Untuk mengumpulkan data dari perangkat menggunakan Batterystats dan membukanya di Battery Historian, lakukan hal berikut:

1. Sambungkan perangkat seluler ke komputer.

2. Dari jendela Terminal, nonaktifkan server adb yang sedang berjalan.

   adb kill-server
   

3. Mulai ulang adb dan periksa perangkat yang terhubung.

   adb devices
   

   Anda akan melihat perangkat tercantum, persis dengan contoh output di bawah.

   

   Jika tidak melihat perangkat apa pun, pastikan ponsel terhubung, dan Proses Debug USB dalam status aktif, lalu nonaktifkan dan mulai ulang adb.

4. Reset pengumpulan data baterai.

   adb shell dumpsys batterystats --reset
   

   Perangkat selalu mengumpulkan batterystats dan informasi proses debug lainnya di latar belakang. Reset akan menghapus data pengumpulan baterai yang lama. Jika tidak melakukan reset, outputnya akan sangat besar.

5. Putuskan sambungan perangkat dari komputer sehingga Anda hanya menggunakan daya dari baterai perangkat.

6. Gunakan beberapa aplikasi dan lakukan tindakan yang Anda inginkan datanya; misalnya, memutuskan sambungan dari Wi-Fi dan mengirim data ke cloud.

7. Sambungkan kembali ponsel Anda.

8. Pastikan ponsel dikenali:

   adb devices
   

9. Hapus semua data baterai. Proses ini mungkin memerlukan waktu beberapa saat:

   adb shell dumpsys batterystats > [path/]batterystats.txt
   

   File batterystats.txt dibuat di direktori yang Anda tentukan menggunakan argumen jalur opsional. Jika tidak menentukan jalur, file tersebut akan dibuat di direktori beranda.

10. Buat laporan dari data mentah.

    Untuk perangkat yang menjalankan Android 7.0 dan yang lebih tinggi:

    adb bugreport [path/]bugreport.zip

    Untuk perangkat yang menjalankan Android 6.0 dan yang lebih rendah:

    adb bugreport [path/]bugreport.txt

    Laporan bug mungkin perlu waktu beberapa menit untuk menyelesaikan proses. Jangan memutuskan sambungan perangkat Anda atau membatalkan prosesnya sampai selesai.

    Seperti halnya batterystats.txt di atas, file-file ini dibuat di direktori yang Anda tentukan menggunakan argumen path opsional. Jika Anda tidak menentukan lokasi, file akan dibuat di direktori utama.

    Jika belum berjalan, jalankan Battery Historian menggunakan perintah berikut:

    docker --run -p port_number:9999 gcr.io/android-battery-historian/stable:3.0 --port 9999
    

11. Untuk melihat data Anda di Battery Historian, buka Battery Historian di browser. (Untuk Mac dan Linux, Battery Historian berjalan di http://localhost:port_number. Untuk Windows, Battery Historian berjalan di http://your_IP_address:port_number.)

12. Klik Browse, lalu pilih file laporan bug yang Anda buat di atas.

13. Klik Kirim. Battery Historian akan membuka diagram yang dibuat dari data batterystats Anda.

Melihat data dengan diagram Battery Historian

Diagram Battery Historian menampilkan peristiwa yang terkait dengan daya dari waktu ke waktu.

Setiap baris menampilkan segmen batang berwarna ketika komponen sistem aktif dan menggunakan daya dari baterai. Diagram tidak menunjukkan jumlah daya baterai yang digunakan oleh komponen tersebut, dan hanya menunjukkan bahwa aplikasi tersebut aktif. Diagram disusun berdasarkan kategori, menampilkan batang untuk setiap kategori dari waktu ke waktu, seperti yang ditampilkan di sumbu X diagram.

1. Menambahkan metrik tambahan dari menu drop-down.
2. Arahkan kursor ke ikon informasi untuk melihat informasi selengkapnya tentang setiap metrik, termasuk kunci untuk warna yang digunakan pada diagram.
3. Arahkan kursor ke batang untuk melihat informasi yang lebih detail tentang metrik tersebut dan statistik baterainya di titik tertentu di linimasa.

Output batterystats tambahan

Anda dapat melihat informasi tambahan dari file batterystats.txt di bagian statistik di bawah diagram Battery Historian.

Tab 1 System Stats mencakup statistik seluruh sistem, seperti tingkat sinyal seluler dan kecerahan layar. Informasi ini memberikan gambaran keseluruhan tentang apa yang terjadi pada perangkat. Informasi tersebut sangat berguna untuk memastikan tidak ada peristiwa eksternal yang memengaruhi pengujian Anda.

Tab 2 App Stats mencakup informasi tentang aplikasi tertentu. Urutkan daftar aplikasi menggunakan menu drop-down 3 Sort apps by di panel App Selection di sebelah kiri. Anda dapat memilih aplikasi tertentu untuk melihat statistik penggunaan daftar drop-down 4 aplikasi di bawah.