Inizia a utilizzare il monitoraggio del rendimento per il web

Prima di iniziare

Se non l'hai già fatto, consulta 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 JS Performance Monitoring 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 libreria polyfill per il ritardo del primo input

Per misurare la metrica del primo ritardo di input, 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 consentire a Performance Monitoring di generare report sulle altre metriche delle app web.

Passaggio 3: genera eventi sul rendimento per la visualizzazione dei dati iniziali

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

  2. Genera eventi caricando pagine secondarie per il tuo sito, interagendo con la tua app e/o attivando richieste di rete. Assicurati di mantenere 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 qualche minuto.

    Se non vedi i dati iniziali, consulta i suggerimenti per la risoluzione dei problemi.

Passaggio 4: (Facoltativo) visualizza i messaggi di log per gli eventi relativi al rendimento

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

  2. Aggiorna l'app web nel browser.

  3. Controlla se nei messaggi del log sono presenti messaggi di errore.

  4. Dopo alcuni secondi, 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 sul rendimento, consulta i suggerimenti per la risoluzione dei problemi.

Passaggio 5: (Facoltativo) aggiungi il monitoraggio personalizzato per un codice specifico

Per monitorare i dati sulle prestazioni 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 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 personalizzata (e aggiungi le metriche personalizzate che preferisci) 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 6: esegui il deployment dell'app e poi esamina i risultati

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

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

Passaggi successivi