Dataset-Schema für exportierte Daten in BigQuery

Auf dieser Seite finden Sie das Datensatzschema für exportierte Crashlytics-Daten und Firebase-Sitzungsdaten in BigQuery.

Firebase erstellt in BigQuery neue Datasets für Ihre exportierten Daten:


Crashlytics Dataset

Crashlytics-Daten werden in ein BigQuery-Dataset mit dem Namen firebase_crashlytics exportiert. Das Dataset deckt das gesamte Projekt ab, selbst wenn dieses mehrere Apps umfasst.

Tabellen

Standardmäßig erstellt Firebase für jede App in Ihrem Projekt, die mit BigQuery verknüpft ist, separate Tabellen im Dataset Crashlytics.

Die Tabellen werden nach der ID der App benannt. Die in der ID enthaltenen Punkte werden in Unterstriche umgewandelt und am Ende wird die Plattform der App (_IOS oder _ANDROID) angehängt. Daten für eine Android-App mit dem Paketnamen com.google.test befinden sich beispielsweise in einer Tabelle mit dem Namen com_google_test_ANDROID.

  • Wenn der Streaming-Export nach BigQuery aktiviert ist, werden Daten auch in Echtzeit in eine Tabelle gestreamt, an die _REALTIME angehängt wird (z. B. com_google_test_ANDROID_REALTIME).

  • Jede Zeile in einer Tabelle stellt ein Ereignis dar, das in der App aufgetreten ist, z. B. Abstürze, nicht schwerwiegende Fehler und ANR-Fehler.

  • Die Tabellen enthalten einen Standardsatz von Crashlytics-Daten sowie alle benutzerdefinierten Crashlytics-Schlüssel, die Sie in Ihrer App definiert haben (iOS+ | Android | Flutter | Unity).

Zeilen

Jede Zeile der Tabelle stellt einen Fehler der Anwendung dar.

Spalten

Die Spalten der Tabelle sind für Abstürze, nicht schwerwiegende Fehler und ANRs identisch.

  • Wenn der Streaming-Export nach BigQuery aktiviert ist, hat die Echtzeittabelle dieselben Spalten wie die Batchtabelle.

  • Möglicherweise haben Sie Spalten in Zeilen, die Ereignisse darstellen, für die keine Stacktraces vorhanden sind.

Hier sind die Spalten in der Tabelle für die exportierten Crashlytics-Daten aufgeführt:

Feldname Datentyp Beschreibung
app_orientation STRING Beispiele: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN usw.
application DATENSATZ Die App, durch die das Ereignis hervorgerufen wurde
application.build_version STRING Die Build-Version der App
application.display_version STRING
blame_frame DATENSATZ Der Frame, der als Ursache des Absturzes oder Fehlers identifiziert wurde
blame_frame.address INT64 Die Adresse im Binär-Image, die den Code
enthält. Für Java-Frames nicht festgelegt.
blame_frame.blamed BOOLEAN Gibt an, ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Absturzes oder Fehlers ist.
blame_frame.file STRING Der Name der Frame-Datei
blame_frame.library STRING Der Anzeigename der Bibliothek, die den Frame enthält
blame_frame.line INT64 Die Zeilennummer der Datei des Frames
blame_frame.offset INT64 Der Byte-Offset im binären Image, das den Code enthält
Für Java-Ausnahmen nicht festgelegt
blame_frame.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM
blame_frame.symbol STRING Das hydrierte Symbol oder das Rohsymbol, wenn es nicht hydriert werden kann
breadcrumbs WIEDERHOLTE AUFZEICHNUNG Zeitstempel für Google Analytics-Navigationspfade, sofern aktiviert
breadcrumbs.name STRING Der Name, der mit dem Breadcrumb verknüpft ist
breadcrumbs.params WIEDERHOLTE AUFZEICHNUNG Parameter, die mit dem Breadcrumb verknüpft sind
breadcrumbs.params.key STRING Ein Parameterschlüssel, der dem Breadcrumb zugeordnet ist
breadcrumbs.params.value STRING Ein Parameterwert, der dem Breadcrumb zugeordnet ist
breadcrumbs.timestamp TIMESTAMP Der Zeitstempel, der dem Breadcrumb zugeordnet ist
bundle_identifier STRING Die eindeutige Kennung der App, wie sie im Firebase-Projekt registriert ist (z. B. com.google.gmail)
Bei Apps für Apple-Plattformen ist dies die Bundle-ID der App.
Bei Android-Apps ist dies der Paketname der App.
crashlytics_sdk_versions STRING Die Crashlytics-SDK-Version, die das Ereignis generiert hat
custom_keys WIEDERHOLTE AUFZEICHNUNG Von Entwicklern definierte Schlüssel/Wert-Paare
custom_keys.key STRING Ein vom Entwickler definierter Schlüssel
custom_keys.value STRING Ein vom Entwickler definierter Wert
device DATENSATZ Das Gerät, auf dem das Ereignis aufgetreten ist
device_orientation STRING Beispiele: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN usw.
device.architecture STRING Beispiel: X86_32, X86_64, ARMV7, ARM64, ARMV7S oder ARMV7K
device.manufacturer STRING Der Gerätehersteller
device.model STRING Das Gerätemodell
error WIEDERHOLTE AUFZEICHNUNG (Nur Apple-Apps) Nicht schwerwiegende Fehler
error_type STRING Der Fehlertyp des Ereignisses, z. B. FATAL, NON_FATAL oder ANR.
error.blamed BOOLEAN Gibt an, ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Fehlers ist.
error.code INT64 Fehlercode, der dem benutzerdefinierten protokollierten NSError der App zugeordnet ist
error.frames WIEDERHOLTE AUFZEICHNUNG Die Frames des Stacktrace
error.frames.address INT64 Die Adresse im binären Image, die den Code enthält
error.frames.blamed BOOLEAN Gibt an, ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Fehlers ist.
error.frames.file STRING Der Name der Frame-Datei
error.frames.library STRING Der Anzeigename der Bibliothek, die den Frame enthält
error.frames.line INT64 Die Zeilennummer der Datei des Frames
error.frames.offset INT64 Der Byte-Offset im binären Image, das den Code enthält
error.frames.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM
error.frames.symbol STRING Das hydrierte Symbol oder das Rohsymbol, wenn es nicht hydriert werden kann
error.queue_name STRING Die Warteschlange, in der der Thread ausgeführt wurde
error.subtitle STRING Der Untertitel des Threads
error.title STRING Der Titel des Threads
event_id STRING Die eindeutige ID für das Ereignis
event_timestamp TIMESTAMP Zeitpunkt des Ereignisses
exceptions WIEDERHOLTE AUFZEICHNUNG (Nur Android) Ausnahmen, die während dieses Ereignisses aufgetreten sind. Verschachtelte Ausnahmen werden in umgekehrter chronologischer Reihenfolge dargestellt. Das bedeutet, dass der letzte Datensatz die erste ausgelöste Ausnahme ist.
exceptions.blamed BOOLEAN „True“, wenn Crashlytics feststellt, dass die Ausnahme für den Fehler oder Absturz verantwortlich ist.
exceptions.exception_message STRING Eine Nachricht, die mit der Ausnahme verknüpft ist
exceptions.frames WIEDERHOLTE AUFZEICHNUNG Die mit der Ausnahme verknüpften Frames
exceptions.frames.address INT64 Die Adresse im Binär-Image, die den Code
enthält. Für Java-Frames nicht festgelegt.
exceptions.frames.blamed BOOLEAN Gibt an, ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Absturzes oder Fehlers ist.
exceptions.frames.file STRING Der Name der Frame-Datei
exceptions.frames.library STRING Der Anzeigename der Bibliothek, die den Frame enthält
exceptions.frames.line INT64 Die Zeilennummer der Datei des Frames
exceptions.frames.offset INT64 Der Byte-Offset im binären Image, das den Code enthält
Für Java-Ausnahmen nicht festgelegt
exceptions.frames.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM
exceptions.frames.symbol STRING Das hydrierte Symbol oder das Rohsymbol, wenn es nicht hydriert werden kann
exceptions.nested BOOLEAN „True“ für alle außer der zuletzt ausgelösten Ausnahme (also dem ersten Datensatz)
exceptions.subtitle STRING Der Untertitel des Threads
exceptions.title STRING Der Titel des Threads
exceptions.type STRING Der Ausnahmetyp (z. B. java.lang.IllegalStateException))
firebase_session_id STRING Die automatisch generierte ID für die Firebase-Sitzung, die dem Ereignis aus Crashlytics zugeordnet ist
installation_uuid STRING Eine ID, die eine eindeutige App- und Geräteinstallation identifiziert
is_fatal BOOLEAN Gibt an, ob die App abgestürzt ist.
issue_id STRING Das mit dem Ereignis verknüpfte Problem
logs WIEDERHOLTE AUFZEICHNUNG Zeitgestempelte Log-Nachrichten, die vom Crashlytics-Logger generiert werden, sofern aktiviert
logs.message STRING Die protokollierte Nachricht
logs.timestamp TIMESTAMP Wann das Log erstellt wurde
memory DATENSATZ Speicherstatus des Geräts
memory.free INT64 Verbleibende Arbeitsspeicherbytes
memory.used INT64 Verwendete Arbeitsspeicher-Bytes
operating_system DATENSATZ Details zum Betriebssystem auf dem Gerät
operating_system.device_type STRING Der Gerätetyp (z. B. MOBILE, TABLET oder TV), auch als „Gerätekategorie“ bezeichnet
operating_system.display_version STRING Die Version des Betriebssystems auf dem Gerät
operating_system.modification_state STRING Gibt an, ob das Gerät manipuliert wurde (z. B. eine App mit Jailbreak ist MODIFIED und eine gerootete App ist UNMODIFIED).
operating_system.name STRING Der Name des Betriebssystems auf dem Gerät
operating_system.type STRING (Nur Apple-Apps) Der Typ des Betriebssystems, das auf dem Gerät ausgeführt wird (z. B. IOS, MACOS usw.)
platform STRING Die Plattform der App, wie sie im Firebase-Projekt registriert ist (gültige Werte: IOS oder ANDROID)
process_state STRING BACKGROUND oder FOREGROUND
storage DATENSATZ Der nichtflüchtige Speicher des Geräts
storage.free INT64 Verbleibender Speicherplatz in Byte
storage.used INT64 Genutzter Speicherplatz in Bytes
threads WIEDERHOLTE AUFZEICHNUNG Threads, die zum Zeitpunkt des Ereignisses vorhanden waren
threads.blamed BOOLEAN Gibt an, ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Absturzes oder Fehlers ist.
threads.code INT64 (Nur Apple-Apps) Fehlercode des benutzerdefinierten protokollierten NSError der Anwendung
threads.crash_address INT64 Die Adresse des Signals, das den Absturz der Anwendung verursacht hat. Ist nur bei abgestürzten nativen Threads vorhanden.
threads.crashed BOOLEAN Ob der Thread abgestürzt ist
threads.frames WIEDERHOLTE AUFZEICHNUNG Die Frames des Threads
threads.frames.address INT64 Die Adresse im binären Image, die den Code enthält
threads.frames.blamed BOOLEAN Gibt an, ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Fehlers ist.
threads.frames.file STRING Der Name der Frame-Datei
threads.frames.library STRING Der Anzeigename der Bibliothek, die den Frame enthält
threads.frames.line INT64 Die Zeilennummer der Datei des Frames
threads.frames.offset INT64 Der Byte-Offset im binären Image, das den Code enthält
threads.frames.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM
threads.frames.symbol STRING Das Symbol mit Platzhaltern oder das Rohsymbol, wenn es nicht mit Platzhaltern versehen werden kann
threads.queue_name STRING (Nur Apple-Apps) Die Warteschlange, in der der Thread ausgeführt wurde
threads.signal_code STRING Der Code des Signals, das zum Absturz der App geführt hat. Ist nur bei abgestürzten nativen Threads vorhanden.
threads.signal_name STRING Der Name des Signals, das zum Absturz der App geführt hat. Ist nur bei abgestürzten nativen Threads vorhanden.
threads.subtitle STRING Der Untertitel des Threads
threads.thread_name STRING Der Name des Threads
threads.title STRING Der Titel des Threads
unity_metadata.debug_build BOOLEAN Wenn es sich um einen Debug-Build handelt
unity_metadata.graphics_copy_texture_support STRING Unterstützung für das Kopieren von Grafiktexturen gemäß der Unity API
unity_metadata.graphics_device_id INT64 Die Kennung des Grafikgeräts
unity_metadata.graphics_device_name STRING Der Name des Grafikgeräts
unity_metadata.graphics_device_type STRING Der Typ des Grafikgeräts
unity_metadata.graphics_device_vendor_id INT64 Die Kennung des Anbieters des Grafikprozessors
unity_metadata.graphics_device_vendor STRING Der Anbieter des Grafikgeräts
unity_metadata.graphics_device_version STRING Die Version des Grafikgeräts
unity_metadata.graphics_max_texture_size INT64 Maximale Größe für das Rendern von Texturen
unity_metadata.graphics_memory_size_mb INT64 Der Grafikspeicher in MB
unity_metadata.graphics_render_target_count INT64 Die Anzahl der grafischen Rendering-Ziele
unity_metadata.graphics_shader_level INT64 Die Shader-Ebene der Grafik
unity_metadata.processor_count INT64 Die Anzahl der Prozessoren (Kerne)
unity_metadata.processor_frequency_mhz INT64 Die Frequenz des Prozessors bzw. der Prozessoren in MHz
unity_metadata.processor_type STRING Prozessortyp
unity_metadata.screen_refresh_rate_hz INT64 Die Aktualisierungsrate des Displays in Hz
unity_metadata.screen_resolution_dpi STRING Die DPI des Displays als Gleitkommazahl
unity_metadata.screen_size_px STRING Die Größe des Bildschirms in Pixeln im Format „Breite × Höhe“
unity_metadata.system_memory_size_mb INT64 Größe des Systemspeichers in MB
unity_metadata.unity_version STRING Die Unity-Version, die auf diesem Gerät ausgeführt wird
user DATENSATZ Optional: Informationen, die über den Nutzer der App erhoben werden
user.email STRING (Optional) Die E-Mail-Adresse des Nutzers
user.id STRING (Optional) Eine appspezifische ID, die mit dem Nutzer verknüpft ist
user.name STRING (Optional): Der Name des Nutzers
variant_id STRING Die mit diesem Ereignis verknüpfte Problemvariante
Hinweis: Nicht alle Ereignisse haben eine zugehörige Problemvariante.


Firebase-Dataset für Sitzungen

Firebase-Sitzungsdaten werden in ein BigQuery-Dataset mit dem Namen firebase_sessions exportiert. Das Dataset deckt das gesamte Projekt ab, selbst wenn dieses mehrere Apps umfasst.

Tabellen

Standardmäßig erstellt Firebase für jede App in Ihrem Projekt, die mit BigQuery verknüpft ist, separate Tabellen im Dataset „Firebase-Sitzungen“.

Die Tabellen werden nach der ID der App benannt. Die in der ID enthaltenen Punkte werden in Unterstriche umgewandelt und am Ende wird die Plattform der App (_IOS oder _ANDROID) angehängt. Daten für eine Android-App mit dem Paketnamen com.google.test befinden sich beispielsweise in einer Tabelle mit dem Namen com_google_test_ANDROID.

Zeilen

Jede Zeile in einer Tabelle steht für ein Sitzungsereignis.

Spalten

Wenn der Streaming-Export nach BigQuery aktiviert ist, hat die Echtzeittabelle dieselben Spalten wie die Batchtabelle.

Hier sind die Spalten in der Tabelle für die exportierten Firebase-Sitzungsdaten:

Feldname Datentyp Beschreibung
instance_id STRING Die Firebase-Installations-ID (FID) des Geräts. Identifiziert eine eindeutige App- und Geräteinstallation.
session_id STRING Die eindeutige ID dieser Sitzung
first_session_id STRING Die erste ID einer Reihe von Sitzungen, zu der diese Sitzung gehört, seit die App kalt gestartet wurde. Damit lassen sich alle Sitzungen gruppieren, die seit einem Kaltstart stattgefunden haben. Wenn dies die erste Sitzung ist, ist dieses Feld mit session_id identisch.
session_index INTEGER Die Reihenfolge, in der diese Sitzung nach dem Kaltstart der App eingegangen ist. Bei der ersten Sitzung nach einem Kaltstart ist dieser Wert 0. Der Index wird jedes Mal erhöht, wenn eine Sitzung ohne Kaltstart generiert wird (z. B. nach 30 Minuten Inaktivität).
event_type STRING Der Typ des Ereignisses, das in der Sitzung aufgetreten ist (z. B. SESSION_START)
event_timestamp TIMESTAMP Zeitpunkt des Ereignisses
received_timestamp TIMESTAMP Der Zeitpunkt, zu dem das Ereignis vom Gerät auf dem Server empfangen wurde
performance_data_collection_enabled BOOLEAN Gibt an, ob die Datenerfassung des Firebase Performance Monitoring SDK zum Zeitpunkt der Sitzung aktiviert war.
crashlytics_data_collection_enabled BOOLEAN Ob die Datenerhebung über das Firebase Crashlytics SDK zum Zeitpunkt der Sitzung aktiviert war
application DATENSATZ Beschreibt die Anwendung
application.build_version STRING Die Build-Version der Anwendung (z. B. 1523456)
application.display_version STRING Die Anzeigeversion der Anwendung (z. B. 4.1.7)
device DATENSATZ Das Gerät, auf dem das Ereignis aufgetreten ist
device.model STRING Das Modell des Geräts
device.manufacturer STRING Der Hersteller des Geräts. Bei Apps für Apple-Plattformen ist das NULL.
operating_system DATENSATZ Beschreibt das Betriebssystem des Geräts.
operating_system.display_version STRING Die Anzeigeversion des Betriebssystems (z. B. 10.2.1)
operating_system.name STRING Name des Betriebssystems
operating_system.type STRING Der Typ des Betriebssystems, z. B. IOS. Dieses Feld wird nur für Apple-Geräte festgelegt.
operating_system.device_type STRING Der Gerätetyp (z. B. MOBILE, TABLET oder TV)