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/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
注意：這個模式不會與 |
|
任意路徑後置字串 (**) |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
第一個子網域區隔 (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
查看自訂網址模式及其資料
Firebase 會在追蹤記錄表的「Network requests」子分頁中顯示所有網址模式 (包括自訂網址模式) 及其匯總資料，該子分頁位於 Firebase 控制台的「Performance」資訊主頁底部。
如要只查看自訂網址格式，請在追蹤記錄表的「網路要求」子分頁中，從下拉式選單中選取「自訂格式」。請注意，如果自訂網址模式沒有任何匯總資料，就只會顯示在這份清單中。
當網址模式下匯總的資料資料保留期限屆滿時，Firebase 會從網址模式中刪除該資料。如果自訂網址模式下匯總的所有資料都到期，Firebase 不會從 Firebase 主控台刪除自訂網址模式。相反地，Firebase 會繼續在追蹤記錄表的「網路要求」子分頁的「自訂模式」清單中列出「空白」自訂網址模式。
移除自訂網址模式
您可以從專案中移除自訂網址模式。請注意，您無法移除自動網址模式。
在「成效」資訊主頁中，向下捲動至追蹤記錄表，然後選取「網路要求」子分頁。
在「網路要求」子分頁的下拉式選單中，選取「自訂模式」。
將滑鼠游標懸停在要移除的自訂網址模式資料列上。
按一下該列最右側的 ，選取「移除自訂模式」，然後在對話方塊中確認移除。
移除自訂網址模式時，請注意下列事項：
任何未來要求都會對應至最具體的下一個相符自訂網址模式。如果 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 管理員，以及專案擁有者或編輯者。
- 前往 Firebase 主控台的 Performance Monitoring「Dashboard」 分頁標籤，然後選取要設定成功率計算的應用程式。
- 向下捲動至畫面底部的追蹤記錄表格，然後選取「Network requests」分頁標籤。
- 找出要設定成功率計算的網址模式。
- 在資料列最右側，開啟溢位選單 ()，然後選取「設定成功率」。
- 按照畫面上的指示，選取要視為成功回應代碼的回應代碼。