Inizia con il monitoraggio delle prestazioni per Android

Prima di iniziare

Se non l'hai già, aggiungi Firebase al progetto Android .

Passo 1: Aggiungere il Monitoraggio del rendimento SDK per la vostra applicazione

Dopo aver aggiunto il Monitoraggio del rendimento SDK, Firebase avvia automaticamente la raccolta di dati per la vostra applicazione di rendering dello schermo e dei dati relativi al ciclo di vita della tua app (come app ora di inizio ). Per consentire Firebase di monitorare le richieste di rete, è necessario aggiungere anche il Monitoraggio del rendimento plug Gradle (passo successivo).

  1. Utilizzando la Firebase Android BoM , dichiarare la dipendenza per il Monitoraggio del rendimento libreria Android nel modulo (a livello di app) File Gradle (di solito app/build.gradle ).

    Giava

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.3.0')
    
        // Declare the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf'
    }
    

    Usando il Firebase Android BoM , la vostra applicazione sarà sempre utilizzare versioni compatibili delle librerie Firebase Android.

    (Alternativa) Dichiarare Firebase dipendenze delle librerie senza utilizzare la distinta

    Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella relativa riga di dipendenza.

    Si noti che se si utilizzano più librerie Firebase nella vostra app, ti consigliamo di utilizzare la distinta di gestire versioni della libreria, che assicura che tutte le versioni sono compatibili.

    dependencies {
        // Declare the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf:20.0.2'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.3.0')
    
        // Declare the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx'
    }
    

    Usando il Firebase Android BoM , la vostra applicazione sarà sempre utilizzare versioni compatibili delle librerie Firebase Android.

    (Alternativa) Dichiarare Firebase dipendenze delle librerie senza utilizzare la distinta

    Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella relativa riga di dipendenza.

    Si noti che se si utilizzano più librerie Firebase nella vostra app, ti consigliamo di utilizzare la distinta di gestire versioni della libreria, che assicura che tutte le versioni sono compatibili.

    dependencies {
        // Declare the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx:20.0.2'
    }
    

  2. Ricompila la tua app.

Fase 2: Aggiungere il plugin Monitoraggio del rendimento per la vostra applicazione

Dopo aver aggiunto il Monitoraggio del rendimento plug Gradle, Firebase avvia automaticamente la raccolta di dati per HTTP / S richieste di rete . Il plugin consente inoltre di tracce di codice strumento personalizzati utilizzando @AddTrace annotazioni .

  1. Nel modulo (a livello di app) File Gradle (di solito app/build.gradle ), applicare il plugin Monitoraggio delle prestazioni:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. In root-level (a livello di progetto) di file Gradle ( build.gradle ), aggiungere le regole per includere il plugin Monitoraggio del rendimento.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.8'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.4.0'  // Performance Monitoring plugin
        }
    }
    
  3. Ricompila la tua app.

Fase 3: Generare eventi performativi per la visualizzazione dei dati iniziali

Firebase inizia a elaborare gli eventi quando aggiungi correttamente l'SDK alla tua app. Se stai ancora sviluppando in locale, interagisci con la tua app per generare eventi per la raccolta e l'elaborazione iniziali dei dati.

  1. Genera eventi passando più volte l'app in background e in primo piano, interagendo con l'app navigando tra le schermate e/o attivando richieste di rete.

  2. Vai alla performance dashboard della console Firebase. Dovresti vedere la visualizzazione dei dati iniziali entro pochi minuti.

    Se non si vede una visualizzazione dei dati iniziali, rivedere i suggerimenti di risoluzione dei problemi .

Fase 4: (facoltativo) Visualizza i messaggi di log per gli eventi di performance

  1. Abilitare la registrazione di debug per Monitoraggio del rendimento in fase di compilazione con l'aggiunta di un <meta-data> elemento della tua app AndroidManifest.xml del file, in questo modo:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. Controlla i tuoi messaggi di registro per eventuali messaggi di errore.

  3. Performance Monitoring tag propri messaggi di log con FirebasePerformance . Utilizzando il filtro logcat, è possibile visualizzare in modo specifico la traccia della durata e la registrazione delle richieste di rete HTTP/S eseguendo il comando seguente:

    adb logcat -s FirebasePerformance
  4. Controllare i seguenti tipi di log che indicano che il monitoraggio delle prestazioni sta registrando gli eventi delle prestazioni:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. Fare clic sull'URL per visualizzare i dati nella console Firebase. L'aggiornamento dei dati nella dashboard potrebbe richiedere alcuni istanti.

Se l'applicazione non sta registrando eventi di prestazioni, rivedere i suggerimenti di risoluzione dei problemi .

Passo 5: (facoltativo) aggiungere personalizzato monitoraggio di codice specifico

Per monitorare i dati delle prestazioni associati a codice specifico nella vostra applicazione, è possibile strumento tracce di codice personalizzato .

Con una traccia del codice personalizzata, puoi misurare quanto tempo impiega la tua app per completare un'attività specifica o una serie di attività, come il caricamento di una serie di immagini o l'esecuzione di query sul database. La metrica predefinita per una traccia di codice personalizzata è la sua durata, ma puoi anche aggiungere metriche personalizzate, come riscontri nella cache e avvisi di memoria.

Nel codice, definisci l'inizio e la fine di una traccia del codice personalizzato (e aggiungi eventuali metriche personalizzate desiderate) utilizzando l'API fornita dall'SDK di monitoraggio delle prestazioni. Per le applicazioni Android, è possibile anche monitorare la durata di metodi specifici che utilizzano @AddTrace annotazioni .

Visita Aggiungi il monitoraggio di codice specifico per saperne di più su queste funzioni e come per aggiungerli alla vostra applicazione.

Passo 6: distribuire l'applicazione poi risultati recensione

Dopo aver convalidato il monitoraggio delle prestazioni utilizzando uno o più dispositivi di prova, puoi distribuire la versione aggiornata della tua app ai tuoi utenti.

È possibile monitorare i dati sulle prestazioni nella performance dashboard della console Firebase.

Problemi conosciuti

  • Il plug-in Gradle di monitoraggio delle prestazioni v1.1.0 può causare una mancata corrispondenza nelle dipendenze Guava, con il seguente errore:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    Se vedi questo errore, puoi:

    • Aggiorna il plug-in di monitoraggio delle prestazioni alla v1.1.1 o successiva (la più recente è la v1.4.0).

    • Sostituire il Monitoraggio del rendimento plug riga di dipendenza nella root-level (a livello di progetto) di file Gradle ( build.gradle ), come segue:

      buildscript {
        // ...
      
        dependencies {
          // ...
      
          // Replace the standard Performance Monitoring plugin dependency line, as follows:
          classpath ('com.google.firebase:perf-plugin:1.1.0') {
                      exclude group: 'com.google.guava', module: 'guava-jdk5'
          }
        }
      }
      
  • Il monitoraggio delle prestazioni riporta la dimensione totale del payload per le richieste di rete HTTP in base al valore impostato nell'intestazione della lunghezza del contenuto HTTP. Questo valore potrebbe non essere sempre accurato.

  • Il monitoraggio delle prestazioni supporta solo il processo principale nelle app Android multiprocesso.

Prossimi passi