Aggiungere il monitoraggio personalizzato per un codice dell'app specifico

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 tracce personalizzate per monitorare i dati sul rendimento associati a un codice specifico nella tua app. Con una tracce di codice personalizzata, puoi misurare in che modo tempo impiegato dall'app per completare un'attività specifica o un insieme di attività; esempio del caricamento di un insieme di immagini o dell'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

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 Trace Performance Monitoring (Swift | Obj-C) 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 righe di codice simili alle seguenti:

// 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()

// 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: 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 una riga di codice simile alla seguente ogni volta che 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.

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()

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

Usa l'API Trace Performance Monitoring (Swift | Obj-C) per aggiungere attributi personalizzati alle tracce di codice personalizzate.

Per utilizzare gli attributi personalizzati, aggiungi alla tua app 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 (_)
  • Nessuno spazio
  • La lunghezza massima è di 32 caratteri
  • I caratteri consentiti per il nome sono A-Z, a-z e _.

• Ogni traccia di codice personalizzato può registrare fino a 5 attributi personalizzati.

• Assicurati che gli attributi personalizzati non contengano informazioni che identificano personalmente un individuo su Google.

  Scopri di più su questa linea guida

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;

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 conoscere l'andamento delle tue metriche chiave, aggiungile alla bacheca delle metriche nella parte superiore della Dashboard sul rendimento. Puoi identificare rapidamente le regressioni analizzando su base settimanale modifiche o verificare che le modifiche recenti al codice stiano migliorando il rendimento.

Per aggiungere una metrica alla scheda delle metriche, segui questi passaggi:

1. Vai alla sezione Dashboard Performance nella console Firebase.
2. Fai clic su una scheda di una metrica vuota, poi seleziona una metrica esistente da aggiungere alla scheda.
3. Clic more_vert 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 sotto forma di grafico che di 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 e fai clic sulla sottoscheda appropriata. La tabella mostra alcune delle metriche principali per ogni traccia ed è anche possibile ordinare l'elenco per variazione percentuale per una metrica specifica.

Performance Monitoring fornisce una pagina per la risoluzione dei problemi nella console Firebase che mette in evidenza le variazioni delle metriche, consentendo di risolvere rapidamente e ridurre al minimo l'impatto dei problemi di prestazioni sulle tue app e sui tuoi utenti. Puoi usare la pagina di risoluzione dei problemi quando trovi potenziali problemi di prestazioni, ad esempio, nei seguenti scenari:

• Selezioni metriche pertinenti nella dashboard e noti un grande delta.
• Nella tabella delle tracce, ordina in modo da visualizzare i delta più grandi in alto e vedrai un una variazione percentuale significativa.
• Riceverai un avviso via email che ti informa di un problema di prestazioni.

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 more_vert => Visualizza dettagli La pagina di risoluzione dei problemi mostra informazioni sulla metrica che hai selezionato.
• 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 Esegui accertamenti ora.

Quando fai clic sul nome di una traccia nella tabella delle tracce, puoi visualizzare in dettaglio le metriche di interesse. Fai clic sull' Pulsante Filtraadd per filtrare i dati per attributo, ad esempio:

• Filtra per Versione dell'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 località del database non influisca su un valore specifico regione

Scopri di più su per la visualizzazione dei dati delle immagini.

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.

• Visualizzare report dettagliati sulle sessioni utente in cui puoi vedere una traccia specifica nel contesto della sequenza temporale di altre tracce raccolte durante lo stesso durante la sessione.