使用屬性篩選資料


使用 Performance Monitoring 時，您可以使用屬性區隔效能資料，並著重於應用程式在不同實際情境中的效能。

在追蹤記錄表 (位於 「Performance」資訊主頁底部) 中按一下追蹤記錄名稱後，您就可以深入瞭解感興趣的指標。使用篩選器按鈕 (畫面左上方)，依屬性篩選資料，例如：

<span class=Firebase Performance Monitoring 資料以屬性篩選/>

  • 篩選「網頁網址」，查看網站上特定網頁的資料
  • 依「有效連線類型」篩選，瞭解 3G 連線對應用程式有何影響
  • 依「國家/地區」篩選，確認資料庫位置不會影響特定區域

預設屬性

Performance Monitoring 會根據追蹤記錄的類型，自動收集各種預設屬性。

除了這些預設屬性之外，您也可以在自訂程式碼追蹤記錄中建立自訂屬性，依應用程式專屬類別區隔資料。舉例來說，在遊戲中，您可以依遊戲關卡區隔資料。

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

根據預設，所有網頁應用程式追蹤記錄都會收集下列屬性：

收集使用者資料

建立自訂屬性

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

使用 Performance Monitoring Trace API 將自訂屬性新增至自訂程式碼追蹤記錄。

如要使用自訂屬性，請在應用程式中新增程式碼，定義屬性並將其與特定自訂程式碼追蹤連結。您可以在追蹤開始和停止期間的任何時間設定自訂屬性。

注意事項：

  • 自訂屬性名稱必須符合下列規定：

    • 開頭或結尾不得有空白字元，開頭不得有底線 (_) 字元
    • 不能有空格
    • 長度上限為 32 個半形字元
    • 名稱可使用的字元為 A-Z、a-z 和 _。

  • 每個自訂程式碼追蹤記錄最多可記錄 5 個自訂屬性。

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

    進一步瞭解這項規範

Web

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

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