Используйте оповещения Performance Monitoring , чтобы уведомить участников проекта о том, что изменения кода или сетевые запросы ухудшают производительность вашего приложения.
Вы можете настроить и настроить оповещения для своего приложения, которые будут уведомлять вас, когда эффективность события превысит установленный порог.
Что вызывает срабатывание оповещения?
Оповещение срабатывает, когда метрика вашего приложения пересекает порог, который вы определяете для указанного процентиля (если применимо) в консоли Firebase . Оповещения срабатывают только в том случае, если ваше приложение использует версию SDK, совместимую с реальным временем .
время запуска приложения
При настройке оповещения о времени запуска приложения оповещение срабатывает, если выполняются все следующие условия:
- Firebase записал не менее
100 образцов трассировки_app_start
для последней версии вашего приложения за последний час. - Длительность трассировки
_app_start
превысила заданное пороговое значение приложения за последний час и для настроенного процентиля. - Ранее в последней версии вашего приложения оповещения о таком же пороговом значении не выдавались.
пользовательские трассировки кода
При настройке оповещения для пользовательской метрики трассировки кода оповещение срабатывает, если выполняются все следующие условия:
- Firebase записал не менее
100 образцов трассировки пользовательского кода для последней версии вашего приложения за последний час. - Длительность трассировки превысила заданный приложением порог в течение последнего часа и для настроенного процентиля.
- (Только для iOS+ и Android) Ранее в последней версии вашего приложения не было предупреждений о том же пороговом значении.
- (Только для веб-сайта) За последние
3 дня оповещения о достижении того же порогового значения не выдавались.
сетевые запросы
При настройке оповещения для метрики сетевого запроса оповещение срабатывает, если выполняются все следующие условия:
- За последний час Firebase зафиксировал не менее
100 образцов , соответствующих шаблону URL во всех версиях вашего приложения. - Агрегированное значение метрики превысило заданный порог за последний час:
- время отклика : агрегированное значение превысило установленный порог для настроенного процентиля
- показатель успешности : (только для iOS+/Android) совокупное значение опустилось ниже установленного порогового значения среди всех пользователей
- За последние
3 дня предупреждений о превышении этого порогового значения не поступало.
рендеринг экрана
При настройке оповещения для метрики рендеринга экрана оповещение срабатывает, если выполняются все следующие условия:
- Firebase записал не менее
100 образцов рендеринга экрана для последней версии вашего приложения за последний час. - Агрегированное значение метрики превысило заданный порог за последний час:
- замороженные кадры : агрегированное значение превысило установленный порог
- медленные кадры : агрегированное значение превысило установленный порог
- Ранее в последней версии вашего приложения оповещения о таком же пороговом значении не выдавались.
загрузка страницы
При настройке оповещения для метрики загрузки страницы оповещение срабатывает, если выполняются все следующие условия:
- Firebase зафиксировал не менее
100 образцов загрузки страницы вашего приложения за последний час. - Агрегированное значение метрики превысило заданный порог в течение последнего часа и для настроенного процентиля:
- первая задержка ввода : агрегированное значение превысило установленный порог и настроенный процентиль
- первая содержательная отрисовка : агрегированное значение превысило установленный порог и настроенный процентиль
- первая краска : агрегированное значение превысило установленный порог и настроенный процентиль
- За последние
3 дня предупреждений о превышении этого порогового значения не поступало.
Узнайте больше о настройке оповещений , процентилях по умолчанию и передовых методах настройки оповещений для определенных типов трассировок и показателей.
Оповещения для других показателей производительности или для встроенных интеграций Firebase со Slack , Jira и PagerDuty недоступны для оповещений Performance Monitoring .
Получать оповещения
Получать оповещения по умолчанию
По умолчанию Firebase может отправлять оповещения Performance Monitoring по электронной почте.
Чтобы получать оповещения Performance Monitoring через этот механизм по умолчанию, у вас должно быть разрешение firebaseperformance.config.update
. Следующие роли включают это требуемое разрешение по умолчанию:
- Администратор производительности Firebase
- Администратор качества Firebase
- Администратор Firebase
- Владелец проекта или редактор
Оповещения и их настройки действуют на весь проект. Это означает, что по умолчанию каждый участник проекта получит электронное письмо при срабатывании оповещения о производительности. Оповещения отправляются только участникам проекта с необходимыми разрешениями на получение оповещений и на отдельные адреса электронной почты (а не на группы учетных записей, такие как группы Google или учетные записи Google Workspace).
Включить/выключить оповещения для вашей учетной записи
Для своей учетной записи вы можете включить/выключить оповещения Performance Monitoring не влияя на других участников проекта. Обратите внимание, что вам по-прежнему нужны требуемые разрешения для получения оповещений.
Чтобы включить или отключить оповещения Performance Monitoring , выполните следующие действия:
- В консоли Firebase в правом верхнем углу перейдите в
- Затем перейдите к
Performance Monitoring . Настройки и настройте параметры учетной записи для оповещений
Настройте расширенные оповещения для сторонних служб
Вы также можете отправлять оповещения Performance Monitoring на предпочтительный канал уведомлений вашей команды, используя Cloud Functions for Firebase . Например, вы можете написать функцию, которая фиксирует событие оповещения о медленном запуске приложения и публикует информацию об оповещении в стороннем сервисе, например Discord, Slack или Jira.
Чтобы настроить расширенные возможности оповещения с помощью Cloud Functions for Firebase , выполните следующие действия:
Настройка облачных функций для Firebase , которая включает в себя следующие задачи:
- Настройте среду разработки для Node.js или Python.
- Установите и войдите в Firebase CLI.
- Инициализируйте Cloud Functions for Firebase с помощью Firebase CLI.
Напишите и разверните функцию , которая фиксирует событие оповещения из Performance Monitoring и обрабатывает полезную нагрузку события (например, публикует информацию оповещения в сообщении в Discord).
Чтобы узнать обо всех событиях оповещений о производительности, которые вы можете отслеживать, перейдите к справочной документации по оповещениям мониторинга производительности .
Автоматическое удаление недействительных оповещений
Performance Monitoring проверяет оповещения, чтобы гарантировать, что данные действительны и что оповещения активно используются. Оповещения считаются действительными, если выполняется одно из следующих условий:
- Оповещение создается для идентификатора ресурса, для которого Performance Monitoring получил данные за последние 90 дней.
- Оповещение было создано недавно для пользовательского шаблона URL. После создания пользовательского шаблона URL и настройки оповещения у вас есть 90 дней на отправку данных для этого шаблона. Если в течение 90-дневного периода данные не отправляются, Performance Monitoring удаляет это оповещение. Для получения дополнительной информации о пользовательских шаблонах URL см. раздел Агрегированные данные в разделе Шаблоны URL клиентов .
Если хотя бы одно из этих условий не выполняется, Performance Monitoring удаляет оповещение.
Настроить оповещение
Для настройки оповещений Performance Monitoring необходимо иметь разрешение firebaseperformance.config.update
. Следующие роли включают это требуемое разрешение по умолчанию: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin и project Owner или Editor .
Если вы еще этого не сделали, добавьте в свое приложение последнюю версию Performance Monitoring SDK. Для получения дополнительной информации см. руководства по началу работы для платформ Web , Android , Apple и Flutter .
В каждом из зарегистрированных приложений используйте таблицу Traces или отчетную карточку Dashboard , чтобы настроить оповещение для каждой метрики, которую вы хотите отслеживать. Каждое приложение может иметь разный набор оповещений, каждое с разным порогом (или вообще не иметь оповещений).
Настройте оповещение в таблице трассировок
Перейдите на вкладку «Панель Performance Monitoring » в консоли Firebase , а затем выберите приложение, для которого вы хотите настроить оповещение.
Прокрутите страницу вниз до таблицы «Трассы» в нижней части экрана.
Выберите вкладку типа трассировки, для которого вы хотите установить оповещение, а затем найдите соответствующую строку.
В правом углу строки откройте меню переполнения (
) и выберите Настройки оповещений .Следуйте инструкциям на экране, чтобы задать порог оповещения и процентиль (если применимо) для приложения или включить/выключить оповещение. Процентили по умолчанию — 90-й для Android и iOS и 75-й для Web. Чтобы узнать больше о процентилях по умолчанию, см . Отслеживание ключевых показателей на панели мониторинга .
Настройте оповещение в карточке отчета панели мониторинга
Перейдите на вкладку «Панель Performance Monitoring » в консоли Firebase , а затем выберите приложение, для которого вы хотите настроить оповещение.
На вкладке «Карточка отчета» найдите карточку показателя, для которой вы хотите настроить оповещение.
В нужной карточке метрики откройте меню переполнения (
) и выберите Настройки оповещений .Следуйте инструкциям на экране, чтобы задать порог оповещения и процентиль (если применимо) для приложения или включить/выключить оповещение. Процентили по умолчанию — 90-й для Android и iOS и 75-й для Web. Чтобы узнать больше о процентилях по умолчанию, см . Отслеживание ключевых показателей на панели мониторинга .
Лучшие практики по настройке оповещений о производительности
Сетевые запросы
Firebase объединяет данные из похожих сетевых запросов по шаблонам URL, которые могут быть одним из следующих:
Пользовательские шаблоны, которые называются пользовательскими шаблонами URL .
Шаблоны, полученные из Firebase, которые называются автоматическими шаблонами URL .
Эти закономерности могут со временем меняться в зависимости от последних данных об использовании вашего приложения.
Настройте оповещения для ваших пользовательских шаблонов URL
Мы рекомендуем настроить оповещения для любых настроенных вами шаблонов пользовательских URL. Поскольку Firebase сначала пытается сопоставить запрос с шаблоном пользовательских URL, похожие запросы более последовательно сопоставляются с тем же шаблоном URL. Это делает оповещения для шаблона пользовательских URL более значимыми и эффективными для вашей команды, поскольку вы уже определили этот конкретный шаблон запросов как важный для вашего приложения.
Настройте оповещения для автоматических шаблонов URL
При настройке оповещения для автоматического шаблона URL убедитесь, что автоматический шаблон URL стабилизировался в течение нескольких дней. Помните, что автоматические шаблоны URL могут со временем меняться, а конфигурации оповещений не переносятся на новые шаблоны URL. Это может привести к неверным или отсутствующим оповещениям для интересующих вас шаблонов. Вы также можете рассмотреть возможность создания пользовательского шаблона URL, чтобы гарантировать стабильность этого шаблона.
Загрузка веб-страницы
Чтобы узнать рекомендуемые пороговые значения для измерения веб-показателей, см. документацию Core Web Vitals .
Рендеринг экрана
Для обеспечения оптимального опыта работы приложения сеансы пользователей не должны содержать медленных и замороженных кадров. Performance Monitoring рекомендует настроить оповещения для замороженных кадров, превышающих 1%, и настроить оповещения для медленных кадров, превышающих 5%. Вы обнаружите, что эти значения присутствуют в качестве настроек по умолчанию во время настройки оповещений о производительности. Чтобы узнать больше о чрезмерно медленных или замороженных кадрах и других рекомендациях по производительности приложений, см. руководство Google Play .