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