Raccogliere i dati sul rendimento

Watchdog native service registra i dati sul rendimento I/O dall'inizio dell'inizializzazione durante l'avvio del sistema. Il servizio nativo esegue il dump dei dati sul rendimento raccolti nel report bug. I fornitori possono eseguire query sul servizio nativo tramite dumpsys per scaricare i dati raccolti o avviare una sessione di raccolta personalizzata per il debug.

Frequenza di raccolta dei dati

La frequenza di raccolta dei dati sul rendimento varia in base al tipo di build.

  • Nelle build userdebug o eng, Watchdog raccoglie i dati sul rendimento una volta al secondo durante l'avvio del sistema e una volta al minuto dopo il completamento dell'avvio.
  • Nelle build utente, 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

La profilazione basata su campioni viene eseguita durante vari eventi di sistema (ad esempio avvio del sistema, riattivazione del sistema e cambio utente) e durante la finestra degli ultimi N minuti.

  • Eventi degli ultimi N minuti prima della generazione della segnalazione di bug: generati durante una finestra mobile di 30 minuti.
  • Eventi di avvio:generati dopo l'avvio.
  • Eventi di cambio utente:generati dopo l'avvio di un cambio utente.
  • Eventi di raccolta personalizzati:possono specificare il periodo di polling, la durata massima e possono filtrare in base ai pacchetti.

Dump dei dati sul rendimento

Quando viene acquisito un bugreport, il servizio nativo Watchdog esegue il dump dei dati sulle prestazioni raccolti nel bugreport. I fornitori possono eseguire query sul servizio nativo tramite il comando dumpsys riportato di seguito per scaricare i dati sulle prestazioni raccolti. Per maggiori dettagli sul report, consulta la sezione Informazioni sul report sui dati di 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 in modo personalizzato i dati sul rendimento a scopo di debug. Ad esempio, per comprendere l'utilizzo di I/O di un'app o di un servizio, i fornitori possono eseguire una raccolta personalizzata di dati sul rendimento che profila l'utilizzo di 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 personalizzata dei dati sul rendimento:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
  • --start_perf Avvia 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 personalizzati. Se la sessione non viene interrotta manualmente, viene interrotta 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 sul rendimento è limitata a questi pacchetti. In caso contrario, la raccolta dei dati sul rendimento viene eseguita per tutti i pacchetti del sistema.

Ad esempio, il comando riportato di seguito avvia una raccolta personalizzata dei dati sul rendimento con un intervallo di profilazione di 10 secondi, una durata massima della 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

Interrompi e scarica la sessione di raccolta personalizzata

Dopo aver registrato l'utilizzo di I/O di un'app o di un servizio di interesse, i fornitori devono interrompere la sessione di raccolta dei dati personalizzati sul rendimento per scaricare i dati raccolti. Questo comando interrompe la raccolta dei dati sul rendimento personalizzati e scarica i 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 per dumpsys:

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

Dump in formato proto

(Facoltativo) I dati dumpsys possono essere scaricati 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 bug, esegui un comando dumpsys di Watchdog senza argomenti o interrompi una sessione di raccolta personalizzata, il servizio nativo Watchdog esegue il dump di un report sui dati di rendimento simile a quello riportato sopra.

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 all'avvio Fornisce informazioni sulla sessione di raccolta dei dati sul rendimento all'avvio.
Informazioni sulla raccolta del risveglio Fornisce informazioni sulla sessione di raccolta dei dati sulle prestazioni di riattivazione quando il sistema si riattiva dalla sospensione.
Informazioni sulla raccolta del cambio utente Fornisce informazioni sulla sessione di raccolta dei dati sulle prestazioni del cambio utente quando si verifica un cambio utente.
Informazioni sulla raccolta periodica Fornisce informazioni sulla sessione di raccolta periodica delle prestazioni che inizia dopo il completamento dell'avvio.
Report sul rendimento all'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 dell'attivazione Contiene i dati sul rendimento raccolti durante l'attivazione. Questi dati vengono mantenuti in memoria fino all'arresto del sistema, pertanto vengono inseriti in tutti i report.
Report sul rendimento del cambio utente Contiene i dati sul rendimento raccolti durante il cambio utente. Questi dati rimangono in memoria fino allo spegnimento del sistema, pertanto vengono inclusi 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 segnalate in un singolo report.

Ogni raccolta segnalata nel report può contenere tutte o alcune delle sezioni seguenti. Le statistiche riportate in ogni raccolta sono il delta rispetto all'ultima raccolta, ad eccezione delle statistiche istantanee (ad esempio, non aggregate dall'avvio del sistema).

Articolo Descrizione
Tempo/percentuale di attesa I/O CPU Tempo CPU assoluto e percentuale del tempo CPU totale trascorso in commutazione di contesto o in attesa a causa di operazioni di I/O dall'ultima raccolta.
Tempo di CPU totale Tempo di CPU totale in millisecondi.
Tempo di CPU inattiva totale Tempo di CPU totale trascorso in stato di inattività.
Tempo di attesa I/O CPU Tempo totale che la CPU ha trascorso in attesa delle operazioni di I/O.
Numero di cambi di contesto Numero di cambi di CPU da un processo o thread a un altro.
Numero di processi bloccati I/O/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 CPU

I primi N pacchetti che hanno consumato più tempo CPU dall'ultima raccolta:

  • Ogni riga di primo livello contiene l'ID utente, il nome del pacchetto, il tempo CPU, la percentuale del tempo CPU totale e i cicli CPU.
  • Le righe di livello interno contengono il comando, il tempo di CPU, la percentuale di tempo di CPU UID e i cicli della CPU.
Le prime N letture I/O di archiviazione

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à in primo piano rispetto alla modalità in background, la percentuale di byte in tutte le letture in modalità in primo piano rispetto alla modalità in background nel sistema, il numero totale di chiamate fsync effettuate in modalità in primo piano rispetto alla modalità in background e la percentuale di chiamate fsync in tutte le chiamate fsync effettuate in modalità in primo piano rispetto alla modalità in background nel sistema.
Prime N scritture I/O di archiviazione I primi N pacchetti che hanno scritto più dati sul disco dall'ultima raccolta. Ogni riga contiene campi simili a quelli di Letture principali N.
UID principali in attesa di I/O

I primi N pacchetti con il maggior numero di attività di attesa I/O.

  • Ogni riga di primo livello contiene l'ID utente, i nomi dei pacchetti, il numero e la percentuale di attività di proprietà del pacchetto in attesa di I/O.
  • Le righe del livello interno contengono le informazioni sull'attesa I/O per i processi principali di proprietà del pacchetto.
Principali N errori di pagina I primi N pacchetti con il maggior numero di errori pagina maggiori dall'ultima raccolta.