Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

Для каждого запроса 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 превышает установленное вами пороговое значение.

Настройте способ расчета показателя успешности

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

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

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

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

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

Чтобы настроить расчет вероятности успеха для шаблона URL-адреса сети, у вас должно быть разрешение firebaseperformance.config.update . Следующие роли включают это необходимое разрешение по умолчанию: Администратор производительности Firebase , Администратор качества Firebase , Администратор Firebase и Владелец или редактор проекта .

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