Performance Monitoring raccoglie tracce per aiutarti a monitorare le prestazioni della tua app. R è un report dei dati sulle prestazioni acquisiti tra due momenti nel la tua app.
Puoi creare le tue tracce per monitorare i dati sul rendimento associati a codice specifico nella tua app. Con una traccia di codice personalizzata, puoi misurare il tempo necessario alla tua app per completare un'attività specifica o un insieme di attività, ad esempio il caricamento di un insieme di immagini o l'esecuzione di query sul database.
La metrica predefinita per una traccia di codice personalizzata è la sua "durata" (l'intervallo di i punti di inizio e di fine della traccia), ma puoi aggiungere metriche personalizzate.
Nel codice definisci l'inizio e la fine di una traccia di codice personalizzata utilizzando le API fornite dall'SDK Performance Monitoring.
Dopo la creazione, le tracce di codice personalizzate possono essere avviate in qualsiasi momento sono sicuri per i thread.
Poiché la metrica predefinita raccolta per queste tracce è "durata", vengono chiamata a volte "Tracce durata".
Puoi visualizzare i dati di queste tracce nella scheda secondaria Tracce personalizzate delle tracce. che si trova nella parte inferiore della dashboard Rendimento (scopri di più su come utilizzando la console più avanti in questa pagina).
Attributi predefiniti, attributi personalizzati e metriche personalizzate
Per le tracce di codice personalizzate, Performance Monitoring registra automaticamente 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 (ad esempio, il livello del gioco o le proprietà utente).
Puoi configurare ulteriormente una traccia di codice personalizzata metriche personalizzate per eventi correlati al rendimento che che si verifichino nell'ambito della traccia. Ad esempio, puoi creare una metrica personalizzata per il numero di hit e fallimenti della cache o il numero di volte in cui l'interfaccia utente non risponde per un periodo di tempo notevole.
Gli attributi 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
Usa l'API Performance Monitoring Trace per aggiungere tracce di codice personalizzate per monitorare codice dell'applicazione specifico.
Tieni presente quanto segue:
- Un'app può avere più tracce di codice personalizzate.
- È possibile eseguire più tracce di codice personalizzate contemporaneamente.
- I nomi delle tracce di codice personalizzate devono soddisfare i seguenti requisiti:
Nessuno spazio vuoto iniziale o finale, nessun carattere di sottolineatura iniziale (
_) e la lunghezza massima è di 100 caratteri. - Le tracce di codice personalizzate supportano l'aggiunta di metriche personalizzate e attributi personalizzati.
Per avviare e arrestare una traccia di codice personalizzata, esegui il wrapping del codice che vuoi tracciare 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
Usa l'API Performance Monitoring Trace per aggiungere metriche personalizzate alle tracce di codice personalizzate.
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 la lunghezza massima è di 100 caratteri. - Ogni traccia di codice personalizzata può registrare fino a 32 metriche (inclusa la metrica predefinita Durata).
Per aggiungere una metrica personalizzata, aggiungi ogni volta una riga di codice simile alla seguente in cui si verifica l'evento. Ad esempio, questa metrica personalizzata conteggia eventi correlati alle prestazioni che si verificano nella tua app, come hit della cache o nuovi 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 all'app del codice che definisce l'attributo e lo associa a una traccia di codice personalizzata specifica. Puoi impostare l'opzione l'attributo in qualsiasi momento tra l'inizio della traccia e il momento in cui si interrompe.
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 la lunghezza massima è di 32 caratteri.Ogni traccia di codice personalizzata può registrare fino a cinque attributi personalizzati.
Non utilizzare attributi personalizzati che contengono informazioni personali identifica un privato a 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 conoscere l'andamento delle tue metriche chiave, aggiungile alla bacheca delle metriche all'indirizzo nella parte superiore della dashboard Rendimento. Per identificare rapidamente le regressioni, su base settimanale o verificare che le modifiche recenti al codice siano migliorando le prestazioni.
Per aggiungere una metrica alla scheda delle metriche, vai alla dashboard Rendimento. nella console Firebase, poi fai clic sulla scheda Dashboard. Fai clic su una metrica vuota e seleziona una metrica esistente da aggiungere alla scheda. Fai clic sul verticale puntini di sospensione (⋮) su una scheda della metrica compilata per visualizzare altre opzioni, ad esempio: per sostituire o rimuovere una metrica.
La scheda delle metriche mostra i dati delle metriche raccolti nel tempo, sia in forma grafica sia come variazione percentuale numerica.
Scopri di più sull'utilizzo della dashboard.
Visualizza 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, quindi fai clic appropriata in base alla relativa sottosezione. La tabella mostra alcune metriche principali per ogni traccia e puoi anche 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 schermate diverse 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 filtra i dati per attributo, ad esempio:
- Filtra per Versione dell'app per visualizzare i dati relativi a una release precedente o alla tua ultima versione rilasciare
- Filtra per Dispositivo per scoprire in che modo i dispositivi meno recenti gestiscono la tua app
- Filtra per Paese per assicurarti che la località del database non influisca su un regione specifica
Scopri di più sulla visualizzazione dei dati per le tracce.
Passaggi successivi
Scopri di più su utilizzando attributi per esaminare i dati sul rendimento.
Scopri di più su come monitorare i problemi di prestazioni Console Firebase.
Configura avvisi per le modifiche al codice in fase di riduzione 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.