perfetto è uno strumento che ti consente di raccogliere informazioni sul rendimento dai dispositivi Android tramite Android Debug Bridge (ADB). Richiama lo strumento perfetto utilizzando il comando adb shell perfetto ....
perfetto utilizza varie
fonti per raccogliere le tracce delle prestazioni dal tuo dispositivo, ad esempio:
ftraceper le informazioni dal kernelatraceper l'annotazione dello spazio utente in servizi e appheapprofdper informazioni sull'utilizzo della memoria utilizzata nativa di servizi e app
Questa pagina descrive come chiamare perfetto e configurarlo per generare l'output desiderato. Per ulteriori informazioni, consulta la documentazione di perfetto.
Competenze Android
Visualizza su GitHubProfiler Android
android skills add android-profilerSintassi
Questa sezione descrive come utilizzare ADB per chiamare perfetto per diverse modalità e generare una traccia.
Selezione origine dati
perfetto include le seguenti due modalità che determinano le origini dati
utilizzate per registrare la traccia:
- Modalità Luce: puoi selezionare solo un sottoinsieme di origini dati, in particolare
atraceeftrace. Tuttavia, questa modalità offre un'interfaccia simile asystrace. - Modalità normale: ottiene la configurazione in un buffer di protocollo e ti consente di sfruttare meglio le funzionalità di
perfettoutilizzando origini dati diverse daatraceeftrace.
Opzioni generali
La tabella seguente elenca le opzioni disponibili quando utilizzi perfetto in una delle due modalità:
Tabella 1. Elenco delle opzioni generali disponibili per lo strumento Perfetto.
| Opzione | Descrizione |
|---|---|
--background |
|
perfetto esce immediatamente dall'interfaccia a riga di comando e continua a registrare la traccia in background. |
--background-wait | -D
|
Come --background, ma attende (fino a 30 secondi) che tutte le origini dati vengano avviate prima di uscire. Il codice di uscita è zero se viene ricevuta una conferma di esito positivo, altrimenti è diverso da zero (errore o timeout).
|
--alert-id
|
ID dell'avviso che ha attivato questa traccia. |
--config-id
|
ID della configurazione di attivazione. |
--config-uid
|
UID dell'app che ha registrato la configurazione. |
--subscription-id
|
ID della sottoscrizione che ha attivato questa traccia. |
--out OUT_FILE |
|
Specifica il percorso desiderato per il file di traccia di output o Nota: devi specificare il percorso completo del file di output. In genere, i file devono essere scritti nella cartella |
--upload
|
Al termine, passa la traccia al pacchetto specificato dal messaggio IncidentReportConfig nella configurazione della traccia proto. |
--no-guardrails
|
Disattiva le protezioni contro l'utilizzo eccessivo delle risorse quando attivi il flag --upload durante i test. |
--reset-guardrails
|
Reimposta lo stato persistente dei guardrail ed esce per i test. |
--rsave-for-bugreport
|
Se è in esecuzione una traccia con bugreport_score > 0, salva la traccia in un file. Restituisce il percorso al termine.
|
--query
|
Esegue una query sullo stato del servizio e lo stampa come testo leggibile. |
--query-raw
|
Simile a --query, ma stampa i byte non elaborati con codifica proto di tracing_service_state.proto. |
--help | -h
|
Stampa il testo della guida per lo strumento perfetto.
|
Modalità Luce
La sintassi generale per l'utilizzo di perfetto in modalità Luce è la seguente:
adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
[ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
--out FILE
La tabella seguente elenca le opzioni disponibili quando utilizzi perfetto in modalità Luce:
Tabella 2. Elenco delle opzioni dello strumento perfetto disponibili quando utilizzi la modalità Luce.
| Opzione | Descrizione |
|---|---|
--time TIME[s|m|h] |
|
Specifica la durata della traccia in secondi, minuti o ore.
Ad esempio, --time 1m specifica una durata della traccia di 1 minuto.
La durata predefinita è di 10 secondi.
|
--buffer SIZE[mb|gb] |
|
Specifica la dimensione del buffer circolare in megabyte (mb) o gigabyte (gb).
Il parametro predefinito è --buffer 32mb.
|
--size SIZE[mb|gb] |
|
Specifica la dimensione massima del file in megabyte (MB) o gigabyte (GB). Per impostazione predefinita, perfetto utilizza solo il buffer circolare in memoria.
|
--app | -a
|
Nome app Android (atrace) |
Queste opzioni sono seguite da un elenco di identificatori di eventi:
Tabella 3. Elenco di identificatori di eventi per la modalità Luce.
| Evento | Descrizione |
|---|---|
| ATRACE_CAT |
Specifica le categorie atrace per cui vuoi registrare una traccia.
Ad esempio, il seguente comando traccia Window Manager utilizzando atrace:
adb shell perfetto --out FILE wm
Per registrare altre categorie, consulta questo
elenco
di categorie |
| FTRACE_GROUP/FTRACE_NAME |
Specifica gli eventi ftrace per cui vuoi registrare una traccia.
Ad esempio, il seguente comando traccia gli eventi sched/sched_switch:
adb shell perfetto --out FILE sched/sched_switch
|
Modalità normale
La sintassi generale per l'utilizzo di perfetto in modalità normale è la seguente:
adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE
La tabella seguente elenca le opzioni disponibili quando utilizzi perfetto in modalità normale:
Tabella 4. Elenco delle opzioni dello strumento perfetto disponibili quando utilizzi la modalità normale.
| Opzione | Descrizione |
|---|---|
--config CONFIG_FILE | -c CONFIG_FILE
|
Specifica il percorso di un file di configurazione. In modalità normale, alcune configurazioni potrebbero essere codificate in un buffer di protocollo di configurazione. Questo file deve essere conforme allo schema del buffer di protocollo definito in AOSP trace_config.proto.
Seleziona e configura le origini dati utilizzando il membro |
--txt
|
Indica a perfetto di analizzare il file di configurazione come pbtxt. Questo flag è destinato solo ai test locali e non è consigliabile attivarlo per la produzione. |
Origini dati supportate
Questa sezione descrive le diverse origini utilizzate da perfetto per generare la traccia.
ftrace
L'origine dati ftrace consente a perfetto di recuperare gli eventi dal kernel.
Attiva questa origine impostando
ftrace_config
in DataSourceConfig.
Gli eventi che possono essere attivati includono:
-
sched/sched_switchsched/sched_wakeupsched/sched_wakeup_newsched/sched_process_execsched/sched_process_exitsched/sched_process_forksched/sched_process_freesched/sched_process_hangsched/sched_process_wait
Eventi del file system:
A seconda del dispositivo, della versione del sistema operativo o del kernel, potrebbero essere disponibili altri eventi. Per saperne di più, consulta i proto di configurazione.
Statistiche sui processi
L'origine dati delle statistiche di processo consente di ottenere contatori sottoposti a polling sul sistema e sui singoli processi.
Attiva questa origine impostando process_stats_config
e sys_stats_config
in DataSourceConfig.
I dati generati da perfetto includono:
-
/proc/meminfo/proc/vmstat/proc/stat
-
/proc/\<pid\>/status/proc/\<pid\>/oom_score_adj
A seconda del dispositivo, della versione del sistema operativo e del kernel, potrebbero essere disponibili altri eventi. Per saperne di più, consulta i proto di configurazione per sys_stats
e process_stats.
heapprofd
heapprofd ti consente di campionare le cause dell'utilizzo della memoria nativa.
Attiva questa origine impostando heapprofd_config in DataSourceConfig. Questa impostazione produce ProfilePackets, inclusi i frame Java dello stack di chiamate.
Ulteriori informazioni su come utilizzare heapprofd sono disponibili all'indirizzo
perfetto.dev.
Altre fonti
A seconda del dispositivo, della versione del sistema operativo e del kernel, potrebbero essere disponibili altre origini dati. Per scoprire di più, consulta i proto di configurazione dell'origine dati.
Ulteriori informazioni su perfetto sono disponibili all'indirizzo
perfetto.dev.