性能監控使用跟踪來收集有關應用程序中受監控進程的數據。跟踪是包含應用程序中兩個時間點之間捕獲的數據的報告。
對於所有應用程序類型,性能監控會自動收集應用程序發出的每個網絡請求的跟踪信息,稱為HTTP/S 網絡請求跟踪。這些跟踪收集應用程序向服務端點發出請求與該端點的響應完成之間的時間間隔的指標。對於您的應用程序發出請求的任何端點,性能監控會捕獲多個指標:
響應時間 - 發出請求和完全收到響應之間的時間
響應負載大小 - 應用程序下載的網絡負載的字節大小
請求負載大小 - 應用程序上傳的網絡負載的字節大小
成功率 - 成功響應(響應代碼在 100 - 399 範圍內)與總響應的百分比
您可以在跟踪表的網絡請求子選項卡中查看這些跟踪的數據,該表位於性能儀表板的底部(稍後將詳細了解如何使用控制台)。
自定義網絡請求數據聚合
除了網絡請求的開箱即用工具和數據聚合之外,性能監控還支持以下選項:
- 手動檢測網絡請求跟踪:開箱即用的監控包括應用程序的大多數網絡請求。但是,某些請求可能不會被報告,或者您可能使用不同的庫來發出網絡請求。在這些情況下,您可以使用性能監控 API 手動檢測自定義網絡請求跟踪。
- 聚合自定義網址模式下的數據:如果 Firebase 未通過其派生的自動網址模式匹配捕獲特定網址,您可以創建自定義網址模式來監控一段時間內的一組特定網址。
- 自定義成功率的計算方式:有時,某些 API 端點需要錯誤代碼,或者已在您的應用程序中處理。在這些情況下,您可以配置成功率的計算方式並更準確地監控應用程序網絡調用的成功率。
URL模式下的數據聚合
Firebase 性能監控會自動聚合類似網絡請求的數據,以幫助您了解網絡請求性能的趨勢。
對於每個請求,Firebase 都會檢查網絡請求的 URL 是否與 URL 模式匹配。如果請求網址與網址模式匹配,Firebase 會自動根據該網址模式聚合請求的數據。 Firebase 在 Firebase 控制台性能儀表板的“網絡”選項卡中顯示 URL 模式及其聚合數據。
什麼是 URL 模式?
URL 模式包含一個域以及一個可以匹配 URL 路徑的模式,例如: example.com/*/animals/**
。
URL 模式可以包含以下路徑段:
- 純文本 — 匹配精確的字符串
*
— 匹配單個路徑段中的任何字符串**
— 匹配任意路徑後綴
URL 模式可以是:
- Firebase 派生模式 — 稱為自動 URL 模式
- 用戶定義的模式——稱為自定義 URL 模式
例如:以下任何 URL 請求都可以與 URL 模式example.com/*/animals/**
匹配。
-
example.com/singapore/animals
-
example.com/australia/animals/spiders
-
example.com/australia/animals/marsupials/koala.png
URL 模式的域還可以包含*
作為其第一段,例如: *.example.com/*/fruits/**
。
Firebase 將每個請求僅映射到一種 URL 模式。如果您配置了任何自定義網址模式,Firebase 會首先嘗試將請求網址與這些模式進行匹配。如果 Firebase 找不到匹配的自定義 URL 模式,則會將請求 URL 與最具代表性的自動 URL 模式進行匹配。在以下部分中了解有關自動和自定義 URL 模式的更多信息。
自動 URL 模式
無需您進行任何配置,性能監控就會嘗試通過將應用程序的請求與自動 URL 模式進行匹配來反映應用程序的最新使用行為。
自動 URL 模式匹配如何工作?
Firebase 將每個請求與其從應用發送的請求派生的最具代表性的自動 URL 模式進行匹配。但請注意,Firebase 首先會嘗試將請求 URL 與任何配置的自定義 URL 模式進行匹配。
以下是 Firebase 如何嘗試將請求與應用程序最具代表性的自動 URL 模式相匹配的基本示例。
您的應用程序向 URL 發送許多請求,例如:
-
example.com/germany/animals/bears
-
example.com/germany/animals/birds
-
example.com/germany/cars
Firebase 確定
example.com/germany/**
是您的應用的常見請求模式,並將其添加為項目中的自動 URL 模式。對於任何與此 URL 模式匹配的新請求,Firebase 都會在自動 URL 模式
example.com/germany/**
下聚合請求的數據。-
一星期後,應用程序的大部分請求都發送到
example.com/germany/animals/bears
和example.com/germany/animals/birds
。因此,Firebase 派生出更具代表性的 URL 模式example.com/germany/animals/**
。對於與此新 URL 模式匹配的任何新請求,Firebase僅在新 URL 模式下聚合請求的數據。 Firebase 繼續聚合
example.com/germany/**
下的example.com/germany/cars
請求數據。但是,在接下來的幾週內,您的應用對
example.com/germany/animals/bears
和example.com/germany/animals/birds
的請求將大幅減少。 Firebase 確定example.com/germany/animals/**
不代表您應用的最新使用行為,因此 Firebase 開始將這兩個請求匹配回example.com/germany/**
。Firebase 不會在
example.com/germany/animals/**
下聚合任何進一步的請求數據,因為它不再是最具代表性的自動 URL 模式。
由於自動 URL 模式匹配是動態的,因此請注意以下事項:
先前請求的匹配和聚合數據不受新 URL 模式的影響。 Firebase 不會追溯性地重新聚合請求數據。
只有未來的請求才會受到新 URL 模式的影響。 Firebase 將每個新請求映射到最具代表性的自動 URL 模式。但請注意,Firebase 首先會嘗試將請求 URL 與任何配置的自定義 URL 模式進行匹配。
查看自動 URL 模式及其數據
Firebase 在跟踪表的網絡請求子選項卡中顯示所有 URL 模式及其聚合數據,該表位於 Firebase 控制台性能儀表板的底部。
您可能會看到帶有“未分類”標籤的 URL 模式。這些是“廣泛”的自動 URL 模式,Firebase 可以在這些模式下聚合與任何更具體的 URL 模式不匹配的請求的數據。
當在 URL 模式下聚合的數據的數據保留期結束時,Firebase 會從 URL 模式中刪除該數據。如果自動 URL 模式下聚合的所有數據均已過期,Firebase 將從 Firebase 控制台中刪除該 URL 模式。
自定義 URL 模式
您可以創建自定義網址模式來監控 Firebase 未通過其派生的自動網址模式匹配捕獲的特定網址模式。例如,您可以使用自定義 URL 模式對特定 URL 進行故障排除或隨著時間的推移監控一組特定的 URL。
請訪問創建自定義 URL 模式以了解更多信息。
跟踪、查看和過濾性能數據
要查看實時性能數據,請確保您的應用使用與實時數據處理兼容的性能監控 SDK 版本。了解有關實時性能數據的更多信息。
跟踪儀表板中的特定指標
要了解關鍵指標的趨勢,請將它們添加到績效儀表板頂部的指標板中。您可以通過查看每週的變化來快速識別回歸,或者驗證代碼中的最新更改是否正在提高性能。

要將指標添加到指標板,請執行以下步驟:
- 轉到 Firebase 控制台中的性能儀表板。
- 單擊空指標卡,然後選擇現有指標以添加到您的看板中。
- 單擊填充的指標卡上的 可獲取更多選項,例如替換或刪除指標。
指標板以圖形形式和數字百分比變化的形式顯示隨時間推移收集的指標數據。
了解有關使用儀表板的更多信息。
查看踪跡及其數據
要查看跟踪,請轉到 Firebase 控制台中的性能儀表板,向下滾動到跟踪表,然後單擊相應的子選項卡。該表顯示每個跟踪的一些主要指標,您甚至可以按特定指標的百分比變化對列表進行排序。
性能監控在 Firebase 控制台中提供了一個故障排除頁面,其中突出顯示了指標更改,從而可以輕鬆快速解決性能問題並最大程度地減少其對應用和用戶的影響。當您了解潛在的性能問題時,您可以使用故障排除頁面,例如,在以下場景中:
- 您在儀表板上選擇相關指標,您會注意到一個很大的增量。
- 在跟踪表中,您進行排序以在頂部顯示最大增量,並且您會看到顯著的百分比變化。
- 您會收到一封電子郵件警報,通知您出現性能問題。
您可以通過以下方式進入故障排除頁面:
- 在指標儀表板上,單擊查看指標詳細信息按鈕。
- 在任何指標卡上,選擇 => 查看詳細信息。故障排除頁面顯示有關您選擇的指標的信息。
- 在跟踪表中,單擊跟踪名稱或與該跟踪關聯的行中的任何指標值。
- 在電子郵件警報中,單擊“立即調查” 。
當您單擊跟踪表中的跟踪名稱時,您可以深入了解感興趣的指標。單擊“過濾器
按鈕可按屬性過濾數據,例如:
- 按應用程序版本過濾以查看有關過去版本或最新版本的數據
- 按設備過濾以了解舊設備如何處理您的應用
- 按國家/地區過濾以確保您的數據庫位置不會影響特定區域
了解有關查看跟踪數據的更多信息。
下一步
了解有關使用屬性檢查性能數據的更多信息。
詳細了解如何在 Firebase 控制台中跟踪性能問題。
針對降低應用性能的網絡請求設置警報。例如,如果特定 URL 模式的響應時間超過您設置的閾值,您可以為您的團隊配置電子郵件警報。
- 查看用戶會話的詳細報告,您可以在其中看到同一會話期間收集的其他跟踪的時間線上下文中的特定跟踪。