Inizia a utilizzare il monitoraggio del rendimento per il web

Prima di iniziare

Se non l'hai ancora fatto, visita la pagina Aggiungere Firebase al progetto JavaScript per scoprire come:

  • Crea un progetto Firebase

  • Registra la tua app web con Firebase

Tieni presente che quando aggiungi Firebase alla tua app, potresti completare alcuni dei passaggi descritti più avanti in questa pagina (ad esempio, l'aggiunta dell'SDK e l'inizializzazione di Firebase).

Passaggio 1: aggiungi e inizializza Performance Monitoring

  1. Se non l'hai ancora fatto, installa l'SDK Firebase JS e inizializza Firebase.

  2. Aggiungi l'SDK Performance Monitoring JS e inizializza Performance Monitoring:

Web 

import { initializeApp } from "firebase/app";
import { getPerformance } from "firebase/performance";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Performance Monitoring and get a reference to the service
const perf = getPerformance(app);

Web 

import firebase from "firebase/compat/app";
import "firebase/compat/performance";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Performance Monitoring and get a reference to the service
const perf = firebase.performance();

Passaggio 2: aggiungi la prima libreria polyfill per il ritardo di input

Per misurare la metrica First Input Delay, devi aggiungere la libreria polyfill per questa metrica. Per le istruzioni di installazione, consulta la documentazione della libreria.

L'aggiunta di questa libreria polyfill non è necessaria per Performance Monitoring per segnalare le altre metriche delle app web.

Passaggio 3: 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. Pubblica e visualizza la tua app web in un ambiente locale.

  2. Genera eventi caricando le sottopagine del tuo sito, interagendo con la tua app e/o attivando richieste di rete. Assicurati di tenere aperta la scheda del browser per almeno 10 secondi dopo il caricamento della pagina.

  3. Vai alla dashboard Rendimento 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 4: (facoltativo) visualizza i messaggi di log per gli eventi di rendimento

  1. Apri gli strumenti per sviluppatori del browser (ad esempio, scheda Rete per Chrome DevTools o in Network Monitor per Firefox).

  2. Aggiorna la web app nel browser.

  3. Controlla i messaggi di log per eventuali messaggi di errore.

  4. Dopo qualche secondo, cerca una chiamata di rete a firebaselogging.googleapis.com negli strumenti per sviluppatori del browser. La presenza di questa chiamata di rete indica che il browser sta inviando dati sul rendimento a Firebase.

Se la tua app non registra gli eventi di rendimento, consulta i suggerimenti per la risoluzione dei problemi.

Passaggio 5: (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 6: esegui il deployment dell'app e rivedi i risultati

Dopo aver convalidato Performance Monitoring, puoi implementare la versione aggiornata della tua app per gli utenti.

Puoi monitorare i dati sul rendimento nella dashboard Rendimento della consoleFirebase.

Passaggi successivi