Performance Monitoring raccoglie tracce per aiutarti a monitorare le prestazioni della tua app. Una traccia è un report dei dati sulle prestazioni acquisiti tra due momenti nella 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 "durata" (il tempo tra i punti di inizio e di arresto della traccia), ma puoi anche 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. Le tracce di codice personalizzate possono essere avviate in qualsiasi momento dopo la creazione e sono sicure nei thread.
Poiché la metrica predefinita raccolta per queste tracce è "durata", a volte viene chiamata "tracce durata".
Puoi visualizzare i dati di queste tracce nella sottoscheda Tracce personalizzate della tabella delle tracce, che si trova nella parte inferiore della 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 personalizzate, Performance Monitoring registra automaticamente gli attributi predefiniti (metadati comuni come versione dell'app, paese, dispositivo e così via) in modo da poter filtrare i dati relativi alla traccia nella console Firebase. Puoi anche aggiungere e monitorare gli attributi personalizzati, ad esempio il livello di gioco o le proprietà utente.Puoi configurare ulteriormente una traccia di codice personalizzata 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 fallimenti della cache o per il numero di volte in cui la UI non risponde per un periodo di tempo significativo.
Gli attributi e le metriche personalizzate vengono visualizzati nella console Firebase insieme agli attributi e alla metrica predefiniti per la traccia.
Aggiungere tracce di codice personalizzate
Utilizza l'API Trace Performance Monitoring (Swift | Obj-C) per aggiungere tracce di codice personalizzate per monitorare il codice specifico dell'applicazione.
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 interrompere una traccia di codice personalizzato, racchiudi il codice che vuoi tracciare con righe di codice simili alle seguenti:
Swift
// Add the Performance Monitoring module to your header import FirebasePerformance let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME") // code that you want to trace trace.stop()
Objective-C
// Add the Performance Monitoring module to your header @import FirebasePerformance; FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"]; // code that you want to trace [trace stop];
Aggiungi metriche personalizzate alle tracce di codice personalizzate
Usa l'API Trace Performance Monitoring (Swift | Obj-C) per aggiungere metriche personalizzate alle tracce di codice personalizzate.
Tieni presente quanto segue:
- I nomi delle metriche personalizzate devono soddisfare i seguenti requisiti:
nessun carattere iniziale o finale di spazio vuoto, nessun carattere iniziale di trattino basso (
_
) 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 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, come gli hit della cache o i tentativi di nuovo caricamento.
Swift
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME") trace.incrementMetric(named:"EVENT_NAME", by: 1) // code that you want to trace (and log custom metrics) trace.stop()
Objective-C
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"]; [trace incrementMetric:@"EVENT_NAME" byInt:1]; // code that you want to trace (and log custom metrics) [trace stop];
Creare attributi personalizzati per le tracce di codice personalizzate
Utilizza l'API Trace Performance Monitoring (Swift | Obj-C) per aggiungere attributi personalizzati alle 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'attributo personalizzato in qualsiasi momento tra l'inizio e la fine della traccia.
Tieni presente quanto segue:
I nomi degli attributi personalizzati devono soddisfare i seguenti requisiti:
- Nessuno spazio iniziale o finale, nessun carattere trattino basso (
_
) iniziale - Nessuno spazio
- La lunghezza massima è di 32 caratteri
- I caratteri consentiti per il nome sono
A-Z
,a-z
e_
.
- Nessuno spazio iniziale o finale, nessun carattere trattino basso (
Ogni traccia di codice personalizzato può registrare fino a 5 attributi personalizzati.
Assicurati che gli attributi personalizzati non contengano informazioni che consentono l'identificazione personale di un individuo per Google.
Scopri di più su queste linee guida
Swift
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME") trace.setValue("A", forAttribute: "experiment") // Update scenario. trace.setValue("B", forAttribute: "experiment") // Reading scenario. let experimentValue:String? = trace.valueForAttribute("experiment") // Delete scenario. trace.removeAttribute("experiment") // Read attributes. let attributes:[String, String] = trace.attributes;
Objective-C
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"]; [trace setValue:@"A" forAttribute:@"experiment"]; // Update scenario. [trace setValue:@"B" forAttribute:@"experiment"]; // Reading scenario. NSString *experimentValue = [trace valueForAttribute:@"experiment"]; // Delete scenario. [trace removeAttribute:@"experiment"]; // Read attributes. NSDictionary <NSString *, NSString *> *attributes = [trace attributes];
Monitorare, visualizzare e filtrare i dati sul rendimento
Monitorare metriche specifiche nella dashboard
Per scoprire l'andamento delle tue metriche principali, aggiungile alla scheda delle metriche nella parte superiore della dashboard Rendimento. Puoi identificare rapidamente le regressioni osservando le modifiche su base settimanale o verificare che le modifiche recenti al codice stiano migliorando le prestazioni.
Dashboard di Firebase Performance Monitoring" />Per aggiungere una metrica alla scheda delle metriche, segui questi passaggi:
- Vai alla dashboard Prestazioni nella console Firebase.
- Fai clic su una scheda metrica vuota, quindi seleziona una metrica esistente da aggiungere alla scheda.
- Fai clic su in una scheda delle metriche 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.
Visualizzare 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 e fai clic sulla scheda secondaria appropriata. La tabella mostra alcune delle metriche principali per ogni traccia e puoi anche ordinare l'elenco in base alla variazione percentuale per una metrica specifica.
Performance Monitoring fornisce una pagina di risoluzione dei problemi nella console Firebase che evidenzia le modifiche delle metriche, semplificando e riducendo al minimo l'impatto dei problemi di prestazioni su app e utenti. Puoi utilizzare questa pagina per la risoluzione dei problemi quando cerchi potenziali problemi di prestazioni, ad esempio nei seguenti scenari:
- Selezioni metriche pertinenti nella dashboard e noti un grande delta.
- Nella tabella delle tracce puoi ordinare in modo da visualizzare i delta più grandi in alto e vedere una variazione percentuale significativa.
- Ricevi un avviso via email che ti informa di un problema di rendimento.
Puoi accedere alla pagina di risoluzione dei problemi nei seguenti modi:
- Nella dashboard delle metriche, fai clic sul pulsante Visualizza dettagli metrica.
- In qualsiasi scheda delle metriche, seleziona
. La pagina per la risoluzione dei problemi mostra informazioni sulla metrica selezionata. => Visualizza dettagli - Nella tabella delle tracce, fai clic sul nome di una traccia o su un valore della metrica nella riga associata alla traccia.
- In un avviso via email, fai clic su Indaga ora.
Quando fai clic sul nome di una traccia nella tabella delle tracce, puoi visualizzare in dettaglio le metriche che ti interessano. Fai clic sul pulsante
- Filtra per Versione app per visualizzare i dati relativi a una release precedente o alla release più recente
- Filtra per Dispositivo per scoprire in che modo 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ù su come visualizzare i dati delle 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 rendimento nella consoleFirebase.
Configura avvisi per le modifiche al codice che riducono le prestazioni della tua app. Ad esempio, puoi configurare un avviso via email per il tuo team se la durata di una specifica traccia di codice personalizzata supera una soglia che hai impostato.
- Visualizza report dettagliati sulle sessioni utente in cui puoi vedere una traccia specifica nel contesto di una sequenza temporale di altre tracce raccolte durante la stessa sessione.