Risoluzione dei problemi e domande frequenti su Performance Monitoring
Questa pagina fornisce suggerimenti per la risoluzione dei problemi per iniziare a utilizzare Performance Monitoring o
le funzionalità e gli strumenti di Performance Monitoring.
Controlli iniziali per la risoluzione dei problemi
I due controlli riportati di seguito sono best practice generali consigliate a chiunque
prima di procedere con la risoluzione dei problemi.
1. Controllare i messaggi di log per gli eventi di rendimento
Controlla i messaggi di log per assicurarti che l'SDK Performance Monitoring stia acquisendo
gli eventi relativi al rendimento.
Come visualizzare i messaggi di log per gli eventi di rendimento
Fai clic sull'URL per visualizzare i dati nella console Firebase. Potrebbero essere necessari alcuni
istanti prima che i dati vengano aggiornati nella dashboard.
2. Controllare la dashboard dello stato di Firebase
Controlla la
dashboard dello stato di Firebase nel caso in cui
si verifichi un'interruzione di servizio nota per Firebase o per Performance Monitoring.
Guida introduttiva a Performance Monitoring
Se stai iniziando a utilizzare Performance Monitoring
(iOS+ |
Android |
web), i seguenti suggerimenti per la risoluzione dei problemi
possono aiutarti a risolvere i problemi relativi al rilevamento dell'SDK da parte di Firebase o alla visualizzazione
dei primi dati sul rendimento nella console Firebase.
Ho aggiunto l'SDK all'app, ma la console
continua a chiedere di aggiungerlo
Firebase può rilevare se hai aggiunto correttamente l'SDK Performance Monitoring alla tua app
quando riceve informazioni sugli eventi (ad esempio interazioni con l'app) dalla tua app.
Di solito, entro 10 minuti dall'avvio dell'app, nella dashboard
di Firebase viene visualizzato il messaggio "SDK rilevato". Entro 30 minuti, la dashboard mostra i dati iniziali elaborati.
Se sono trascorsi più di 10 minuti dall'aggiunta dell'ultima versione dell'SDK alla tua app e non vedi ancora alcuna modifica, controlla i messaggi di log per assicurarti che Performance Monitoring registri gli eventi. Prova i passaggi per la risoluzione dei problemi appropriati descritti di seguito per
risolvere i problemi relativi a un messaggio di rilevamento ritardato dell'SDK.
L'app registra gli eventi: passaggi per la risoluzione dei
problemi
Se continui a sviluppare localmente, prova a generare più eventi per la raccolta dei dati:
Continua a sviluppare la tua app utilizzando un simulatore o un dispositivo di test.
Genera eventi passando più volte dall'app in background a quella in primo piano, interagendo con l'app spostandoti tra le schermate e/o attivando richieste di rete.
Assicurati che il file di configurazione
Firebase (Google-Service-Info.plist) sia
stato aggiunto correttamente alla tua app e che non sia stato modificato.
In particolare, controlla quanto segue:
Al nome del file di configurazione non vengono aggiunti caratteri aggiuntivi, ad esempio
(2).
Il file di configurazione si trova nella root del progetto Xcode ed è stato aggiunto ai target corretti.
L'ID app Firebase Apple (GOOGLE_APP_ID) elencato nel file di configurazione è
corretto per la tua app. Trova l'ID app Firebase nella scheda Le tue app
delle settingsimpostazioni del progetto.
Se riscontri problemi con il file di configurazione nella tua app, prova a:
Elimina il file di configurazione attualmente presente nella tua app.
Segui queste istruzioni per scaricare
un nuovo file di configurazione e aggiungerlo alla tua app Apple.
Se l'SDK registra gli eventi e tutto sembra configurato correttamente,
ma non visualizzi ancora il messaggio di rilevamento dell'SDK o i dati elaborati
(dopo 2 ore), contatta l'assistenza Firebase.
L'app non registra gli eventi:
passaggi per la risoluzione dei problemi
La console indica che l'SDK è
rilevato, ma non vengono visualizzati dati
Performance Monitoring elabora i dati sugli eventi di rendimento prima di visualizzarli nella
dashboard Rendimento.
Se sono trascorse più di 24 ore dalla visualizzazione del messaggio "SDK rilevato"
e ancora non visualizzi i dati, controlla la
dashboard dello stato di Firebase per verificare se è presente
un'interruzione nota. Se non è presente alcuna interruzione,
contatta l'assistenza Firebase.
Risoluzione dei problemi generali
Se hai aggiunto correttamente l'SDK e utilizzi Performance Monitoring nella tua app, i seguenti suggerimenti per la risoluzione dei problemi possono aiutarti a risolvere i problemi generali che riguardano le funzionalità e gli strumenti di Performance Monitoring.
Nella dashboard del rendimento
mancano i dati di tracciamento dello schermo
Se mancano dati per le tracce di rendering dello schermo, prova i seguenti
passaggi per la risoluzione dei problemi:
Assicurati di utilizzare l'ultima versione dell'SDK delle piattaforme Apple
(v11.15.0). Le tracce di rendering dello schermo sono disponibili solo
con la versione 5.0.0 o successive.
Performance Monitoring non crea tracce di rendering dello schermo per i controller di visualizzazione dei contenitori (come UINavigationController e UITabBarController). Se i dati mancano solo per queste schermate, si tratta di un comportamento previsto.
Nella dashboard sul rendimento
mancherebbero dati di traccia personalizzati
Visualizzi i dati sul rendimento per le tracce raccolte automaticamente ma non per
le tracce di codice personalizzato? Prova a svolgere i seguenti passaggi per la risoluzione dei problemi:
Controlla la configurazione delle tracce di codice personalizzato instrumentate tramite l'API Trace, in particolare:
I nomi delle tracce di codice personalizzato e delle metriche personalizzate devono soddisfare i seguenti
requisiti: nessun spazio vuoto iniziale o finale, nessun carattere di sottolineatura iniziale
(_) e lunghezza massima di 32 caratteri.
Tutte le tracce devono essere avviate e interrotte. Qualsiasi traccia non avviata, non
interrotta o interrotta prima dell'avvio non verrà registrata.
Controlla i messaggi di log per assicurarti che
Performance Monitoring stia registrando le tracce del codice personalizzato previste.
Se Performance Monitoring registra gli eventi, ma non vengono visualizzati dati dopo 24 ore,
contatta l'assistenza Firebase.
Nella dashboard sul rendimento
mancano i dati sulle richieste di rete
Se mancano i dati delle richieste di rete, prova i seguenti passaggi per la risoluzione dei problemi:
A seconda del comportamento del codice e delle librerie di rete utilizzate dal codice, Performance Monitoring potrebbe generare report solo sulle richieste di rete completate. Ciò significa che le connessioni HTTP/S lasciate aperte potrebbero non
essere segnalate.
Performance Monitoring non genera report sulle richieste di rete con intestazioni Content-Type non valide. Tuttavia, le richieste di rete senza le intestazioni
Content-Type verranno comunque accettate.
I dati delle richieste di rete non vengono aggregati come previsto
Che fine hanno fatto i problemi principali nella scheda Rendimento della home page del progetto?
Abbiamo sostituito Problemi principali con Avvisi recenti in seguito alla recente introduzione degli avvisi, che ti inviano una notifica automatica quando vengono superate le soglie che hai impostato. I problemi sono ora ritirati
e sostituiti dagli avvisi.
Il selettore delle app nella parte superiore della scheda Rendimento filtra le voci
di avviso nella sezione Avvisi recenti. Vengono visualizzati solo i tre avvisi più recenti per le app selezionate.
Che fine ha fatto la possibilità di impostare soglie per i problemi nella console?
Performance Monitoring supporta gli avvisi per le metriche che superano le soglie definite. Per evitare confusione con queste soglie configurabili per le metriche di rendimento, abbiamo rimosso la possibilità di configurare le soglie per i problemi.
Che cosa è successo alle informazioni su dettagli e metriche nella console Firebase?
Abbiamo sostituito le pagine Dettagli e Metriche con un'interfaccia utente (UI) centralizzata e appena riprogettata per migliorare la risoluzione dei problemi. Questa nuova
UI per la risoluzione dei problemi offre le stesse funzionalità di base di Dettagli e
Metriche. Per scoprire di più sulla risoluzione dei problemi, consulta
Visualizzare più dati per una traccia specifica.
Perché il numero di campioni non è quello che mi aspettavo?
Performance Monitoring raccoglie i dati sul rendimento dai dispositivi utente della tua app. Se la tua
applicazione ha molti utenti o se genera una grande quantità di attività
di rendimento, Performance Monitoring potrebbe limitare la raccolta dei dati a un sottoinsieme di dispositivi per
ridurre il numero di eventi elaborati. Questi limiti sono sufficientemente elevati in modo che,
anche con un numero inferiore di eventi, i valori delle metriche siano comunque rappresentativi
dell'esperienza utente nell'app.
Per gestire il volume di dati che raccogliamo, Performance Monitoring utilizza le seguenti
opzioni di campionamento:
Limitazione della frequenza sul dispositivo: per impedire a un dispositivo di inviare raffiche improvvise di
tracce, limitiamo il numero di tracce di codice e richieste di rete inviate da un
dispositivo a 300 eventi ogni 10 minuti. Questo approccio protegge il dispositivo da
strumentazioni in loop che possono inviare grandi quantità di dati sul rendimento e
impedisce a un singolo dispositivo di distorcere le misurazioni del rendimento.
Campionamento dinamico: Performance Monitoring raccoglie un numero limitato di tracce di codice e
tracce di richieste di rete per app al giorno per tutti gli utenti dell'app. Sui dispositivi viene recuperato un tasso di campionamento dinamico (utilizzando Firebase Remote Config) per determinare se un dispositivo casuale deve acquisire e inviare tracce. Un dispositivo non selezionato per il campionamento non invia eventi. La frequenza di campionamento dinamica è
specifica per l'app e si adatta per garantire che il volume complessivo dei dati raccolti
rimanga al di sotto del limite.
I progetti che hanno abilitato l'integrazione di BigQuery ricevono un limite più elevato per il
numero di tracce delle richieste di rete.
Le sessioni utente inviano dati aggiuntivi e dettagliati dal dispositivo di un utente, richiedendo
più risorse per acquisire e inviare i dati. Per ridurre al minimo l'impatto delle sessioni utente, Performance Monitoring potrebbe anche limitare il numero di sessioni.
Limitazione della frequenza lato server: per garantire che le app non superino il limite di campionamento, Performance Monitoring potrebbe utilizzare il campionamento lato server per eliminare alcuni eventi ricevuti dai dispositivi. Sebbene questo tipo di limitazione non modifichi l'efficacia delle nostre metriche, potrebbe causare lievi cambiamenti nei pattern, tra cui:
Il numero di tracce può differire dal numero di volte in cui è stato eseguito un blocco di
codice.
Le tracce strettamente accoppiate nel codice potrebbero avere un numero diverso di
campioni.
Che cosa è successo alla scheda Problemi nella console?
Abbiamo sostituito la scheda Problemi con l'introduzione degli avvisi, che
ti avvisano automaticamente quando vengono superate le soglie che hai impostato. Non devi più controllare manualmente la console Firebase per determinare lo stato di una soglia. Per scoprire di più sugli avvisi, consulta Configurare avvisi per problemi di prestazioni.
Che cosa è successo alle schede Sul dispositivo e Rete nella console?
Come faccio a visualizzare le tracce presenti in queste pagine?
Abbiamo riprogettato la sezione Performance Monitoring della console Firebase in modo che la scheda Dashboard mostri le metriche chiave e tutte le tracce in un unico spazio. Nell'ambito
del nuovo design, abbiamo rimosso le pagine Sul dispositivo e Rete.
La tabella delle tracce nella parte inferiore della scheda Dashboard contiene tutte le stesse
informazioni visualizzate nelle schede Sul dispositivo e Rete, ma con alcune
funzionalità aggiuntive, tra cui la possibilità di ordinare le tracce in base alla variazione
percentuale per una metrica specifica. Per visualizzare tutte le metriche e i dati per una traccia specifica, fai clic sul nome della traccia nella tabella delle tracce.
Visualizza le tracce nelle seguenti schede secondarie della tabella delle tracce:
Tracce richiesta di rete (sia predefinite che personalizzate) - scheda secondaria Richieste di rete
Tracce di codice personalizzato: scheda secondaria Tracce personalizzate
Tracce di avvio dell'app, app in primo piano e app in background: scheda secondaria Tracce personalizzate
Tracce caricamento pagina - Scheda secondaria Caricamento pagina
Per informazioni dettagliate sulla tabella delle tracce e sulla visualizzazione di metriche e dati, visita la
pagina di panoramica della console
(iOS+ |
Android |
Web).
Perché il numero di frame lenti e bloccati non è quello che mi aspettavo?
I frame con rendering lento e i frame bloccati vengono calcolati con una frequenza di aggiornamento del dispositivo presunta di 60 Hz. Se la frequenza di aggiornamento di un dispositivo è inferiore a 60 Hz, ogni frame
avrà un tempo di rendering più lento perché vengono renderizzati meno frame al secondo.
Tempi di rendering più lenti possono causare la segnalazione di un numero maggiore di frame lenti o bloccati
perché un numero maggiore di frame verrà sottoposto a rendering più lentamente o si bloccherà. Tuttavia, se la frequenza di aggiornamento di un dispositivo è superiore a 60 Hz, ogni frame avrà un tempo di rendering più rapido.
In questo modo, verranno segnalati meno fotogrammi lenti o bloccati. Si tratta di una limitazione
corrente dell'SDK Performance Monitoring.
L'esportazione dei miei dati Performance Monitoring in BigQuery sta richiedendo più tempo del previsto. Non è in tempo reale?
Se hai attivato l'integrazione BigQuery per Firebase Performance Monitoring, i tuoi dati
verranno esportati in BigQuery 12-24 ore dopo la fine della giornata (ora del
Pacifico).
Ad esempio, i dati del 19 aprile saranno disponibili in BigQuery il 20 aprile
tra le 12:00 e mezzanotte (tutte le date e gli orari sono in ora del Pacifico).
Elaborazione e visualizzazione dei dati quasi in tempo reale
Che cosa si intende per dati sul rendimento "quasi in tempo reale"?
Firebase Performance Monitoring elabora i dati sul rendimento raccolti man mano che vengono ricevuti, il che
consente la visualizzazione dei dati quasi in tempo reale nella console Firebase. I dati
elaborati vengono visualizzati nella console pochi minuti dopo la raccolta, da cui il termine "quasi in tempo reale".
Come faccio a ottenere dati sul rendimento quasi in tempo reale per la mia app?
Per usufruire dell'elaborazione dei dati quasi in tempo reale, devi solo assicurarti
che la tua app utilizzi una versione dell'SDK Performance Monitoring compatibile con l'elaborazione dei dati in tempo reale.
Queste sono le versioni dell'SDK compatibili con Realtime:
iOS: v7.3.0 o versioni successive
tvOS: v8.9.0 o versioni successive
Android: v19.0.10 o versioni successive (o Firebase Android BoM v26.1.0 o versioni successive)
Web: v7.14.0 o versioni successive
Tieni presente che consigliamo sempre di utilizzare l'ultima versione dell'SDK, ma qualsiasi versione elencata sopra consentirà a Performance Monitoring di elaborare i tuoi dati quasi in tempo reale.
Quali versioni dell'SDK Performance Monitoring sono considerate compatibili con Realtime?
Queste sono le versioni dell'SDK compatibili con l'elaborazione dei dati in tempo reale:
iOS: v7.3.0 o versioni successive
tvOS: v8.9.0 o versioni successive
Android: v19.0.10 o versioni successive (o Firebase Android BoM v26.1.0 o versioni successive)
Web: v7.14.0 o versioni successive
Tieni presente che consigliamo sempre di utilizzare l'ultima versione dell'SDK, ma qualsiasi versione elencata sopra consentirà a Performance Monitoring di elaborare i tuoi dati quasi in tempo reale.
Cosa succede se non aggiorno la mia app in modo che utilizzi una versione dell'SDK compatibile con il tempo reale?
Se la tua app non utilizza una versione dell'SDK compatibile con i dati in tempo reale, continuerai a visualizzare
tutti i dati sulle prestazioni dell'app nella console Firebase. Tuttavia, la visualizzazione
dei dati sul rendimento verrà ritardata di circa 36 ore rispetto al momento della
raccolta.
Ho eseguito l'aggiornamento a una versione dell'SDK compatibile con Realtime, ma alcuni dei miei utenti
utilizzano ancora le versioni precedenti della mia app. Continuerò a visualizzare i loro dati
sulle prestazioni nella console Firebase?
Sì! Indipendentemente dalla versione dell'SDK utilizzata da un'istanza dell'app, vedrai
i dati sul rendimento di tutti i tuoi utenti.
Tuttavia, se esamini dati recenti (risalenti a meno di 36 ore circa),
i dati visualizzati provengono da utenti di istanze dell'app che utilizzano una versione dell'SDK compatibile con i dati in tempo reale. I dati non recenti, invece, includono i dati sul rendimento
di tutte le versioni della tua app.
