Dataset-Schema für exportierte Daten in BigQuery

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

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


Crashlytics Dataset

Crashlytics-Daten werden in ein BigQuery-Dataset mit dem Namen firebase_crashlytics exportiert. Das Dataset umfasst Ihr gesamtes Projekt, auch wenn es mehrere Apps enthält.

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 anhand der Kennung der App benannt. Dabei werden Punkte in Unterstriche umgewandelt und die Plattform der App (_IOS oder _ANDROID) wird 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 steht für ein Ereignis, 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 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, durch die das Ereignis hervorgerufen wurde
application.build_version STRING 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ärbild, 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 Mediathek, 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 gerenderte Symbol oder das Rohsymbol, wenn es nicht gerendert werden kann
breadcrumbs WIEDERHOLTE AUFNAHME Zeitstempel für Google Analytics-Navigationspfade, sofern aktiviert
breadcrumbs.name STRING Der Name, der mit dem Breadcrumb verknüpft ist
breadcrumbs.params WIEDERHOLTE AUFNAHME Mit dem Breadcrumb verknüpfte Parameter
breadcrumbs.params.key STRING Ein Parameterschlüssel, der mit dem Breadcrumb verknüpft ist
breadcrumbs.params.value STRING Ein Parameterwert, der mit dem Breadcrumb verknüpft ist
breadcrumbs.timestamp TIMESTAMP Der Zeitstempel, der mit dem Breadcrumb verknüpft ist
bundle_identifier STRING Die eindeutige Kennung für die App, wie sie im Firebase-Projekt registriert ist (z. B. com.google.gmail)
Bei Apps für Apple-Plattformen ist dies die Paket-ID der App.
Bei Android-Apps ist dies der Paketname der App.
crashlytics_sdk_versions STRING Die Crashlytics SDK-Version, mit der das Ereignis generiert wurde
custom_keys WIEDERHOLTE AUFNAHME 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 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 WIEDERHOLTE AUFNAHME Nicht schwerwiegende Fehler (nur Apple-Apps)
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 mit dem benutzerdefinierten protokollierten NSError der App verknüpft ist
error.frames WIEDERHOLTE AUFNAHME Die Frames des Stacktrace
error.frames.address INT64 Die Adresse im binären Bild, 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 Mediathek, 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 gerenderte Symbol oder das Rohsymbol, wenn es nicht gerendert 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 AUFNAHME (Nur Android) Ausnahmen, die während dieses Ereignisses aufgetreten sind. Verschachtelte Ausnahmen werden in umgekehrter chronologischer Reihenfolge angezeigt. Das bedeutet, dass der letzte Datensatz die erste ausgelöste Ausnahme ist.
exceptions.blamed BOOLEAN Wahr, 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 WIEDERHOLTE AUFNAHME Die mit der Ausnahme verknüpften Frames
exceptions.frames.address INT64 Die Adresse im Binärbild, 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 Mediathek, 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 gerenderte Symbol oder das Rohsymbol, wenn es nicht gerendert werden kann
exceptions.nested BOOLEAN „Wahr“ für alle außer der zuletzt ausgelösten Ausnahme (d. h. 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 Ob die App abgestürzt ist
issue_id STRING Das Problem im Zusammenhang mit dem Ereignis
logs WIEDERHOLTE AUFNAHME Zeitstempel versehene Logeinträge, die vom Logger Crashlytics generiert werden (falls aktiviert)
logs.message STRING Die protokollierte Nachricht
logs.timestamp TIMESTAMP Wann das Protokoll 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 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 Nichtflüchtiger Speicher des Geräts
storage.free INT64 Verbleibende Speicherbyte
storage.used INT64 Belegter Speicherplatz in Bytes
threads WIEDERHOLTE AUFNAHME 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 NSError der Anwendung
threads.crash_address INT64 Die Adresse des Signals, das zum Absturz der Anwendung geführt hat. Ist nur bei abgestürzten nativen Threads vorhanden.
threads.crashed BOOLEAN Ob der Thread abgestürzt ist
threads.frames WIEDERHOLTE AUFNAHME Die Frames des Threads
threads.frames.address INT64 Die Adresse im binären Bild, 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 Mediathek, 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 hydrierte Symbol oder das Rohsymbol, wenn es nicht hydriert 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 den Absturz der App verursacht 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 Die maximale Größe, die für das Rendern von Texturen verwendet wird
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 Grafiken
unity_metadata.processor_count INT64 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 Displays in Pixeln im Format „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 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 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 zugehörige Problemvariante.


Firebase-Dataset für Sitzungen

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

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 Kennung der App benannt (Punkte werden in Unterstriche umgewandelt) und mit der Plattform der App (_IOS oder _ANDROID) ergänzt. 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, entspricht dieses Feld session_id.
session_index INTEGER Die Reihenfolge, in der diese Sitzung nach dem Kaltstart der App eingegangen ist. Bei der ersten 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 Der Typ des Ereignisses, das in der Sitzung aufgetreten ist (z. B. SESSION_START).
event_timestamp TIMESTAMP Zeitpunkt des Ereignisses
received_timestamp TIMESTAMP Die Zeit, zu der das Ereignis vom Gerät auf dem Server empfangen wurde
performance_data_collection_enabled BOOLEAN Gibt an, ob die Datenerhebung 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 Der 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)