Inizia a utilizzare il monitoraggio delle prestazioni per Flutter

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

Prima di iniziare

Se non l'hai già fatto, configurare e inizializzare Firebase in Flutter progetto.

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 root del tuo progetto Flutter, esegui questo comando:

    flutterfire configure

    L'esecuzione di questo comando garantisce che la configurazione Firebase della tua app Flutter è aggiornato e, per Android, aggiunge il monitoraggio delle prestazioni Plug-in Gradle per l'app.

  3. Al termine, ricrea 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 avvia l'elaborazione degli eventi quando aggiungi correttamente l'SDK al tuo dell'app. Se stai ancora sviluppando localmente, interagisci con la tua app per generare per la raccolta e l'elaborazione iniziali 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. I dati iniziali vengono visualizzati entro alcuni minuti.

    Se i dati iniziali non vengono visualizzati, consulta la Risoluzione dei problemi suggerimenti.

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.

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

    • iOS o 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 un codice specifico nella tua app, puoi: tracce di codice personalizzate dello strumento.

Con una traccia di codice personalizzata puoi misurare il tempo necessario per il completamento dell'app un'attività o un insieme di attività specifiche, come il caricamento di un insieme di immagini o l'esecuzione di query del database. La metrica predefinita per una traccia di codice personalizzata è la sua durata, ma puoi anche aggiungere metriche personalizzate, come hit della cache e avvisi sulla memoria.

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

Consulta 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 ed esamina i risultati

Dopo aver convalidato Performance Monitoring utilizzando un emulatore e uno o più dispositivi di test, puoi eseguire il deployment della versione aggiornata dell'app per gli utenti.

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

Passaggi successivi