Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Aggiungi monitoraggio personalizzato per codice app specifico

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Performance Monitoring raccoglie tracce per aiutarti a monitorare le prestazioni della tua app. Una traccia è un rapporto di dati sulle prestazioni acquisiti tra due momenti nella tua app.

Puoi creare le tue tracce per monitorare i dati sulle prestazioni associati a codice specifico nella tua app. Con una traccia del codice personalizzata , puoi misurare quanto tempo impiega la tua app per completare un'attività specifica o una serie di attività, ad esempio il caricamento di una serie di immagini o l'esecuzione di query nel database.

La metrica predefinita per una traccia di codice personalizzata è la sua "durata" (il tempo tra i punti di inizio e di fine della traccia), ma puoi anche aggiungere metriche personalizzate .

Nel codice, definisci l'inizio e la fine di una traccia di codice personalizzata utilizzando le API fornite da Performance Monitoring SDK.tracce del codice personalizzato possono essere avviate in qualsiasi momento dopo la creazione e sono thread-safe.

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

Puoi visualizzare i dati di queste tracce nella sottoscheda Tracce personalizzate della tabella delle tracce, che si trova nella parte inferiore del dashboard Prestazioni (ulteriori informazioni sull'utilizzo della console più avanti in questa pagina).

Attributi predefiniti, attributi personalizzati e metriche personalizzate

Per le tracce di codice personalizzate, Performance Monitoring registra automaticamente gli attributi predefiniti (metadati comuni come paese, browser, URL della pagina e così via) in modo da poter filtrare i dati per la traccia nella console Firebase. Puoi anche aggiungere e monitorare attributi personalizzati (come il livello di gioco o le proprietà dell'utente).

È possibile configurare ulteriormente una traccia di codice personalizzata per registrare metriche personalizzate per eventi relativi alle prestazioni che si verificano nell'ambito della traccia. Ad esempio, puoi creare una metrica personalizzata per il numero di hit e miss della cache o per 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

Utilizzare l' API di traccia del monitoraggio delle prestazioni per aggiungere tracce di codice personalizzate per monitorare il codice dell'applicazione specifico.

Nota quanto segue:

  • Un'app può avere più tracce di codice personalizzate.
  • È possibile eseguire più tracce di codice personalizzato contemporaneamente.
  • I nomi per le tracce di codice personalizzato 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 interrompere una traccia di codice personalizzata, racchiudere il codice che desideri tracciare con righe di codice simili alle seguenti:

Web version 9

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();

Web version 8

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();

Aggiungi tracce di codice personalizzate utilizzando l'API User Timing

Oltre all'API di traccia del monitoraggio delle prestazioni, puoi aggiungere tracce di codice personalizzate utilizzando l' API di temporizzazione utente nativa del browser. La durata di una traccia misurata utilizzando questa API viene rilevata automaticamente dall'SDK di monitoraggio delle prestazioni. L'utilizzo dell'API User Timing è particolarmente utile se si preferisce caricare l'SDK di monitoraggio delle prestazioni in modo asincrono. Una volta che l'SDK è stato inizializzato, l'SDK registrerà le misurazioni avvenute prima del suo caricamento.

Per utilizzare questa funzione, avvolgi il codice che desideri tracciare con i segni di temporizzazione utente:

Web version 9

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Web version 8

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Si noti che le performance nell'esempio precedente si riferiscono all'oggetto window.performance del browser.

Quando si utilizza l'API User Timing, non è possibile aggiungere metriche e attributi personalizzati alle tracce del codice personalizzato. Utilizzare l' API di traccia di monitoraggio delle prestazioni se si desidera aggiungere quegli elementi personalizzati a una traccia di codice personalizzata.

Aggiungi metriche personalizzate alle tracce di codice personalizzate

Utilizza l' API di traccia del monitoraggio delle prestazioni per aggiungere metriche personalizzate alle tracce di codice personalizzate.

Nota quanto segue:

  • I nomi per le 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 del codice personalizzato può registrare fino a 32 metriche (inclusa la metrica 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.

Web version 9

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}

Web version 8

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}

Crea attributi personalizzati per tracce di codice personalizzate

Utilizzare l' API di traccia di monitoraggio delle prestazioni per aggiungere attributi personalizzati alle tracce di codice personalizzate.

Per utilizzare gli attributi personalizzati, aggiungi codice alla tua app 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:

    • Nessuno spazio vuoto iniziale o finale, nessun carattere di sottolineatura iniziale ( _ ).
    • No spazi
    • La lunghezza massima è di 32 caratteri
    • I caratteri consentiti per il nome sono AZ , az 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.

    Ulteriori informazioni su questa linea guida

Web version 9

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

Web version 8

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

Traccia, visualizza e filtra i dati sulle prestazioni

Per visualizzare i dati sulle prestazioni in tempo reale, assicurati che la tua app utilizzi una versione dell'SDK di monitoraggio delle prestazioni compatibile con l'elaborazione dei dati in tempo reale. Ulteriori informazioni sui dati sulle prestazioni in tempo reale .

Tieni traccia di metriche specifiche nella tua dashboard

Per conoscere l'andamento delle tue metriche chiave, aggiungile alla scheda delle metriche nella parte superiore della dashboard del rendimento . Puoi identificare rapidamente le regressioni visualizzando le modifiche settimana dopo settimana o verificare che le modifiche recenti al codice stiano migliorando le prestazioni.

un'immagine della scheda delle metriche nella dashboard di monitoraggio delle prestazioni di Firebase

Per aggiungere una metrica alla scheda delle metriche, procedi nel seguente modo:

  1. Vai alla dashboard delle prestazioni nella console Firebase.
  2. Fai clic su una scheda metrica vuota, quindi seleziona una metrica esistente da aggiungere alla tua bacheca.
  3. Fai clic su su una scheda metrica popolata per ulteriori opzioni, ad esempio per sostituire o rimuovere una metrica.

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

Ulteriori informazioni sull'utilizzo della dashboard .

Visualizza le tracce e i loro dati

Per visualizzare le tue tracce, vai al dashboard Prestazioni nella console Firebase, scorri verso il basso fino alla tabella delle tracce, quindi fai clic sulla sottoscheda appropriata. La tabella mostra alcune metriche principali per ciascuna traccia e puoi persino ordinare l'elenco in base alla variazione percentuale per una metrica specifica.

Monitoraggio delle prestazioni fornisce una pagina per la risoluzione dei problemi nella console Firebase che evidenzia le modifiche alle metriche, semplificando la rapida risoluzione e riducendo al minimo l'impatto dei problemi di prestazioni sulle tue app e sugli utenti. Puoi utilizzare la pagina di risoluzione dei problemi per conoscere potenziali problemi di prestazioni, ad esempio nei seguenti scenari:

  • Selezioni le metriche pertinenti sulla dashboard e noti un grande delta.
  • Nella tabella delle tracce si ordina per visualizzare i delta più grandi in alto e si vede una variazione percentuale significativa.
  • Ricevi un avviso e-mail che ti informa di un problema di prestazioni.

È possibile accedere alla pagina di risoluzione dei problemi nei seguenti modi:

  • Nella dashboard delle metriche, fai clic sul pulsante Visualizza dettagli metrica .
  • Su qualsiasi scheda metrica, seleziona => Visualizza dettagli . La pagina di risoluzione dei problemi mostra informazioni sulla metrica selezionata.
  • Nella tabella delle tracce, fare clic sul nome di una traccia o su qualsiasi valore di metrica nella riga associata a tale traccia.
  • In un avviso e-mail, fai clic su Esamina ora .

Quando si fa clic sul nome di una traccia nella tabella delle tracce, è possibile visualizzare in dettaglio le metriche di interesse. Fare clic sul pulsante filtro per filtrare i dati per attributo, ad esempio:

un'immagine dei dati di monitoraggio delle prestazioni di Firebase filtrati per attributo
  • Filtra per URL pagina per visualizzare i dati per una pagina specifica del tuo sito
  • Filtra per 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

Ulteriori informazioni sulla visualizzazione dei dati per le tue tracce .

Prossimi passi

  • Ulteriori informazioni sull'utilizzo degli attributi per esaminare i dati sulle prestazioni.

  • Scopri di più su come tenere traccia dei problemi di prestazioni nella console Firebase.

  • Imposta avvisi per le modifiche al codice che stanno degradando le prestazioni della tua app. Ad esempio, puoi configurare un avviso e-mail per il tuo team se la durata di una traccia di codice personalizzato specifico supera una soglia impostata.