На этой странице представлена схема набора данных для экспортированных данных Crashlytics и данных о сеансах Firebase для мобильных приложений в BigQuery.
Firebase создает в BigQuery новые наборы данных для экспортированных данных:
Набор данных о сеансах Firebase (если включен экспорт данных о сеансах)
Набор данных 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 |
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, то в таблице реального времени будут те же столбцы, что и в таблице пакетного экспорта.
Ниже приведены столбцы таблицы экспортируемых данных о сеансах 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.
|