Catch up on highlights from Firebase at Google I/O 2023. Learn more

使用屬性過濾數據

版

通過性能監控，您可以使用屬性來細分性能數據，並重點關注應用程序在不同現實場景中的性能。

單擊跟踪表（位於性能儀表板底部）中的跟踪名稱後，您可以深入了解感興趣的指標。使用“過濾器按鈕（屏幕左上角）按屬性過濾數據，例如：

按屬性過濾的 Firebase 性能監控數據的圖像

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

默認屬性

性能監控根據跟踪類型自動收集各種默認屬性。

除了這些默認屬性之外，您還可以在自定義代碼跟踪上創建自定義屬性，以按應用程序特定的類別對數據進行分段。例如，在遊戲中，您可以按遊戲級別對數據進行分段。

為 Web 應用程序收集的默認屬性

默認情況下，Web 應用程序的所有跟踪都會收集以下屬性：

收集用戶數據

創建自定義屬性

您可以在任何已檢測的自定義代碼跟踪上創建自定義屬性。

使用性能監控跟踪 API將自定義屬性添加到自定義代碼跟踪。

要使用自定義屬性，請將代碼添加到定義該屬性並將其與特定自定義代碼跟踪關聯的應用程序。您可以在跟踪開始和跟踪停止之間隨時設置自定義屬性。

請注意以下事項：

  • 自定義屬性的名稱必須滿足以下要求：

    • 沒有前導或尾隨空格，沒有前導下劃線 ( _ ) 字符
    • 沒有空間
    • 最大長度為 32 個字符
    • 名稱允許的字符包括AZ 、 az和_ 。

  • 每個自定義代碼跟踪最多可以記錄 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();
perf_add_custom_attributes.js

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();
index.js