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 (situata nella parte inferiore della dashboard Rendimento), puoi visualizzare in dettaglio le metriche di interesse. Utilizza il pulsante Filtra (in alto a sinistra dello schermo) per filtrare i dati per 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 precedente o alla release più recente.
Filtra per Dispositivo per scoprire come 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 a seconda del tipo di traccia.

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

Attributi predefiniti per le app Apple e Android

Tutte le tracce per le app Apple e Android raccolgono per impostazione predefinita 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

Raccolta dei dati utente

Raccolta dei dati utente:Performance Monitoring non raccoglie alcuna informazione che consente 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. I dati raccolti tramite Performance Monitoring non devono contenere informazioni che identificano personalmente 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 espongono informazioni che consentono l'identificazione personale sono soggetti a eliminazione senza preavviso.

Creare attributi personalizzati

Puoi creare attributi personalizzati in una qualsiasi delle tue tracce di codice personalizzato instrumentate.

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

Per utilizzare gli attributi personalizzati, aggiungi alla tua app un codice che definisca l'attributo e lo associ a una traccia di codice personalizzato specifica. Puoi impostare l'attributo personalizzato in qualsiasi momento tra l'inizio e l'interruzione della traccia.

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 identifichino personalmente un individuo per Google.
Scopri di più su questa linea guida
Raccolta dei dati utente:Performance Monitoring non raccoglie alcuna informazione che consente 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. I dati raccolti tramite Performance Monitoring non devono contenere informazioni che identificano personalmente 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 espongono informazioni che consentono l'identificazione personale sono soggetti a eliminazione senza preavviso.

Swift

Nota:questo prodotto Firebase non è disponibile su 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 su 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];