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 in base a URL pagina per visualizzare i dati relativi a una pagina specifica del tuo sito.
Filtra in base a Tipo di connessione efficace per scoprire in che modo una connessione 3G influisce sulla tua app
Filtra per Paese per assicurarti che la posizione del database non influisca su una regione specifica

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 raccolti per le app web

Per impostazione predefinita, tutte le tracce per le app web raccolgono i seguenti attributi:

Browser
Paese
Tipo di connessione effettivo
URL pagina
Stato del service worker
Stato visibilità

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 Monitoring API Trace per aggiungere attributi personalizzati alle tracce di codice personalizzato.

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 vuoto 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.

Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();perf_add_custom_attributes.js

Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

// Delete scenario
trace.removeAttribute("experiment");

// Read attributes
const traceAttributes = trace.getAttributes();index.js