自定義網絡請求數據聚合

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. 請依照螢幕上的指示選擇您想要計算為成功回應代碼的回應代碼。