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 不會回溯重新匯總要求資料。
只有「日後」的要求會因為建立新的自訂網址模式而受到影響。 你最多可能需要等待 12 小時，才能讓「Performance Monitoring」收集並收集到 並透過新的自訂網址模式匯總資料
建立自訂網址模式
您可以在 追蹤記錄資料表，位於 效能資訊主頁 Firebase 控制台。
專案成員必須是擁有者或編輯者，才能 建立新的自訂網址模式但所有專案成員 網址模式及相關匯總資料。
每個應用程式最多可建立 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 會顯示所有網址模式 (包括自訂網址模式) 及其 追蹤記錄表格中「聯播網要求」子分頁的匯總資料 底部的 效能資訊主頁 Firebase 控制台。
如果「只想」查看自訂網址模式，請在下拉式選單中選取「自訂模式」 選單的「網路要求」子分頁。請注意 網址模式沒有任何匯總資料，因此只會顯示在這份清單中。
資料保留期限的期間 以網址模式匯總的資料結束，Firebase 會刪除這些資料 網址模式依自訂網址模式匯總的所有資料 在此情況下，Firebase 不會將自訂網址模式從 Firebase 控制台。相反地，Firebase 將繼續列出「empty」自訂網址 「聯播網請求」子標籤中「自訂模式」清單中的模式 追蹤記錄資料表。
移除自訂網址模式
你可以從專案中移除自訂網址模式。請注意，您無法 移除自動網址模式
在「成效」資訊主頁中，向下捲動至追蹤記錄表，然後選取「網路要求」子分頁。
在「網路要求」的下拉式選單中，選取「自訂模式」 子分頁。
將滑鼠遊標懸停在要移除的自訂網址模式資料列上。
按一下清單最右側的 資料列，選取「移除自訂模式」，然後在對話方塊中確認移除。
移除自訂網址模式時，請注意下列事項：
任何「未來」要求都會對應至「最明確」的比對結果 自訂網址模式如果 Firebase 找不到相符的自訂網址模式， 就會改回自動網址模式比對。
先前要求的相符和匯總資料不會受到影響 即可移除自訂網址模式
在適用的資料保留期結束前，您仍可在「Network requests」子頁籤 (選取「All network requests」) 中存取已移除的自訂網址模式及其匯總資料。在所有 在已移除的自訂網址模式下匯總資料，Firebase 會到期 就會刪除自訂網址模式
「聯播網請求」子分頁 (已選取「自訂模式」) 不會 列出所有已移除的自訂網址模式。
後續步驟
- 為網路要求降級時設定快訊 應用程式的效能舉例來說，您可以設定 如果特定網址模式的回應時間超過 門檻值
自訂成功率的計算方式
Firebase 會針對各個網路要求監控一項指標 包括要求回覆成功率成功率是指成功回應的百分比 。這項指標有助於評估網路和伺服器 失敗。
具體來說，Firebase 會透過回應自動計算網路要求數量 介於 100 到 399 之間的程式碼，做為成功回應。
您可以計算特定錯誤代碼，藉此自訂成功率的計算方法 「成功回應」以及 Firebase 傳回的回應代碼 就會自動計為成功
舉例來說，如果應用程式有搜尋端點 API，您可以計算 404 個回應 「成功」因為搜尋端點預計會產生 404 回應 假設這個搜尋端點每小時有 100 個樣本，而 60 個 是 200 個回應，其中 40 個是 404 個回應在設定成功率之前，成功率為 60%。設定成功後 計算成功的 404 則回應比率時 100%。
設定成功率計算
如要設定網路網址模式的成功率計算，您必須具備 firebaseperformance.config.update 權限。下列角色
預設加入以下必要權限：
Firebase 效能管理員，
Firebase 品質管理員，
Firebase 管理員，
和專案擁有者或編輯者。
- 前往 Performance Monitoring 資訊主頁 分頁 前往 Firebase 控制台，選取要使用的應用程式 設定成功率計算方式。
- 向下捲動至畫面底部的追蹤記錄表格，然後選取 「網路要求」分頁。
- 找出要設定成功率計算的網址模式。
- 在資料列最右側，開啟溢位選單 ()，然後選取「設定成功率」。
- 按照畫面上的指示選取要使用的回應代碼 可視為成功的回應代碼