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 sulle prestazioni raccolti nella segnalazione 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 di userdebug o eng, Watchdog raccoglie i dati sulle prestazioni una volta ogni (1) secondo durante l'avvio del sistema e una volta ogni (1) minuto dopo il completamento 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 dati
La profilazione basata su campioni viene eseguita durante vari eventi di sistema (ad esempio l'avvio del sistema, la riattivazione del sistema e il cambio utente) e durante l'intervallo 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 cambio utente:vengono generati dopo l'avvio di un passaggio da un utente.
- Eventi di raccolta personalizzati: puoi specificare il periodo di polling, la durata massima e filtrare per 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 informazioni dettagliate sul report, consulta la sezione Comprendere il report sui dati sul rendimento.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt
Raccogliere dati sul rendimento per il debug
I fornitori possono utilizzare il servizio nativo Watchdog per raccogliere dati sulle prestazioni personalizzati a scopo 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 sessione di raccolta personalizzata
Di seguito è riportato il comando per avviare una sessione di raccolta dei dati sulle prestazioni 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 è 30 secondi.--max_duration <seconds>Specifica la durata massima della sessione di raccolta dei dati sul rendimento personalizzata. Se la sessione non viene interrotta manualmente, viene arrestata e i dati raccolti vengono eliminati dopo questa durata. Per impostazione predefinita, la durata massima è 30 minuti.--filter_packages <package_name>,<package_name>...Specifica un elenco di nomi dei pacchetti da profilare separati da virgole. 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 seguente avvia una raccolta personalizzata di dati sulle prestazioni con un intervallo di profilazione di 10 secondi, una durata massima di raccolta di 1 ora e limita la profilazione 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
Arresta ed esegui il dump della sessione di raccolta personalizzata
Dopo aver registrato l'utilizzo dell'I/O di un'app o un servizio di interesse, i fornitori devono interrompere la
sessione di raccolta dei dati sulle prestazioni personalizzate per eseguire il dump dei dati raccolti. Questo comando interrompe la raccolta dei dati sulle prestazioni personalizzati ed esegue il dump dei dati raccolti in /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 su dumpsys:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help
Esegui il dump nel formato protocollo
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 esempio di report 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%
Durante l'acquisizione di un report di bug, l'esecuzione di un comando dumpsys di Watchdog senza argomenti o l'interruzione di una sessione di raccolta personalizzata, il servizio nativo Watchdog esegue il dump di un report sui dati sulle prestazioni simile a quello del report precedente.
Il report contiene i dati raccolti durante l'avvio del sistema e gli 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 sulle prestazioni al momento dell'avvio. |
| Informazioni sulla raccolta dei dati per la riattivazione | Fornisce informazioni sulla sessione di raccolta dei dati sulle prestazioni della riattivazione quando il sistema si riattiva dopo la sospensione. |
| Informazioni sulla raccolta di cambi di utente | Fornisce informazioni sulla sessione di raccolta dei dati sulle prestazioni del passaggio da un utente in caso di passaggio di un utente. |
| Informazioni sulla raccolta periodica | Fornisce informazioni sulla sessione di raccolta periodica delle prestazioni che inizia dopo il completamento dell'avvio. |
| Report sul rendimento al momento dell'avvio | Contiene i dati sulle prestazioni raccolti durante l'avvio del sistema. Questi dati rimangono in memoria fino all'arresto del sistema, quindi vengono sottoposti a dump in tutti i report. |
| Report sul rendimento del risveglio | Contiene i dati sulle prestazioni raccolti durante la riattivazione. Questi dati rimangono in memoria fino all'arresto del sistema, quindi vengono sottoposti a dump in tutti i report. |
| Report sul rendimento del passaggio 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 sulle prestazioni 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 registrato in un singolo report. |
Ogni raccolta riportata nel report può contenere tutte o alcune delle seguenti sezioni. Le statistiche riportate in ogni raccolta sono il delta dall'ultima raccolta, ad eccezione delle statistiche istantanee (ad esempio, non aggregate dall'avvio del sistema).
| Articolo | Descrizione |
|---|---|
| Tempo di attesa I/O CPU/percentuale | Tempo di CPU assoluto e percentuale del tempo di CPU totale speso per il cambio di contesto o per l'attesa, a causa di operazioni di I/O dall'ultima raccolta. |
| Tempo di CPU totale | Tempo di CPU totale in millisecondi. |
| Tempo di CPU totale di inattività | Tempo totale di CPU trascorso in stato di inattività. |
| Tempo di attesa I/O CPU | Tempo totale di attesa della CPU per le 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. |
| Primi N tempi di CPU |
Primi N pacchetti che hanno consumato più tempo di CPU dall'ultima raccolta:
|
| Principali N letture I/O Storage |
I primi N pacchetti che leggono la maggior parte dei dati dal disco dall'ultima raccolta. Ogni riga contiene l'ID utente, il nome del pacchetto, il numero totale di byte letti in modalità in primo piano o in background, la percentuale di byte letti in tutte le letture in modalità in primo piano rispetto a quelle in background nel sistema, il numero totale di chiamate |
| Top N scritture I/O Storage | I primi N pacchetti che hanno scritto la maggior parte dei dati su disco dall'ultima raccolta. Ogni riga contiene campi simili a quelli delle prime N letture. |
| Primi N I/O in attesa di UID | I primi N pacchetti con il maggior numero di attività di I/O in attesa.
|
| Primi N errori gravi di pagina | Primi N pacchetti con i maggiori errori di pagina dall'ultima raccolta. |