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

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

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

匯總自訂網址模式下的資料

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

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

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

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

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

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

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

不過，example.com/books/* 模式是最明確的比對網址模式，因為 example.com/books/* 中最左邊的片段 books 優先於 example.com/*/dog 中最左邊的片段 *。

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

  • 舊有要求的比對結果和匯總資料不會受到新建自訂網址模式的影響。Firebase 不會回溯重新匯總要求資料。

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

建立自訂網址模式

您可以透過追蹤記錄表中的「Network requests」子分頁建立自訂網址模式，該子分頁位於 Firebase 控制台的「Performance」資訊主頁底部。

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

每個應用程式最多可建立 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 會在追蹤記錄表的「Network requests」子分頁中顯示所有網址模式 (包括自訂網址模式) 及其匯總資料，該子分頁位於 Firebase 控制台的「Performance」資訊主頁底部。

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

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

移除自訂網址模式

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

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

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

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

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

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

  • 任何未來要求都會對應至最具體的下一個相符自訂網址模式。如果 Firebase 找不到相符的自訂網址模式，就會改用自動網址模式比對功能。

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

    在適用的資料保留期間結束前，您仍可在「Network requests」子頁籤 (選取「All network requests」) 中存取已移除的自訂網址模式及其匯總資料。當移除的自訂網址模式下所有匯總資料到期時，Firebase 就會刪除該自訂網址模式。

  • 「Network requests」子頁籤 (選取「Custom patterns」) 不會列出任何已移除的自訂網址模式。

後續步驟

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

自訂成功率的計算方式

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

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

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

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

設定成功率計算方式

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

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