Risoluzione dei problemi e domande frequenti su Performance Monitoring
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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 minuti prima che i dati vengano aggiornati nella dashboard.
Controlla la
dashboard dello stato di Firebase nel caso in cui
si verifichi un'interruzione di servizio nota per Firebase o per Performance Monitoring.
Iniziare con 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 che riguardano il rilevamento dell'SDK da parte di Firebase o la visualizzazione dei primi dati sulle prestazioni 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 (come le interazioni con l'app) dalla tua app. In genere, entro 10 minuti dall'avvio dell'app, la dashboard Prestazioni della console Firebase visualizza il messaggio "SDK rilevato". Entro 30 minuti, la dashboard mostra i dati iniziali elaborati.
Se sono trascorsi più di 10 minuti da quando hai aggiunto l'ultima versione dell'SDK alla tua app e non vedi ancora alcuna modifica, controlla i messaggi di registro per assicurarti che Performance Monitoring stia registrando gli eventi. Per risolvere un messaggio di rilevamento ritardato dell'SDK, provare a seguire i passaggi di risoluzione dei problemi appropriati descritti di seguito.
L'app registra gli eventi: passaggi per la risoluzione dei problemi
Se stai ancora sviluppando 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 alternando più volte la visualizzazione della tua app tra background e primo piano, interagendo con la tua app navigando tra le schermate e/o attivando richieste di rete.
Assicurati che il file di configurazione di Firebase (Google-Service-Info.plist) sia stato aggiunto correttamente alla tua app e che non sia stato modificato.
In particolare, verificare quanto segue:
Il nome del file di configurazione non viene aggiunto con caratteri aggiuntivi, come (2).
Il file di configurazione si trova nella radice del progetto XCode e viene 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 qualcosa sembra sbagliato nel file di configurazione della tua app, prova quanto segue:
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 essere impostato correttamente, ma non vedi 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 è
stato rilevato, ma non vengono visualizzati dati
Performance Monitoring elabora i dati degli eventi prestazionali prima di visualizzarli nella dashboard Prestazioni.
Se sono trascorse più di 24 ore da quando è apparso il messaggio "SDK rilevato" e non vedi ancora dati, controlla la Dashboard di stato di Firebase nel caso in cui si sia verificata un'interruzione nota. Se non si verifica alcuna interruzione, contatta l'assistenza Firebase.
Risoluzione dei problemi generali
Se hai aggiunto correttamente l'SDK e stai utilizzando 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.
L'app non registra gli eventi relativi alle prestazioni
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 per le piattaforme Apple
(v12.6.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 del rendimento
mancano 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 quanto segue:
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 arrestate. Qualsiasi traccia non avviata, non arrestata o arrestata prima dell'avvio non verrà registrata.
Controlla i messaggi di registro per assicurarti che Performance Monitoring stia registrando le tracce di codice personalizzato previste.
Se Performance Monitoring registra gli eventi, ma non vengono visualizzati dati dopo 24 ore,
contatta l'assistenza Firebase.
Nella dashboard delle prestazioni mancano i dati sulle richieste di rete
Se mancano i dati di richiesta 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 segnalare solo le 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 cosa è successo alla sezione 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 in 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 fine hanno fatto le 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 dati sulle prestazioni dai dispositivi degli utenti 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 con l'app.
Per gestire il volume di dati che raccogliamo, Performance Monitoring utilizza le seguenti
opzioni di campionamento:
Limitazione della frequenza sul dispositivo: per impedire che un dispositivo invii improvvisi picchi 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 sulle prestazioni e impedisce che un singolo dispositivo alteri le misurazioni delle prestazioni.
Campionamento dinamico: Performance Monitoring raccoglie ogni giorno un numero limitato di tracce di codice e di richieste di rete per app, per tutti gli utenti dell'app. Viene recuperata una frequenza di campionamento dinamica sui dispositivi (utilizzando Firebase Remote Config) per determinare se un dispositivo casuale debba acquisire e inviare tracce. Un dispositivo non selezionato per il campionamento non invia alcun evento. La frequenza di campionamento dinamica è specifica dell'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 dell'utente, il che richiede 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 piccole variazioni nei modelli, 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 è più necessario controllare manualmente la console Firebase per determinare lo stato di una soglia. Per informazioni sugli avvisi, consulta Impostare gli 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 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, dell'app in primo piano e dell'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à renderizzato 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 del trattamento dei dati quasi in tempo reale, devi solo assicurarti
che la tua app utilizzi una versione dell'SDK Performance Monitoring compatibile con il trattamento 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 sulle prestazioni 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 di 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.
