Dataset-Schema für exportierte Daten in BigQuery

Auf dieser Seite finden Sie das Dataset-Schema 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 Ihr gesamtes Projekt ab, auch wenn es mehrere Apps enthält.

Tabellen

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

Die Tabellen werden nach der Kennung der App benannt (wobei Punkte in Unterstriche umgewandelt werden) und mit der Plattform der App (_IOS oder _ANDROID) versehen. 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 die Daten auch in Echtzeit in eine Tabelle gestreamt, die mit _REALTIME angehängt ist (z. B. com_google_test_ANDROID_REALTIME).

  • Jede Zeile in einer Tabelle steht für ein Ereignis, das in der App aufgetreten ist, einschließlich Abstürzen, nicht schwerwiegenden Fehlern und ANRs.

  • 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 in einer 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 ohne Stacktraces darstellen.

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

Feldname Datentyp Beschreibung
app_orientation STRING Beispiel: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN usw.
application DATENSATZ Die App, die das Ereignis generiert hat
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
Nicht festgelegt für Java-Frames
blame_frame.blamed BOOLEAN 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är-Image, das den Code enthält
Nicht festgelegt für Java-Ausnahmen
blame_frame.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM.
blame_frame.symbol STRING Das hydratisierte Symbol oder das Rohsymbol, wenn es nicht hydratisiert werden kann
breadcrumbs REPEATED RECORD Google Analytics-Navigationspfade mit Zeitstempel, sofern aktiviert
breadcrumbs.name STRING Der mit der Navigationspfad verknüpfte Name
breadcrumbs.params REPEATED RECORD Mit der Navigationspfad verknüpfte Parameter
breadcrumbs.params.key STRING Ein Parameterschlüssel, der mit der Navigationspfad-Anzeige verknüpft ist
breadcrumbs.params.value STRING Ein Parameterwert, der mit dem Breadcrumb verknüpft ist
breadcrumbs.timestamp TIMESTAMP Der mit dem Breadcrumb verknüpfte Zeitstempel
bundle_identifier STRING Die eindeutige Kennung für die App, wie sie im Firebase-Projekt registriert ist (z. B. com.google.gmail)
Bei Apple-Plattform-Apps ist dies die Paket-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 REPEATED RECORD Vom Entwickler 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 Beispiel: 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 REPEATED RECORD (Nur Apple-Apps) Nicht schwerwiegende Fehler
error_type STRING Der Fehlertyp des Ereignisses (z. B. FATAL, NON_FATAL, ANR usw.)
error.blamed BOOLEAN Gibt an, ob Crashlytics diesen Frame als Ursache des Fehlers ermittelt hat
error.code INT64 Fehlercode, der mit dem benutzerdefinierten protokollierten NSError der App verknüpft ist
error.frames REPEATED RECORD Die Frames des Stacktrace
error.frames.address INT64 Die Adresse im Binär-Image, die den Code enthält
error.frames.blamed BOOLEAN Gibt an, ob Crashlytics diesen Frame als Ursache des Fehlers ermittelt hat
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 in das Binär-Image, das den Code enthält
error.frames.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM.
error.frames.symbol STRING Das hydratisierte Symbol oder das Rohsymbol, wenn es nicht hydratisiert 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 REPEATED RECORD (Nur Android) Ausnahmen, die während dieses Ereignisses aufgetreten sind. Verschachtelte Ausnahmen werden in umgekehrter chronologischer Reihenfolge dargestellt. Das bedeutet, dass der letzte Eintrag 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 mit der Ausnahme verknüpfte Nachricht
exceptions.frames REPEATED RECORD Die mit der Ausnahme verknüpften Frames
exceptions.frames.address INT64 Die Adresse im Binär-Image, die den Code enthält
Nicht festgelegt für Java-Frames
exceptions.frames.blamed BOOLEAN 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är-Image, das den Code enthält
Nicht festgelegt für Java-Ausnahmen
exceptions.frames.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM.
exceptions.frames.symbol STRING Das hydratisierte Symbol oder das Rohsymbol, wenn es nicht hydratisiert werden kann
exceptions.nested BOOLEAN „Wahr“ für alle außer der zuletzt ausgelösten Ausnahme (d. h. der erste 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 von Crashlytics zugeordnet ist
installation_uuid STRING Eine ID, die eine eindeutige App- und Geräteinstallation identifiziert
is_fatal BOOLEAN Ob die App abgestürzt ist
issue_id STRING Das mit dem Ereignis verbundene Problem
logs REPEATED RECORD Logeinträge mit Zeitstempel, die vom Crashlytics-Logger generiert wurden, sofern aktiviert
logs.message STRING Der Logeintrag
logs.timestamp TIMESTAMP Zeitpunkt der Protokollerstellung
memory DATENSATZ Speicherstatus des Geräts
memory.free INT64 Verbleibende Arbeitsspeicherbytes
memory.used INT64 Verwendete Arbeitsspeicher-Byte
operating_system DATENSATZ Details zum Betriebssystem auf dem Gerät
operating_system.device_type STRING Der Gerätetyp (z. B. MOBILE, TABLET, TV usw.), auch als „Gerätekategorie“ bezeichnet
operating_system.display_version STRING Die Version des Betriebssystems auf dem Gerät
operating_system.modification_state STRING Ob das Gerät modifiziert wurde (z. B. ist eine App mit Jailbreak MODIFIED und eine gerootete App 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 im Firebase-Projekt registriert (gültige Werte: IOS oder ANDROID)
process_state STRING BACKGROUND oder FOREGROUND
storage DATENSATZ Der nichtflüchtige Speicher des Geräts
storage.free INT64 Verbleibende Speicherbyte
storage.used INT64 Belegter Speicherplatz in Byte
threads REPEATED RECORD Threads, die zum Zeitpunkt des Ereignisses vorhanden waren
threads.blamed BOOLEAN Ob Crashlytics festgestellt hat, dass dieser Frame die Ursache des Absturzes oder Fehlers ist
threads.code INT64 (Nur Apple-Apps) Fehlercode des benutzerdefinierten NSError-Objekts der Anwendung
threads.crash_address INT64 Die Adresse des Signals, das den Absturz der Anwendung verursacht hat; nur bei abgestürzten nativen Threads vorhanden
threads.crashed BOOLEAN Ob der Thread abgestürzt ist
threads.frames REPEATED RECORD Die Frames des Threads
threads.frames.address INT64 Die Adresse im Binär-Image, die den Code enthält
threads.frames.blamed BOOLEAN Gibt an, ob Crashlytics diesen Frame als Ursache des Fehlers ermittelt hat
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 in das Binär-Image, das den Code enthält
threads.frames.owner STRING Beispiel: DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM.
threads.frames.symbol STRING Das hydratisierte Symbol oder das Rohsymbol, wenn es nicht hydratisierbar ist
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 den Absturz der App verursacht hat; nur bei abgestürzten nativen Threads vorhanden
threads.signal_name STRING Der Name des Signals, das den Absturz der App verursacht hat, 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 dies ein Debug-Build ist
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 Die 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-Stufe 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 Der Prozessortyp
unity_metadata.screen_refresh_rate_hz INT64 Die Aktualisierungsrate des Displays in Hz
unity_metadata.screen_resolution_dpi STRING Die DPI des Bildschirms als Gleitkommazahl
unity_metadata.screen_size_px STRING Die Größe des Bildschirms in Pixeln, formatiert als Breite × Höhe
unity_metadata.system_memory_size_mb INT64 Die Größe des Arbeitsspeichers des Systems in MB
unity_metadata.unity_version STRING Die auf diesem Gerät ausgeführte Unity-Version
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 App-spezifische ID, die dem Nutzer zugeordnet 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 verknüpfte Problemvariante.


Firebase-Sitzungs-Dataset

Firebase-Sitzungsdaten werden in ein BigQuery-Dataset mit dem Namen firebase_sessions exportiert. Das Dataset deckt Ihr gesamtes Projekt ab, auch wenn es mehrere Apps enthält.

Tabellen

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

Die Tabellen werden nach der Kennung der App benannt (wobei Punkte in Unterstriche umgewandelt werden) und mit der Plattform der App (_IOS oder _ANDROID) versehen. 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, das stattgefunden hat.

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- + 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 können alle Sitzungen gruppiert werden, die seit einem Kaltstart stattgefunden haben. Wenn diese Sitzung 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 gestartet wurde. Für die erste Sitzung nach einem Kaltstart ist dies 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 Die Art des Ereignisses, das in der Sitzung aufgetreten ist (z. B. SESSION_START)
event_timestamp TIMESTAMP Der Zeitpunkt des Ereignisses
received_timestamp TIMESTAMP Der Zeitpunkt, zu dem das Ereignis vom Gerät auf dem Server eingegangen ist
performance_data_collection_enabled BOOLEAN Ob die Datenerhebung des Firebase Performance Monitoring SDK zum Zeitpunkt der Sitzung aktiviert war
crashlytics_data_collection_enabled BOOLEAN Ob die Datenerhebung des 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 stattgefunden hat
device.model STRING Das Modell des Geräts
device.manufacturer STRING Der Hersteller des Geräts. Bei Apps für Apple-Plattformen ist dies NULL.
operating_system DATENSATZ Beschreibt das Betriebssystem des Geräts
operating_system.display_version STRING Die angezeigte Version 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, TV)