Acquisire una traccia del sistema su un dispositivo

I dispositivi con Android 9 (livello API 28) o versioni successive includono un'app a livello di sistema chiamata Monitoraggio del sistema. Questa app è simile all'utilità a riga di comando systrace, ma consente di registrare le tracce direttamente da un dispositivo di test, senza dover collegare il dispositivo e connetterti tramite adb. Puoi quindi utilizzare l'app per condividere i risultati di queste tracce con il tuo team di sviluppo.

I dispositivi con Android 10 e versioni successive registrano le tracce in formato Perfetto, mentre quelli precedenti le registrano in formato Systrace. Ti consigliamo di utilizzare il visualizzatore di traccia di Perfetto per aprire entrambi i formati e poi analizzare le tracce.

È utile per registrare le tracce quando si risolvono bug relativi al rendimento nell'app, come avvio lento, transizioni lente o UI a scatti.

Registrare una traccia di sistema

L'app Monitoraggio sistema ti consente di registrare una traccia di sistema utilizzando il riquadro Impostazioni rapide o un menu all'interno dell'app stessa. Le sezioni seguenti descrivono come completare la procedura di registrazione utilizzando queste interfacce.

Registrare utilizzando il riquadro Impostazioni rapide

Il riquadro Impostazioni rapide è in genere il modo più pratico per completare la procedura di monitoraggio del sistema sul dispositivo.

Configurare il riquadro

Se utilizzi la funzionalità di monitoraggio del sistema per la prima volta sul dispositivo di test o se non vedi il riquadro Monitoraggio del sistema nel riquadro Impostazioni rapide del dispositivo, come mostrato nella figura 2, completa i seguenti passaggi di configurazione:

1. Attiva le opzioni sviluppatore.
2. Apri la schermata delle impostazioni Opzioni sviluppatore.
3. Nella sezione Debug, seleziona Tracciamento del sistema. Si apre l'app Monitoraggio sistema, che mostra il menu dell'app.

4. Dal menu dell'app, attiva Mostra riquadro Impostazioni rapide, come mostrato nella figura 1. Il sistema aggiunge il riquadro Tracciamento del sistema al riquadro Impostazioni rapide, come mostrato nella figura 2:

   

   

   Nota:per impostazione predefinita, il sistema aggiunge il riquadro Monitoraggio sistema come primo riquadro nel riquadro Impostazioni rapide. Se vuoi che il riquadro appaia in una posizione diversa, usa la modalità di modifica del riquadro per spostarlo.

Completare una registrazione della traccia di sistema

Per registrare una traccia di sistema utilizzando il riquadro Impostazioni rapide, completa i seguenti passaggi:

1. Tocca il riquadro Monitoraggio sistema, con l'etichetta Registra traccia. Il riquadro viene attivato e viene visualizzata una notifica persistente per informarti che il sistema sta registrando una traccia, come mostrato nella figura 3:

   

2. Esegui nell'app le azioni che vuoi che il sistema esamini.

3. Interrompi il monitoraggio toccando il riquadro Monitoraggio del sistema nel riquadro Impostazioni rapide o la notifica Monitoraggio del sistema.

   Il sistema mostra una nuova notifica contenente il messaggio "Salvataggio del tracciato". Al termine del salvataggio, il sistema chiude la notifica e visualizza una terza notifica che conferma che la traccia è stata salvata e che puoi condividere la traccia di sistema, come mostrato nella figura 4:

   

Registra usando il menu dell'app

Il menu dell'app ti consente di configurare diverse impostazioni avanzate relative al monitoraggio del sistema e fornisce un'opzione per avviare e interrompere una traccia di sistema.

Per registrare una traccia di sistema utilizzando il menu dell'app Monitoraggio sistema, completa i seguenti passaggi:

1. Attiva le opzioni sviluppatore.

2. Apri la schermata delle impostazioni Opzioni sviluppatore. Nella sezione Debug, seleziona Monitoraggio sistema. Si apre l'app Monitoraggio sistema.

   In alternativa, se hai configurato il riquadro Monitoraggio sistema, puoi toccarlo e tenerlo premuto per accedere all'app Monitoraggio sistema.

3. Assicurati che l'opzione Traccia applicazioni di debug sia selezionata per includere le app per le quali è abilitato il debug nella traccia di sistema.

4. Se vuoi, scegli le Categorie di chiamate di sistema e del sensore da monitorare e una Dimensione del buffer per CPU in KB. Scegli le categorie corrispondenti al caso d'uso che stai testando, ad esempio la categoria Audio per testare le operazioni Bluetooth o la categoria Memoria per le allocazioni dell'heap.

5. Se vuoi, seleziona Tracce lunghe per attivare le tracce che vengono salvate continuamente nello spazio di archiviazione del dispositivo. Per questa opzione, imposta i limiti per le Dimensioni massime della traccia lunga e la Durata massima della traccia lunga.

6. Attiva l'opzione Registra traccia, evidenziata in figura 5. Il riquadro viene abilitato e appare una notifica persistente che indica che il sistema sta registrando una traccia, come mostrato nella Figura 3.

   

7. Esegui nell'app le azioni che vuoi che il sistema esamini.

8. Interrompi il tracciamento disattivando l'opzione Registra traccia.

   Il sistema mostra una nuova notifica contenente il messaggio "Salvataggio del tracciato". Al termine del salvataggio, il sistema chiude la notifica e visualizza una terza notifica che conferma che la traccia è stata salvata e che puoi condividere la traccia di sistema, come mostrato nella Figura 4.

Condividi una traccia di sistema

L'app Monitoraggio sistema ti aiuta a condividere i risultati della traccia del sistema nell'ambito di diversi flussi di lavoro. Su un dispositivo con Android 10 (livello API 29) o versioni successive, i file di traccia vengono salvati con l'estensione del nome file .perfetto-trace e possono essere aperti in Perfetto UI. Su un dispositivo con una versione precedente di Android, i file di traccia vengono salvati con l'estensione del nome file .ctrace, che indica il formato Systrace.

Condividere come messaggio

La funzionalità di monitoraggio del sistema ti consente di condividere la traccia raccolta con altre app sul tuo dispositivo. Puoi inviare la traccia al tuo team di sviluppo tramite un'email o un'app di monitoraggio dei bug senza dover collegare un dispositivo alla tua macchina di sviluppo.

Dopo aver registrato una traccia di sistema, tocca la notifica visualizzata sul dispositivo, come quella mostrata nella figura 4. Viene visualizzato il selettore di intent della piattaforma, che ti consente di condividere la traccia utilizzando l'app di messaggistica che preferisci.

Condividere dall'app Files

Sui dispositivi con Android 10 (livello API 29) o versioni successive, le tracce vengono mostrate nell'app Files. Puoi condividere una traccia da questa app.

Scaricare il report utilizzando ADB

Puoi anche estrarre una traccia di sistema da un dispositivo usando adb. Collega il dispositivo utilizzato per registrare la traccia alla tua macchina di sviluppo, quindi esegui i seguenti comandi in una finestra del terminale:

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

Convertire tra formati di traccia

Puoi convertire i file di traccia di Perfetto nel formato Systrace. Per ulteriori informazioni, consulta la sezione Conversione tra formati di traccia.

Creare un report HTML

Quando condividi la traccia, il report si trova in un file .perfetto-trace sui dispositivi con Android 10 o versioni successive o in un file .ctrace per tutte le altre versioni.

Crea un report HTML dal file di traccia utilizzando un'interfaccia utente basata sul web o dalla riga di comando.

Interfaccia utente basata sul web

Utilizza l'interfaccia utente di Perfetto per aprire il file di traccia e generare il report.

Per un file Perfetto, fai clic su Apri file di traccia. Per un file Systrace, fai clic su Apri con UI precedente. La UI precedente ha lo stesso aspetto del report Systrace.

Riga di comando

Esegui i seguenti comandi in una finestra del terminale per generare un report HTML dal file di traccia:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Se non hai già il programma a riga di comando systrace, puoi scaricarlo dal progetto Catapult su GitHub o direttamente dal progetto Android Open Source.