Schema del set di dati per i dati esportati in BigQuery

Questa pagina fornisce lo schema del set di dati per i dati Crashlytics esportati e i dati delle sessioni Firebase in BigQuery.

Firebase crea nuovi set di dati in BigQuery per i dati esportati:


Crashlytics set di dati

I dati di Crashlytics vengono esportati in un set di dati BigQuery denominato firebase_crashlytics. Il set di dati copre l'intero progetto, anche se contiene più app.

Tabelle

Per impostazione predefinita, Firebase crea tabelle individuali all'interno del set di dati Crashlytics per ogni app del tuo progetto collegata a BigQuery.

I nomi delle tabelle si basano sull'identificatore dell'app (con i punti convertiti in trattini bassi) e sono seguiti dalla piattaforma dell'app (_IOS o _ANDROID). Ad esempio, i dati di un'app per Android con il nome del pacchetto com.google.test si troveranno in una tabella denominata com_google_test_ANDROID.

  • Se l'esportazione in streaming in BigQuery è attivata, i dati verranno trasmessi in streaming in tempo reale anche a una tabella a cui è stato aggiunto _REALTIME (ad esempio, com_google_test_ANDROID_REALTIME).

  • Ogni riga di una tabella rappresenta un evento che si è verificato nell'app, inclusi arresti anomali, errori non irreversibili e ANR.

  • Le tabelle contengono un insieme standard di dati Crashlytics, oltre a eventuali chiavi Crashlytics personalizzate definite dall'utente nella sua app (iOS+ | Android | Flutter | Unity ).

Righe

Ogni riga di una tabella rappresenta un errore riscontrato dall'app.

Colonne

Le colonne di una tabella sono identiche per arresti anomali, errori non irreversibili e ANR.

  • Se l'esportazione streaming in BigQuery è abilitata, la tabella in tempo reale avrà le stesse colonne della tabella batch.

  • Potresti avere colonne in righe che rappresentano eventi senza stack trace.

Di seguito sono riportate le colonne della tabella per i dati Crashlytics esportati:

Nome campo Tipo di dati Descrizione
app_orientation STRING Ad esempio, PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN e così via.
application RECORD L'app che ha generato l'evento
application.build_version STRING Versione build dell'app
application.display_version STRING
blame_frame RECORD Il frame identificato come causa principale dell'arresto anomalo o dell'errore
blame_frame.address INT64 L'indirizzo nell'immagine binaria che contiene il codice
Non impostato per i frame Java
blame_frame.blamed BOOLEAN Se Crashlytics ha determinato che questo frame è la causa dell'arresto anomalo o dell'errore
blame_frame.file STRING Il nome del file del frame
blame_frame.library STRING Il nome visualizzato della libreria che include il frame
blame_frame.line INT64 Il numero di riga del file del frame
blame_frame.offset INT64 L'offset di byte nell'immagine binaria che contiene il codice
Non impostato per le eccezioni Java
blame_frame.owner STRING Ad esempio, DEVELOPER, VENDOR, RUNTIME, PLATFORM o SYSTEM
blame_frame.symbol STRING Il simbolo idratato o il simbolo non idratabile, se non è idratabile
breadcrumbs REPEATED RECORD Breadcrumb Google Analytics con timestamp, se abilitati
breadcrumbs.name STRING Il nome associato alla breadcrumb
breadcrumbs.params REPEATED RECORD Parametri associati alla breadcrumb
breadcrumbs.params.key STRING Una chiave parametro associata alla breadcrumb
breadcrumbs.params.value STRING Un valore del parametro associato alla breadcrumb
breadcrumbs.timestamp TIMESTAMP Il timestamp associato alla sequenza
bundle_identifier STRING L'identificatore univoco dell'app registrata nel progetto Firebase (ad esempio, com.google.gmail)
Per le app della piattaforma Apple, questo è l'ID bundle dell'app.
Per le app per Android, questo è il nome del pacchetto dell'app.
crashlytics_sdk_versions STRING La versione dell'SDK Crashlytics che ha generato l'evento
custom_keys REPEATED RECORD Coppie chiave-valore definite dallo sviluppatore
custom_keys.key STRING Una chiave definita dallo sviluppatore
custom_keys.value STRING Un valore definito dallo sviluppatore
device RECORD Il dispositivo su cui si è verificato l'evento
device_orientation STRING Ad esempio, PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN e così via.
device.architecture STRING Ad esempio, X86_32, X86_64, ARMV7, ARM64, ARMV7S o ARMV7K
device.manufacturer STRING Il produttore del dispositivo
device.model STRING Il modello del dispositivo
error REPEATED RECORD (solo app Apple) errori non irreversibili
error_type STRING Il tipo di errore dell'evento (ad esempio FATAL, NON_FATAL, ANR e così via).
error.blamed BOOLEAN Se Crashlytics ha stabilito che questo frame è la causa dell'errore
error.code INT64 Codice di errore associato a NSError registrato personalizzato dell'app
error.frames REPEATED RECORD I frame dello stacktrace
error.frames.address INT64 L'indirizzo nell'immagine binaria che contiene il codice
error.frames.blamed BOOLEAN Se Crashlytics ha stabilito che questo frame è la causa dell'errore
error.frames.file STRING Il nome del file del frame
error.frames.library STRING Il nome visualizzato della libreria che include il frame
error.frames.line INT64 Il numero di riga del file del frame
error.frames.offset INT64 L'offset di byte nell'immagine binaria che contiene il codice
error.frames.owner STRING Ad esempio, DEVELOPER, VENDOR, RUNTIME, PLATFORM o SYSTEM
error.frames.symbol STRING Il simbolo idratato o il simbolo non idratabile, se non è idratabile
error.queue_name STRING La coda in cui è stato eseguito il thread
error.subtitle STRING Il sottotitolo del thread
error.title STRING Il titolo del thread
event_id STRING L'ID univoco dell'evento
event_timestamp TIMESTAMP Quando si è verificato l'evento
exceptions REPEATED RECORD (Solo Android) Eccezioni che si sono verificate durante questo evento. Le eccezioni nidificate vengono presentate in ordine cronologico inverso, il che significa che l'ultimo record è la prima eccezione generata
exceptions.blamed BOOLEAN True se Crashlytics determina che l'eccezione è responsabile dell'errore o dell'arresto anomalo
exceptions.exception_message STRING Un messaggio associato all'eccezione
exceptions.frames REPEATED RECORD I frame associati all'eccezione
exceptions.frames.address INT64 L'indirizzo nell'immagine binaria che contiene il codice
Non impostato per i frame Java
exceptions.frames.blamed BOOLEAN Se Crashlytics ha determinato che questo frame è la causa dell'arresto anomalo o dell'errore
exceptions.frames.file STRING Il nome del file del frame
exceptions.frames.library STRING Il nome visualizzato della libreria che include il frame
exceptions.frames.line INT64 Il numero di riga del file del frame
exceptions.frames.offset INT64 L'offset di byte nell'immagine binaria che contiene il codice
Non impostato per le eccezioni Java
exceptions.frames.owner STRING Ad esempio, DEVELOPER, VENDOR, RUNTIME, PLATFORM o SYSTEM
exceptions.frames.symbol STRING Il simbolo idratato o il simbolo non idratabile, se non è idratabile
exceptions.nested BOOLEAN Vero per tutte le eccezioni tranne l'ultima (ovvero il primo record)
exceptions.subtitle STRING Il sottotitolo del thread
exceptions.title STRING Il titolo del thread
exceptions.type STRING Il tipo di eccezione (ad esempio, java.lang.IllegalStateException)
firebase_session_id STRING L'ID generato automaticamente per la sessione Firebase mappata all'evento da Crashlytics
installation_uuid STRING Un ID che identifica un'installazione univoca di app e dispositivo
is_fatal BOOLEAN Indica se l'app ha subito un arresto anomalo
issue_id STRING Il problema associato all'evento
logs REPEATED RECORD Messaggi di log con timestamp generati dal logger Crashlytics, se abilitato
logs.message STRING Il messaggio registrato
logs.timestamp TIMESTAMP Quando è stato creato il log
memory RECORD Lo stato della memoria del dispositivo
memory.free INT64 Byte di memoria rimanenti
memory.used INT64 Byte di memoria utilizzati
operating_system RECORD I dettagli del sistema operativo sul dispositivo
operating_system.device_type STRING Il tipo di dispositivo (ad esempio MOBILE, TABLET, TV e così via), noto anche come "categoria del dispositivo".
operating_system.display_version STRING La versione del sistema operativo sul dispositivo
operating_system.modification_state STRING Indica se il dispositivo è stato modificato (ad esempio, un'app jailbroken è MODIFIED e un'app rooted è UNMODIFIED)
operating_system.name STRING Il nome del sistema operativo sul dispositivo.
operating_system.type STRING (Solo app Apple) Il tipo di sistema operativo in esecuzione sul dispositivo (ad esempio, IOS, MACOS e così via).
platform STRING La piattaforma dell'app registrata nel progetto Firebase (valori validi: IOS o ANDROID)
process_state STRING BACKGROUND o FOREGROUND
storage RECORD Lo spazio di archiviazione permanente del dispositivo
storage.free INT64 Byte di spazio di archiviazione rimanente
storage.used INT64 Byte di spazio di archiviazione utilizzato
threads REPEATED RECORD Thread presenti al momento dell'evento
threads.blamed BOOLEAN Se Crashlytics ha determinato che questo frame è la causa dell'arresto anomalo o dell'errore
threads.code INT64 (Solo app Apple) Codice di errore di NSError personalizzato registrato dell'applicazione
threads.crash_address INT64 L'indirizzo del segnale che ha causato l'arresto anomalo dell'applicazione; presente solo nei thread nativi in cui si è verificato l'arresto anomalo
threads.crashed BOOLEAN Se il thread è andato in crash
threads.frames REPEATED RECORD I frame del thread
threads.frames.address INT64 L'indirizzo nell'immagine binaria che contiene il codice
threads.frames.blamed BOOLEAN Se Crashlytics ha stabilito che questo frame è la causa dell'errore
threads.frames.file STRING Il nome del file del frame
threads.frames.library STRING Il nome visualizzato della libreria che include il frame
threads.frames.line INT64 Il numero di riga del file del frame
threads.frames.offset INT64 L'offset di byte nell'immagine binaria che contiene il codice
threads.frames.owner STRING Ad esempio, DEVELOPER, VENDOR, RUNTIME, PLATFORM o SYSTEM
threads.frames.symbol STRING Il simbolo idratato o il simbolo grezzo se non è idratabile
threads.queue_name STRING (Solo app Apple) La coda in cui è stato eseguito il thread
threads.signal_code STRING Il codice del segnale che ha causato l'arresto anomalo dell'app; presente solo nei thread nativi arrestati in modo anomalo
threads.signal_name STRING Il nome del segnale che ha causato l'arresto anomalo dell'app, presente solo nei thread nativi con arresto anomalo
threads.subtitle STRING Il sottotitolo del thread
threads.thread_name STRING Il nome del thread.
threads.title STRING Il titolo del thread
unity_metadata.debug_build BOOLEAN Se si tratta di una build di debug
unity_metadata.graphics_copy_texture_support STRING Supporto per la copia della texture grafica come definita nell'API Unity
unity_metadata.graphics_device_id INT64 L'identificatore del dispositivo grafico
unity_metadata.graphics_device_name STRING Il nome del dispositivo grafico
unity_metadata.graphics_device_type STRING Il tipo di dispositivo grafico
unity_metadata.graphics_device_vendor_id INT64 L'identificatore del fornitore del processore grafico
unity_metadata.graphics_device_vendor STRING Il fornitore del dispositivo grafico
unity_metadata.graphics_device_version STRING La versione del dispositivo grafico
unity_metadata.graphics_max_texture_size INT64 La dimensione massima dedicata al rendering della texture
unity_metadata.graphics_memory_size_mb INT64 La memoria video in MB
unity_metadata.graphics_render_target_count INT64 Il numero di target di rendering grafici
unity_metadata.graphics_shader_level INT64 Il livello di shader della grafica
unity_metadata.processor_count INT64 Il numero di processori (core)
unity_metadata.processor_frequency_mhz INT64 La frequenza del processore o dei processori in MHz
unity_metadata.processor_type STRING Il tipo di processore
unity_metadata.screen_refresh_rate_hz INT64 La frequenza di aggiornamento dello schermo in Hz
unity_metadata.screen_resolution_dpi STRING Il DPI dello schermo come numero in virgola mobile
unity_metadata.screen_size_px STRING Le dimensioni dello schermo in pixel, nel formato larghezza x altezza
unity_metadata.system_memory_size_mb INT64 Dimensioni della memoria del sistema in MB
unity_metadata.unity_version STRING La versione di Unity in esecuzione su questo dispositivo
user RECORD (Facoltativo) Informazioni raccolte sull'utente dell'app
user.email STRING (Facoltativo) L'indirizzo email dell'utente
user.id STRING (Facoltativo) Un ID specifico dell'app associato all'utente
user.name STRING (Facoltativo) Il nome dell'utente.
variant_id STRING La variante del problema associata a questo evento
Tieni presente che non tutti gli eventi hanno una variante del problema associata.


Set di dati delle sessioni Firebase

I dati delle sessioni Firebase vengono esportati in un set di dati BigQuery denominato firebase_sessions. Il set di dati copre l'intero progetto, anche se contiene più app.

Tabelle

Per impostazione predefinita, Firebase crea tabelle individuali all'interno del set di dati Sessioni Firebase per ogni app del tuo progetto collegata a BigQuery.

I nomi delle tabelle si basano sull'identificatore dell'app (con i punti convertiti in trattini bassi) e sono seguiti dalla piattaforma dell'app (_IOS o _ANDROID). Ad esempio, i dati di un'app per Android con il nome del pacchetto com.google.test si trovano in una tabella denominata com_google_test_ANDROID.

Righe

Ogni riga di una tabella rappresenta un evento di sessione che si è verificato.

Colonne

Se l'esportazione streaming in BigQuery è abilitata, la tabella in tempo reale avrà le stesse colonne della tabella batch.

Di seguito sono riportate le colonne della tabella per i dati delle sessioni Firebase esportati:

Nome campo Tipo di dati Descrizione
instance_id STRING L'ID installazione Firebase (FID) del dispositivo. Identifica un'installazione unica di app + dispositivo
session_id STRING L'ID univoco di questa sessione
first_session_id STRING Il primo ID di una serie di sessioni a cui appartiene questa sessione dall'avvio a freddo dell'app. Può essere utilizzato per raggruppare tutte le sessioni che si sono verificate dall'ultimo riavvio a freddo. Se questa è la prima sessione, questo campo sarà uguale a session_id.
session_index NUMERO INTERO L'ordine di questa sessione è stato ricevuto dopo l'avvio a freddo dell'app. Per la prima sessione dopo un riavvio a freddo, questo valore sarà 0. L'indice viene incrementato ogni volta che viene generata una sessione senza che si verifichi un avvio a freddo (ad esempio, dopo 30 minuti di inattività).
event_type STRING Il tipo di evento che si è verificato nella sessione (ad esempio, SESSION_START)
event_timestamp TIMESTAMP L'ora in cui si è verificato l'evento
received_timestamp TIMESTAMP L'ora in cui l'evento è stato ricevuto dal server dal dispositivo
performance_data_collection_enabled BOOLEAN Indica se la raccolta dei dati dell'SDK Firebase Performance Monitoring era attivata al momento della sessione
crashlytics_data_collection_enabled BOOLEAN Se la raccolta dei dati dell'SDK Firebase Crashlytics è stata attivata al momento della sessione
application RECORD Descrive l'applicazione
application.build_version STRING La versione della build dell'applicazione (ad esempio, 1523456)
application.display_version STRING La versione visualizzata dell'applicazione (ad esempio, 4.1.7)
device RECORD Il dispositivo su cui si è verificato l'evento
device.model STRING Il modello del dispositivo.
device.manufacturer STRING Il produttore del dispositivo. Per le app della piattaforma Apple, sarà NULL.
operating_system RECORD Descrive il sistema operativo del dispositivo
operating_system.display_version STRING La versione visualizzata del sistema operativo (ad esempio, 10.2.1)
operating_system.name STRING Il nome del sistema operativo
operating_system.type STRING Il tipo di sistema operativo (ad esempio IOS). Questo campo viene impostato solo per i dispositivi Apple.
operating_system.device_type STRING Il tipo di dispositivo (ad esempio, MOBILE, TABLET, TV)