Схема набора данных для экспортированных данных в 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, то в таблице realtime будут те же столбцы, что и в таблице batch.

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

Ниже перечислены столбцы таблицы с экспортированными данными Crashlytics.

Название поля Тип данных Описание
app_orientation STRING Примеры: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN и т. д.
application RECORD Приложение, которое сгенерировало событие.
application.build_version STRING Версия сборки приложения.
application.display_version STRING
blame_frame RECORD Фрейм, который был определен как основная причина сбоя или ошибки.
blame_frame.address INT64 Адрес в двоичном изображении, содержащем код.
Не задано для фреймов Java.
blame_frame.blamed BOOLEAN Определил ли Crashlytics, что этот фрейм является причиной сбоя или ошибки.
blame_frame.file STRING Название файла кадра.
blame_frame.library STRING Отображаемое название библиотеки, в которую входит фрейм.
blame_frame.line INT64 Номер строки файла фрейма.
blame_frame.offset INT64 Смещение в байтах в двоичном изображении, содержащем код.
Не задано для исключений Java.
blame_frame.owner STRING Примеры: DEVELOPER, VENDOR, RUNTIME, PLATFORM, SYSTEM.
blame_frame.symbol STRING Дополненный символ или исходный символ, если его нельзя дополнить.
breadcrumbs ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Google Analytics навигационные цепочки с временными метками (если включены).
breadcrumbs.name STRING Название, связанное со строкой навигации.
breadcrumbs.params ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Параметры, связанные с элементом навигации
breadcrumbs.params.key STRING Ключ параметра, связанный с подсказкой.
breadcrumbs.params.value STRING Значение параметра, связанное с навигационной цепочкой.
breadcrumbs.timestamp ВРЕМЕННЫЕ МЕТКИ Временная метка, связанная с подсказкой.
bundle_identifier STRING Уникальный идентификатор приложения, зарегистрированного в проекте Firebase (например, com.google.gmail).
Для приложений на платформе Apple это идентификатор пакета приложения.
Для приложений Android это название пакета приложения.
crashlytics_sdk_versions STRING Версия SDK Crashlytics, которая сгенерировала событие.
custom_keys ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Пары "ключ-значение", заданные разработчиком
custom_keys.key STRING Ключ, заданный разработчиком.
custom_keys.value STRING Значение, заданное разработчиком.
device RECORD Устройство, на котором произошло событие.
device_orientation STRING Примеры: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN и т. д.
device.architecture STRING Примеры: X86_32, X86_64, ARMV7, ARM64, ARMV7S, ARMV7K.
device.manufacturer STRING производитель устройства;
device.model STRING Модель устройства.
error ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Некритические ошибки (только для приложений Apple).
error_type STRING Тип ошибки события (например, FATAL, NON_FATAL, ANR и т. д.).
error.blamed BOOLEAN Определил ли Crashlytics, что этот фрейм является причиной ошибки.
error.code INT64 Код ошибки, связанный с пользовательской ошибкой NSError, зарегистрированной в приложении.
error.frames ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Фреймы трассировки стека.
error.frames.address INT64 Адрес в двоичном изображении, содержащем код.
error.frames.blamed BOOLEAN Определил ли Crashlytics, что этот фрейм является причиной ошибки.
error.frames.file STRING Название файла кадра.
error.frames.library STRING Отображаемое название библиотеки, в которую входит фрейм.
error.frames.line INT64 Номер строки файла фрейма.
error.frames.offset INT64 Смещение в байтах в двоичном изображении, содержащем код.
error.frames.owner STRING Примеры: DEVELOPER, VENDOR, RUNTIME, PLATFORM, SYSTEM.
error.frames.symbol STRING Символ с добавленными данными или исходный символ, если данные добавить нельзя.
error.queue_name STRING Очередь, в которой выполнялся поток.
error.subtitle STRING Подзаголовок цепочки.
error.title STRING Название цепочки.
event_id STRING Уникальный идентификатор события.
event_timestamp ВРЕМЕННЫЕ МЕТКИ время, когда произошло событие;
exceptions ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ (Только для Android.) Исключения, которые произошли во время этого события. Вложенные исключения представлены в обратном хронологическом порядке, то есть последняя запись – это первое возникшее исключение.
exceptions.blamed BOOLEAN True, если Crashlytics определяет, что исключение является причиной ошибки или сбоя.
exceptions.exception_message STRING Сообщение, связанное с исключением.
exceptions.frames ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Фреймы, связанные с исключением.
exceptions.frames.address INT64 Адрес в двоичном изображении, содержащем код.
Не задано для фреймов Java.
exceptions.frames.blamed BOOLEAN Определил ли Crashlytics, что этот фрейм является причиной сбоя или ошибки.
exceptions.frames.file STRING Название файла кадра.
exceptions.frames.library STRING Отображаемое название библиотеки, в которую входит фрейм.
exceptions.frames.line INT64 Номер строки файла фрейма.
exceptions.frames.offset INT64 Смещение в байтах в двоичном изображении, содержащем код.
Не задано для исключений Java.
exceptions.frames.owner STRING Примеры: DEVELOPER, VENDOR, RUNTIME, PLATFORM, SYSTEM.
exceptions.frames.symbol STRING Дополненный символ или исходный символ, если его нельзя дополнить.
exceptions.nested BOOLEAN True для всех исключений, кроме последнего (то есть первой записи)
exceptions.subtitle STRING Подзаголовок цепочки.
exceptions.title STRING Название цепочки.
exceptions.type STRING Тип исключения (например, java.lang.IllegalStateException)).
firebase_session_id STRING Автоматически созданный идентификатор сеанса Firebase, сопоставленный с событием из Crashlytics.
installation_uuid STRING Идентификатор, который позволяет определить уникальное приложение и устройство, на котором оно установлено.
is_fatal BOOLEAN произошел ли сбой приложения;
issue_id STRING Проблема, связанная с событием.
logs ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Сообщения в журнале с временными метками, созданные регистратором Crashlytics (если включен).
logs.message STRING Сообщение в журнале
logs.timestamp ВРЕМЕННЫЕ МЕТКИ время создания записи;
memory RECORD Статус памяти устройства.
memory.free INT64 Оставшийся объем памяти в байтах
memory.used INT64 Используемый объем памяти (в байтах)
operating_system RECORD Сведения об ОС на устройстве.
operating_system.device_type STRING Тип устройства (например, MOBILE, TABLET, TV и т. д.). Также называется категорией устройства.
operating_system.display_version STRING версия ОС на устройстве;
operating_system.modification_state STRING Информация о том, было ли устройство изменено (например, незаконно разблокировано – MODIFIED, или к нему разрешен root-доступ – UNMODIFIED).
operating_system.name STRING Название ОС на устройстве.
operating_system.type STRING (Только для приложений Apple.) Тип ОС, установленной на устройстве (например, IOS, MACOS и т. д.).
platform STRING Платформа приложения, зарегистрированная в проекте Firebase (допустимые значения: IOS или ANDROID).
process_state STRING BACKGROUND или FOREGROUND
storage RECORD Постоянное хранилище устройства.
storage.free INT64 Оставшийся объем хранилища в байтах
storage.used INT64 Использовано хранилища (в байтах)
threads ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Цепочки, существовавшие на момент события.
threads.blamed BOOLEAN Определил ли Crashlytics, что этот фрейм является причиной сбоя или ошибки.
threads.code INT64 (Только для приложений Apple) Код ошибки NSError, зарегистрированной в приложении.
threads.crash_address INT64 Адрес сигнала, который привел к сбою приложения. Указывается только для нативных потоков, в которых произошел сбой.
threads.crashed BOOLEAN Произошел ли сбой потока.
threads.frames ПОВТОРЯЮЩАЯСЯ ЗАПИСЬ Фреймы потока.
threads.frames.address INT64 Адрес в двоичном изображении, содержащем код.
threads.frames.blamed BOOLEAN Определил ли Crashlytics, что этот фрейм является причиной ошибки.
threads.frames.file STRING Название файла кадра.
threads.frames.library STRING Отображаемое название библиотеки, в которую входит фрейм.
threads.frames.line INT64 Номер строки файла фрейма.
threads.frames.offset INT64 Смещение в байтах в двоичном изображении, содержащем код.
threads.frames.owner STRING Примеры: DEVELOPER, VENDOR, RUNTIME, PLATFORM, SYSTEM.
threads.frames.symbol STRING Дополненный символ или исходный символ, если его нельзя дополнить.
threads.queue_name STRING (Только для приложений Apple.) Очередь, в которой выполнялся поток.
threads.signal_code STRING Код сигнала, который привел к сбою приложения. Указывается только для нативных потоков, в которых произошел сбой.
threads.signal_name STRING Название сигнала, который привел к сбою приложения. Указывается только для нативных потоков, в которых произошел сбой.
threads.subtitle STRING Подзаголовок цепочки.
threads.thread_name STRING Название цепочки.
threads.title STRING Название цепочки.
unity_metadata.debug_build BOOLEAN Если это отладочная сборка
unity_metadata.graphics_copy_texture_support STRING Поддержка копирования текстуры графики, как определено в Unity API.
unity_metadata.graphics_device_id INT64 Идентификатор графического устройства.
unity_metadata.graphics_device_name STRING Название графического устройства.
unity_metadata.graphics_device_type STRING Тип графического устройства.
unity_metadata.graphics_device_vendor_id INT64 Идентификатор поставщика графического процессора.
unity_metadata.graphics_device_vendor STRING Поставщик графического устройства.
unity_metadata.graphics_device_version STRING Версия графического устройства.
unity_metadata.graphics_max_texture_size INT64 Максимальный размер, выделенный для текстуры рендеринга
unity_metadata.graphics_memory_size_mb INT64 Объем графической памяти в мегабайтах.
unity_metadata.graphics_render_target_count INT64 Количество целей графического рендеринга
unity_metadata.graphics_shader_level INT64 Уровень шейдеров графики
unity_metadata.processor_count INT64 Количество процессоров (ядер)
unity_metadata.processor_frequency_mhz INT64 Частота процессора(процессоров) в МГц.
unity_metadata.processor_type STRING Тип процессора.
unity_metadata.screen_refresh_rate_hz INT64 Частота обновления экрана в Гц.
unity_metadata.screen_resolution_dpi STRING Разрешение экрана в DPI в виде числа с плавающей запятой.
unity_metadata.screen_size_px STRING Размер экрана в пикселях в формате "ширина x высота".
unity_metadata.system_memory_size_mb INT64 Объем памяти системы в МБ.
unity_metadata.unity_version STRING Версия Unity, запущенная на этом устройстве.
user RECORD (Необязательно) Информация о пользователе приложения.
user.email STRING (Необязательно) Адрес электронной почты пользователя.
user.id STRING (Необязательно.) Идентификатор пользователя в приложении.
user.name STRING (необязательно) имя пользователя;
variant_id STRING Вариант проблемы, связанный с этим событием.
Обратите внимание, что не у всех событий есть связанный вариант проблемы.


Набор данных о сеансах Firebase

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

Таблицы

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

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

Строки

Каждая строка в таблице представляет событие сеанса.

Столбцы

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

Ниже приведены столбцы таблицы экспортируемых данных о сеансах Firebase.

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