Informazioni sui dati relativi alle prestazioni delle richieste di rete HTTP/S (qualsiasi app)

iOS+ Android Web Flutter

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 punti nel tempo nella tua app.

Per tutti i tipi di app, Performance Monitoring raccoglie automaticamente una traccia per ogni richiesta di rete emessa dalla tua app, chiamata traccia della richiesta di rete HTTP/S. Queste tracce raccolgono metriche per il tempo che intercorre tra il momento in cui la tua app invia una richiesta a un endpoint di servizio e il momento in cui la risposta da quell'endpoint è completa. Per qualsiasi endpoint a cui la tua app invia una richiesta, Performance Monitoring acquisisce diverse metriche:

• Tempo di risposta: il tempo che intercorre tra il momento in cui viene effettuata la richiesta e il momento in cui la risposta viene ricevuta completamente

• Dimensioni payload risposta: dimensioni in byte del payload di rete scaricato dall'app

Nota :l'SDK JavaScript Performance Monitoring utilizza l'API PerformanceResourceTiming per misurare le metriche delle richieste di rete ed è soggetto alle relative limitazioni e al relativo comportamento. Ad esempio, le dimensioni del payload di risposta segnalate possono essere pari a zero se la richiesta di rete era cross-origin, o se la risorsa richiesta è stata recuperata da una cache locale.

Puoi visualizzare i dati di queste tracce nella scheda secondaria Richieste di rete della tabella delle tracce, che si trova nella parte inferiore della dashboard Rendimento (scopri di più sull'utilizzo della console più avanti in questa pagina).

Il monitoraggio predefinito include la maggior parte delle richieste di rete per la tua app. Tuttavia, se ci sono URL specifici che Firebase non acquisisce con la corrispondenza automatica dei pattern URL derivati, puoi creare pattern URL personalizzati per monitorare un insieme specifico di URL nel tempo.

Aggregazione dei dati in base ai pattern URL

Firebase Performance Monitoring Aggrega automaticamente i dati per richieste di rete simili per aiutarti a comprendere le tendenze nel rendimento delle richieste di rete.

Per ogni richiesta, Firebase controlla se l'URL della richiesta di rete corrisponde a un pattern URL. Se l'URL della richiesta corrisponde a un pattern URL, Firebase aggrega automaticamente i dati della richiesta in base al pattern URL. Firebase mostra i pattern URL e i relativi dati aggregati nella scheda Rete della dashboard Rendimento della console Firebase.

Che cos'è un pattern URL?

Un pattern URL contiene un dominio più un pattern che può corrispondere a un percorso URL, ad esempio: example.com/*/animals/**.

• I pattern URL possono contenere i seguenti segmenti di percorso:

  • testo normale: corrisponde a una stringa esatta
  • *: corrisponde a qualsiasi stringa in un singolo segmento di percorso
  • **: corrisponde a un suffisso di percorso arbitrario

• I pattern URL possono essere:

  • Pattern derivati da Firebase, chiamati pattern URL automatici
  • Pattern definiti dall'utente, chiamati pattern URL personalizzati

Ad esempio, una qualsiasi delle seguenti richieste di URL potrebbe corrispondere al pattern URL example.com/*/animals/**.

• example.com/singapore/animals
• example.com/australia/animals/spiders
• example.com/australia/animals/marsupials/koala.png

Il dominio di un pattern URL può contenere anche * come primo segmento, ad esempio: *.example.com/*/fruits/**.

Firebase mappa ogni richiesta a un solo pattern URL. Se hai configurato pattern URL personalizzati, Firebase tenta di abbinare gli URL delle richieste a questi pattern. Se Firebase non trova alcun pattern URL personalizzato corrispondente, associa un URL di richiesta al pattern URL automatico più rappresentativo. Scopri di più sui pattern URL automatici e personalizzati nelle sezioni seguenti.

Pattern URL automatici

Senza alcuna configurazione da parte tua, Performance Monitoring tenta di riflettere il comportamento di utilizzo più recente della tua app abbinando le richieste dell'app a pattern URL automatici.

Come funziona la corrispondenza automatica dei pattern URL?

Firebase associa ogni richiesta al pattern URL automatico più rappresentativo che ha derivato dalle richieste inviate dalla tua app. Tieni presente, tuttavia, che Firebase tenta di associare gli URL delle richieste a eventuali pattern URL personalizzati configurati.

Di seguito è riportato un esempio di base di come Firebase tenta di abbinare le richieste al pattern URL automatico più rappresentativo per la tua app.

1. La tua app invia molte richieste a URL come:

   • example.com/germany/animals/bears
   • example.com/germany/animals/birds
   • example.com/germany/cars

   Firebase determina che example.com/germany/** è un pattern di richiesta comune per la tua app e lo aggiunge come pattern URL automatico nel tuo progetto.

   Per qualsiasi nuova richiesta corrispondente a questo pattern URL, Firebase aggrega i dati delle richieste nel pattern URL automatico example.com/germany/**.

2. Dopo una settimana, la maggior parte delle richieste della tua app riguarda example.com/germany/animals/bears e example.com/germany/animals/birds. Pertanto, Firebase deriva un pattern URL più rappresentativo di example.com/germany/animals/**.

   Per tutte le nuove richieste corrispondenti a questo nuovo pattern URL, Firebase aggrega i dati delle richieste solo nel nuovo pattern URL. Firebase continua ad aggregare i dati per le richieste a example.com/germany/cars in example.com/germany/**.

3. Tuttavia, nelle prossime settimane, le richieste della tua app di example.com/germany/animals/bears e example.com/germany/animals/birds diminuiranno in modo sostanziale. Firebase determina che example.com/germany/animals/** non è rappresentativo del comportamento di utilizzo più recente della tua app, quindi inizia a mettere in corrispondenza queste due richieste con example.com/germany/**.

   Firebase non aggrega ulteriori dati delle richieste in example.com/germany/animals/** perché non è più il pattern URL automatico più rappresentativo.

Poiché la corrispondenza automatica dei pattern URL è dinamica, tieni presente quanto segue:

• Le corrispondenze e i dati aggregati delle richieste precedenti non sono interessati dai nuovi pattern URL. Firebase non riaggrega retroattivamente i dati delle richieste.

• Solo le richieste future sono interessate dai nuovi pattern URL. Firebase mappa ogni nuova richiesta al pattern URL automatico più rappresentativo. Tieni presente, tuttavia, che Firebase tenta di abbinare gli URL delle richieste a eventuali pattern URL personalizzati configurati.

Visualizzare i pattern URL automatici e i relativi dati

Firebase mostra tutti i pattern URL e i relativi dati aggregati nella scheda secondaria Richieste di rete della tabella delle tracce, che si trova nella parte inferiore della dashboard Performance della console Firebase.

Potresti visualizzare pattern URL con l'etichetta Senza categoria. Questi sono pattern URL automatici "generici" in base ai quali Firebase può aggregare i dati per le richieste che non corrispondono a nessun pattern URL più specifico.

Al termine del periodo di conservazione dei dati per i dati aggregati in base a un pattern URL, Firebase elimina questi dati dal pattern URL. Se tutti i dati aggregati in un pattern URL automatico scadono, Firebase elimina il pattern URL dalla console Firebase.

Pattern URL personalizzati

Puoi creare pattern URL personalizzati per monitorare pattern URL specifici che Firebase non acquisisce con la corrispondenza automatica dei pattern URL. Ad esempio, puoi utilizzare un pattern URL personalizzato per risolvere i problemi relativi a un URL specifico o per monitorare un insieme specifico di URL nel tempo.

Visita la pagina Creare pattern URL personalizzati per scoprire di più.

Monitorare, visualizzare e filtrare i dati sul rendimento

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

Monitorare metriche specifiche nella dashboard

Per scoprire l'andamento delle tue metriche chiave, aggiungile al pannello delle metriche nella parte superiore della dashboard Rendimento. Puoi identificare rapidamente le regressioni monitorando le variazioni di settimana in settimana o verificare che le modifiche recenti al codice stiano migliorando il rendimento.

Firebase Performance Monitoring dashboard" />

Per aggiungere una metrica al tuo prospetto delle metriche:

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

Il prospetto delle metriche mostra i dati delle metriche raccolti nel tempo, sia in forma grafica che come variazione percentuale numerica.

Scopri di più sull'utilizzo della dashboard.

Visualizzare le tracce e i relativi dati

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

Performance Monitoring fornisce una pagina di risoluzione dei problemi nella console Firebase che mette in evidenza 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 per la risoluzione dei problemi quando riscontri potenziali problemi di prestazioni, ad esempio nei seguenti scenari:

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

Puoi accedere alla pagina per la risoluzione dei problemi nei seguenti modi:

• Nella dashboard delle metriche, fai clic sul pulsante Visualizza dettagli metrica.
• In una qualsiasi scheda delle metriche, seleziona => Visualizza dettagli. La pagina per la risoluzione dei problemi mostra informazioni sulla metrica che hai selezionato.
• Nella tabella delle tracce, fai clic sul nome di una traccia o su qualsiasi valore della metrica nella riga associata a quella traccia.
• In un avviso via email, fai clic su Analizza 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 Filtra per filtrare i dati per attributo, ad esempio:

Dati di Firebase Performance Monitoring filtrati per attributo" />

• Filtra per URL pagina per visualizzare i dati di una pagina specifica del tuo sito.
• Filtra per Tipo effettivo di connessione 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 tue 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 rendimento nella console Firebase.

• Configura avvisi per le richieste di rete che peggiorano il rendimento della tua app. Ad esempio, puoi configurare un avviso via email per il tuo team se il tempo di risposta per un pattern URL specifico supera una soglia che hai impostato.