BigQuery にエクスポートされたデータのデータセット スキーマ

このページでは、BigQuery でエクスポートされた Crashlytics データと Firebase セッション データのデータセット スキーマについて説明します。

Firebase は、エクスポートされたデータ用に BigQuery に新しいデータセットを作成します。


Crashlytics 個のデータセット

Crashlytics データは、firebase_crashlytics という名前の BigQuery データセットにエクスポートされます。このデータセットは、複数のアプリがある場合でもプロジェクト全体をカバーします。

テーブル

デフォルトでは、Firebase は BigQuery にリンクされているプロジェクト内のアプリごとに、Crashlytics データセット内に個々のテーブルを作成します。

テーブルの名前は、アプリの ID（ピリオドはアンダースコアに変換）に基づいて付けられ、アプリのプラットフォーム（_IOS または _ANDROID）が末尾に追加されます。たとえば、パッケージ名が com.google.test の Android アプリのデータは 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 REPEATED RECORD タイムスタンプ付きの Google Analytics パンくずリスト（有効な場合）
breadcrumbs.name STRING パンくずリストに関連付けられている名前
breadcrumbs.params REPEATED RECORD パンくずリストに関連付けられたパラメータ
breadcrumbs.params.key STRING パンくずリストに関連付けられたパラメータキー
breadcrumbs.params.value STRING パンくずリストに関連付けられたパラメータ値
breadcrumbs.timestamp TIMESTAMP パンくずリストに関連付けられているタイムスタンプ
bundle_identifier STRING Firebase プロジェクトに登録されているアプリの固有識別子（例: com.google.gmail）
Apple プラットフォーム アプリの場合、これはアプリのバンドル ID です。
Android アプリの場合、これはアプリのパッケージ名です。
crashlytics_sdk_versions STRING イベントを生成した Crashlytics SDK のバージョン
custom_keys REPEATED RECORD デベロッパーが定義した Key-Value ペア
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 REPEATED RECORD （Apple アプリのみ）致命的でないエラー
error_type STRING イベントのエラータイプ（FATAL、NON_FATAL、ANR など）
error.blamed BOOLEAN Crashlytics で、このフレームがエラーの原因と判断されたかどうか
error.code INT64 アプリのカスタムログに記録された NSError に関連するエラーコード
error.frames REPEATED RECORD スタック トレースのフレーム
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 イベントの一意の ID
event_timestamp TIMESTAMP イベントの発生時間
exceptions REPEATED RECORD （Android のみ）このイベントで発生した例外。ネストされている例外は発生順と逆に表示されます。つまり、最後のレコードが最初にスローされた例外です。
exceptions.blamed BOOLEAN エラーまたはクラッシュが原因で例外が発生しているかどうかを Crashlytics が判断する場合は true
exceptions.exception_message STRING 例外に関連するメッセージ
exceptions.frames REPEATED RECORD 例外に関連付けられているフレーム
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 Crashlytics のイベントにマッピングされた Firebase セッションの自動生成 ID
installation_uuid STRING アプリとデバイスのインストールを一意に識別する ID
is_fatal BOOLEAN アプリがクラッシュしたかどうか
issue_id STRING イベントに関連付けられている問題
logs REPEATED RECORD Crashlytics ロガーによって生成されたタイムスタンプ付きのログメッセージ（有効な場合）
logs.message STRING ログに記録されたメッセージ
logs.timestamp TIMESTAMP ログの作成時間
memory RECORD デバイスのメモリ ステータス
memory.free INT64 未使用のメモリ（バイト）
memory.used INT64 使用済みのメモリ（バイト）
operating_system RECORD デバイスの OS の詳細
operating_system.device_type STRING デバイスの種類（例: MOBILE、TABLET、TV）。「デバイス カテゴリ」とも呼ばれます。
operating_system.display_version STRING デバイスの OS のバージョン
operating_system.modification_state STRING デバイスに変更が加えられているかどうか（例: 制限解除されたアプリは MODIFIED、root 権限を取得したアプリは UNMODIFIED など）
operating_system.name STRING デバイスの OS 名
operating_system.type STRING （Apple アプリのみ）デバイスで実行されている OS の種類（IOS、MACOS など）
platform STRING Firebase プロジェクトに登録されているアプリのプラットフォーム（有効な値: IOS または ANDROID）
process_state STRING BACKGROUND または FOREGROUND
storage RECORD デバイスの永続ストレージ
storage.free INT64 未使用のストレージ（バイト）
storage.used INT64 使用済みストレージ（バイト）
threads REPEATED RECORD イベント発生時に存在していたスレッド
threads.blamed BOOLEAN Crashlytics で、このフレームがクラッシュまたはエラーの原因と判断されたかどうか
threads.code INT64 （Apple アプリのみ）アプリケーションのカスタムログの NSError エラーコード
threads.crash_address INT64 アプリケーションをクラッシュさせたシグナルのアドレス。クラッシュしたネイティブ スレッドにのみ存在します。
threads.crashed BOOLEAN スレッドがクラッシュしたかどうか
threads.frames REPEATED RECORD スレッドのフレーム
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 グラフィック デバイスの ID
unity_metadata.graphics_device_name STRING グラフィック デバイスの名前
unity_metadata.graphics_device_type STRING グラフィック デバイスの種類
unity_metadata.graphics_device_vendor_id INT64 グラフィック プロセッサ ベンダーの ID
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 グラフィック メモリ（MB）
unity_metadata.graphics_render_target_count INT64 グラフィカル レンダリング ターゲットの数
unity_metadata.graphics_shader_level INT64 グラフィックのシェーダー レベル
unity_metadata.processor_count INT64 プロセッサ（コア）数
unity_metadata.processor_frequency_mhz INT64 プロセッサの周波数（MHz）
unity_metadata.processor_type STRING プロセッサの種類
unity_metadata.screen_refresh_rate_hz INT64 画面リフレッシュ レート（Hz）
unity_metadata.screen_resolution_dpi STRING 浮動小数点数による画面の DPI
unity_metadata.screen_size_px STRING 画面サイズのピクセル単位のサイズ（幅 x 高さの形式）
unity_metadata.system_memory_size_mb INT64 システムメモリのサイズ（MB 単位）
unity_metadata.unity_version STRING このデバイスで実行されている Unity のバージョン
user RECORD （省略可）アプリのユーザーに関して収集された情報
user.email STRING （省略可）ユーザーのメールアドレス
user.id STRING （省略可）ユーザーに関連付けられているアプリ固有の ID
user.name STRING （省略可）ユーザーの名前
variant_id STRING このイベントに関連付けられている問題のバリアント
すべてのイベントに問題のバリアントが関連付けられているわけではありません。


Firebase セッション データセット

Firebase セッション データは、firebase_sessions という名前の BigQuery データセットにエクスポートされます。このデータセットは、複数のアプリがある場合でもプロジェクト全体をカバーします。

テーブル

デフォルトでは、Firebase は BigQuery にリンクされているプロジェクト内のアプリごとに、Firebase セッション データセット内に個々のテーブルを作成します。

テーブルの名前は、アプリの ID（ピリオドはアンダースコアに変換）に基づいて付けられ、アプリのプラットフォーム（_IOS または _ANDROID）が末尾に追加されます。たとえば、パッケージ名が com.google.test の Android アプリのデータは com_google_test_ANDROID という名前のテーブルに格納されます。

行

テーブルの各行は、発生したセッション イベントを表します。

列

BigQuery へのストリーミング エクスポートが有効になっている場合、リアルタイム テーブルにはバッチテーブルと同じ列があります。

エクスポートされた Firebase セッションデータのテーブル内の列を次に示します。

フィールド名 データ型 説明
instance_id STRING デバイスの Firebase インストール ID（FID）。アプリとデバイスのインストールを一意に識別します。
session_id STRING このセッションの一意の ID
first_session_id STRING アプリがコールド スタートされてから、このセッションが属する一連のセッションの最初の ID。これを使用して、コールド スタート以降に発生したすべてのセッションをグループ化できます。このセッションが最初のセッションの場合、このフィールドは session_id と同じになります。
session_index INTEGER アプリがコールド スタートされた後にこのセッションが開始された順序。コールド スタート後の最初のセッションの場合は、0 になります。コールド スタートが発生せずにセッションが生成されるたびに（たとえば、30 分間操作がなかった後など）、インデックスが増分されます。
event_type STRING セッションで発生したイベントのタイプ（SESSION_START など）
event_timestamp TIMESTAMP イベントの発生時刻
received_timestamp 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 デバイスの OS を記述します
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 など）