Ulteriori 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 nell'app. Una traccia è un rapporto che contiene i dati acquisiti tra due momenti nella tua app.

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

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

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

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

  • Tasso di successo: percentuale di risposte riuscite (codici di risposta nell'intervallo 100 - 399) rispetto al totale delle risposte

Puoi 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).

Personalizza l'aggregazione dei dati delle richieste di rete

Oltre agli strumenti pronti all'uso e all'aggregazione dei dati per le richieste di rete, Performance Monitoring supporta anche le seguenti opzioni:

  • Strumento manuale delle tracce delle richieste di rete: il monitoraggio pronto all'uso 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, puoi utilizzare l'API di monitoraggio delle prestazioni per strumentare manualmente le tracce delle richieste di rete personalizzate .
  • Aggrega i dati in pattern URL personalizzati: se ci sono URL specifici che Firebase non acquisisce con la corrispondenza automatica del pattern URL derivato, puoi creare pattern URL personalizzati per monitorare un insieme specifico di URL nel tempo.
  • Personalizza il modo in cui viene calcolata la percentuale di successo: a volte è previsto un codice di errore per determinati endpoint API o è già gestito nella tua app. In questi casi, puoi configurare il modo in cui viene calcolata la percentuale di successo e monitorare la percentuale di successo delle chiamate di rete della tua app in modo più accurato.

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 visualizza i pattern URL e i relativi dati aggregati nella scheda Rete nel 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 un pattern URL può anche contenere * come primo segmento, ad esempio: *.example.com/*/fruits/** .

Firebase associa ogni richiesta a un solo pattern URL . Se hai configurato pattern URL personalizzati , Firebase tenta di abbinare prima gli URL di richiesta a tali 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 della tua app ai pattern URL automatici .

Come funziona la corrispondenza automatica del pattern URL?

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

Quello che segue è 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 sotto il pattern URL automatico example.com/germany/** .

  2. Dopo una settimana, la maggior parte delle richieste della tua app sono a example.com/germany/animals/bears e example.com/germany/animals/birds . Quindi, 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 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 a example.com/germany/animals/bears e example.com/germany/animals/birds diminuiscono notevolmente. Firebase determina che example.com/germany/animals/** non è rappresentativo del comportamento di utilizzo più recente della tua app, quindi Firebase inizia a far corrispondere queste due richieste tornando a example.com/germany/** .

    Firebase non aggrega ulteriori dati sulle richieste 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 interessati dai nuovi pattern URL. Firebase non riaggrega retroattivamente i dati delle richieste.

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

Visualizza i pattern URL automatici e i relativi dati

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

Potresti vedere pattern URL con un'etichetta Uncategorized . Si tratta di pattern URL automatici "ampi" in base ai quali Firebase può aggregare i dati per le richieste che non corrispondono a pattern URL più specifici.

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

Pattern URL personalizzati

Puoi creare pattern URL personalizzati per monitorare pattern URL specifici che Firebase non sta acquisendo con la corrispondenza automatica del pattern URL derivato . 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ù.

Traccia, visualizza e filtra i dati sulle prestazioni

Per visualizzare i dati sulle prestazioni in tempo reale, assicurati che la tua app utilizzi una versione dell'SDK di monitoraggio delle prestazioni compatibile con l'elaborazione dei dati in tempo reale. Ulteriori informazioni sui dati sulle prestazioni in tempo reale .

Tieni traccia di metriche specifiche nella tua dashboard

Per conoscere l'andamento delle tue metriche chiave, aggiungile alla scheda delle metriche nella parte superiore della dashboard del rendimento . Puoi identificare rapidamente le regressioni visualizzando le modifiche settimana dopo settimana o verificare che le modifiche recenti al codice stiano migliorando le prestazioni.

un'immagine della scheda delle metriche nella dashboard di monitoraggio delle prestazioni di Firebase

Per aggiungere una metrica alla scheda delle metriche, procedi nel seguente modo:

  1. Vai alla dashboard delle prestazioni nella console Firebase.
  2. Fai clic su una scheda metrica vuota, quindi seleziona una metrica esistente da aggiungere alla tua bacheca.
  3. Fai clic su su una scheda metrica popolata per ulteriori opzioni, ad esempio per 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 loro dati

Per visualizzare le tue tracce, vai al 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 ciascuna traccia e puoi persino ordinare l'elenco in base alla variazione percentuale per una metrica specifica.

Monitoraggio delle prestazioni fornisce una pagina per la risoluzione dei problemi nella console Firebase che evidenzia le modifiche alle metriche, semplificando la rapida risoluzione e riducendo al minimo l'impatto dei problemi di prestazioni sulle tue app e sugli utenti. Puoi utilizzare la pagina di risoluzione dei problemi per conoscere potenziali problemi di prestazioni, ad esempio nei seguenti scenari:

  • Selezioni le metriche pertinenti sulla dashboard e noti un grande delta.
  • Nella tabella delle tracce si ordina per visualizzare i delta più grandi in alto e si vede una variazione percentuale significativa.
  • Ricevi un avviso e-mail che ti informa di un problema di prestazioni.

È possibile accedere alla pagina di risoluzione dei problemi nei seguenti modi:

  • Nella dashboard delle metriche, fai clic sul pulsante Visualizza dettagli metrica .
  • Su qualsiasi scheda metrica, seleziona => Visualizza dettagli . La pagina di risoluzione dei problemi mostra informazioni sulla metrica selezionata.
  • Nella tabella delle tracce, fare clic sul nome di una traccia o su qualsiasi valore di metrica nella riga associata a tale traccia.
  • In un avviso e-mail, fai clic su Esamina ora .

Quando si fa clic sul nome di una traccia nella tabella delle tracce, è possibile visualizzare in dettaglio le metriche di interesse. Fare clic sul pulsante filtro per filtrare i dati per attributo, ad esempio:

un'immagine dei dati di monitoraggio delle prestazioni di Firebase filtrati per attributo
  • Filtra per versione dell'app per visualizzare i dati su una versione passata o sull'ultima versione
  • 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

  • Ulteriori informazioni sull'utilizzo degli attributi per esaminare i dati sulle prestazioni.

  • Scopri di più su come tenere traccia dei problemi di prestazioni nella console Firebase.

  • Imposta avvisi per le richieste di rete che stanno degradando le prestazioni della tua app. Ad esempio, puoi configurare un avviso e-mail per il tuo team se il tempo di risposta per un pattern URL specifico supera una soglia impostata.

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