使用屬性過濾數據

透過效能監控,您可以使用屬性來細分效能數據,並專注於應用程式在不同現實場景中的效能。

點擊追蹤表(位於效能儀表板底部)中的追蹤名稱後,您可以深入了解感興趣的指標。使用過濾器按鈕(螢幕左上角)可按屬性過濾數據,例如:

按屬性過濾的 Firebase 效能監控資料的影像

  • 頁面 URL過濾以查看網站特定頁面的數據
  • 有效連線類型過濾,了解 3g 連線如何影響您的應用
  • 按國家/地區過濾以確保您的資料庫位置不會影響特定區域

預設屬性

效能監控根據追蹤類型自動收集各種預設屬性。

除了這些預設屬性之外,您還可以在自訂程式碼追蹤建立自訂屬性,以按應用程式特定的類別對資料進行分段。例如,在遊戲中,您可以按遊戲等級對資料進行分段。

為 Web 應用程式收集的預設屬性

預設情況下,Web 應用程式的所有追蹤都會收集以下屬性:

收集用戶數據

建立自訂屬性

您可以在任何已偵測的自訂程式碼追蹤上建立自訂屬性。

使用效能監控追蹤 API將自訂屬性新增至自訂程式碼追蹤。

若要使用自訂屬性,請將程式碼新增至定義該屬性並將其與特定自訂程式碼追蹤關聯的應用程式。您可以在追蹤開始和追蹤停止之間隨時設定自訂屬性。

請注意以下事項:

  • 自訂屬性的名稱必須符合以下要求:

    • 沒有前導或尾隨空格,沒有前導底線 ( _ ) 字符
    • 沒有空間
    • 最大長度為 32 個字符
    • 名稱允許的字元包括AZaz_
  • 每個自訂程式碼追蹤最多可以記錄 5 個自訂屬性。

  • 請確保自訂屬性不包含任何可向 Google 識別個人身分的資訊。

    了解有關本指南的更多信息

Web modular API

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();

Web namespaced API

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

// Delete scenario
trace.removeAttribute("experiment");

// Read attributes
const traceAttributes = trace.getAttributes();