Aggiungi monitoraggio personalizzato per codice app specifico

Monitoraggio del rendimento Raccoglie tracce per aiutare a monitorare le prestazioni della vostra applicazione. Una traccia è un report dei dati sulle prestazioni acquisiti tra due momenti 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 di codice personalizzato, è possibile misurare quanto tempo ci vuole la vostra applicazione per completare un compito specifico o un insieme di attività, ad esempio il caricamento di una serie di immagini o di interrogare il database.

L'impostazione predefinita metrica per una traccia di codice personalizzato è la sua "durata" (il tempo tra i punti di partenza e di arresto della traccia), ma è possibile aggiungere metriche personalizzate, pure.

Nel codice, definisci l'inizio e la fine di una traccia del codice personalizzato utilizzando le API fornite dall'SDK di monitoraggio delle prestazioni.tracce di codice personalizzato può essere avviato in qualsiasi momento dopo che sono stati creati, e sono thread-safe.

Poiché la metrica predefinita raccolta per queste tracce è "durata", a volte vengono chiamate "tracce di durata".

È possibile visualizzare i dati da queste tracce in tracce personalizzate sottoscheda del tavolo tracce, che è alla base della plancia Performance (ulteriori informazioni su utilizzando la console più avanti in questa pagina).

Attributi predefiniti, attributi personalizzati e metriche personalizzate

di tracce di codice personalizzato, Monitoraggio del rendimento automaticamente registra gli attributi predefiniti (metadati comuni come la versione app, paese, dispositivo, ecc) in modo che è possibile filtrare i dati per la traccia nella console Firebase. È inoltre possibile aggiungere e monitorare gli attributi personalizzati (come ad esempio, il livello di gioco o proprietà utente).

È possibile configurare ulteriormente una traccia codice personalizzato per registrare metriche personalizzate per gli eventi relativi alle prestazioni che si verificano nel campo di applicazione della traccia. Ad esempio, puoi creare una metrica personalizzata per il numero di riscontri e errori 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 e alla metrica predefiniti per la traccia.

Aggiungi tracce di codice personalizzate

Utilizzare il Monitoraggio del rendimento traccia API ( Swift | Obj-C ) per aggiungere le tracce di codice personalizzato per monitorare codice dell'applicazione specifica.

Nota quanto segue:

  • Un'app può avere più tracce di codice personalizzate.
  • È possibile eseguire più di una traccia di codice personalizzato contemporaneamente.
  • I nomi per le tracce di codice personalizzato devono soddisfare i seguenti requisiti: senza spazi iniziali o finali, nessuna sottolineatura ( _ carattere), e la lunghezza massima è di 100 caratteri.
  • Tracce di codice personalizzato Supporta l'aggiunta di metriche personalizzate e attributi personalizzati .

Per avviare e interrompere una traccia di codice personalizzato, racchiudere il codice che si desidera 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()

Obiettivo-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

Utilizzare il Monitoraggio del rendimento traccia API ( Swift | Obj-C ) per aggiungere metriche personalizzate per le tracce di codice personalizzato.

Nota quanto segue:

  • I nomi per metriche personalizzate devono soddisfare i seguenti requisiti: senza spazi iniziali o finali, nessuna sottolineatura ( _ carattere), e la lunghezza massima è di 100 caratteri.
  • Ogni traccia di codice personalizzato in grado di registrare fino a 32 metriche (tra cui la metrica di 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 riscontri nella cache o nuovi tentativi.

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

Obiettivo-C

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" by:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Crea attributi personalizzati per tracce di codice personalizzate

Utilizzare il Monitoraggio del rendimento traccia API ( Swift | Obj-C ) per aggiungere attributi personalizzati per le tracce di codice personalizzato.

Per utilizzare gli attributi personalizzati, aggiungi alla tua app il codice che definisce l'attributo e lo associa a una traccia di codice personalizzata specifica. È possibile impostare l'attributo personalizzato in qualsiasi momento tra l'avvio della traccia e l'interruzione della traccia.

Nota quanto segue:

  • I nomi per gli attributi personalizzati devono soddisfare i seguenti requisiti: senza spazi iniziali o finali, nessuna sottolineatura ( _ carattere), 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 un individuo per Google.

    Scopri di più su questa linea 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;

Obiettivo-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];

Traccia, visualizza e filtra i dati sulle prestazioni

Tieni traccia di metriche specifiche nella tua dashboard

Per informazioni su come le metriche chiave sono trend, aggiungerli al vostro bordo metriche nella parte superiore del cruscotto delle prestazioni. Puoi identificare rapidamente le regressioni osservando le modifiche settimana dopo settimana o verificando che le modifiche recenti nel codice stiano migliorando le prestazioni.

un'immagine della scheda delle metriche nella dashboard di Firebase Performance Monitoring

Per aggiungere una metrica al vostro bordo metriche, andare al cruscotto delle prestazioni nella console Firebase, quindi fare clic sulla scheda Dashboard. Fai clic su una scheda di metrica vuota, quindi seleziona una metrica esistente da aggiungere alla tua scheda. Clicca su una carta metrica popolata per ulteriori opzioni, come per sostituire o rimuovere una metrica.

La scheda delle metriche mostra i dati delle metriche raccolti nel tempo, sia in forma grafica che come variazione percentuale numerica.

Scopri di più su utilizzando il cruscotto .

Visualizza le tracce e i loro dati

Per visualizzare le tracce, andare al cruscotto delle prestazioni nella console Firebase, scorrere verso il basso al tavolo tracce, quindi 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, è possibile fare clic su varie schermate per esplorare la traccia e approfondire le metriche di interesse. Sulla maggior parte delle pagine, è possibile utilizzare il filtro tasto (in alto a sinistra dello schermo) per filtrare i dati per attributo, ad esempio:

un'immagine dei dati di monitoraggio delle prestazioni di Firebase filtrati per attributo
  • Filtro per la versione all'applicazione di visualizzare i dati su un rilascio passato o la vostra ultima release
  • Filtra per dispositivo per imparare vecchi dispositivi di gestire la vostra applicazione
  • Filtra per paese per assicurarsi che il percorso di database non colpisce una regione specifica

Ulteriori informazioni sulla visualizzazione dei dati per le vostre tracce .

Prossimi passi

  • Visualizzare rapporti dettagliati di sessioni utente in cui è possibile vedere una traccia specifica in un contesto temporale di altre tracce rilevate nel corso della stessa sessione.