Il servizio nativo watchdog registra i dati sulle prestazioni di I/O sin dall'avvio anticipato durante l'avvio del sistema. Il servizio nativo esegue il dump dei dati sul rendimento raccolti nel report di bug. I fornitori possono eseguire query sul servizio nativo tramite dumpsys per eseguire il dump dei dati raccolti o avviare una sessione di raccolta personalizzata per il debug.
Frequenza di raccolta dei dati
La frequenza della raccolta dei dati sulle prestazioni varia in base al tipo di build.
- Nelle build userdebug o eng, Watchdog raccoglie i dati sul rendimento ogni 1 secondo durante l'avvio del sistema e ogni 1 minuto al termine dell'avvio.
- Sulle build degli utenti, Watchdog raccoglie i dati sulle prestazioni una volta ogni 20 secondi durante l'avvio del sistema e una volta ogni due (2) minuti dopo il completamento dell'avvio.
Eventi di raccolta dei dati
Il profiling basato su campioni viene eseguito durante vari eventi di sistema (ad esempio l'avvio del sistema, il risveglio del sistema e il passaggio da un utente all'altro) e durante la finestra degli ultimi N minuti.
- Eventi degli ultimi n minuti prima della generazione della segnalazione di bug: vengono generati durante una finestra temporale continua di 30 minuti.
- Eventi tempo di avvio:vengono generati dopo l'avvio.
- Eventi di passaggio utente:generati dopo l'avvio di un passaggio utente.
- Eventi di raccolta personalizzata:puoi specificare il periodo di polling, la durata massima e filtrare in base ai pacchetti.
Esegui il dump dei dati sul rendimento
Quando viene acquisita una segnalazione di bug, il servizio nativo Watchdog scarica i dati sulle prestazioni raccolti nella segnalazione di bug. I fornitori possono eseguire query sul servizio nativo tramite il comando seguente dumpsys per eseguire il dump dei dati sulle prestazioni raccolti. Per maggiori dettagli sul report, consulta la sezione Informazioni sul report sui dati sul rendimento.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt
Raccogliere i dati sul rendimento per il debug
I fornitori possono utilizzare il servizio nativo Watchdog per raccogliere i dati sul rendimento personalizzati a fini di debug. Ad esempio, per comprendere l'utilizzo I/O di un'app o un servizio, i fornitori possono eseguire una raccolta personalizzata di dati sulle prestazioni che profila l'utilizzo I/O di un elenco specifico di pacchetti o dell'intero sistema.
Avvia una sessione di raccolta personalizzata
Di seguito è riportato il comando per avviare una sessione di raccolta dei dati sul rendimento personalizzata:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
--start_perfAvvia una sessione di raccolta dei dati sul rendimento personalizzata.--interval <seconds>Specifica l'intervallo di profilazione. Per impostazione predefinita, l'intervallo è di 30 secondi.--max_duration <seconds>Specifica la durata massima della sessione di raccolta dei dati sul rendimento personalizzato. Se la sessione non viene interrotta manualmente, viene arrestata e i dati raccolti vengono eliminati dopo questa durata. Per impostazione predefinita, la durata massima è di 30 minuti.--filter_packages <package_name>,<package_name>...Specifica un elenco separato da virgole di nomi di pacchetti da profilare. Se forniti, la raccolta dei dati sulle prestazioni è limitata a questi pacchetti. In caso contrario, la raccolta dei dati sulle prestazioni viene eseguita per tutti i pacchetti nel sistema.
Ad esempio, il comando riportato di seguito avvia una raccolta dei dati sul rendimento personalizzata con un intervallo di profilazione di 10 secondi, una durata massima della raccolta di 1 ora e limita il profiling ai pacchetti com.google.android.car.kitchensink e 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
Interrompi e scarica la sessione di raccolta personalizzata
Dopo aver registrato l'utilizzo I/O di un'app o di un servizio di interesse, i fornitori devono interrompere la sessione di raccolta dei dati sul rendimento personalizzati per eseguire il dump dei dati raccolti. Questo comando interrompe la raccolta dei dati sulle prestazioni personalizzati ed esegue il dump dei dati raccolti su /tmp/carwatchdog_dump.txt:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt
Guida di Dumpsys
Per ricevere assistenza da dumpsys:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help
Esegui il dump in formato proto
Facoltativamente, i dati dumpsys possono essere sottoposti a dump in formato proto:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --proto
Comprendere il report sui dati sul rendimento
Per saperne di più, consulta il seguente report di esempio sui dati sul rendimento:
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%
Quando acquisisci un report di bug, esegui un comando dumpsys Watchdog senza argomenti o interrompi una sessione di raccolta personalizzata, il servizio nativo Watchdog esegue il dump di un report sui dati sulle prestazioni simile al report riportato sopra.
Il report contiene i dati raccolti durante l'avvio del sistema e negli ultimi N minuti prima della generazione del report.
| Articolo | Descrizione |
|---|---|
| Informazioni sulla raccolta al momento dell'avvio | Fornisce informazioni sulla sessione di raccolta dei dati sul rendimento al momento dell'avvio. |
| Informazioni sulla raccolta dei dati per la riattivazione | Fornisce informazioni sulla sessione di raccolta dei dati sul rendimento al risveglio quando il sistema si riattiva dalla sospensione. |
| Informazioni sulla raccolta dei dati relativi al passaggio da un utente all'altro | Fornisce informazioni sulla sessione di raccolta dei dati sul rendimento per il passaggio utente in caso di cambio utente. |
| Informazioni sulla raccolta periodica | Fornisce informazioni sulla sessione di raccolta periodica del rendimento che inizia dopo il completamento dell'avvio. |
| Report sul rendimento in fase di avvio | Contiene i dati sul rendimento raccolti durante l'avvio del sistema. Questi dati rimangono in memoria fino all'arresto del sistema, quindi vengono scaricati in tutti i report. |
| Report sul rendimento delle sveglie | Contiene i dati sul rendimento raccolti durante il risveglio. Questi dati rimangono in memoria fino all'arresto del sistema, pertanto vengono scaricati in tutti i report. |
| Report sul rendimento dei passaggi da un utente all'altro | Contiene i dati sul rendimento raccolti durante il passaggio da un utente all'altro. Questi dati rimangono in memoria fino all'arresto del sistema, quindi vengono sottoposti a dump in tutti i report. |
| Report sul rendimento I/O degli ultimi n minuti | Contiene i dati sul rendimento raccolti (dalla sessione di raccolta periodica) negli ultimi N minuti prima della generazione del report. |
| Durata della raccolta | Durata totale della raccolta dei dati sul rendimento. |
| Numero di raccolte | Numero totale di raccolte riportate in un singolo report. |
Ogni raccolta registrata nel report può contenere tutte o alcune delle sezioni riportate di seguito. Le statistiche riportate in ogni raccolta sono il delta dall'ultima raccolta, ad eccezione di quelle istantanee (ad esempio, non aggregate dall'avvio del sistema).
| Articolo | Descrizione |
|---|---|
| Tempo/percentuale di attesa I/O della CPU | Tempo di CPU assoluto e percentuale del tempo di CPU totale dedicato alla commutazione di contesto o all'attesa a causa di operazioni I/O dall'ultima raccolta. |
| Tempo di CPU totale | Tempo di CPU totale in millisecondi. |
| Tempo di CPU inattiva totale | Tempo totale di CPU inattivo. |
| Tempo di attesa I/O della CPU | Tempo totale di CPU in attesa di operazioni di I/O. |
| Numero di opzioni di contesto | Numero di CPU che passano da un processo o un thread a un altro. |
| Numero di processi I/O bloccati/percentuale | Numero totale di processi bloccati in attesa di I/O e percentuale di processi bloccati in attesa di I/O dall'ultima raccolta. |
| Tempi CPU dei primi N |
I principali N pacchetti che hanno consumato più tempo della CPU dall'ultima raccolta:
|
| Letture I/O di archiviazione Top N |
I primi N pacchetti che hanno letto più dati dal disco dall'ultima raccolta. Ogni riga contiene l'ID utente, il nome del pacchetto, il numero totale di byte letti in modalità foreground rispetto alla modalità background, la percentuale di byte letti in tutte le modalità foreground rispetto alla modalità background nel sistema, il numero totale di chiamate |
| Scritture I/O di archiviazione dei primi N | I pacchetti Top N che hanno scritto la maggior parte dei dati sul disco dall'ultima raccolta. Ogni riga contiene campi simili a quelli delle prime N letture. |
| Primi N UID in attesa di I/O | I pacchetti Top N con il maggior numero di attività in attesa di I/O.
|
| Primi N errori gravi di pagina | Primi N pacchetti con i maggiori errori di pagina dall'ultima raccolta. |