將 Crashlytics 資料匯出至 BigQuery

您可以將 Firebase Crashlytics 資料匯出為 BigQuery 格式。資料匯入 BigQuery 後，您就可以使用 SQL 查詢分析資料、建構資料視覺化和自訂資訊主頁，甚至將資料匯出至其他服務。

本頁說明如何設定將 Crashlytics 和 (選用) Firebase 工作階段資料匯出至 BigQuery。

設定匯出至 BigQuery

前往 Firebase 控制台的「整合」頁面。
在 BigQuery 資訊卡中，按一下「連結」。
按照畫面上的指示設定匯出至 BigQuery，包括下列選項：
- 如要進一步瞭解未發生當機情形的使用者和工作階段，請啟用 Firebase 工作階段資料匯出功能。
- 如要在 BigQuery 中近乎即時地存取 Crashlytics 資料和 Firebase 工作階段資料，請啟用串流匯出。

(選用) 啟用 Firebase 工作階段資料匯出功能

也可以在首次設定匯出至 BigQuery 時啟用這個選項。

前往 Firebase 控制台的「整合」頁面。
在 BigQuery 資訊卡中，按一下「管理」。
勾選「包含工作階段」核取方塊。

這項操作會啟用所有連結應用程式的會期資料匯出功能。如果已啟用串流匯出功能，系統也會開始即時匯出工作階段資料。

(選用) 啟用串流匯出功能

請參閱本頁面稍後的內容，瞭解將匯出內容串流至 BigQuery 的好處。

也可以在首次設定匯出至 BigQuery 時啟用這個選項。

前往 Firebase 控制台的「整合」頁面。
在 BigQuery 資訊卡中，按一下「管理」。
勾選「Include streaming」核取方塊。

這項操作會為所有連結的應用程式啟用串流功能。如果已啟用 Firebase 工作階段匯出功能，系統也會啟用工作階段資料的串流匯出功能。

取消連結「BigQuery」

取消連結 BigQuery 後，系統不會再將資料填入 BigQuery 中對應的資料集。

請留意下列事項：

已匯出至「BigQuery」的資料會保留一段時間 (視情況而定)，且可能仍須支付儲存空間和查詢費用。如要避免產生後續費用，可以手動刪除資料集。
如果將 BigQuery 資料儲存在其他服務，這類內容可能會受到其他資料保留條款的規範。

您可以在 Firebase 專案層級、產品層級，或特定產品的應用程式層級取消連結 BigQuery。

如要取消連結 BigQuery，請按照下列步驟操作：

前往 Firebase 控制台的「整合」頁面。
在 BigQuery 資訊卡中，按一下「管理」。
選擇取消連結特定產品，或取消連結特定產品的特定應用程式。

如要完全取消連結 Firebase 專案，請在頁面底部找到相關按鈕。
系統顯示提示時，請確認要停止匯出。

啟用匯出功能後會發生什麼事？

Firebase 會匯出連結至 BigQuery 的應用程式資料。
- 設定時，專案中的所有應用程式預設都會連結至 BigQuery，但您可以在設定期間選取「不」連結特定應用程式。
- 您之後加進 Firebase 專案的應用程式，都會自動連結至 BigQuery。
- 您隨時可以管理哪些應用程式可以匯出資料。
Firebase 會將資料匯出至您在設定期間選取的資料集位置。
- 這個位置會同時套用至 Crashlytics 資料集和 Firebase 工作階段資料集 (如果已啟用匯出工作階段資料)。
- 這個位置僅適用於匯出至 BigQuery 的資料，不會影響儲存資料的位置，以供在 Firebase 控制台的 Crashlytics 資訊主頁或 Android Studio 中使用。
- 資料集建立後，該資料集的位置就無法再變更，不過您可以將資料集複製到其他位置，或將資料集手動移動 (重新建立) 至其他位置。詳情請參閱「變更現有匯出作業的位置」。
注意： 只有在 2024 年 10 月中旬後啟用匯出功能，或是升級至新的匯出基礎架構，才能選取及變更資料匯出位置。
Firebase 會設定每日將批次資料同步至 BigQuery。
- 連結至 BigQuery 後，初始批次資料匯出作業最多可能需要 48 小時。
- 無論您在 BigQuery 中設定的排定匯出作業為何，系統每天都會執行一次每日同步作業。請注意，同步作業的時間和持續時間可能會變更，因此不建議根據匯出作業的特定時間安排下游作業或工作。
Firebase 會將現有資料副本匯出至 BigQuery。
- 針對每個連結的應用程式，匯出內容會包含一個批次資料表，內含每日同步處理的資料。
- 您可以手動排定資料回填作業，為批次資料表回填過去 30 天的資料或啟用匯出至 BigQuery 時的最新日期資料 (以較近的日期為準)。
請注意，如果您在 2024 年 10 月中旬前啟用Crashlytics資料匯出功能，也可以回填啟用匯出功能前 30 天的資料。
如果您啟用串流匯出至 BigQuery，Firebase 會執行下列動作。
- 此外，每個已連結的應用程式都會有自己的即時表格，其中包含持續更新的資料 (以及應用程式的批次表格，用於每日批次匯出)。
- 啟用串流後，最多可能需要 1 小時，資料才會開始串流。
即時表格中沒有顯示資料嗎？
1. 請確認您已從應用程式傳送至少兩個事件至 Crashlytics，並在傳送後等待幾分鐘。
2. 確認 Firebase 專案採用即付即用 Blaze 定價方案。
  查看Firebase控制台左下角即可確認。
3. 傳送兩個事件並等待幾分鐘後，如果即時表格仍未顯示資料，請按照下列步驟操作：
  1. 前往 Firebase 控制台的BigQuery 資訊卡。
  2. 停用再重新啟用串流匯出功能。
  3. 確認服務帳戶 service-PROJECT_NUMBER@gcp-sa-crashlytics.iam.gserviceaccount.com 位於 Firebase 專案中，且具備「Firebase Crashlytics 服務代理人」角色。
    您可以在Google Cloud控制台的「IAM」頁面中查看這項資訊 (請務必選取「包含 Google 提供的角色授權」核取方塊)。
  4. 至少將兩個事件傳送至 Crashlytics，並等待幾分鐘。
4. 如果即時資料表仍未顯示資料，請與 Firebase 支援團隊聯絡。

將資料串流匯出至 BigQuery 的好處

根據預設，資料會匯出至 BigQuery，並每日批次匯出。此外，您也可以使用BigQuery串流功能，即時串流 Crashlytics 資料和 Firebase 工作階段。您可以將串流資料用於任何需要即時資料的用途，例如在即時資訊主頁中呈現資訊、即時觀看推出作業，或是監控會觸發快訊和自訂工作流程的應用程式問題。

啟用串流匯出至 BigQuery 時，您也會取得即時資料表 (以及批次資料表)。這兩種資料表都有相同的資料集結構定義，但批次資料表和即時資料表之間有以下重要差異：

批次資料表	即時表格
資料每天匯出一次。系統會先永久儲存事件，再批次寫入 BigQuery。資料最多可回填 30 天前*的資料。	資料會即時匯出。無法回填。

批次資料表適合長期分析及找出一段時間內的趨勢，因為系統會先長期儲存事件，再寫入資料表，且最多可回填 30 天的資料*。當我們將資料寫入即時資料表時，會立即將資料寫入 BigQuery，因此非常適合用於即時資訊主頁和自訂快訊。這兩個資料表可以透過縫合查詢合併，同時享有兩者的優點。

根據預設，即時資料表的分區到期時間為 30 天。如要瞭解如何修改這項設定，請參閱 BigQuery 說明文件中的「設定分區期限」。

^{* 如要瞭解回填支援的詳細資訊，請參閱「升級至新的匯出基礎架構」。}

定價和 BigQuery 沙箱

如果 Firebase 專案採用免付費的 Spark 定價方案，您可以使用BigQuery 沙箱，免費存取 BigQuery。如要瞭解 BigQuery 沙箱及其功能，請參閱「使用 BigQuery 沙箱」。

如果 Firebase 專案採用即付即用 Blaze 定價方案，即可使用 BigQuery 的所有功能。使用 BigQuery 時須遵守BigQuery 定價，包括免付費使用上限。

升級至新的匯出基礎架構，只需 BigQuery

2024 年 10 月中旬，Crashlytics推出新基礎架構，可批次將 Crashlytics 資料匯出至 BigQuery。

如果您在 2024 年 10 月之後啟用批次匯出功能，Firebase 專案就會自動使用新的匯出基礎架構。無須採取任何行動。
如果您在 2024 年 10 月之前或期間啟用批次匯出功能，請參閱「如何升級至 BigQuery 的新匯出基礎架構？」一文中的資訊，判斷是否需要採取任何行動。

後續步驟

查看範例 SQL 查詢。
建立自訂資訊主頁，使用匯出的資料和各種 Google Cloud 服務，例如 Looker Studio。
瞭解匯出資料的資料集結構定義。