Performance Monitoring raccoglie le tracce per aiutarti a monitorare il rendimento della tua app. Una traccia è un report dei dati sul rendimento acquisiti tra due punti nel tempo nella tua app.
Puoi creare tracce personalizzate per monitorare i dati sul rendimento associati a un codice specifico nella tua app. Con una traccia di codice personalizzato, puoi misurare il tempo impiegato dalla tua app per completare un'attività specifica o un insieme di attività, ad esempio il caricamento di un insieme di immagini o l'interrogazione del database.
La metrica predefinita per una traccia di codice personalizzato è la "durata" (il tempo che intercorre tra i punti di inizio e di interruzione della traccia), ma puoi aggiungere anche metriche personalizzate.
Nel codice, definisci l'inizio e la fine di una traccia di codice personalizzata utilizzando le API fornite dall'SDK Performance Monitoring.
Le tracce di codice personalizzato possono essere avviate in qualsiasi momento dopo la creazione e sono thread-safe.
Poiché la metrica predefinita raccolta per queste tracce è "duration", a volte vengono chiamate "tracce di durata".
Puoi visualizzare i dati di queste tracce nella scheda secondaria Tracce personalizzate della tabella delle tracce, che si trova in fondo alla dashboard Rendimento (scopri di più sull'utilizzo della console più avanti in questa pagina).
Attributi predefiniti, attributi personalizzati e metriche personalizzate
Per le tracce di codice personalizzato, Performance Monitoring registra automaticamente attributi predefiniti (metadati comuni come versione dell'app, paese, dispositivo e così via) in modo da poter filtrare i dati della traccia nella console Firebase. Puoi anche aggiungere e monitorare attributi personalizzati (ad esempio, livello di gioco o proprietà utente).
Puoi configurare ulteriormente una traccia di codice personalizzato per registrare metriche personalizzate per gli eventi correlati al rendimento che si verificano nell'ambito della traccia. Ad esempio, puoi creare una metrica personalizzata per il numero di hit e mancati riscontri della cache o il numero di volte in cui l'interfaccia utente non risponde per un periodo di tempo notevole.
Gli attributi personalizzati e le metriche personalizzate vengono visualizzati nella console Firebase insieme agli attributi predefiniti e alla metrica predefinita per la traccia.
Aggiungere tracce di codice personalizzate
Utilizza l'API Trace di Performance Monitoring per aggiungere tracce di codice personalizzato per monitorare codice dell'applicazione specifico.
Tieni presente quanto segue:
- Un'app può avere più tracce di codice personalizzate.
- È possibile eseguire più di una traccia di codice personalizzato contemporaneamente.
- I nomi delle tracce di codice personalizzato devono soddisfare i seguenti requisiti:
nessuno spazio vuoto iniziale o finale, nessun carattere di sottolineatura iniziale (
_) e lunghezza massima di 100 caratteri. - Le tracce di codice personalizzato supportano l'aggiunta di metriche personalizzate e attributi personalizzati.
Per avviare e interrompere una traccia del codice personalizzato, racchiudi il codice che vuoi tracciare con un codice simile al seguente:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Aggiungere metriche personalizzate alle tracce di codice personalizzato
Utilizza l'API Performance Monitoring Trace per aggiungere metriche personalizzate alle tracce di codice personalizzato.
Tieni presente quanto segue:
- I nomi delle metriche personalizzate devono soddisfare i seguenti requisiti:
nessuno spazio vuoto iniziale o finale, nessun carattere di sottolineatura iniziale (
_) e lunghezza massima di 100 caratteri. - Ogni traccia di codice personalizzato può registrare fino a 32 metriche (inclusa la metrica predefinita Durata).
Per aggiungere una metrica personalizzata, aggiungi una riga di codice simile alla seguente ogni volta che si verifica l'evento. Ad esempio, questa metrica personalizzata conteggia gli eventi correlati al rendimento che si verificano nella tua app, ad esempio hit della cache o tentativi.
Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();
// Code you want to trace
customTrace.incrementMetric("metric-name", 1);
// More code
await customTrace.stop();
Creare attributi personalizzati per le tracce di codice personalizzate
Per utilizzare gli attributi personalizzati, aggiungi alla tua app un codice che definisca l'attributo e lo associ a una traccia di codice personalizzato specifica. Puoi impostare l'attributo personalizzato in qualsiasi momento tra l'inizio e l'interruzione della traccia.
Tieni presente quanto segue:
I nomi degli attributi personalizzati devono soddisfare i seguenti requisiti: nessuno spazio vuoto iniziale o finale, nessun carattere di sottolineatura iniziale (
_) e lunghezza massima di 32 caratteri.Ogni traccia di codice personalizzato può registrare fino a 5 attributi personalizzati.
Non devi utilizzare attributi personalizzati che contengono informazioni che identificano personalmente un individuo per Google.
Trace trace = FirebasePerformance.instance.newTrace("test_trace");
// Update scenario.
trace.putAttribute("experiment", "A");
// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");
// Delete scenario.
trace.removeAttribute("experiment");
// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
Monitorare, visualizzare e filtrare i dati sul rendimento
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 visualizzando le variazioni di settimana in settimana o verificare che le modifiche recenti al codice stiano migliorando il rendimento.
Per aggiungere una metrica alla bacheca delle metriche, vai alla dashboard Rendimento nella console Firebase, poi fai clic sulla scheda Dashboard. Fai clic su una scheda metrica vuota, quindi seleziona una metrica esistente da aggiungere alla bacheca. Fai clic sui puntini verticali (⋮) su una scheda metrica 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 tue tracce, vai alla dashboard Rendimento nella console Firebase, scorri verso il basso fino alla tabella delle tracce e poi 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.
Se fai clic sul nome di una traccia nella tabella delle tracce, puoi 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 Filtra (in alto a sinistra dello schermo) per filtrare i dati per attributo, ad esempio:
- Filtra per Versione app per visualizzare i dati relativi a una release precedente o alla tua ultima release.
- 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.
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 prestazioni nella console Firebase.
Configura avvisi per le modifiche al codice che peggiorano il rendimento della tua app. Ad esempio, puoi configurare un avviso via email per il tuo team se la durata di una traccia di codice personalizzato specifica supera una soglia che hai impostato.