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模式。