自訂網路要求資料匯總作業

Firebase Performance Monitoring會自動彙整類似網路要求的資料，協助您瞭解網路要求成效的趨勢。

不過，有時您需要自訂 Firebase 彙整特定網路要求資料的方式，以便更妥善支援應用程式的用途。我們提供兩種方式，讓您自訂網路要求的資料匯總：依自訂網址模式匯總資料，以及自訂成功率的計算方式。

依自訂網址模式匯總資料

Firebase 會檢查每個要求的網路要求網址是否符合網址模式。如果要求網址符合網址模式，Firebase 會自動將要求資料匯總至該網址模式。

您可以建立自訂網址模式，監控 Firebase 無法透過衍生自動網址模式比對擷取的特定網址模式。舉例來說，您可以使用自訂網址模式排解特定網址的問題，或是長期監控特定網址組合。

Firebase 會在追蹤記錄表格的「網路要求」子分頁中，顯示所有網址模式 (包括自訂網址模式) 及其匯總資料。追蹤記錄表格位於 Firebase 控制台的「效能」資訊主頁底部。

自訂網址模式比對的運作方式

Firebase 會先嘗試將要求網址與任何已設定的自訂網址模式比對，然後再改用自動網址模式比對。如果要求符合自訂網址模式，Firebase 會將要求資料匯總至該模式。

如果要求的網址符合多個自訂網址模式，Firebase 只會根據下列具體程度順序，將要求對應至最具體的自訂網址模式：純文字 > * > ** (路徑中從左到右)。舉例來說，對 example.com/books/dog 的要求會比對兩個自訂網址模式：

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

不過，模式 example.com/books/* 是最明確的相符網址模式，因為 example.com/books/* 最左側的區隔 books 優先於 example.com/*/dog 最左側的區隔 *。

建立新的自訂網址模式時，請注意下列事項：

  • 建立新的自訂網址模式不會影響先前要求的比對結果和匯總資料。Firebase 不會追溯重新彙整要求資料。

  • 建立新的自訂網址模式只會影響日後的要求。 Performance Monitoring 最多可能需要 12 小時，才能收集及匯總新自訂網址模式下的資料。

建立自訂網址模式

您可以在 Firebase 控制台的「效能」資訊主頁底部的追蹤記錄表格中，從「網路要求」子分頁建立自訂網址模式。

專案成員必須是擁有者或編輯者，才能建立新的自訂網址模式；不過，所有專案成員都能查看自訂網址模式及其匯總資料。

每個應用程式最多可建立 400 個自訂網址模式，每個網域最多可建立 100 個自訂網址模式。

如要建立自訂網址模式，請先輸入主機名稱，然後輸入路徑區隔。主機名稱必須包含有效網域，也可以選擇是否包含子網域。使用下列路徑區隔語法建立可比對網址的模式。

  • 純文字 - 比對完全一致的字串
  • *：符合第一個子網域片段，或單一路徑片段中的任何字串
  • **：比對任意路徑後置字串

下表說明一些可能的自訂網址模式比對。

如要比對... 建立自訂網址模式，例如... 符合這個網址模式的範例
確切網址 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

查看自訂網址模式及其資料

Firebase 會在追蹤記錄表格的「網路要求」子分頁中，顯示所有網址模式 (包括自訂網址模式) 及其匯總資料。追蹤記錄表格位於 Firebase 控制台的「效能」資訊主頁底部。

如要只查看自訂網址格式，請在追蹤記錄表格的「網路要求」子分頁中，從下拉式選單選取「自訂格式」。請注意，如果自訂網址模式沒有任何匯總資料，就只會顯示在這份清單中。

如果網址模式匯總的資料保留期限屆滿，Firebase 會從該網址模式中刪除資料。如果自訂網址模式下匯總的所有資料都過期，Firebase 不會從 Firebase 控制台中刪除自訂網址模式。不過，Firebase 會繼續在追蹤記錄表格的「網路要求」子分頁「自訂模式」清單中，列出「空白」自訂網址模式。

移除自訂網址模式

您可以從專案中移除自訂網址模式。請注意，您無法移除自動網址模式。

  1. 在「成效」資訊主頁中，向下捲動至追蹤記錄表格，然後選取「網路要求」子分頁。

  2. 在「網路要求」子分頁的下拉式選單中，選取「自訂模式」。

  3. 將滑鼠游標懸停在要移除的自訂網址模式資料列上。

  4. 按一下資料列最右側的 ，選取「移除自訂模式」，然後在對話方塊中確認移除。

移除自訂網址模式時，請注意下列事項：

  • 日後所有要求都會對應至下一個最符合的自訂網址模式。如果 Firebase 找不到相符的自訂網址模式，就會改用自動網址模式比對。

  • 移除自訂網址模式不會影響先前要求的比對結果和匯總資料。

    在適用的資料保留期限結束前，您仍可在「網路要求」子分頁 (選取「所有網路要求」) 中，存取已移除的自訂網址模式及其匯總資料。移除自訂網址模式後，當該模式下的所有匯總資料過期時，Firebase 就會刪除該模式。

  • 「網路要求」子分頁 (已選取「自訂模式」) 不會列出任何已移除的自訂網址模式。

後續步驟

  • 設定快訊，針對會降低應用程式效能的網路要求發出通知。舉例來說，如果特定網址模式的回應時間超過您設定的門檻，您可以設定電子郵件快訊，通知團隊。

自訂成功率的計算方式

Firebase 會監控每項網路要求的指標，其中一項就是要求成功率。成功率是指成功回應數占總回應數的百分比。這項指標有助於評估網路和伺服器故障。

具體來說，Firebase 會自動將回應代碼介於 100 到 399 之間的網路要求視為成功回應。

除了 Firebase 自動計為成功的狀態碼外，您也可以將特定錯誤代碼計為「成功回應」，自訂成功率計算方式。

舉例來說，如果應用程式有搜尋端點 API，您可以將 404 回應計為「成功」，因為搜尋端點預期會出現 404 回應。假設這個搜尋端點每小時有 100 個樣本，其中 60 個是 200 回應，40 個是 404 回應。設定成功率前，系統會將成功率設為 60%。將成功率計算方式設為將 404 回應計為成功後，成功率就會是 100%。

設定成功率計算方式

如要設定網路網址模式的成功率計算方式，您必須具備 firebaseperformance.config.update 權限。下列角色預設包含這項必要權限：Firebase 效能管理員、Firebase 品質管理員、Firebase 管理員，以及專案擁有者或編輯者。

  1. 前往 Firebase 控制台的「資訊主頁」分頁標籤 Performance Monitoring，然後選取要設定成功率計算的應用程式。
  2. 向下捲動至畫面底部的追蹤記錄表格，然後選取「網路要求」分頁。
  3. 找出要設定成功率計算的網址模式。
  4. 開啟資料列最右側的溢位選單 ()，然後選取「設定成功率」。
  5. 按照畫面上的指示，選取要計為成功回應代碼的回應代碼。