Filtrare i dati utilizzando attributi

Con Performance Monitoring, puoi utilizzare gli attributi per segmentare i dati sul rendimento e concentrarti sul rendimento della tua app in diversi scenari reali.

Dopo aver fatto clic sul nome di una traccia nella tabella delle tracce (nella parte inferiore della dashboard Rendimento), puoi visualizzare in dettaglio le metriche che ti interessano. Utilizza il pulsante Filtra (in alto a sinistra nella schermata) per filtrare i dati in base all'attributo, ad esempio:

un'immagine di <span class= Dati di Firebase Performance Monitoring filtrati per attributo" />

Filtra per Versione app per visualizzare i dati relativi a una release passata 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

Per un'analisi ancora più efficace basata sugli attributi, esporta i dati sul rendimento in BigQuery.

Attributi predefiniti

Performance Monitoring raccoglie automaticamente una serie di attributi predefiniti in base al tipo di traccia.

Oltre a questi attributi predefiniti, puoi anche creare attributi personalizzati nelle tracce di codice personalizzate per segmentare i dati in base alle categorie specifiche della tua app. Ad esempio, in un gioco puoi segmentare i dati in base al livello del gioco.

Attributi predefiniti per le app Apple e Android

Per impostazione predefinita, tutte le tracce per le app Apple e Android raccolgono i seguenti attributi:

Versione dell'app
Paese
Livello del sistema operativo
Dispositivo
Radio
Operatore

Inoltre, le tracce delle richieste di rete raccolgono anche il seguente attributo:

Tipo MIME

Raccogliere i dati utente

Raccolta dei dati utente: Performance Monitoring non raccoglie da sola informazioni che consentono l'identificazione personale (PII), come nomi, indirizzi email o numeri di telefono. Gli sviluppatori possono raccogliere dati aggiuntivi utilizzando Performance Monitoring creando attributi personalizzati nelle tracce di codice personalizzato. Questi dati raccolti tramite Performance Monitoring non devono contenere informazioni che consentono l'identificazione personale di un individuo per Google.

Ecco un esempio di messaggio di log che non contiene informazioni che consentono l'identificazione personale:

trace.putAttribute("experiment", "A");

Ecco un esempio che contiene informazioni che consentono l'identificazione personale (non utilizzare questo tipo di attributo personalizzato nella tua app):

trace.putAttribute("email", user.getEmailAddress());

I dati che mostrano informazioni che consentono l'identificazione personale sono soggetti all'eliminazione senza preavviso.

Creare attributi personalizzati

Puoi creare attributi personalizzati su qualsiasi traccia di codice personalizzato sottoposta a instrumentazione.

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

Per utilizzare gli attributi personalizzati, aggiungi alla tua 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 _.
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
Raccolta dei dati utente: Performance Monitoring non raccoglie da sola informazioni che consentono l'identificazione personale (PII), come nomi, indirizzi email o numeri di telefono. Gli sviluppatori possono raccogliere dati aggiuntivi utilizzando Performance Monitoring creando attributi personalizzati nelle tracce di codice personalizzato. Questi dati raccolti tramite Performance Monitoring non devono contenere informazioni che consentono l'identificazione personale di un individuo per Google.

Ecco un esempio di messaggio di log che non contiene informazioni che consentono l'identificazione personale:
trace.putAttribute("experiment", "A");
Ecco un esempio che contiene informazioni che consentono l'identificazione personale (non utilizzare questo tipo di attributo personalizzato nella tua app):
trace.putAttribute("email", user.getEmailAddress());
I dati che mostrano informazioni che consentono l'identificazione personale sono soggetti all'eliminazione senza preavviso.

Swift

Nota:questo prodotto Firebase non è disponibile sui target macOS, Mac Catalyst e watchOS.

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

Nota:questo prodotto Firebase non è disponibile sui target macOS, Mac Catalyst e watchOS.

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