Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

自定義網絡請求數據聚合

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

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

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

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

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

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

在回退到自動 URL 模式匹配之前,Firebase 會嘗試將請求 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向下滾動到 traces 表,然後選擇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和 project Owner or Editor

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