Inizia a utilizzare il monitoraggio delle prestazioni per Flutter

Questa guida rapida descrive come configurare Firebase Performance Monitoring per aiutarti a ottenere informazioni sulle caratteristiche di rendimento delle tue app Flutter.

Prima di iniziare

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

Passaggio 1: aggiungi il monitoraggio del rendimento alla tua app

  1. Dalla directory principale del progetto Flutter, esegui il seguente comando per installare il plug-in Flutter per il monitoraggio del rendimento:

    flutter pub add firebase_performance

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

    flutterfire configure

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

  3. Al termine, ricostruisci il 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 (ad esempio l'ora di avvio dell'app) e i dati relativi alle richieste di rete HTTP/S.

Su Flutter, non è possibile monitorare automaticamente le prestazioni del rendering dello schermo per le singole schermate Flutter. Un singolo controller di visualizzazione incapsula l'intera applicazione Flutter in modo nativo, pertanto l'SDK Firebase nativo sottostante non è consapevole delle transizioni tra le schermate.

Passaggio 2: genera eventi sul rendimento per la visualizzazione dei dati iniziali

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 ed elaborazione iniziale dei dati.

  1. Continua a sviluppare l'app utilizzando un simulatore o un dispositivo di test.

  2. Genera eventi spostando l'app tra primo piano e sfondo diverse volte, interagendo con l'app spostandoti tra le schermate e/o attivando richieste di rete.

  3. Vai alla dashboard Rendimento della Console Firebase. Dovresti visualizzare i dati iniziali entro qualche minuto.

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

Passaggio 3: (Facoltativo) visualizza i messaggi di log per gli eventi di rendimento

  1. Controlla se nei messaggi di log sono presenti messaggi di errore.

    Il monitoraggio del rendimento contrassegna i messaggi di log con i seguenti tag in modo da poterli filtrare:

    • iOS e versioni successive: Firebase/Performance
    • Android: FirebasePerformance

  2. Controlla i seguenti tipi di log che indicano che il monitoraggio del rendimento sta registrando eventi relativi al rendimento:

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

  3. Fai clic sull'URL per visualizzare i dati nella console Firebase. Potrebbero essere necessari alcuni momenti prima che 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 codice specifico nella tua app, puoi instrumentare le tracce di codice personalizzate.

Con una traccia di codice personalizzata, puoi misurare il tempo necessario alla tua app per completare un'attività o un insieme di attività specifiche, ad esempio il caricamento di un insieme di immagini o l'esecuzione di query sul tuo database. La metrica predefinita per una traccia di codice personalizzato è la durata, ma puoi anche aggiungere metriche personalizzate, come hit della cache e avvisi di memoria.

Nel codice, definisci l'inizio e la fine di una traccia di codice personalizzata (e aggiungi le eventuali metriche personalizzate) utilizzando l'API fornita dall'SDK Performance Monitoring.

Consulta Aggiungere il monitoraggio per codice specifico per scoprire di più su queste funzionalità e su come aggiungerle alla tua app.

Passaggio 5: esegui il deployment dell'app e poi esamina i risultati

Dopo aver convalidato il monitoraggio del rendimento utilizzando un emulatore e uno o più dispositivi di test, puoi implementare la versione aggiornata dell'app per i tuoi utenti.

Puoi monitorare i dati sul rendimento nella dashboard Rendimento della Console Firebase.

Passaggi successivi