Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

創建自定義 URL 模式

Firebase 性能監控會自動匯總類似網絡請求的數據,以幫助您了解網絡請求性能的趨勢。

對於每個請求,火力地堡檢查所述網絡請求的URL匹配一個URL模式。如果請求 URL 與 URL 模式匹配,Firebase 會自動在 URL 模式下聚合請求的數據。

您可以創建自定義URL模式監視特定的URL模式,火力地堡沒有與它的派生捕捉自動URL模式匹配。例如,您可以使用自定義 URL 模式對特定 URL 進行故障排除或隨時間監控一組特定 URL。

火力地堡顯示所有的URL模式(包括自定義URL模式)及其匯總的數據在網絡請求的痕跡表,這是在底部的子選項卡性能儀表板的火力地堡控制台。

自定義 URL 模式匹配如何工作?

Firebase 嘗試將請求 URL 與任何配置的自定義 URL 模式匹配,然後再返回到自動 URL 模式匹配。對於自定義 URL 模式的任何匹配請求,Firebase 會在自定義 URL 模式下聚合請求的數據。

如果請求的URL多個自定義URL模式匹配,火力地堡將請求映射到唯一的最具體的自定義URL模式,按照以下順序特異性:純文本> * > **從左至右路徑。例如,要請求example.com/books/dog匹配了兩個自定義URL模式:

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

然而圖案example.com/books/*最具體的匹配URL模式,因為最左邊的部分booksexample.com/books/*優先於最左邊的部分*example.com/*/dog

創建新的自定義 URL 模式時,請注意以下事項:

  • 比賽和以前的請求匯總數據不受創建新的自定義URL模式。 Firebase 不會追溯重新聚合請求數據。

  • 只有將來的請求通過創建一個新的自定義URL模式的影響。您可能需要等待長達 12 小時,性能監控才能在新的自定義 URL 模式下收集和聚合數據。

創建自定義 URL 模式

網絡中的痕跡表,這是在底部請求子選項卡,您可以創建一個自定義URL模式性能儀表板的火力地堡控制台。

項目成員必須是所有者或編輯,以創建新的自定義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 模式及其數據

火力地堡顯示所有的URL模式(包括自定義URL模式)及其匯總的數據在網絡請求的痕跡表,這是在底部的子選項卡性能儀表板的火力地堡控制台。

查看自定義URL模式,從下拉菜單中選擇自定義模式網絡請求的痕跡表的子選項卡。請注意,如果自定義 URL 模式沒有任何聚合數據,則它只會出現在此列表中。

數據保存期為一個URL模式下聚合的數據端,火力地堡刪除從URL模式的數據。如果下一個自定義URL模式到期的所有匯總數據,然後火力地堡不會刪除從火力地堡控制台自定義URL模式。相反,火力地堡繼續列表“空”自定義URL模式在網絡自定義模式列表請求的痕跡表的子選項卡。

刪除自定義 URL 模式

您可以從項目中刪除自定義 URL 模式。請注意,您無法刪除自動 URL 模式。

  1. 性能儀表盤,向下滾動到的痕跡表,然後選擇網絡請求子選項卡。

  2. 網絡下拉菜單中選擇自定義模式要求子選項卡。

  3. 將鼠標懸停在要刪除的自定義 URL 格式所在的行上。

  4. 點擊在最右邊的行,選擇刪除自定義模式,然後確認對話框中刪除。

刪除自定義 URL 模式時,請注意以下事項:

  • 今後的任何請求都被映射到下一個最具體的匹配定制URL模式。如果火力地堡沒有發現匹配的自定義URL模式,那麼它回落到自動URL模式匹配

  • 比賽和以前的請求匯總數據不受刪除自定義URL模式。

    您仍然可以訪問已刪除的自定義URL模式和網絡的聚合數據請求子選項卡(與選定的所有網絡請求),直到適用的數據保留期結束。當移除的自定義網址格式下的所有匯總數據都過期時,Firebase 會刪除自定義網址格式。

  • (選擇使用自定義模式)的網絡請求子選項卡沒有列出任何刪除自定義URL模式。