自定義網絡請求數據聚合

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

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

自定義 URL 模式下聚合數據

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

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

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

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

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

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

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

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

創建新的自定義 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. “性能儀表板”中,向下滾動到跟踪表,然後選擇“網絡請求”子選項卡。

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

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

  4. 單擊該行最右側的 ,選擇“刪除自定義圖案” ,然後在對話框中確認刪除。

刪除自定義 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. 按照屏幕上的說明選擇您想要計為成功響應代碼的響應代碼。