Создавайте собственные шаблоны URL

Firebase Performance Monitoring автоматически собирает данные для похожих сетевых запросов, чтобы помочь вам понять тенденции в производительности ваших сетевых запросов.

Для каждого запроса Firebase проверяет, соответствует ли URL-адрес сетевого запроса шаблону URL . Если URL-адрес запроса соответствует шаблону URL-адреса, Firebase автоматически объединяет данные запроса по шаблону URL-адреса.

Вы можете создавать собственные шаблоны URL, чтобы отслеживать определенные шаблоны URL, которые Firebase не фиксирует с помощью производного автоматического сопоставления шаблонов URL . Например, вы можете использовать собственный шаблон URL-адреса для устранения неполадок с определенным URL-адресом или для отслеживания определенного набора URL-адресов с течением времени.

Firebase отображает все шаблоны URL-адресов (включая настраиваемые шаблоны URL-адресов) и их агрегированные данные на подвкладке « Сетевые запросы » таблицы трассировок, которая находится в нижней части панели « Производительность » консоли Firebase.

Как работает сопоставление с шаблоном пользовательского URL?

Firebase пытается сопоставить URL-адреса запросов с любыми настроенными пользовательскими шаблонами URL-адресов, прежде чем вернуться к автоматическому сопоставлению шаблонов URL-адресов. Для любых запросов, соответствующих пользовательскому шаблону URL, Firebase агрегирует данные запросов по пользовательскому шаблону URL.

Если URL-адрес запроса соответствует более чем одному пользовательскому шаблону URL, Firebase сопоставляет запрос только с наиболее конкретным пользовательским шаблоном URL в соответствии со следующим порядком специфичности: обычный текст > * > ** слева направо в пути . Например, запрос к example.com/books/dog соответствует двум пользовательским шаблонам URL:

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

Однако шаблон example.com/books/* является наиболее подходящим шаблоном URL-адреса, поскольку крайний левый сегмент books в example.com/books/* имеет приоритет над крайним левым сегментом * в example.com/*/dog .

При создании нового пользовательского шаблона URL помните о следующем:

  • Совпадения и агрегированные данные из предыдущих запросов не затрагиваются созданием нового пользовательского шаблона URL. Firebase не выполняет повторную агрегацию данных запросов задним числом.

  • Создание нового пользовательского шаблона URL влияет только на будущие запросы. Возможно, вам придется подождать до 12 часов, пока система мониторинга производительности соберет и обобщит данные по новому пользовательскому шаблону URL-адреса.

Создание пользовательского шаблона URL

Вы можете создать пользовательский шаблон URL-адреса на вложенной вкладке « Сетевые запросы » в таблице трассировок, которая находится в нижней части панели « Производительность » консоли Firebase.

Участник проекта должен быть владельцем или редактором , чтобы создать новый пользовательский шаблон URL; однако все участники проекта могут просматривать пользовательские шаблоны URL и их агрегированные данные.

Вы можете создать до 400 настраиваемых шаблонов URL-адресов для каждого приложения и до 100 настраиваемых шаблонов URL-адресов для каждого домена этого приложения.

Чтобы создать собственный шаблон 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 и их данных

Firebase отображает все шаблоны URL-адресов (включая настраиваемые шаблоны URL-адресов) и их агрегированные данные на подвкладке « Сетевые запросы » таблицы трассировок, которая находится в нижней части панели « Производительность » консоли Firebase.

Чтобы просмотреть только настраиваемые шаблоны URL, выберите Пользовательские шаблоны в раскрывающемся меню на вложенной вкладке Сетевые запросы таблицы трассировок. Обратите внимание, что если для пользовательского шаблона URL нет агрегированных данных, он отображается только в этом списке.

Когда срок хранения данных, собранных по шаблону URL, заканчивается, Firebase удаляет эти данные из шаблона URL. Если срок действия всех данных, агрегированных по пользовательскому шаблону URL, истекает, то Firebase не удаляет пользовательский шаблон URL из консоли Firebase. Вместо этого Firebase продолжает перечислять «пустые» настраиваемые шаблоны URL в списке « Пользовательские шаблоны » вложенной вкладки « Сетевые запросы » таблицы трассировки.

Удаление пользовательского шаблона URL

Вы можете удалить пользовательские шаблоны URL из своего проекта. Обратите внимание, что вы не можете удалить автоматический шаблон URL.

  1. На панели мониторинга производительности прокрутите вниз до таблицы трассировок, затем выберите вложенную вкладку Сетевые запросы .

  2. Выберите Пользовательские шаблоны в раскрывающемся меню на вложенной вкладке Сетевые запросы .

  3. Наведите указатель мыши на строку пользовательского шаблона URL, который вы хотите удалить.

  4. Нажмите в крайнем правом углу строки, выберите « Удалить пользовательский шаблон » и подтвердите удаление в диалоговом окне.

При удалении пользовательского шаблона URL помните о следующем:

  • Любые будущие запросы сопоставляются со следующим наиболее подходящим настраиваемым шаблоном URL. Если Firebase не находит подходящих пользовательских шаблонов URL, он возвращается к автоматическому сопоставлению шаблонов URL .

  • Совпадения и агрегированные данные из предыдущих запросов не затрагиваются удалением пользовательского шаблона URL.

    Вы по-прежнему можете получить доступ к удаленному пользовательскому шаблону URL и его агрегированным данным на вложенной вкладке Сетевые запросы (с выбранным параметром Все сетевые запросы ) до окончания соответствующего периода хранения данных. Когда срок действия всех агрегированных данных по удаленному пользовательскому шаблону URL истечет, Firebase удалит этот пользовательский шаблон URL.

  • Вложенная вкладка « Сетевые запросы » (с выбранным параметром « Пользовательские шаблоны ») не содержит списка удаленных пользовательских шаблонов URL.

Следующие шаги

  • Настройте оповещения для сетевых запросов, снижающих производительность вашего приложения. Например, вы можете настроить оповещение по электронной почте для своей команды, если время отклика для определенного шаблона URL превышает установленное вами пороговое значение.