Questa pagina fornisce assistenza per la risoluzione dei problemi e risposte alle domande più frequenti sull'utilizzo di Crashlytics. Se non riesci a trovare quello che stai cercando o hai bisogno di ulteriore aiuto, contatta l'assistenza Firebase .
Risoluzione dei problemi generali/FAQ
Se non visualizzi utenti senza arresti anomali, registri breadcrumb e/o avvisi di velocità, ti consigliamo di controllare la configurazione della tua app per Google Analytics.
Assicurati di aver abilitato Google Analytics nel tuo progetto Firebase.
Assicurati che la condivisione dei dati sia abilitata per Google Analytics nella pagina Integrazioni > Google Analytics della console Firebase. Tieni presente che le impostazioni di condivisione dei dati vengono visualizzate nella console Firebase ma gestite nella console di Google Analytics.
Oltre all'SDK Firebase Crashlytics, assicurati di aver aggiunto l'SDK Firebase per Google Analytics alla tua app ( iOS+ | Android ).
Assicurati di utilizzare le versioni più recenti per tutti i tuoi SDK Firebase ( iOS+ | Android ).
In particolare, verifica di utilizzare almeno le seguenti versioni dell'SDK Firebase per Google Analytics:iOS+ — v6.3.1+ (v8.9.0+ per macOS e tvOS) | Android : v17.2.3+ (distinta base v24.7.1+) .
Potresti notare due formati diversi per i problemi elencati nella tabella Problemi nella console Firebase. E potresti anche notare una funzionalità chiamata "varianti" in alcuni dei tuoi problemi. Ecco perché!
All'inizio del 2023, abbiamo implementato un motore di analisi migliorato per il raggruppamento degli eventi, nonché un design aggiornato e alcune funzionalità avanzate per i nuovi numeri (come le varianti!). Dai un'occhiata al nostro recente post sul blog per tutti i dettagli, ma puoi leggere di seguito per i punti salienti.
Crashlytics analizza tutti gli eventi della tua app (come arresti anomali, eventi non fatali e ANR) e crea gruppi di eventi chiamati problemi : tutti gli eventi in un problema hanno un punto di errore comune.
Per raggruppare gli eventi in questi problemi, il motore di analisi migliorato ora esamina molti aspetti dell'evento, inclusi i frame nell'analisi dello stack, il messaggio di eccezione, il codice di errore e altre caratteristiche della piattaforma o del tipo di errore.
Tuttavia, all'interno di questo gruppo di eventi, le analisi dello stack che portano all'errore potrebbero essere diverse. Un'analisi dello stack diversa potrebbe significare una causa principale diversa. Per rappresentare questa possibile differenza all'interno di un problema, ora creiamo varianti all'interno dei problemi: ciascuna variante è un sottogruppo di eventi in un problema che hanno lo stesso punto di errore e una traccia dello stack simile. Con le varianti, puoi eseguire il debug delle analisi dello stack più comuni all'interno di un problema e determinare se diverse cause principali stanno causando l'errore.
Ecco cosa sperimenterai con questi miglioramenti:
Metadati rinnovati visualizzati nella riga del problema
Ora è più semplice comprendere e valutare i problemi nella tua app.Meno problemi duplicati
Una modifica del numero di riga non comporta un nuovo problema.Debug più semplice di problemi complessi con varie cause principali
Utilizza le varianti per eseguire il debug delle analisi dello stack più comuni all'interno di un problema.Avvisi e segnali più significativi
Un nuovo problema rappresenta in realtà un nuovo bug.Ricerca più potente
Ogni numero contiene più metadati ricercabili, come il tipo di eccezione e il nome del pacchetto.
Ecco come verranno implementati questi miglioramenti:
Quando riceviamo nuovi eventi dalla tua app, controlleremo se corrispondono a un problema esistente.
Se non c'è corrispondenza, applicheremo automaticamente il nostro algoritmo di raggruppamento degli eventi più intelligente all'evento e creeremo un nuovo problema con il design dei metadati rinnovato.
Questo è il primo grande aggiornamento che stiamo apportando al nostro raggruppamento di eventi. Se hai feedback o riscontri problemi, faccelo sapere inviando una segnalazione.
Il valore senza arresti anomali rappresenta la percentuale di utenti che hanno interagito con la tua app ma non hanno subito arresti anomali in un periodo di tempo specifico.
Ecco la formula per calcolare la percentuale di utenti senza crash. I suoi valori di input sono forniti da Google Analytics.
CRASH_FREE_USERS_PERCENTAGE = 1 - ( CRASHED_USERS / ALL_USERS ) x 100
Quando si verifica un arresto anomalo, Google Analytics invia un tipo di evento
app_exception
e CRASHED_USERS rappresenta il numero di utenti associati a quel tipo di evento.ALL_USERS rappresenta il numero totale di utenti che hanno interagito con la tua app nel periodo di tempo che hai selezionato dal menu a discesa in alto a destra nella dashboard di Crashlytics.
La percentuale di utenti senza arresti anomali è un'aggregazione nel tempo e non una media.
Ad esempio, immagina che la tua app abbia tre utenti; li chiameremo Utente A, Utente B e Utente C. La tabella seguente mostra quali utenti hanno utilizzato la tua app ogni giorno e quali di questi utenti hanno avuto un arresto anomalo quel giorno:
Lunedi | Martedì | Mercoledì | |
---|---|---|---|
Utenti che hanno interagito con la tua app | A, B, C | A, B, C | A, B |
Utente che ha avuto un arresto anomalo | C | B | UN |
Mercoledì, la percentuale di utenti senza arresti anomali è del 50% (1 utente su 2 non ha avuto arresti anomali).
Due dei tuoi utenti hanno interagito con la tua app mercoledì, ma solo uno di loro (Utente B) non ha avuto arresti anomali.Negli ultimi 2 giorni, la percentuale di utenti senza arresti anomali è stata del 33,3% (1 utente su 3 non ha avuto arresti anomali).
Tre dei tuoi utenti hanno interagito con la tua app negli ultimi due giorni, ma solo uno di loro (Utente C) non ha riscontrato arresti anomali.Negli ultimi 3 giorni, la percentuale di utenti senza arresti anomali è stata dello 0% (0 utenti su 3 non hanno avuto arresti anomali).
Tre dei tuoi utenti hanno interagito con la tua app negli ultimi tre giorni, ma nessuno di loro non ha riscontrato arresti anomali.
Il valore degli utenti senza arresti anomali non deve essere confrontato su periodi di tempo diversi. La probabilità che un singolo utente subisca un arresto anomalo aumenta quanto più volte utilizza la tua app, quindi è probabile che il valore degli utenti senza arresti anomali sia inferiore per periodi di tempo più lunghi.
Le note consentono ai membri del progetto di commentare questioni specifiche con domande, aggiornamenti di stato, ecc.
Quando un membro del progetto pubblica una nota, questa viene etichettata con l'e-mail del suo account Google. Questo indirizzo email è visibile, insieme alla nota, a tutti i membri del progetto con accesso per visualizzare la nota.
Di seguito viene descritto l'accesso richiesto per visualizzare, scrivere ed eliminare le note:
I membri del progetto con uno qualsiasi dei seguenti ruoli possono visualizzare ed eliminare le note esistenti e scrivere nuove note su un problema.
I membri del progetto con uno qualsiasi dei seguenti ruoli possono visualizzare le note pubblicate su un problema, ma non possono eliminare o scrivere una nota.
Integrazioni
Se il tuo progetto utilizza Crashlytics insieme a Google Mobile Ads SDK, è probabile che i crash reporter interferiscano durante la registrazione dei gestori delle eccezioni. Per risolvere il problema, disattiva la segnalazione degli arresti anomali nell'SDK Mobile Ads chiamando disableSDKCrashReporting
.
Dopo aver collegato Crashlytics a BigQuery, i nuovi set di dati creati vengono automaticamente posizionati negli Stati Uniti, indipendentemente dalla posizione del tuo progetto Firebase.
Supporto della piattaforma
Problemi regrediti
Si è verificata una regressione di un problema dopo averlo chiuso in precedenza, ma Crashlytics riceve un nuovo report indicante che il problema si è ripresentato. Crashlytics riapre automaticamente questi problemi regrediti in modo che tu possa risolverli in modo appropriato per la tua app.
Di seguito è riportato uno scenario di esempio che spiega in che modo Crashlytics classifica un problema come regressione:
- Per la prima volta in assoluto, Crashlytics riceve un rapporto sull'incidente relativo al Crash "A". Crashlytics apre un problema corrispondente per quell'arresto anomalo (problema "A").
- Correggi rapidamente questo bug, chiudi il problema "A" e quindi rilasci una nuova versione della tua app.
- Crashlytics riceve un altro rapporto sul problema "A" dopo che hai chiuso il problema.
- Se il report proviene da una versione dell'app di cui Crashlytics era a conoscenza quando hai chiuso il problema (il che significa che la versione aveva inviato un report di arresto anomalo per qualsiasi arresto anomalo), Crashlytics non considererà il problema regredito. La questione resterà chiusa.
- Se il rapporto proviene da una versione dell'app di cui Crashlytics non era a conoscenza quando hai chiuso il problema (il che significa che la versione non ha mai inviato alcun rapporto sugli arresti anomali per alcun arresto anomalo), Crashlytics considera il problema regredito e lo riaprirà .
Quando un problema regredisce, inviamo un avviso di rilevamento della regressione e aggiungiamo un segnale di regressione al problema per farti sapere che Crashlytics ha riaperto il problema. Se non desideri che un problema si riapra a causa del nostro algoritmo di regressione, "disattiva" il problema invece di chiuderlo.
Se un rapporto proviene da una versione precedente dell'app che non ha mai inviato alcun rapporto sugli arresti anomali quando hai chiuso il problema, Crashlytics considererà il problema regredito e lo riaprirà.
Questa situazione può verificarsi nella seguente situazione: hai corretto un bug e rilasciato una nuova versione della tua app, ma hai ancora utenti con versioni precedenti senza la correzione del bug. Se, per caso, una di quelle versioni precedenti non avesse mai inviato alcun rapporto sugli arresti anomali quando hai chiuso il problema e quegli utenti iniziassero a riscontrare il bug, quei rapporti sugli arresti anomali attiverebbero un problema regredito.
Se non desideri che un problema si riapra a causa del nostro algoritmo di regressione, "disattiva" il problema invece di chiuderlo.