Raccogliere i dati sul rendimento

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 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 di raccolta dei dati sulle prestazioni varia in base alla build di testo.

  • 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.
  • Nelle build degli utenti, Watchdog raccoglie i dati sul rendimento 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

Il profiling basato su sample 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 Ultimi n minuti prima della generazione della segnalazione di bug: vengono generati durante una 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 personalizzati: 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 raccolti sul rendimento nella segnalazione di bug. I fornitori possono eseguire query sul servizio nativo tramite sotto il comando dumpsys per eseguire il dump dei dati sulle prestazioni raccolti. Consulta: la sezione Comprensione del rendimento report sui dati per maggiori dettagli sul report.

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 personalizzare il rendimento della raccolta per il debug. Ad esempio, per comprendere l'utilizzo dell'I/O di un app o servizi, i fornitori possono eseguire una raccolta personalizzata di dati sul rendimento che profila l'utilizzo I/O di un elenco specifico di pacchetti o dell'intero di un sistema operativo completo.

Avvia una sessione di raccolta personalizzata

Di seguito è riportato il comando per avviare una raccolta personalizzata di dati sulle prestazioni sessione:

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 è 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 di nomi di pacchetti da profilare separati da virgole. 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 seguente avvia una raccolta personalizzata di dati sulle prestazioni con un intervallo di profilazione di 10 secondi, numero massimo di raccolte media di 1 ora e limita la profilazione com.google.android.car.kitchensink e com.google.android.apps.maps pacchetti.

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 dell'I/O di un'app o un servizio di interesse, i fornitori devono interrompere sessione di raccolta dati sulle prestazioni personalizzata per eseguire il dump dei dati raccolti. Questo comando arresta raccolta di dati sulle prestazioni personalizzate ed esegue il dump dei dati raccolti /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 in formato proto

Se vuoi, i dati di dumpsys possono essere espulsi 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 gli ultimi N minuti precedenti la generazione di 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 relativi alla sveglia 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 del passaggio dell'utente, se presente è un cambio di utente.
Informazioni sulla raccolta periodica Fornisce informazioni sulla sessione di raccolta periodica delle prestazioni che inizia dopo boot-complete.
Report sul rendimento in fase di avvio Contiene i dati sul rendimento raccolti durante l'avvio del sistema. Questi dati rimangono in memoria fino alla chiusura del sistema, quindi i dati vengono scaricati in tutti i report.
Report sul rendimento del risveglio 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 di utente Contiene i dati sul rendimento raccolti durante il passaggio da un utente all'altro. Questi dati rimangono in memoria fino all'interruzione del sistema, pertanto 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 registrate in un singolo report.

Ogni raccolta riportata nel report potrebbe contenere tutti o alcuni dei seguenti elementi sezioni. Le statistiche riportate in ogni raccolta sono il delta dall'ultima raccolta ad eccezione delle statistiche istantanee (ad esempio, non aggregate poiché l'avvio del sistema).

Articolo Descrizione
Tempo di attesa I/O CPU/percentuale 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 totale di inattività Tempo totale di CPU inattivo.
Tempo di attesa I/O della CPU Tempo totale di attesa della CPU per le operazioni di I/O.
Numero di opzioni di contesto Numero di passaggi della CPU da un processo o thread all'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:

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

I primi N pacchetti che hanno letto più dati dal disco dall'ultima raccolta.

Ogni riga contiene l'ID utente, il nome del pacchetto e il numero totale di byte letti in primo piano. rispetto alla modalità in background, la percentuale di byte in tutta la modalità in primo piano rispetto la modalità in background legge nel sistema, il numero totale di chiamate effettuate in fsync modalità in primo piano e in background e percentuale di fsync chiamate su tutte le chiamate in modalità in primo piano rispetto a quelle in background fsync effettuate nel sistema.
Top N scritture I/O Storage I pacchetti Top N che hanno scritto la maggior parte dei dati sul disco dall'ultima raccolta. Ogni riga contiene campi simili a quelli di Letture più lette.
Primi N I/O in attesa di UID

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

  • 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 di livello interno contengono le informazioni relative all'attesa I/O per i processi principali di proprietà del pacchetto.
Primi N errori di pagina principali Primi N pacchetti con i maggiori errori di pagina dall'ultima raccolta.