Inizia a utilizzare il monitoraggio delle prestazioni per Flutter

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

Prima di iniziare

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

Passaggio 1: aggiungi Performance Monitoring alla tua app

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

    flutter pub add firebase_performance

  2. Dalla directory principale del progetto Flutter, esegui questo 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 Performance Monitoring richiesto alla tua app.

  3. Al termine, ricompila il progetto Flutter:

    flutter run

Dopo aver aggiunto l'SDK Performance Monitoring, Firebase inizia automaticamente a raccogliere dati relativi al ciclo di vita della tua app (ad esempio l'ora di avvio dell'app) e 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 singolo controller di visualizzazione incapsula l'intera applicazione Flutter in modo nativo, quindi l'SDK Firebase nativo sottostante non è a conoscenza delle transizioni tra le schermate.

Passaggio 2: genera eventi di rendimento 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 passando più volte dall'app in background a quella in primo piano, interagendo con l'app spostandoti 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 una visualizzazione dei tuoi 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 i messaggi di log per eventuali messaggi di errore.

    Performance Monitoring contrassegna i messaggi di log con i seguenti tag in modo da poterli filtrare:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Controlla i seguenti tipi di log che indicano che Performance Monitoring sta registrando gli eventi di 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 istanti prima che i dati vengano aggiornati nella dashboard.

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

Per monitorare i dati sul rendimento associati a un codice specifico nella tua app, puoi strumentare le tracce di codice personalizzato.

Con una traccia di codice personalizzata, puoi misurare il tempo impiegato dalla tua app per completare un'attività o un insieme di attività specifico, ad esempio il caricamento di un insieme di immagini o l'esecuzione di query nel 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 personalizzato (e aggiungi le metriche personalizzate che preferisci) utilizzando l'API fornita dall'SDK Performance Monitoring.

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

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

Dopo aver convalidato il monitoraggio delle prestazioni utilizzando un emulatore e uno o più dispositivi di test, puoi eseguire il deployment della versione aggiornata della tua app per gli utenti.

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

Passaggi successivi