Эта страница переведена с помощью Cloud Translation API.

Настройте агрегирование данных сетевых запросов

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

Иногда, однако, вам необходимо настроить способ агрегирования данных сетевых запросов Firebase, чтобы лучше соответствовать сценариям использования вашего приложения. Мы предлагаем два способа настройки агрегирования данных для сетевых запросов: агрегирование данных по пользовательским шаблонам URL и настройка способа расчета коэффициента успешности .

Агрегирование данных по пользовательским шаблонам URL-адресов

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

Вы можете создавать пользовательские шаблоны 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-адреса повлияет только на будущие запросы. Для сбора и агрегирования данных по новому пользовательскому шаблону URL-адреса с помощью Performance Monitoring может потребоваться до 12 часов.

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

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

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

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

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

На панели мониторинга производительности прокрутите вниз до таблицы трассировок, затем выберите подвкладку «Сетевые запросы» .
В подвкладке «Сетевые запросы» выберите «Пользовательские шаблоны» из выпадающего меню.
Наведите курсор на строку пользовательского шаблона URL, которую хотите удалить.
Щелкните в крайнем правом углу строки, выберите «Удалить пользовательский шаблон» , а затем подтвердите удаление в диалоговом окне.

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

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

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

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

Настройте способ расчета процента успешных результатов.

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

В частности, Firebase автоматически считает сетевые запросы с кодом ответа в диапазоне от 100 до 399 успешными.

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

Например, если ваше приложение использует API для поиска, вы можете считать ответы с кодом 404 «успешными», поскольку такие ответы ожидаются для данного API. Предположим, что каждый час поступает 100 запросов к этому API, 60 из них — с кодом 200, а 40 — с кодом 404. До настройки коэффициента успешности он составлял 60%. После настройки расчета коэффициента успешности таким образом, чтобы ответы с кодом 404 считались успешными, коэффициент успешности составит 100%.

Настройка расчета вероятности успеха

Для настройки расчета вероятности успешного выполнения для шаблона сетевого URL-адреса необходимо иметь разрешение firebaseperformance.config.update . Следующие роли по умолчанию обладают этим необходимым разрешением: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin , а также Project Owner или Editor .

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