使用屬性篩選資料

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

點選追蹤記錄表格中的追蹤記錄名稱 (位於「效能」資訊主頁底部)，即可進一步查看感興趣的指標。使用「篩選器」按鈕 (畫面左上方) 即可依屬性篩選資料，例如：

圖片：依屬性篩選 Firebase Performance Monitoring 資料

  • 依「應用程式版本」篩選，即可查看過去或最新版本的資料
  • 依「裝置」篩選，瞭解舊版裝置如何處理您的應用程式
  • 依「國家/地區」篩選，確保資料庫位置不會影響特定區域

如要進一步以屬性為基礎進一步分析，請將效能資料匯出至 BigQuery。

預設屬性

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

除了這些預設屬性以外，您也可以在自訂程式碼追蹤記錄上建立自訂屬性，依照應用程式的特定類別區隔資料。舉例來說，您可以在遊戲中按遊戲等級區隔資料。

Apple 和 Android 應用程式的預設屬性

根據預設，Apple 和 Android 應用程式的所有追蹤記錄會收集下列屬性：

  • 應用程式版本
  • 國家/地區
  • 作業系統版本
  • 裝置
  • 廣播
  • 貨運公司

此外，網路要求追蹤記錄也會收集下列屬性：

  • MIME 類型

收集使用者資料

建立自訂屬性

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

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

如要使用自訂屬性，請在應用程式中加入用來定義屬性的程式碼，並將其與特定自訂程式碼追蹤記錄建立關聯。從追蹤記錄開始到追蹤記錄停止的時間點之間，您隨時可以設定自訂屬性。

注意事項：

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

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

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

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

    進一步瞭解這項規範

Kotlin+KTX 

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}
MainActivity.kt

Java 

Trace trace = FirebasePerformance.getInstance().newTrace("test_trace");

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

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

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

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
MainActivity.java