Il monitoraggio delle prestazioni raccoglie tracce per aiutarti a monitorare le prestazioni della tua app. Una traccia è un rapporto di dati sulle prestazioni acquisiti tra due punti nel tempo nella tua app.
Puoi creare le tue tracce per monitorare i dati sulle prestazioni associati a codice specifico nella tua app. Con una traccia del codice personalizzata , puoi misurare quanto tempo impiega la tua app per completare un'attività specifica o una serie di attività, ad esempio il caricamento di una serie di immagini o l'esecuzione di query sul database.
La metrica predefinita per una traccia di codice personalizzata è la sua "durata" (il tempo che intercorre tra il punto iniziale e quello di arresto della traccia), ma puoi anche aggiungere metriche personalizzate .
Nel tuo codice, definisci l'inizio e la fine di una traccia del codice personalizzato utilizzando le API fornite da Performance Monitoring SDK.
Le tracce del codice personalizzato possono essere avviate in qualsiasi momento dopo che sono state create e sono thread-safe.
Poiché la metrica predefinita raccolta per queste tracce è la "durata", a volte vengono chiamate "Tracce di durata".
Puoi visualizzare i dati di queste tracce nella sottoscheda Tracce personalizzate della tabella delle tracce, che si trova nella parte inferiore del dashboard Prestazioni (ulteriori informazioni sull'utilizzo della console più avanti in questa pagina).
Attributi predefiniti, attributi personalizzati e metriche personalizzate
Per le tracce del codice personalizzate, il monitoraggio delle prestazioni registra automaticamente gli attributi predefiniti (metadati comuni come versione dell'app, paese, dispositivo e così via) in modo da poter filtrare i dati per la traccia nella console Firebase. Puoi anche aggiungere e monitorare attributi personalizzati (come il livello di gioco o le proprietà dell'utente).
È inoltre possibile configurare una traccia del codice personalizzata per registrare le metriche personalizzate per gli eventi relativi alle prestazioni che si verificano nell'ambito della traccia. Ad esempio, puoi creare una metrica personalizzata per il numero di riscontri nella cache o per 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.
Aggiungi tracce di codice personalizzate
Utilizzare l'API Performance Monitoring Trace per aggiungere tracce di codice personalizzate per monitorare il codice dell'applicazione specifica.
Notare quanto segue:
- Un'app può avere più tracce di codice personalizzate.
- È possibile eseguire contemporaneamente più tracce di codice personalizzato.
- I nomi per le tracce del codice personalizzato devono soddisfare i seguenti requisiti: nessuno spazio bianco iniziale o finale, nessun carattere di sottolineatura iniziale (
_
) e la lunghezza massima è di 100 caratteri. - Le tracce del codice personalizzato supportano l'aggiunta di metriche e attributi personalizzati .
Per avviare e arrestare una traccia del codice personalizzato, racchiudi il codice che desideri 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();
Aggiungi metriche personalizzate alle tracce di codice personalizzate
Utilizza l'API Performance Monitoring Trace per aggiungere metriche personalizzate alle tracce di codice personalizzate.
Notare quanto segue:
- I nomi per le metriche personalizzate devono soddisfare i seguenti requisiti: nessuno spazio bianco iniziale o finale, nessun carattere di sottolineatura iniziale (
_
) e la lunghezza massima è di 100 caratteri. - Ogni traccia di codice personalizzato può registrare fino a 32 metriche (inclusa la metrica Durata predefinita).
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 conta gli eventi relativi alle prestazioni che si verificano nella tua app, come gli accessi alla cache o i 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();
Crea attributi personalizzati per tracce di codice personalizzate
Per utilizzare gli attributi personalizzati, aggiungi il codice alla tua app che definisce l'attributo e lo associa a una specifica traccia del codice personalizzato. È possibile impostare l'attributo personalizzato in qualsiasi momento tra l'avvio e l'arresto della traccia.
Notare quanto segue:
I nomi per gli attributi personalizzati devono soddisfare i seguenti requisiti: nessuno spazio bianco iniziale o finale, nessun carattere di sottolineatura iniziale (
_
) e la lunghezza massima è di 32 caratteri.Ogni traccia di codice personalizzato può registrare fino a 5 attributi personalizzati.
Non dovresti utilizzare attributi personalizzati che contengono informazioni che identificano personalmente una persona per Google.
Il monitoraggio delle prestazioni non raccoglie alcuna informazione di identificazione personale (PII), come nomi, indirizzi e-mail o numeri di telefono. Gli sviluppatori possono raccogliere dati aggiuntivi utilizzando il monitoraggio delle prestazioni creando attributi personalizzati su tracce di codice personalizzate. Tali dati raccolti tramite il monitoraggio delle prestazioni non devono contenere informazioni che identificano personalmente un individuo per Google.
Ecco un esempio di messaggio di registro che non contiene informazioni di identificazione personale:
customTrace.putAttribute("experiment", "A"); // OK
Ecco un esempio che contiene informazioni di identificazione personale (non utilizzare questo tipo di attributo personalizzato nella tua app):
customTrace.putAttribute(("email", user.getEmailAddress()); // Don't do this!
I dati che espongono informazioni di identificazione personale sono soggetti a cancellazione senza preavviso.
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();
Tieni traccia, visualizza e filtra i dati sulle prestazioni
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 Performance . Puoi identificare rapidamente le regressioni visualizzando le modifiche settimanali o verificare che le modifiche recenti nel tuo codice stiano migliorando le prestazioni.
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 scheda. Fai clic sui puntini di sospensione verticali ( ⋮ ) su 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 delle 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:
- Filtra per versione dell'app per visualizzare i dati su una versione precedente o sulla tua 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 tuo database non riguardi una regione specifica
Scopri di più sulla visualizzazione dei dati per le tue tracce .
Prossimi passi
Ulteriori informazioni sull'utilizzo degli attributi per esaminare i dati sulle prestazioni.
Ulteriori informazioni su come tenere traccia dei problemi di prestazioni nella console Firebase.
Imposta avvisi per le modifiche al codice che riducono le prestazioni della tua app. Ad esempio, puoi configurare un avviso e-mail per il tuo team se la durata di una specifica traccia di codice personalizzato supera una soglia impostata.