Inizia a utilizzare il monitoraggio delle prestazioni per Flutter
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida rapida descrive come configurare Firebase Performance Monitoring per aiutarti
a ottenere informazioni dettagliate sulle caratteristiche di rendimento delle tue app Flutter.
Passaggio 1: aggiungi Performance Monitoring alla tua app
Dalla directory principale del progetto Flutter, esegui il seguente comando
per installare il plug-in Flutter di Performance Monitoring:
flutterpubaddfirebase_performance
Dalla directory principale del progetto Flutter, esegui questo comando:
flutterfireconfigure
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.
Al termine, ricompila il progetto Flutter:
flutterrun
Dopo aver aggiunto l'SDK Performance Monitoring, Firebase inizia automaticamente a raccogliere
dati relativi al ciclo di vita della tua app (ad esempio
tempo 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.
Continua a sviluppare la tua app utilizzando un simulatore o un dispositivo di test.
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.
Vai alla dashboard Prestazioni
della console Firebase. Dovresti visualizzare i dati iniziali entro
pochi minuti.
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'interrogazione
del 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.
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
Scopri di più sui dati raccolti automaticamente da Performance Monitoring:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[],[],null,["\u003cbr /\u003e\n\nThis quickstart describes how to set up Firebase Performance Monitoring to help\nyou to gain insight into the performance characteristics of your Flutter apps.\n\nBefore you begin\n\nIf you haven't already,\n[configure and initialize Firebase](/docs/flutter/setup) in your Flutter\nproject.\n\n**Step 1**: Add Performance Monitoring to your app\n\n1. From the root directory of your Flutter project, run the following\n command to install the Performance Monitoring Flutter plugin:\n\n flutter pub add firebase_performance\n\n2. From the root directory of your Flutter project, run the following command:\n\n flutterfire configure\n\n Running this command ensures that your Flutter app's Firebase configuration\n is up-to-date and, for Android, adds the required Performance Monitoring\n Gradle plugin to your app.\n3. Once complete, rebuild your Flutter project:\n\n flutter run\n\nAfter you've added the Performance Monitoring SDK, Firebase automatically starts collecting\ndata related to your app's lifecycle (like\n[app start time](/docs/perf-mon/app-start-foreground-background-traces)), and\ndata for [HTTP/S network requests](/docs/perf-mon/network-traces).\n\nOn Flutter, automatic screen rendering performance monitoring is not possible\nfor individual Flutter screens. A single view controller encapsulates your\nentire Flutter application natively so the underlying native Firebase SDK is\nnot aware of screen transitions.\n| **Note:** When you add Performance Monitoring to your app, the Remote Config SDK is included as a dependency. If you already use Remote Config, you won't see any difference. However, if you're new to Remote Config, explore the [Remote Config documentation](/docs/remote-config) to learn more about the various features you'll be able to access in your app.\n\n**Step 2**: Generate performance events for initial data display\n\nFirebase starts processing the events when you successfully add the SDK to your\napp. If you're still developing locally, interact with your app to generate\nevents for initial data collection and processing.\n| **Note:** The Performance Monitoring SDK batches events locally then sends them to Firebase periodically (every 30 seconds) or when the app comes back to foreground. So, there's a delay between an app interaction and when Firebase receives the event information from your app.\n\n1. Continue to develop your app using a simulator or test device.\n\n2. Generate events by switching your app between background and foreground\n several times, interacting with your app by navigating across screens,\n and/or triggering network requests.\n\n3. Go to the [*Performance* dashboard](//console.firebase.google.com/project/_/performance)\n of the Firebase console. You should see your initial data display within\n a few minutes.\n\n If you don't see a display of your initial data, review the [troubleshooting\n tips](/docs/perf-mon/troubleshooting?platform=ios#sdk-detected-no-data).\n\n**Step 3** : *(Optional)* View log messages for performance events\n\n1. Check your log messages for any error messages.\n\n Performance Monitoring tags its log messages with the following tags so that\n you can filter your log messages:\n - iOS+: `Firebase/Performance`\n - Android: `FirebasePerformance`\n2. Check for the following types of logs which indicate that Performance Monitoring is\n logging performance events:\n\n - `Logging trace metric: `\u003cvar translate=\"no\"\u003eTRACE_NAME\u003c/var\u003e`, `\u003cvar translate=\"no\"\u003eFIREBASE_PERFORMANCE_CONSOLE_URL\u003c/var\u003e\n - `Logging network request trace: `\u003cvar translate=\"no\"\u003eURL\u003c/var\u003e\n3. Click on the URL to view your data in the Firebase console. It may take a few\n moments for the data to update in the dashboard.\n\n**Step 4** : *(Optional)* Add custom monitoring for specific code\n\nTo monitor performance data associated with specific code in your app, you can\ninstrument [**custom code traces**](/docs/perf-mon/custom-code-traces?platform=flutter).\n\nWith a custom code trace, you can measure how long it takes your app to complete\na specific task or set of tasks, such as loading a set of images or querying\nyour database. The default metric for a custom code trace is its duration, but\nyou can also add custom metrics, such as cache hits and memory warnings.\n\nIn your code, you define the beginning and the end of a custom code trace (and\nadd any desired custom metrics) using the API provided by the Performance Monitoring SDK.\n\nVisit [Add monitoring for specific code](/docs/perf-mon/custom-code-traces?platform=flutter)\nto learn more about these features and how to add them to your app.\n\n**Step 5**: Deploy your app then review results\n\nAfter you've validated Performance Monitoring using the an emulator and one or more\ntest devices, you can deploy the updated version of your app to your users.\n\nYou can monitor performance data in the\n[*Performance* dashboard](//console.firebase.google.com/project/_/performance)\nof the Firebase console.\n\nNext steps\n\n- Learn more about data automatically collected by Performance Monitoring:\n\n - Data related to your app's lifecycle, like [app start time](/docs/perf-mon/app-start-foreground-background-traces)\n - Data for [HTTP/S network requests](/docs/perf-mon/network-traces) issued by your app\n- [View, track, and filter](/docs/perf-mon/console) your\n performance data in the Firebase console.\n\n- Add monitoring for specific tasks or workflows in your app by\n [instrumenting custom code traces](/docs/perf-mon/custom-code-traces?platform=flutter).\n\n- [Use attributes to filter performance data](/docs/perf-mon/attributes)."]]
