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

使用屬性過濾數據

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

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

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

  • 應用程序版本過濾以查看有關過去版本或最新版本的數據
  • 設備過濾以了解舊設備如何處理您的應用
  • 按國家/地區過濾以確保您的數據庫位置不會影響特定區域

要根據屬性進行更強大的分析,請將性能數據導出到 BigQuery

默認屬性

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

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

Apple 和 Android 應用程序的默認屬性

默認情況下,Apple 和 Android 應用程序的所有跟踪都會收集以下屬性:

  • 應用程序版本
  • 國家
  • 操作系統級別
  • 設備
  • 收音機
  • 載體

此外,網絡請求跟踪還收集以下屬性:

  • MIME類型

收集用戶數據

創建自定義屬性

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

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

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

請注意以下事項:

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

    • 沒有前導或尾隨空格,沒有前導下劃線 ( _ ) 字符
    • 沒有空間
    • 最大長度為 32 個字符
    • 名稱允許的字符包括AZaz_
  • 每個自定義代碼跟踪最多可以記錄 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
}

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();