將 Performance Monitoring 資料匯出至 BigQuery

您可以將 Apple 和 Android 應用程式的 Performance Monitoring 資料匯出至 BigQuery，以便進一步分析。BigQuery 可讓您使用 BigQuery SQL 分析資料、將資料匯出至其他雲端服務供應商，甚至將資料用於自訂機器學習模型。

啟用BigQuery匯出功能

1. 前往 Firebase 控制台的「Integrations」(整合) 頁面，然後點選「BigQuery」資訊卡中的「Link」(連結)。

2. 按照畫面上的指示啟用 BigQuery。

   為 Performance Monitoring 啟用 BigQuery 匯出功能後，會發生下列情況：

   • Firebase 會將現有資料副本匯出至 BigQuery。匯出資料的初始傳播作業最多可能需要 48 小時才能完成。

     • 您可以手動排定資料補充作業，最多可回溯至過去 30 天，或啟用 BigQuery 匯出作業的最近日期 (以最近者為準)。

   • 資料集建立後，位置就無法變更，不過您可以將資料集複製到其他位置，或手動將資料集移動 (重新建立) 至其他位置。詳情請參閱「變更資料集位置」。

   • Firebase 會定期將 Firebase 專案中的資料同步至BigQuery。這些每日匯出作業通常會在排定後 24 小時內完成。

   • 根據預設，專案中的所有應用程式都會連結至 BigQuery。日後新增至專案的任何應用程式，都會自動連結至 BigQuery。此外，您可以控管該讓哪些應用程式傳送資料。

如要停用 BigQuery 匯出功能，請在 Firebase 控制台中取消連結專案。

哪些資料會匯出至 BigQuery？

匯出作業會為專案中的每個應用程式建立一個資料表，其中包含所有擷取的效能事件。表格中的每一列都是單一效能事件，可能是下列其中一種：

• 時間長度追蹤記錄：預設會收集「時間長度」指標的追蹤記錄，包括應用程式啟動、應用程式在前景執行、應用程式在背景執行，以及任何開發人員檢測的自訂程式碼追蹤記錄

  • 「event_type」現為「DURATION_TRACE」
  • event_name與追蹤記錄名稱相同

• 追蹤指標：與開發人員檢測的自訂程式碼追蹤記錄相關聯的自訂指標

  • 「event_type」現為「TRACE_METRIC」
  • event_name 是指標名稱
  • parent_trace_name 是包含這項指標的追蹤記錄名稱

• 畫面追蹤記錄：涵蓋畫面生命週期的追蹤記錄 (畫面轉譯追蹤記錄)

  • 「event_type」現為「SCREEN_TRACE」
  • event_name 是前置字串 _st_ 加上實際畫面名稱

• 網路要求：涵蓋網路要求生命週期的追蹤記錄 (HTTP 網路要求追蹤記錄)

  • 「event_type」現為「NETWORK_REQUEST」
  • event_name 是網路要求網址的分類模式

每個效能事件都包含事件屬性 (例如用戶端裝置的國家/地區和電信業者)，以及事件專屬資訊：

• 時間長度追蹤記錄、追蹤記錄指標和畫面追蹤記錄包含 trace_info
• 追蹤指標包含 trace_info.metric_info
• 畫面追蹤記錄包含 trace_info.screen_info
• 網路追蹤記錄包含 network_info

詳細資料架構

匯出資料後可以做什麼？

下列各節提供查詢範例，說明如何在 BigQuery 中對匯出的 Performance Monitoring 資料執行查詢。

與控制台顯示的資料相符

Firebase 資訊主頁會以America/Los_Angeles時區匯總每日資料。 為符合控制台顯示的內容，日期函式應明確將 America/Los_Angeles 設為時區，否則日期函式會預設使用世界標準時間。

SELECT
  DATE(event_timestamp, 'America/Los_Angeles') AS daily_date,
  APPROX_QUANTILES(trace_info.duration_us, 100)[OFFSET(90)] / 1000000 AS p90_seconds,
FROM `TABLE_NAME`
WHERE
  DATE(event_timestamp, 'America/Los_Angeles')
    >= DATE_SUB( PARSE_DATE('%Y%m%d', 'YYYY-MM-DD'), INTERVAL 7 DAY)
  AND DATE(event_timestamp, 'America/Los_Angeles')
    <= PARSE_DATE('%Y%m%d', 'YYYY-MM-DD')
  AND event_name = '_app_start'
GROUP BY 1
ORDER BY 1 DESC;

查看應用程式平均啟動延遲時間 (依國家/地區細分)

SELECT AVG(trace_info.duration_us), country
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "DURATION_TRACE"
AND event_name = "_app_start"
GROUP BY 2;

查看各種條件下的凍結影格比率

舉例來說，您可以查看凍結畫面比例，以及使用者在不同無線電類型 (Wi-Fi、4G 等) 下，在應用程式各個畫面上花費的時間。

SELECT
  AVG(trace_info.duration_us / 1000000) AS seconds_on_screen,
  AVG(trace_info.screen_info.frozen_frame_ratio) AS frozen_frame_ratio,
  event_name,
  radio_type
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "SCREEN_TRACE"
GROUP BY event_name, radio_type
ORDER BY event_name, radio_type;

計算從磁碟載入特定類型檔案的快取命中率

這項分析假設您已檢測自訂程式碼追蹤記錄，以便從磁碟載入，其中包含名為 file-extension 的自訂屬性和名為 cache-hit 的自訂指標 (TRACE_METRIC)，如果快取命中，則設為 1，如果快取失敗，則設為 0。

舉例來說，您可以計算從磁碟載入 PNG 檔案的快取命中率：

SELECT AVG(trace_info.metric_info.metric_value) AS cache_hit_rate
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "TRACE_METRIC"
AND event_name = "cache-hit"
AND parent_trace_name = "loadFromDisk"
AND STRUCT("file-extension", "png") IN UNNEST(custom_attributes);

查看使用者發出網路要求的時段

舉例來說，您可以查看美國使用者在一天中的哪個小時，從應用程式發出網路要求：

SELECT
  count(1) AS hourly_count,
  EXTRACT(HOUR FROM event_timestamp) AS hour_of_day
FROM `TABLE_NAME`
WHERE _PARTITIONTIME > TIMESTAMP("YYYY-MM-DD")
AND event_type = "NETWORK_REQUEST"
AND country = "US"
GROUP BY 2 ORDER BY 2;

隨時隨地存取 Performance Monitoring 資料

有時您可能想在伺服器端存取 Performance Monitoring 資料，或將資料推送至其他第三方解決方案。目前匯出資料不收費。

匯出資料的方式如下：

• 使用 BigQuery 網頁版 UI

• 執行 CLI 指令 bq extract

• 透過 API 或用戶端程式庫提交擷取工作。

定價

從 Performance Monitoring 匯出資料不需付費，且 BigQuery 提供相當寬裕的免付費用量限制。詳情請參閱 BigQuery 定價或 BigQuery 沙箱。