Scopri di più sui dati sulle prestazioni di caricamento delle pagine (app web)

Performance Monitoring utilizza le tracce per raccogliere dati sui processi monitorati nella tua app. Una traccia è un report che contiene i dati acquisiti tra due momenti nel tempo nella tua app.

Per le app web, Performance Monitoring raccoglie automaticamente una traccia per ogni pagina della tua app, chiamata traccia di caricamento pagina. Ogni traccia di caricamento pagina raccoglie le seguenti metriche predefinite:

  • Largest Contentful Paint: una metrica che misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui si verifica la modifica visiva più grande.

  • Interaction to Next Paint: una metrica che misura il tempo più lungo tra l'interazione dell'utente con la pagina e il momento in cui si verifica il paint successivo

  • Cumulative Layout Shift: una metrica che misura e assegna un punteggio alle variazioni del layout impreviste in una pagina

  • First Paint: una metrica che misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui si verifica qualsiasi modifica visiva.

  • First Contentful Paint: una metrica che misura il tempo che intercorre tra il momento in cui un utente accede a una pagina e quello in cui vengono visualizzati contenuti significativi, come un'immagine o un testo

  • domInteractive: una metrica che misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui la pagina è considerata interattiva per l'utente.

  • domContentLoadedEventEnd: una metrica che misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui il documento HTML iniziale viene completamente caricato e analizzato.

  • loadEventEnd: una metrica che misura il tempo che intercorre tra il momento in cui l'utente accede alla pagina e quello in cui viene completato l'evento di caricamento del documento corrente.

Puoi visualizzare i dati di queste tracce nella sottoscheda Caricamento pagina della tabella delle tracce, che si trova nella parte inferiore della dashboard Prestazioni (scopri di più su come utilizzare la console più avanti in questa pagina).

Definizione di una traccia di caricamento pagina

Questa traccia misura diverse metriche relative al caricamento delle pagine della tua app, in particolare il tempo necessario per raggiungere i punti di caricamento comuni, come un'app adattabile.

Le tracce di caricamento pagina ti aiutano a monitorare i Core Web Vitals della tua app, come First Contentful Paint.

Metriche raccolte per le tracce di caricamento pagina

Queste tracce sono pronte all'uso, quindi non puoi aggiungere metriche personalizzate o attributi personalizzati aggiuntivi.

Largest Contentful Paint

Questa metrica misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui vengono visualizzati l'immagine, il testo o il contenuto video più grandi.

Questa metrica è utile per capire quanto velocemente i contenuti principali della pagina web diventano visibili all'utente.

  • Inizia quando l'utente accede a una pagina.

  • Si interrompe quando si verifica la modifica visiva più grande, inclusi elementi di immagini, testo o video. Per maggiori dettagli, consulta i Core Web Vitals.

"Elemento Largest Contentful Paint" è un attributo personalizzato che identifica l'elemento corrispondente al Largest Contentful Paint. Questo dato viene acquisito oltre alla tempistica di Largest Contentful Paint.

Interaction to Next Paint

Questa metrica misura il tempo che intercorre tra l'interazione di un utente con una pagina e la visualizzazione della pagina successiva.

Questa metrica è utile perché misura la reattività di una pagina all'input utente.

  • Inizia quando l'utente interagisce con la pagina (clic del mouse, tocco su un dispositivo o input da tastiera).

  • Si interrompe quando si verifica il paint successivo. Per maggiori dettagli, consulta i Core Web Vitals.

"Interaction to Next Paint più lunga" è un attributo personalizzato che identifica l'elemento con cui l'utente ha interagito quando si è verificato l'evento Interaction to Next Paint. Questo viene acquisito in aggiunta alla tempistica di Interaction to Next Paint.

Cumulative Layout Shift

Questa metrica misura la più ampia serie di punteggi di variazione del layout per ogni variazione del layout imprevista che si verifica durante l'intero ciclo di vita della pagina.

Questa metrica è utile perché gli spostamenti imprevisti del layout possono compromettere l'esperienza utente. La metrica genera un punteggio basato sull'API Layout Instability. Per ulteriori dettagli su come viene calcolato il punteggio, consulta i Core Web Vitals.

"Target Cumulative Layout Shift più grande" è un attributo personalizzato che identifica l'elemento che si è spostato quando si è verificata la variazione del layout più grande. Questo dato viene acquisito in aggiunta al punteggio Cumulative Layout Shift.

Prima visualizzazione

Questa metrica misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui si verifica una modifica visiva.

Questa metrica è utile perché la prima visualizzazione indica agli utenti che la pagina sta iniziando a caricarsi.

  • Inizia quando l'utente accede a una pagina.

  • Si interrompe quando si verifica una qualsiasi modifica visiva, inclusa una modifica del colore di sfondo o il caricamento di un'intestazione.

First Contentful Paint

Questa metrica misura il tempo che intercorre tra il momento in cui un utente accede a una pagina e quello in cui vengono visualizzati contenuti significativi, come un'immagine o un testo.

Questa metrica è utile per capire quanto tempo impiegano gli utenti per visualizzare i contenuti effettivi della tua app, anziché solo un nuovo colore di sfondo o un'intestazione.

  • Inizia quando l'utente accede a una pagina.

  • Si interrompe immediatamente dopo che il browser esegue il rendering dei primi contenuti dal DOM, inclusi testo, immagini (incluse le immagini di sfondo), canvas non vuoti o SVG.

domInteractive

Questa metrica misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui la pagina viene considerata interattiva per l'utente.

Questa metrica è utile per capire quanto velocemente gli utenti possono effettivamente interagire con gli elementi della tua app, come pulsanti e link ipertestuali, anziché limitarsi a visualizzarli sullo schermo. Tieni presente che questo non significa che il browser risponderà all'interazione (per questa metrica, consulta la traccia Interaction to Next Paint).

  • Inizia quando l'utente accede a una pagina.

  • Si interrompe immediatamente prima che lo user agent imposti l'idoneità del documento HTML corrente su "interactive".

domContentLoadedEventEnd

Questa metrica misura il tempo che intercorre tra il momento in cui l'utente accede a una pagina e quello in cui il documento HTML iniziale viene caricato e analizzato completamente.

  • Inizia quando l'utente accede a una pagina.

  • Si interrompe immediatamente dopo il caricamento e l'analisi completi del documento HTML iniziale (DOMContentLoaded), ma ciò non significa che il caricamento di fogli di stile, immagini e frame secondari sia terminato.

loadEventEnd

Questa metrica misura il tempo che intercorre tra il momento in cui l'utente accede alla pagina e il momento in cui viene completato l'evento di caricamento del documento corrente.

Questa metrica è utile per capire quanto tempo è necessario per caricare tutti i tuoi contenuti, inclusi fogli di stile e immagini.

  • Inizia quando l'utente accede a una pagina.

  • Si interrompe immediatamente dopo il completamento dell'evento di caricamento del documento HTML corrente.

First Input Delay (deprecato)

Questa metrica misura il tempo che intercorre tra l'interazione dell'utente con una pagina e il momento in cui il browser è in grado di rispondere a questo input.

Questa metrica è utile perché la risposta del browser a un'interazione dell'utente fornisce agli utenti le prime impressioni sulla reattività della tua app.

  • Inizia quando l'utente interagisce per la prima volta con un elemento della pagina, ad esempio facendo clic su un pulsante o un link ipertestuale.

  • Si interrompe immediatamente dopo che il browser è in grado di rispondere all'input, il che significa che il browser non è impegnato a caricare o analizzare i tuoi contenuti.

La misurazione del First Input Delay richiede un polyfill legacy. Consulta la sezione Risoluzione dei problemi.

Monitora, visualizza e filtra i dati sul rendimento

Per visualizzare i dati sul rendimento in tempo reale, assicurati che la tua app utilizzi una versione dell'SDK Performance Monitoring compatibile con il trattamento dei dati in tempo reale. Scopri di più sui dati sul rendimento in tempo reale.

Monitora le metriche chiave nella tua dashboard

Per scoprire l'andamento delle metriche chiave, aggiungile alla bacheca delle metriche nella parte superiore della dashboard Rendimento. Puoi identificare rapidamente le regressioni visualizzando le modifiche di settimana in settimana o verificare che le modifiche recenti al codice stiano migliorando le prestazioni.

un'immagine della bacheca delle metriche nella <span class=Dashboard di Firebase Performance Monitoring" />

Per aggiungere una metrica alla dashboard delle metriche:

  1. Vai alla dashboard Prestazioni nella console Firebase.
  2. Fai clic su una scheda delle metriche vuota, poi seleziona una metrica esistente da aggiungere alla dashboard.
  3. Fai clic su in una scheda delle metriche compilata per visualizzare altre opzioni, ad esempio per sostituire o rimuovere una metrica.

La dashboard delle metriche mostra i dati delle metriche raccolti nel tempo, sia in forma grafica sia come variazione percentuale numerica.

Scopri di più su come utilizzare la dashboard.

Visualizza le tracce e i relativi dati

Per visualizzare le tracce, vai alla dashboard Prestazioni nella console Firebase, scorri verso il basso fino alla tabella delle tracce e fai clic sulla scheda secondaria appropriata. La tabella mostra alcune metriche principali per ogni traccia e puoi persino ordinare l'elenco in base alla variazione percentuale di una metrica specifica.

Performance Monitoring fornisce una pagina per la risoluzione dei problemi nella console Firebase che evidenzia le modifiche alle metriche, semplificando la risoluzione rapida e la riduzione al minimo dell'impatto dei problemi di prestazioni sulle tue app e sui tuoi utenti. Puoi utilizzare la pagina di risoluzione dei problemi quando vieni a conoscenza di potenziali problemi di prestazioni, ad esempio nei seguenti scenari:

  • Selezioni le metriche pertinenti nella dashboard e noti un delta elevato.
  • Nella tabella delle tracce, ordina i dati in modo da visualizzare i delta più grandi in alto e vedrai una variazione percentuale significativa.
  • Ricevi un avviso via email che ti informa di un problema di prestazioni.

Puoi accedere alla pagina di risoluzione dei problemi nei seguenti modi:

  • Nella dashboard delle metriche, fai clic sul pulsante Visualizza dettagli metrica.
  • In qualsiasi scheda delle metriche, seleziona => Visualizza dettagli. La pagina di risoluzione dei problemi mostra informazioni sulla metrica selezionata.
  • Nella tabella delle tracce, fai clic sul nome di una traccia o su un valore della metrica nella riga associata alla traccia.
  • In un avviso via email, fai clic su Indaga ora.

Quando fai clic sul nome di una traccia nella tabella delle tracce, puoi visualizzare in dettaglio le metriche di interesse. Fai clic sul pulsante Filtro per filtrare i dati in base all'attributo, ad esempio:

un'immagine di <span class=Dati di Firebase Performance Monitoring filtrati per attributo" />
  • Filtra per URL pagina per visualizzare i dati relativi a una pagina specifica del tuo sito.
  • Filtra per Tipo di connessione effettivo per scoprire in che modo una connessione 3G influisce sulla tua app.
  • Filtra per Paese per assicurarti che la posizione del database non influisca su una regione specifica

Scopri di più sulla visualizzazione dei dati per le tracce.

Passaggi successivi

  • Scopri di più sull'utilizzo degli attributi per esaminare i dati sul rendimento.

  • Scopri di più su come monitorare i problemi di prestazioni nella console Firebase.

  • Configura avvisi per i caricamenti pagina che peggiorano le prestazioni della tua app. Ad esempio, puoi configurare un avviso via email per il tuo team se il First Input Delay per una pagina specifica supera una soglia impostata da te.