Схема набора данных для экспортированных данных в BigQuery

На этой странице представлена ​​схема набора данных для экспортированных данных Crashlytics и данных сессий Firebase в BigQuery .

Firebase создает новые наборы данных в BigQuery для экспортированных данных:


Набор данных Crashlytics

Данные Crashlytics экспортируются в набор данных BigQuery под названием firebase_crashlytics . Этот набор данных охватывает весь ваш проект, даже если он включает в себя несколько приложений.

Таблицы

По умолчанию Firebase создает отдельные таблицы внутри набора данных Crashlytics для каждого приложения в вашем проекте, связанного с BigQuery .

Таблицы именуются на основе идентификатора приложения (точки заменяются подчеркиваниями) и дополняются названием платформы приложения ( _IOS или _ANDROID ). Например, данные для приложения Android с именем пакета com.google.test будут находиться в таблице с именем com_google_test_ANDROID .

  • Если включен потоковый экспорт в BigQuery , то данные также будут передаваться в режиме реального времени в таблицу с добавлением _REALTIME (например, com_google_test_ANDROID_REALTIME ).

  • Каждая строка в таблице представляет собой событие, произошедшее в приложении, включая сбои, некритические ошибки и ошибки ANR.

  • В таблицах содержится стандартный набор данных Crashlytics в дополнение к любым пользовательским ключам Crashlytics , определенным вами в вашем приложении ( iOS+ | Android | Flutter | Unity ).

Ряды

Каждая строка в таблице представляет собой ошибку, обнаруженную приложением.

Колонки

Столбцы в таблице идентичны для аварий, нефатальных ошибок и ошибок ANR.

  • Если включен потоковый экспорт в BigQuery , то таблица в реальном времени будет содержать те же столбцы, что и таблица пакетной обработки.

  • У вас могут быть столбцы в строках, представляющие события, для которых отсутствуют трассировки стека.

Вот столбцы таблицы с экспортированными данными Crashlytics :

Название поля Тип данных Описание
app_orientation НИТЬ Например, PORTRAIT , LANDSCAPE , FACE_UP , FACE_DOWN и т. д.
application ЗАПИСЫВАТЬ Приложение, которое инициировало это событие.
application.build_version НИТЬ Версия сборки приложения
application.display_version НИТЬ
blame_frame ЗАПИСЫВАТЬ Кадр, идентифицированный как основная причина сбоя или ошибки.
blame_frame.address INT64 Адрес в двоичном образе, содержащий код.
Не задано для Java-фреймов
blame_frame.blamed БУЛЕВОЕ Было ли установлено, что именно этот кадр стал причиной сбоя или ошибки, по данным Crashlytics
blame_frame.file НИТЬ Имя файла кадра
blame_frame.library НИТЬ Отображаемое имя библиотеки, в которую входит фрейм.
blame_frame.line INT64 Номер строки файла кадра
blame_frame.offset INT64 Смещение в байтах в двоичном образе, содержащем код.
Unset for Java exceptions
blame_frame.owner НИТЬ Например, DEVELOPER , VENDOR , RUNTIME , PLATFORM или SYSTEM
blame_frame.symbol НИТЬ Символ увлажненного состояния или символ необработанного вещества, если оно не увлажаемое.
breadcrumbs ПОВТОРНАЯ ЗАПИСЬ Если функция отображения навигационной цепочки Google Analytics включена, она будет содержать временные метки.
breadcrumbs.name НИТЬ The name associated with the breadcrumb
breadcrumbs.params REPEATED RECORD Параметры, связанные с хлебными крошками
breadcrumbs.params.key НИТЬ A parameter key associated with the breadcrumb
breadcrumbs.params.value НИТЬ Значение параметра, связанного с хлебными крошками.
breadcrumbs.timestamp ОТМЕТКА ВРЕМЕНИ The timestamp associated with the breadcrumb
bundle_identifier НИТЬ Уникальный идентификатор приложения, зарегистрированный в проекте Firebase (например, com.google.gmail )
Для приложений на платформе Apple это идентификатор пакета приложения.
Для приложений Android это имя пакета приложения.
crashlytics_sdk_versions НИТЬ Версия SDK Crashlytics , которая сгенерировала событие.
custom_keys REPEATED RECORD Developer-defined key-value pairs
custom_keys.key НИТЬ A developer-defined key
custom_keys.value НИТЬ A developer-defined value
device ЗАПИСЫВАТЬ Устройство, на котором произошло событие
device_orientation НИТЬ Например, PORTRAIT , LANDSCAPE , FACE_UP , FACE_DOWN и т. д.
device.architecture НИТЬ Например, X86_32 , X86_64 , ARMV7 , ARM64 , ARMV7S или ARMV7K
device.manufacturer НИТЬ The device manufacturer
device.model НИТЬ Модель устройства
error REPEATED RECORD (Apple apps only) non-fatal errors
error_type НИТЬ Тип ошибки события (например, FATAL , NON_FATAL , ANR и т. д.)
error.blamed BOOLEAN Уточнили ли Crashlytics , что именно этот кадр является причиной ошибки?
error.code INT64 Код ошибки, связанный с пользовательской записью NSError в журнале приложения.
error.frames REPEATED RECORD The frames of the stacktrace
error.frames.address INT64 Адрес в двоичном образе, содержащий код.
error.frames.blamed БУЛЕВОЕ Уточнили ли Crashlytics , что именно этот кадр является причиной ошибки?
error.frames.file НИТЬ The name of the frame file
error.frames.library НИТЬ Отображаемое имя библиотеки, в которую входит фрейм.
error.frames.line INT64 The line number of the file of the frame
error.frames.offset INT64 Смещение в байтах в двоичном образе, содержащем код.
error.frames.owner НИТЬ Например, DEVELOPER , VENDOR , RUNTIME , PLATFORM или SYSTEM
error.frames.symbol НИТЬ Символ увлажненного состояния или символ необработанного вещества, если оно не увлажаемое.
error.queue_name НИТЬ The queue the thread was running on
error.subtitle НИТЬ Подзаголовок темы
error.title НИТЬ The title of the thread
event_id НИТЬ The unique ID for the event
event_timestamp ОТМЕТКА ВРЕМЕНИ When the event occurred
exceptions ПОВТОРНАЯ ЗАПИСЬ (Только для Android) Исключения, возникшие во время этого события. Вложенные исключения представлены в обратном хронологическом порядке, то есть последняя запись — это первое выброшенное исключение.
exceptions.blamed BOOLEAN Значение true, если Crashlytics определяет, что именно исключение стало причиной ошибки или сбоя.
exceptions.exception_message НИТЬ A message associated with the exception
exceptions.frames ПОВТОРНАЯ ЗАПИСЬ The frames associated with the exception
exceptions.frames.address INT64 Адрес в двоичном образе, содержащий код.
Не задано для Java-фреймов
exceptions.frames.blamed БУЛЕВОЕ Было ли установлено, что именно этот кадр стал причиной сбоя или ошибки, по данным Crashlytics
exceptions.frames.file НИТЬ The name of the frame file
exceptions.frames.library НИТЬ Отображаемое имя библиотеки, в которую входит фрейм.
exceptions.frames.line INT64 The line number of the file of the frame
exceptions.frames.offset INT64 Смещение в байтах в двоичном образе, содержащем код.
Не задано для исключений Java.
exceptions.frames.owner НИТЬ Например, DEVELOPER , VENDOR , RUNTIME , PLATFORM или SYSTEM
exceptions.frames.symbol НИТЬ Символ увлажненного состояния или символ необработанного вещества, если оно не увлажаемое.
exceptions.nested BOOLEAN Это справедливо для всех исключений, кроме последнего выброшенного исключения (то есть первой записи).
exceptions.subtitle НИТЬ Подзаголовок темы
exceptions.title НИТЬ Название темы
exceptions.type НИТЬ Тип исключения (например, java.lang.IllegalStateException)
firebase_session_id НИТЬ Автоматически сгенерированный идентификатор сессии Firebase, сопоставленный с событием из Crashlytics
installation_uuid НИТЬ Идентификатор, который определяет уникальность установки приложения и устройства.
is_fatal БУЛЕВОЕ Произошёл ли сбой в работе приложения?
issue_id НИТЬ Проблема, связанная с этим событием.
logs ПОВТОРНАЯ ЗАПИСЬ Сообщения журнала с отметками времени, генерируемые регистратором Crashlytics (если он включен).
logs.message НИТЬ Зарегистрированное сообщение
logs.timestamp ОТМЕТКА ВРЕМЕНИ Когда бревно было изготовлено
memory ЗАПИСЫВАТЬ Состояние памяти устройства
memory.free INT64 Bytes of memory remaining
memory.used INT64 Использовано байтов памяти
operating_system ЗАПИСЫВАТЬ Подробная информация об операционной системе на устройстве.
operating_system.device_type НИТЬ Тип устройства (например, MOBILE , TABLET , TV и т. д.); также известен как «категория устройства».
operating_system.display_version НИТЬ Версия операционной системы на устройстве
operating_system.modification_state НИТЬ Была ли проведена модификация устройства (например, приложение, взломанное с помощью джейлбрейка, считается MODIFIED , а приложение, рутированное с помощью UNMODIFIED ).
operating_system.name НИТЬ Название операционной системы на устройстве
operating_system.type НИТЬ (Только для приложений Apple) Тип операционной системы, работающей на устройстве (например, IOS , MACOS и т. д.)
platform НИТЬ Платформа приложения, зарегистрированная в проекте Firebase (допустимые значения: IOS или ANDROID ).
process_state НИТЬ BACKGROUND или FOREGROUND
storage ЗАПИСЫВАТЬ Постоянное хранилище устройства
storage.free INT64 Осталось байтов памяти
storage.used INT64 Использовано байтов памяти
threads ПОВТОРНАЯ ЗАПИСЬ Темы, существовавшие на момент события.
threads.blamed БУЛЕВОЕ Было ли установлено, что именно этот кадр стал причиной сбоя или ошибки, по данным Crashlytics
threads.code INT64 (Только для приложений Apple) Код ошибки, регистрируемый в пользовательском журнале NSError приложения.
threads.crash_address INT64 Адрес сигнала, вызвавшего сбой приложения; присутствует только в потоках, завершившихся с ошибкой.
threads.crashed БУЛЕВОЕ Произошёл ли сбой в потоке?
threads.frames ПОВТОРНАЯ ЗАПИСЬ Рамки нити
threads.frames.address INT64 Адрес в двоичном образе, содержащий код.
threads.frames.blamed БУЛЕВОЕ Уточнили ли Crashlytics , что именно этот кадр является причиной ошибки?
threads.frames.file НИТЬ Имя файла кадра
threads.frames.library НИТЬ Отображаемое имя библиотеки, в которую входит фрейм.
threads.frames.line INT64 Номер строки файла кадра
threads.frames.offset INT64 Смещение в байтах в двоичном образе, содержащем код.
threads.frames.owner НИТЬ Например, DEVELOPER , VENDOR , RUNTIME , PLATFORM или SYSTEM
threads.frames.symbol НИТЬ Символ увлажненного состояния или символ необработанного вещества, если оно не поддается увлажнению.
threads.queue_name НИТЬ (Только для приложений Apple) Очередь, в которой выполнялся поток.
threads.signal_code НИТЬ Код сигнала, вызвавшего сбой приложения; присутствует только в потоках, завершившихся с ошибкой.
threads.signal_name НИТЬ Название сигнала, вызвавшего сбой приложения, присутствует только в потоках, завершившихся с ошибкой.
threads.subtitle НИТЬ Подзаголовок темы
threads.thread_name НИТЬ Название темы
threads.title НИТЬ Название темы
unity_metadata.debug_build БУЛЕВОЕ Если это отладочная сборка
unity_metadata.graphics_copy_texture_support НИТЬ Поддержка копирования графических текстур в соответствии с API Unity.
unity_metadata.graphics_device_id INT64 Идентификатор графического устройства
unity_metadata.graphics_device_name НИТЬ Название графического устройства
unity_metadata.graphics_device_type НИТЬ Тип графического устройства
unity_metadata.graphics_device_vendor_id INT64 Идентификатор производителя графического процессора.
unity_metadata.graphics_device_vendor НИТЬ The vendor of the graphics device
unity_metadata.graphics_device_version НИТЬ Версия графического устройства
unity_metadata.graphics_max_texture_size INT64 Максимальный размер, выделенный для рендеринга текстуры.
unity_metadata.graphics_memory_size_mb INT64 The graphics memory in MB
unity_metadata.graphics_render_target_count INT64 The number of graphical rendering targets
unity_metadata.graphics_shader_level INT64 The shader level of the graphics
unity_metadata.processor_count INT64 The number of processors (cores)
unity_metadata.processor_frequency_mhz INT64 The frequency of the processor(s) in MHz
unity_metadata.processor_type НИТЬ Тип процессора
unity_metadata.screen_refresh_rate_hz INT64 The refresh rate of the screen in Hz
unity_metadata.screen_resolution_dpi НИТЬ The DPI of the screen as a floating point number
unity_metadata.screen_size_px НИТЬ Размер экрана в пикселях, форматированный как ширина x высота.
unity_metadata.system_memory_size_mb INT64 The size of the system's memory in Mb
unity_metadata.unity_version НИТЬ Версия Unity, установленная на этом устройстве.
user ЗАПИСЫВАТЬ (Optional) Info collected about the app's user
user.email НИТЬ (Optional) The user's email address
user.id НИТЬ (Необязательно) Идентификатор приложения, связанный с пользователем.
user.name НИТЬ (Optional) The user's name
variant_id НИТЬ The issue variant associated with this event
Обратите внимание, что не для всех событий существует соответствующий вариант выпуска.


Firebase sessions dataset

Данные о сессиях Firebase экспортируются в набор данных BigQuery под названием firebase_sessions . Этот набор данных охватывает весь ваш проект, даже если он включает в себя несколько приложений.

Таблицы

По умолчанию Firebase создает отдельные таблицы внутри набора данных Firebase sessions для каждого приложения в вашем проекте, связанного с BigQuery .

Таблицы именуются на основе идентификатора приложения (точки заменяются подчеркиваниями) и дополняются названием платформы приложения ( _IOS или _ANDROID ). Например, данные для приложения Android с именем пакета com.google.test будут находиться в таблице с именем com_google_test_ANDROID .

Ряды

Каждая строка в таблице представляет собой событие сессии, которое произошло.

Колонки

Если включен потоковый экспорт в BigQuery , то таблица в реальном времени будет содержать те же столбцы, что и таблица пакетной обработки.

Вот столбцы таблицы с экспортированными данными о сессиях Firebase:

Field name Тип данных Описание
instance_id НИТЬ Идентификатор установки Firebase (FID) с устройства. Идентифицирует уникальную установку приложения и устройства.
session_id НИТЬ The unique ID of this session
first_session_id НИТЬ Первый идентификатор из серии сессий, в которых находится данная сессия с момента холодного запуска приложения. Это поле можно использовать для группировки всех сессий, произошедших после холодного запуска. Если данная сессия является первой, это поле будет совпадать с session_id .
session_index INTEGER Порядок, в котором эта сессия была создана после холодного запуска приложения. Для первой сессии после холодного запуска этот индекс будет равен 0 Индекс будет увеличиваться каждый раз, когда создается сессия без холодного запуска (например, после 30 минут бездействия).
event_type НИТЬ Тип события, произошедшего в ходе сессии (например, SESSION_START ).
event_timestamp ОТМЕТКА ВРЕМЕНИ The time of the event's occurrence
received_timestamp ОТМЕТКА ВРЕМЕНИ Время получения события сервером от устройства.
performance_data_collection_enabled BOOLEAN Была ли включена функция сбора данных Firebase Performance Monitoring SDK во время сеанса.
crashlytics_data_collection_enabled BOOLEAN Была ли включена функция сбора данных с помощью Firebase Crashlytics SDK во время сессии.
application ЗАПИСЫВАТЬ Описывает приложение
application.build_version НИТЬ Версия сборки приложения (например, 1523456 )
application.display_version НИТЬ Версия приложения для отображения (например, 4.1.7 )
device ЗАПИСЫВАТЬ Устройство, на котором произошло событие
device.model НИТЬ The model of the device
device.manufacturer НИТЬ Производитель устройства. Для приложений на платформе Apple это будет NULL .
operating_system ЗАПИСЫВАТЬ Описывает операционную систему устройства.
operating_system.display_version НИТЬ Отображаемая версия операционной системы (например, 10.2.1 )
operating_system.name НИТЬ The name of the operating system
operating_system.type НИТЬ Тип операционной системы (например, IOS ). Это поле заполняется только для устройств Apple.
operating_system.device_type НИТЬ Тип устройства (например, MOBILE , TABLET , TV )