Mengumpulkan data performa

Layanan native Watchdog mencatat data performa I/O sejak early-init selama booting sistem. Layanan native ini menampilkan data performa yang dikumpulkan dalam laporan bug. Vendor dapat membuat kueri layanan native melalui dumpsys untuk menampilkan data yang dikumpulkan atau memulai sesi pengumpulan kustom untuk proses debug.

Frekuensi pengumpulan data

Frekuensi pengumpulan data performa bervariasi menurut jenis build.

  • Pada build userdebug atau eng, Watchdog mengumpulkan data performa sekali setiap satu (1) detik selama booting sistem dan sekali setiap satu (1) menit setelah booting selesai.
  • Pada build pengguna, Watchdog mengumpulkan data performa sekali setiap 20 detik selama booting sistem dan sekali setiap dua (2) menit setelah booting selesai.

Peristiwa pengumpulan data

Pembuatan profil berbasis sampel dilakukan selama berbagai peristiwa sistem (seperti booting sistem, aktivasi sistem, dan peralihan pengguna) dan selama jendela N menit terakhir.

  • Peristiwa N menit terakhir sebelum pembuatan laporan bug: Dibuat selama jendela bergulir 30 menit.
  • Peristiwa waktu booting: Dibuat setelah booting.
  • Peristiwa peralihan pengguna: Dibuat setelah peralihan pengguna dimulai.
  • Peristiwa pengumpulan kustom: Dapat menentukan periode polling, durasi maksimum, dan dapat memfilter menurut paket.

Menampilkan data performa

Saat bugreport diambil, layanan native Watchdog akan menampilkan data performa yang dikumpulkan dalam laporan bug. Vendor dapat membuat kueri layanan native melalui perintah dumpsys di bawah untuk menampilkan data performa yang dikumpulkan. Lihat bagian Memahami laporan data performa untuk mengetahui detail tentang laporan.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt

Mengumpulkan data performa untuk proses debug

Vendor dapat menggunakan layanan native Watchdog untuk mengumpulkan data performa secara kustom untuk tujuan proses debug. Misalnya, untuk memahami penggunaan I/O aplikasi atau layanan, vendor dapat melakukan pengumpulan data performa kustom yang membuat profil penggunaan I/O dari daftar paket tertentu atau seluruh sistem.

Memulai sesi pengumpulan kustom

Di bawah ini adalah perintah untuk memulai sesi pengumpulan data performa kustom:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
  • --start_perf Memulai sesi pengumpulan data performa kustom.
  • --interval <seconds> Menentukan interval pembuatan profil. Secara default, intervalnya adalah 30 detik.
  • --max_duration <seconds> Menentukan durasi maksimum sesi pengumpulan data performa kustom. Jika sesi tidak dihentikan secara manual, sesi akan dihentikan dan data yang dikumpulkan akan dihapus setelah durasi ini. Secara default, durasi maksimumnya adalah 30 menit.
  • --filter_packages <package_name>,<package_name>... Menentukan daftar nama paket yang dipisahkan koma untuk pembuatan profil. Jika disediakan, pengumpulan data performa akan dibatasi untuk paket ini. Jika tidak, pengumpulan data performa akan dilakukan untuk semua paket dalam sistem.

Misalnya, perintah di bawah memulai pengumpulan data performa kustom dengan interval pembuatan profil 10 detik, durasi pengumpulan maksimum 1 jam, dan membatasi pembuatan profil ke paket com.google.android.car.kitchensink dan com.google.android.apps.maps.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf --interval 10 --max_duration 3600 --filter_packages com.google.android.car.kitchensink,com.google.android.apps.maps

Menghentikan dan menampilkan sesi pengumpulan kustom

Setelah merekam penggunaan I/O aplikasi atau layanan yang diinginkan, vendor harus menghentikan sesi pengumpulan data performa kustom untuk menampilkan data yang dikumpulkan. Perintah ini menghentikan pengumpulan data performa kustom dan menampilkan data yang dikumpulkan ke /tmp/carwatchdog_dump.txt:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt

Bantuan Dumpsys

Untuk mendapatkan bantuan dumpsys:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help

Menampilkan ke format proto

Secara opsional, data dumpsys dapat ditampilkan dalam format proto:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --proto

Memahami laporan data performa

Untuk mempelajari lebih lanjut, lihat contoh laporan data performa berikut:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default

---------------------------------
WatchdogPerfService report:
---------------------------------
Boot-time collection information:
=================================
Event polling interval: 1 second

Wake-up collection information:
===============================
Event polling interval: 1 second

User-switch collection information:
===================================
Event polling interval: 1 second

Periodic collection information:
================================
Event polling interval: 60 seconds
---------------------------------------------------------------------------
Boot-time performance report:
=================================
No collection recorded
---------------------------------------------------------------------------
Wake-up performance report:
===========================
No collection recorded
---------------------------------------------------------------------------
User-switch events performance report:
======================================
No collection recorded
---------------------------------------------------------------------------
Last N minutes performance report:
======================================
Collection duration: 10800 seconds
Number of collections: 181

Collection 0: <Mon Oct  2 18:36:06 2023 GMT>
=============================================
Total CPU time (ms): 473210
Total CPU cycles: 39553152000
Total idle CPU time (ms)/percent: 435860 / 92.11%
CPU I/O wait time (ms)/percent: 0 / 0.00%
Number of context switches: 13723415093
Number of I/O blocked processes/percent: 0 / 0.00%

Top N CPU Times:
----------------
Android User ID, Package Name, CPU Time (ms), Percentage of total CPU time, CPU Cycles
    Command, CPU Time (ms), Percentage of UID's CPU Time, CPU Cycles
10, com.google.android.carassistant, 13357, 2.82%, 16409088000
    assistant:interactor, 13360, 100.02%, 16409088000
0, system, 9097, 1.92%, 9640512000
    sensors@1.0-ser, 3790, 41.66%, 3773184000
    system_server, 2760, 30.34%, 3135936000
    com.android.car, 1150, 12.64%, 1099584000
    binder:621_4, 1000, 10.99%, 1281024000
    surfaceflinger, 230, 2.53%, 245376000
0, audioserver, 4383, 0.93%, 4597248000
    Main, 2690, 61.37%, 2980416000
    binder:916_2, 950, 21.67%, 925056000
    audioserver, 720, 16.43%, 691776000
0, root, 4357, 0.92%, 3727872000
    irq/311-iam2068, 2630, 60.36%, 2471616000
    irq/26-90b6400., 370, 8.49%, 561024000
    kworker/u16:4-bwmon_wq, 290, 6.66%, 48960000
    kworker/u16:1-memlat_wq, 270, 6.20%, 0
    ipcdaemon, 220, 5.05%, 218304000
10, com.google.android.apps.geo.automotive.adas, 1509, 0.32%, 1756416000
    adas:publishing, 1490, 98.74%, 1735680000
    as:clientparams, 10, 0.66%, 20736000
0, com.android.vending, 796, 0.17%, 765504000
    android.vending, 790, 99.25%, 765504000
0, shared:com.google.uid.shared, 581, 0.12%, 481152000
    google.android.gms, 340, 58.52%, 237312000
    .gms.persistent, 190, 32.70%, 184512000
    process.gservices, 50, 8.61%, 59328000
0, gps, 507, 0.11%, 659136000
    binder:920_2, 500, 98.62%, 659136000
10, com.android.vending, 489, 0.10%, 372288000
    android.vending, 480, 98.16%, 372288000
0, shared:android.uid.systemui, 438, 0.09%, 449856000
    android.systemui, 440, 100.46%, 449856000

Top N Storage I/O Reads:
-------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, root, 56123392, 81.95%, 1, 100.00%, 0, 0.00%, 0, 0.00%
0, system, 12333056, 18.01%, 0, 0.00%, 0, 0.00%, 0, 0.00%

Top N Storage I/O Writes:
-------------------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62%
10, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62%
10, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 45056, 4.01%, 0, 0.00%
0, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 36864, 3.28%, 2, 4.76%
0, logd, 24576, 40.00%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, root, 20480, 33.33%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, system, 16384, 26.67%, 0, 0.00%, 0, 0.00%, 0, 0.00%

Top N I/O waiting UIDs:
-----------------------
Android User ID, Package Name, Number of owned tasks waiting for I/O, Percentage of owned tasks waiting for I/O
    Command, Number of I/O waiting tasks, Percentage of UID's tasks waiting for I/O
0, root, 2, 0.39%
    dp_hdcp2p2, 1, 50.00%
    hdcp_2x, 1, 50.00%

Top N major page faults:
------------------------
Android User ID, Package Name, Number of major page faults, Percentage of total major page faults
    Command, Number of major page faults, Percentage of UID's major page faults
0, com.android.vending, 104, 48.83%
    android.vending, 104, 100.00%
10, com.android.vending, 104, 48.83%
    android.vending, 104, 100.00%
0, shared:com.google.uid.shared, 4, 1.88%
    .gms.persistent, 4, 100.00%
10, shared:com.google.uid.shared, 1, 0.47%
    .gms.persistent, 1, 100.00%
Number of major page faults since last collection: 213
Percentage of change in major page faults since last collection: 0.00%

Saat mengambil bugreport, menjalankan perintah dumpsys Watchdog tanpa argumen apa pun, atau menghentikan sesi pengumpulan kustom, layanan native Watchdog akan menampilkan laporan data performa yang mirip dengan laporan di atas.

Laporan ini berisi data yang dikumpulkan selama booting sistem dan N menit terakhir sebelum pembuatan laporan.

Item Deskripsi
Informasi pengumpulan waktu booting Memberikan informasi tentang sesi pengumpulan data performa waktu booting.
Informasi pengumpulan aktivasi Memberikan informasi tentang sesi pengumpulan data performa aktivasi saat sistem aktif dari penangguhan.
Informasi pengumpulan peralihan pengguna Memberikan informasi tentang sesi pengumpulan data performa peralihan pengguna saat ada peralihan pengguna.
Informasi pengumpulan berkala Memberikan informasi tentang sesi pengumpulan performa berkala yang dimulai setelah booting selesai.
Laporan performa waktu booting Berisi data performa yang dikumpulkan selama booting sistem. Data ini tetap ada dalam memori hingga sistem dimatikan, sehingga data akan ditampilkan di semua laporan.
Laporan performa aktivasi Berisi data performa yang dikumpulkan selama aktivasi. Data ini tetap ada dalam memori hingga sistem dimatikan, sehingga data akan ditampilkan di semua laporan.
Laporan performa peralihan pengguna Berisi data performa yang dikumpulkan selama peralihan pengguna. Data ini tetap ada dalam memori hingga sistem dimatikan, sehingga data akan ditampilkan di semua laporan.
Laporan performa I/O N menit terakhir Berisi data performa yang dikumpulkan (oleh sesi pengumpulan berkala) selama N menit terakhir sebelum pembuatan laporan.
Durasi pengumpulan Total durasi pengumpulan data performa.
Jumlah pengumpulan Total jumlah pengumpulan yang dilaporkan dalam satu laporan.

Setiap pengumpulan yang dilaporkan dalam laporan dapat berisi semua atau beberapa bagian di bawah. Statistik yang dilaporkan di setiap pengumpulan adalah delta sejak pengumpulan terakhir, kecuali statistik yang bersifat instan (misalnya, tidak diagregasi sejak booting sistem).

Item Deskripsi
Waktu tunggu/persen I/O CPU Waktu CPU absolut dan persentase total waktu CPU yang dihabiskan untuk peralihan konteks atau menunggu karena operasi I/O sejak pengumpulan terakhir.
Total waktu CPU Total waktu CPU dalam milidetik.
Total waktu CPU tidak aktif Total waktu CPU yang dihabiskan dalam keadaan tidak aktif.
Waktu tunggu I/O CPU Total waktu yang dihabiskan CPU untuk menunggu operasi I/O.
Jumlah peralihan konteks Jumlah peralihan CPU dari satu proses atau thread ke proses atau thread lainnya.
Jumlah proses yang diblokir I/O/persen Total jumlah proses yang diblokir menunggu I/O dan persentase proses yang diblokir menunggu I/O sejak pengumpulan terakhir.
Waktu CPU N Teratas

N paket teratas yang paling banyak menggunakan waktu CPU sejak pengumpulan terakhir:

  • Setiap baris tingkat atas berisi ID pengguna, nama paket, waktu CPU, persentase total waktu CPU, dan siklus CPU.
  • Baris tingkat dalam berisi perintah, waktu CPU, persentase waktu CPU UID, dan siklus CPU.
Pembacaan I/O Penyimpanan N Teratas

N paket teratas yang paling banyak membaca data dari disk sejak pengumpulan terakhir.

Setiap baris berisi ID pengguna, nama paket, jumlah total byte yang dibaca dalam mode latar depan versus mode latar belakang, persentase byte di semua pembacaan mode latar depan versus mode latar belakang dalam sistem, jumlah total panggilan fsync yang dilakukan dalam mode latar depan versus mode latar belakang, dan persentase panggilan fsync di semua panggilan fsync mode latar depan versus mode latar belakang yang dilakukan dalam sistem.
Penulisan I/O Penyimpanan N Teratas N paket teratas yang paling banyak menulis data ke disk sejak pengumpulan terakhir. Setiap baris berisi kolom yang mirip dengan kolom Pembacaan N Teratas.
UID menunggu I/O N Teratas

N paket teratas dengan tugas menunggu I/O terbanyak.

  • Setiap baris tingkat atas berisi ID pengguna, nama paket, jumlah dan persentase tugas yang dimiliki oleh paket yang menunggu I/O.
  • Baris tingkat dalam berisi informasi menunggu I/O untuk proses teratas yang dimiliki oleh paket.
Kesalahan halaman utama N Teratas N paket teratas dengan kesalahan halaman utama terbanyak sejak pengumpulan terakhir.