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 singole tabelle all'interno del set di dati Crashlytics per ogni app del progetto collegata a BigQuery.

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

  • Se l'esportazione streaming in BigQuery è attivata, i dati verranno anche trasmessi in streaming in tempo reale a una tabella con l'aggiunta di _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 fatali e ANR.

  • Le tabelle contengono un set di standard di dati Crashlytics oltre a eventuali chiavi Crashlytics personalizzate definite da te nella tua 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 che non hanno analisi dello stack.

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 ecc.
application RECORD L'app che ha generato l'evento
application.build_version STRING La versione della 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 Indica se Crashlytics ha stabilito 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 raccolta 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 elaborato se non è idratabile
breadcrumbs REPEATED RECORD Breadcrumb Google Analytics con timestamp, se abilitati
breadcrumbs.name STRING Il nome associato al breadcrumb
breadcrumbs.params REPEATED RECORD Parametri associati al breadcrumb
breadcrumbs.params.key STRING Una chiave parametro associata al breadcrumb
breadcrumbs.params.value STRING Un valore parametro associato al breadcrumb
breadcrumbs.timestamp TIMESTAMP Il timestamp associato al breadcrumb
bundle_identifier STRING L'identificatore univoco dell'app registrata nel progetto Firebase (ad esempio, com.google.gmail)
Per le app per piattaforme Apple, si tratta dell'ID pacchetto dell'app.
Per le app per Android, si tratta del nome 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 ecc.
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 Indica se Crashlytics ha stabilito che questo frame è la causa dell'errore
error.code INT64 Codice di errore associato all'NSError personalizzato registrato 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 Indica 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 raccolta 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 elaborato se non è idratabile
error.queue_name STRING La coda in cui era in esecuzione 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 sono 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 Indica se Crashlytics ha stabilito 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 raccolta 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 elaborato se non è idratabile
exceptions.nested BOOLEAN True per tutte le eccezioni tranne l'ultima generata (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 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 di log
logs.timestamp TIMESTAMP Quando è stato creato il log
memory RECORD Stato della memoria del dispositivo
memory.free INT64 Byte di memoria rimanenti
memory.used INT64 Byte di memoria utilizzata
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 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 rimanenti
storage.used INT64 Byte di spazio di archiviazione utilizzato
threads REPEATED RECORD Thread presenti al momento dell'evento
threads.blamed BOOLEAN Indica se Crashlytics ha stabilito che questo frame è la causa dell'arresto anomalo o dell'errore
threads.code INT64 (Solo app Apple) Codice di errore dell'NSError personalizzato registrato dell'applicazione
threads.crash_address INT64 L'indirizzo dell'indicatore che ha causato l'arresto anomalo dell'applicazione; presente solo nei thread nativi con arresto anomalo
threads.crashed BOOLEAN Se il thread ha subito un arresto anomalo
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 Indica 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 raccolta 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 non elaborato se non è idratabile
threads.queue_name STRING (Solo app Apple) La coda su cui era in esecuzione il thread
threads.signal_code STRING Il codice dell'indicatore che ha causato l'arresto anomalo dell'app; presente solo nei thread nativi che hanno subito un arresto anomalo
threads.signal_name STRING Il nome dell'indicatore 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 definito 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 grafico
unity_metadata.graphics_shader_level INT64 Il livello dello shader della grafica
unity_metadata.processor_count INT64 Il numero di processori (core)
unity_metadata.processor_frequency_mhz INT64 La frequenza 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 I 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 Le 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 singole tabelle all'interno del set di dati delle sessioni Firebase per ogni app del progetto collegata a BigQuery.

I nomi delle tabelle si basano sull'identificatore dell'app (con i punti convertiti in trattini bassi) e vengono aggiunti alla piattaforma dell'app (_IOS o _ANDROID). Ad esempio, i dati di un'app per Android con il nome del pacchetto com.google.test si troverebbero 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 univoca di app + dispositivo
session_id STRING L'ID univoco di questa sessione
first_session_id STRING Il primo ID di una serie di sessioni in cui si trova questa sessione dall'avvio a freddo dell'app. Può essere utilizzato per raggruppare tutte le sessioni che si sono verificate dopo un avvio completo. Se questa sessione è la prima, questo campo sarà uguale a session_id.
session_index NUMERO INTERO L'ordine in cui è stata avviata questa sessione dopo l'avvio a freddo dell'app. Per la prima sessione dopo un avvio a freddo, questo valore sarà 0. L'indice viene incrementato ogni volta che viene generata una sessione senza che si verifichi un cold start (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 era 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 dell'applicazione visualizzata (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 per piattaforme Apple, sarà NULL.
operating_system RECORD Descrive il sistema operativo del dispositivo
operating_system.display_version STRING La versione di visualizzazione 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 è impostato solo per i dispositivi Apple.
operating_system.device_type STRING Il tipo di dispositivo (ad esempio, MOBILE, TABLET, TV).