Inizia con il monitoraggio delle prestazioni per Flutter

Questa guida di avvio rapido descrive come configurare il monitoraggio delle prestazioni di Firebase per aiutarti a ottenere informazioni dettagliate sulle caratteristiche prestazionali delle tue app Flutter.

Prima di iniziare

Se non l'hai già fatto, configura e inizializza Firebase nel tuo progetto Flutter.

Passaggio 1 : aggiungi il monitoraggio delle prestazioni alla tua app

  1. Dalla directory root del tuo progetto Flutter, esegui il comando seguente per installare il plug-in Flutter Performance Monitoring:

    flutter pub add firebase_performance

  2. Dalla directory root del tuo progetto Flutter, esegui il comando seguente:

    flutterfire configure

    L'esecuzione di questo comando garantisce che la configurazione Firebase dell'app Flutter sia aggiornata e, per Android, aggiunge il plug-in Gradle Performance Monitoring richiesto alla tua app.

  3. Una volta completato, ricostruisci il tuo progetto Flutter:

    flutter run

Dopo aver aggiunto l'SDK Performance Monitoring, Firebase inizia automaticamente a raccogliere i dati relativi al ciclo di vita della tua app (come l'ora di inizio dell'app ) e i dati per le richieste di rete HTTP/S .

Su Flutter, il monitoraggio automatico delle prestazioni di rendering dello schermo non è possibile per i singoli schermi Flutter. Un controller di visualizzazione singola incapsula l'intera applicazione Flutter in modo nativo in modo che l'SDK Firebase nativo sottostante non sia a conoscenza delle transizioni dello schermo.

Passaggio 2 : generare eventi di prestazione per la visualizzazione iniziale dei dati

Firebase inizia a elaborare gli eventi quando aggiungi correttamente l'SDK alla tua app. Se stai ancora sviluppando localmente, interagisci con la tua app per generare eventi per la raccolta e l'elaborazione iniziali dei dati.

  1. Continua a sviluppare la tua app utilizzando un simulatore o un dispositivo di test.

  2. Genera eventi spostando più volte l'app dallo sfondo al primo piano, interagendo con l'app navigando tra le schermate e/o attivando richieste di rete.

  3. Vai alla dashboard Prestazioni della console Firebase. Dovresti visualizzare i dati iniziali entro pochi minuti.

    Se non vedi la visualizzazione dei dati iniziali, consulta i suggerimenti per la risoluzione dei problemi .

Passaggio 3 : (facoltativo) visualizzare i messaggi di registro per gli eventi di prestazione

  1. Controlla i messaggi di registro per eventuali messaggi di errore.

    Il monitoraggio delle prestazioni contrassegna i messaggi di registro con i seguenti tag in modo da poter filtrare i messaggi di registro:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Verificare la presenza dei seguenti tipi di log che indicano che il monitoraggio delle prestazioni registra gli eventi relativi alle prestazioni:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. Fai clic sull'URL per visualizzare i tuoi dati nella console Firebase. Potrebbero essere necessari alcuni istanti affinché i dati vengano aggiornati nella dashboard.

Passaggio 4 : (facoltativo) aggiungi il monitoraggio personalizzato per un codice specifico

Per monitorare i dati sulle prestazioni associati a un codice specifico nella tua app, puoi strumentare le tracce del codice personalizzato .

Con una traccia del codice personalizzata, puoi misurare il tempo impiegato dalla tua app per completare un'attività specifica o una serie di attività, ad esempio il caricamento di una serie di immagini o l'esecuzione di query sul database. La metrica predefinita per una traccia del codice personalizzato è la sua durata, ma puoi anche aggiungere metriche personalizzate, come riscontri nella cache e avvisi di memoria.

Nel tuo codice, definisci l'inizio e la fine di una traccia di codice personalizzato (e aggiungi eventuali metriche personalizzate desiderate) utilizzando l'API fornita da Performance Monitoring SDK.

Visita Aggiungi monitoraggio per codice specifico per ulteriori informazioni su queste funzionalità e su come aggiungerle alla tua app.

Passaggio 5 : distribuisci la tua app, quindi esamina i risultati

Dopo aver convalidato il monitoraggio delle prestazioni utilizzando un emulatore e uno o più dispositivi di test, puoi distribuire la versione aggiornata della tua app ai tuoi utenti.

Puoi monitorare i dati sulle prestazioni nel dashboard Prestazioni della console Firebase.

Prossimi passi