自定義網絡請求數據聚合

Firebase 性能監控會自動匯總類似網絡請求的數據,以幫助您了解網絡請求性能的趨勢。

不過,有時您需要自定義 Firebase 聚合特定網絡請求數據的方式,以更好地支持您應用的用例。我們提供兩種方式來自定義網絡請求的數據聚合:自定義 URL 模式下的聚合數據自定義成功率的計算方式

在自定義 URL 模式下聚合數據

對於每個請求,Firebase 都會檢查網絡請求的 URL 是否與URL 模式匹配。如果請求 URL 與 URL 模式匹配,Firebase 會自動在 URL 模式下聚合請求的數據。

您可以創建自定義 URL 模式來監控 Firebase 未通過其派生的自動 URL 模式匹配捕獲的特定 URL 模式。例如,您可以使用自定義 URL 模式對特定 URL 進行故障排除或隨著時間的推移監控一組特定的 URL。

Firebase 在跟踪表的網絡請求子選項卡中顯示所有 URL 模式(包括自定義 URL 模式)及其聚合數據,該表位於 Firebase 控制台的性能信息中心的底部。

自定義 URL 模式匹配如何工作?

Firebase 會嘗試將請求 URL 與任何已配置的自定義 URL 模式匹配,然後再回退到自動 URL 模式匹配。對於自定義 URL 模式的任何匹配請求,Firebase 會在自定義 URL 模式下聚合請求的數據。

如果請求的 URL 匹配多個自定義 URL 模式,則 Firebase 僅根據以下特定順序將請求映射到最具體的自定義 URL 模式:純文本 > * > **在路徑中從左到右。例如,對example.com/books/dog的請求匹配兩個自定義 URL 模式:

  • example.com/books/*
  • example.com/*/dog

但是,模式example.com/books/*最具體的匹配 URL 模式,因為example.com/*/dog中最左邊的部分books優先於example.com/books/*中最左邊的部分*

創建新的自定義 URL 模式時,請注意以下事項:

  • 來自先前請求的匹配和聚合數據不受創建新的自定義 URL 模式的影響。 Firebase 不會追溯地重新聚合請求數據。

  • 只有未來的請求會受到創建新的自定義 URL 模式的影響。您可能需要等待長達 12 小時,性能監控才能在新的自定義 URL 模式下收集和聚合數據。

創建自定義 URL 模式

您可以從跟踪表中的網絡請求子選項卡創建自定義 URL 模式,該跟踪表位於 Firebase 控制台的性能信息中心的底部。

項目成員必須是所有者或編輯者才能創建新的自定義 URL 模式;但是,所有項目成員都可以查看自定義 URL 模式及其匯總數據。

您可以為每個應用程序創建最多 400 個自定義 URL 模式,並為該應用程序的每個域創建最多 100 個自定義 URL 模式。

要創建自定義 URL 模式,請從主機名開始,然後是路徑段。主機名必須包含有效域,並且可以選擇包含子域。使用以下路徑段語法創建可以匹配 URL 的模式。

  • 純文本——匹配一個精確的字符串
  • * - 匹配第一個子域段,或單個路徑段中的任何字符串
  • ** — 匹配任意路徑後綴

下表描述了一些潛在的自定義 URL 模式匹配。

匹配...創建一個自定義 URL 模式,例如...與此 URL 模式匹配的示例
準確的網址example.com/foo/baz example.com/foo/baz
任何單個路徑段 ( * ) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

注意:此模式與example.com/foo不匹配。

任意路徑後綴 ( ** ) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
第一個子域段 ( * ) *.example.com/foo bar.example.com/foo
baz.example.com/foo

查看自定義 URL 模式及其數據

Firebase 在跟踪表的網絡請求子選項卡中顯示所有 URL 模式(包括自定義 URL 模式)及其聚合數據,該表位於 Firebase 控制台的性能信息中心的底部。

查看自定義 URL 模式,請從跟踪表的網絡請求子選項卡的下拉菜單中選擇自定義模式。請注意,如果自定義 URL 模式沒有任何聚合數據,則它只會出現在此列表中。

當在 URL 模式下聚合的數據的數據保留期結束時,Firebase 會從 URL 模式中刪除該數據。如果自定義 URL 模式下聚合的所有數據都過期,則 Firebase不會從 Firebase 控制台中刪除自定義 URL 模式。相反,Firebase 繼續在跟踪表的網絡請求子選項卡的自定義模式列表中列出“空”自定義 URL 模式。

刪除自定義 URL 模式

您可以從項目中刪除自定義 URL 模式。請注意,您無法刪除自動 URL 模式。

  1. Performance dashboard向下滾動到跟踪表,然後選擇Network requests子選項卡。

  2. 網絡請求子選項卡的下拉菜單中選擇自定義模式

  3. 將鼠標懸停在您要刪除的自定義 URL 模式的行上。

  4. 單擊該行最右側的 ,選擇Remove custom pattern ,然後在對話框中確認刪除。

刪除自定義 URL 模式時,請注意以下事項:

  • 任何未來的請求都會映射到下一個最具體的匹配自定義 URL 模式。如果 Firebase 未找到匹配的自定義 URL 模式,則會回退到自動 URL 模式匹配

  • 刪除自定義 URL 模式不會影響來自先前請求的匹配項和聚合數據。

    在適用的數據保留期結束之前,您仍然可以在網絡請求子選項卡(選中所有網絡請求)中訪問已刪除的自定義 URL 模式及其聚合數據。當已移除的自定義 URL 模式下的所有聚合數據都過期時,Firebase 會刪除自定義 URL 模式。

  • 網絡請求子選項卡(已選擇自定義模式)未列出任何已刪除的自定義 URL 模式。

下一步

  • 為降低應用程序性能的網絡請求設置警報。例如,如果特定 URL 模式的響應時間超過您設置的閾值,您可以為您的團隊配置電子郵件警報。

自定義成功率的計算方式

Firebase 針對每個網絡請求監控的指標之一是請求的成功率。成功率是成功響應與總響應的百分比。此指標可幫助您衡量網絡和服務器故障。

具體來說,Firebase 會自動將響應代碼在 100 - 399 範圍內的網絡請求計為成功響應。

除了 Firebase 自動計為成功的響應代碼之外,您還可以通過將某些錯誤代碼計為“成功響應”來自定義成功率計算。

例如,如果您的應用具有搜索端點 API,您可以將 404 響應計為“成功”,因為搜索端點需要 404 響應。假設這個搜索端點每小時有 100 個樣本,其中 60 個是 200 個響應,其中 40 個是 404 個響應。在您配置成功率之前,成功率為 60%。將成功率計算配置為將 404 響應計為成功後,成功率為 100%。

配置成功率計算

要為網絡 URL 模式配置成功率計算,您必須具有firebaseperformance.config.update權限。默認情況下,以下角色包括此必需權限: Firebase Performance AdminFirebase Quality AdminFirebase Admin和項目Owner 或 Editor

  1. 轉到 Firebase 控制台中的性能監控儀表板選項卡,然後選擇要為其配置成功率計算的應用。
  2. 向下滾動到屏幕底部的跟踪表,然後選擇網絡請求選項卡。
  3. 找到您要為其配置成功率計算的 URL 模式。
  4. 在該行的最右側,打開溢出菜單 ( ) 並選擇配置成功率
  5. 按照屏幕上的說明選擇要計為成功響應代碼的響應代碼。