Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now

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

Il monitoraggio delle prestazioni 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, il monitoraggio delle prestazioni raccoglie automaticamente una traccia per ogni richiesta di rete emessa dalla tua app, chiamata traccia della richiesta di rete HTTP / S. Queste tracce raccolgono le metriche per il tempo che intercorre tra il momento in cui l'app invia una richiesta a un endpoint del servizio e il completamento della risposta da tale endpoint. Per qualsiasi endpoint a cui l'app effettua una richiesta, il monitoraggio delle prestazioni acquisisce diverse metriche:

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

  • Dimensione payload di risposta: dimensione in byte del payload di rete scaricato dall'app

  • Richiedi dimensione payload: dimensione in byte del payload di rete caricato dall'app

  • Percentuale di successo: percentuale di risposte riuscite rispetto alle risposte totali (per misurare i guasti della rete o del server)

Il monitoraggio delle prestazioni raccoglie automaticamente le metriche per le richieste di rete che utilizzano le seguenti librerie di rete:

È possibile visualizzare i dati di queste tracce nella sottoscheda Richieste di rete della tabella delle tracce, che si trova nella parte inferiore del dashboard delle prestazioni (ulteriori informazioni sull'utilizzo della console più avanti in questa pagina).

Questo monitoraggio immediato include la maggior parte delle richieste di rete per la tua app. Tuttavia, alcune richieste potrebbero non essere segnalate o potresti utilizzare una libreria diversa per effettuare richieste di rete. In questi casi, è possibile utilizzare l'API di monitoraggio delle prestazioni per strumentare manualmente le tracce delle richieste di rete personalizzate .

Aggregazione dei dati in pattern URL

Firebase Performance Monitoring aggrega automaticamente i dati per richieste di rete simili per aiutarti a comprendere le tendenze nelle prestazioni delle tue 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 sotto il pattern URL. Firebase mostra i pattern URL e i relativi dati aggregati nella scheda Rete nella dashboard Prestazioni 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:

Ad esempio: una qualsiasi delle seguenti richieste 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 per i pattern URL automatici può anche contenere * come primo segmento, ad esempio: *.example.com/*/fruits/** . Attualmente non è supportato per i pattern URL personalizzati .

Firebase mappa ogni richiesta a un solo pattern URL . Se hai configurato pattern URL personalizzati , Firebase tenta prima di abbinare gli URL di richiesta a tali pattern. Se Firebase non trova alcun pattern URL personalizzato corrispondente, abbina un URL di richiesta al pattern URL automatico più rappresentativo. Ulteriori informazioni sui pattern URL automatici e personalizzati nelle sezioni seguenti.

Pattern URL automatici

Senza alcuna configurazione da parte tua, il monitoraggio delle prestazioni tenta di riflettere il comportamento di utilizzo più recente della tua app abbinando le richieste della tua app a pattern URL automatici .

Come funziona la corrispondenza automatica del pattern URL?

Firebase abbina ogni richiesta al pattern URL automatico più rappresentativo derivato dalle richieste inviate dalla tua app. Tieni presente, tuttavia, che Firebase tenta prima di abbinare gli URL di richiesta a qualsiasi pattern URL personalizzato configurato.

Il seguente è 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 di corrispondenza 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 è indirizzata a example.com/germany/animals/bears e example.com/germany/animals/birds . Pertanto, Firebase ricava un pattern URL più rappresentativo di example.com/germany/animals/** .

    Per qualsiasi nuova richiesta di corrispondenza a questo nuovo pattern URL, Firebase aggrega i dati delle richieste solo sotto il 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 a example.com/germany/animals/bears ed example.com/germany/animals/birds diminuiscono notevolmente. Firebase determina che example.com/germany/animals/** non è rappresentativo dell'ultimo comportamento di utilizzo della tua app, quindi Firebase inizia a far corrispondere queste due richieste a example.com/germany/** .

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

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

  • Le corrispondenze e i dati aggregati delle richieste precedenti non sono influenzati dai nuovi pattern URL. Firebase non aggrega nuovamente i dati delle richieste in modo retroattivo.

  • Solo le richieste future sono influenzate dai nuovi pattern URL. Firebase mappa ogni nuova richiesta al pattern URL automatico più rappresentativo. Tieni presente, tuttavia, che Firebase tenta prima di abbinare gli URL di richiesta a qualsiasi pattern URL personalizzato configurato.

Visualizza i pattern URL automatici e i relativi dati

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

Potresti visualizzare pattern URL con un'etichetta Senza categoria . Si tratta di pattern URL automatici "generici" in base ai quali Firebase può aggregare dati per richieste che non corrispondono a pattern URL più specifici.

Quando il periodo di conservazione dei dati termina per i dati aggregati in un pattern URL, Firebase elimina i dati dal pattern URL. Se tutti i dati aggregati in un pattern URL automatico scadono, Firebase elimina quel pattern URL dalla console di Firebase.

Pattern URL personalizzati

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

Visita Crea pattern URL personalizzati per saperne di più.

Tieni traccia, visualizza e filtra i dati sulle prestazioni

Per visualizzare i dati sulle prestazioni in tempo reale, assicurati che l'app utilizzi una versione dell'SDK di monitoraggio delle prestazioni compatibile con l'elaborazione dei dati in tempo reale. Scopri di più .

Tieni traccia di metriche specifiche nella tua dashboard

Per sapere come stanno andando le tue metriche chiave, aggiungile alla tua bacheca delle metriche nella parte superiore della dashboard Prestazioni . Puoi identificare rapidamente le regressioni visualizzando le modifiche di settimana in settimana o verificando che le modifiche recenti nel codice migliorino le prestazioni.

un'immagine della scheda delle metriche nella dashboard di Firebase Performance Monitoring

Per aggiungere una metrica alla scheda delle metriche, vai alla dashboard Prestazioni nella console Firebase, quindi fai clic sulla scheda Dashboard . Fai clic su una scheda metrica vuota, quindi seleziona una metrica esistente da aggiungere alla tua bacheca. Fai su in una scheda metrica popolata per ulteriori opzioni, come sostituire o rimuovere una metrica.

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

Ulteriori informazioni sull'utilizzo della dashboard .

Visualizza le tracce e i relativi dati

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

Se si fa clic sul nome di una traccia nella tabella delle tracce, è quindi possibile fare clic su varie schermate per esplorare la traccia e visualizzare in dettaglio le metriche di interesse. Nella maggior parte delle pagine, puoi utilizzare il pulsante filtro (in alto a sinistra dello schermo) per filtrare i dati per attributo, ad esempio:

un'immagine dei dati di Firebase Performance Monitoring filtrati per attributo
  • Filtra per versione dell'app per visualizzare i dati su una versione precedente o su quella più recente
  • Filtra per dispositivo per scoprire come i dispositivi meno recenti gestiscono la tua app
  • Filtra per Paese per assicurarti che la posizione del database non influisca su una regione specifica

Ulteriori informazioni sulla visualizzazione dei dati per le tue tracce .

Prossimi passi

  • Visualizza rapporti dettagliati delle sessioni utente in cui puoi vedere una traccia specifica in un contesto di timeline di altre tracce raccolte durante la stessa sessione.