Catch up on everthing we announced at this year's Firebase Summit. Learn more

創建自定義 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模式。