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 prestazioni 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 delle prestazioni alla tua app

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

    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 Dati relativi al ciclo di vita dell'app (ad es. l'ora di inizio dell'app) e per le richieste di rete HTTP/S.

Su Flutter, il monitoraggio automatico del rendimento dello schermo non è possibile per i singoli schermi Flutter. Un unico controller di visualizzazione racchiude dell'intera applicazione Flutter in modo nativo, quindi l'SDK nativo di Firebase sottostante delle transizioni allo schermo.

Passaggio 2: genera eventi relativi al 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 ed elaborazione iniziale dei dati.

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

  2. Genera eventi spostando la tua app dalla modalità in background a quella in primo piano e viceversa diverse volte, interagendo con l'app navigando su più schermate, e/o l'attivazione di 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 prestazioni

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

    Performance Monitoring contrassegna i propri messaggi di log con i tag seguenti in modo che puoi filtrare i messaggi di log:

    • 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 un monitoraggio personalizzato per un codice specifico

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

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 personalizzata è 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 della tua app per gli utenti.

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

Passaggi successivi