Используйте предупреждения мониторинга производительности, чтобы уведомлять участников проекта, если изменения кода или сетевые запросы снижают производительность вашего приложения.
Вы можете настроить и настроить оповещения для своего приложения, которые уведомляют вас, когда производительность события превышает установленный порог.
Что вызывает оповещение?
Предупреждение срабатывает, когда метрика для вашего приложения пересекает порог, который вы определяете для указанного процентиля (если применимо) в консоли 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 недоступны для оповещений мониторинга производительности.
Получать оповещения
Получить оповещения по умолчанию
По умолчанию Firebase может отправлять оповещения о мониторинге производительности по электронной почте.
Чтобы получать оповещения мониторинга производительности с помощью этого механизма по умолчанию, у вас должно быть разрешение firebaseperformance.config.update . Следующие роли включают это необходимое разрешение по умолчанию:
- Администратор производительности Firebase
- Администратор качества Firebase
- Администратор Firebase
- Владелец проекта или редактор
Оповещения и их настройки распространяются на весь проект. Это означает, что по умолчанию каждый участник проекта (который не входит в группу электронной почты и имеет необходимые разрешения для получения оповещений) получит электронное письмо при срабатывании оповещения о производительности.
Включить/выключить оповещения для своей учетной записи
Для своей учетной записи вы можете включать/отключать предупреждения мониторинга производительности, не затрагивая других участников проекта. Обратите внимание, что вам по-прежнему нужны необходимые разрешения для получения предупреждений.
Чтобы включить или отключить предупреждения мониторинга производительности, выполните следующие действия.
- В консоли Firebase в правом верхнем углу перейдите к Оповещения Firebase .
- Затем перейдите в раздел » и установите настройки своей учетной записи для предупреждений мониторинга производительности.
Настройте расширенные оповещения для сторонних сервисов
Вы также можете отправлять оповещения о мониторинге производительности на предпочтительный канал уведомлений вашей команды, используя облачные функции для Firebase. Например, вы можете написать функцию, которая фиксирует событие оповещения о медленном запуске приложения и отправляет информацию об оповещении в стороннюю службу, например Discord, Slack или Jira.
Чтобы настроить расширенные возможности оповещения с помощью облачных функций для Firebase, выполните следующие действия:
Настройка Cloud Functions для Firebase , которая включает в себя следующие задачи:
- Настройте среду разработки для Node.js или Python.
- Установите и войдите в Firebase CLI.
- Инициализируйте облачные функции для Firebase с помощью интерфейса командной строки Firebase.
Напишите и разверните функцию , которая перехватывает событие оповещения из мониторинга производительности и обрабатывает полезную нагрузку события (например, публикует информацию о предупреждении в сообщении на Discord).
Чтобы узнать обо всех событиях предупреждений о производительности, которые вы можете зафиксировать, перейдите к справочной документации по предупреждениям мониторинга производительности .
Автоматическое удаление недействительных предупреждений
Мониторинг производительности проверяет оповещения, чтобы убедиться, что данные действительны и что оповещения активно используются. Предупреждения считаются действительными, если выполняется одно из следующих условий:
- Предупреждение создается для идентификатора ресурса, для которого мониторинг производительности получил данные за последние 90 дней.
- Предупреждение было создано недавно для пользовательского шаблона URL. После создания пользовательского шаблона URL и настройки оповещения у вас есть 90 дней на отправку данных для этого шаблона. Если данные не отправляются в течение 90-дневного периода времени, мониторинг производительности удаляет это оповещение. Дополнительные сведения о настраиваемых шаблонах URL-адресов см. в разделе Сводные данные по шаблонам URL-адресов клиентов .
Если какое-либо из этих условий не выполняется, мониторинг производительности удаляет оповещение.
Настроить оповещение
Чтобы настроить оповещения мониторинга производительности, необходимо иметь разрешение firebaseperformance.config.update . Следующие роли включают это необходимое разрешение по умолчанию: Администратор производительности Firebase , Администратор качества Firebase , Администратор Firebase и Владелец или редактор проекта .
Если вы еще этого не сделали, добавьте в свое приложение последнюю версию пакета SDK для мониторинга производительности. Дополнительные сведения см. в руководствах по началу работы для веб-платформ , Android , Apple и Flutter .
В каждом из ваших зарегистрированных приложений используйте таблицу Traces или карточку отчета Dashboard , чтобы настроить оповещение для каждой метрики, которую вы хотите отслеживать. Каждое приложение может иметь свой набор предупреждений, каждое из которых имеет свой порог (или вообще не иметь предупреждений).
Настройте оповещение в таблице Traces
Перейдите на вкладку «Панель мониторинга производительности» в консоли Firebase, а затем выберите приложение, для которого вы хотите настроить оповещение.
Прокрутите вниз до таблицы Traces в нижней части экрана.
Выберите вкладку типа трассировки, для которого вы хотите настроить оповещение, а затем найдите соответствующую строку.
В крайнем правом ряду откройте дополнительное меню ( ) и выберите Настройки предупреждений .
Следуйте инструкциям на экране, чтобы установить порог оповещения и процентиль (если применимо) для приложения или включить/отключить оповещение. Процентили по умолчанию — 90-й для Android и iOS и 75-й для Интернета. Дополнительные сведения о процентилях по умолчанию см. в разделе Отслеживание ключевых показателей на панели инструментов .
Настройте оповещение в карточке отчета Dashboard
Перейдите на вкладку «Панель мониторинга производительности» в консоли Firebase, а затем выберите приложение, для которого вы хотите настроить оповещение.
На вкладке Карточка отчета найдите карточку метрики, для которой вы хотите настроить оповещение.
В нужной карточке метрики откройте Overflow Menu ( ) и выберите Alert settings .
Следуйте инструкциям на экране, чтобы установить порог оповещения и процентиль (если применимо) для приложения или включить/отключить оповещение. Процентили по умолчанию — 90-й для Android и iOS и 75-й для Интернета. Дополнительные сведения о процентилях по умолчанию см. в разделе Отслеживание ключевых показателей на панели инструментов .
Рекомендации по настройке оповещения о производительности
Сетевые запросы
Firebase собирает данные из похожих сетевых запросов по шаблонам URL, которые могут быть одним из следующих:
Пользовательские шаблоны, которые называются пользовательскими шаблонами URL .
Шаблоны, производные от Firebase, которые называются автоматическими шаблонами URL .
Эти шаблоны могут меняться со временем в зависимости от последнего поведения вашего приложения.
Настройте оповещения для ваших пользовательских шаблонов URL
Мы рекомендуем настроить оповещения для любых настраиваемых шаблонов URL-адресов, которые вы настроили. Поскольку Firebase сначала пытается сопоставить запрос с пользовательским шаблоном URL, похожие запросы более последовательно сопоставляются с одним и тем же шаблоном URL. Это делает оповещения для пользовательского шаблона URL более значимыми и эффективными для вашей команды, поскольку вы уже определили этот конкретный шаблон запросов как важный для вашего приложения.
Настройте оповещения для автоматических шаблонов URL
При настройке оповещения для автоматического шаблона URL-адреса убедитесь, что автоматический шаблон URL-адреса стабилизировался в течение нескольких дней. Имейте в виду, что автоматические шаблоны URL-адресов могут меняться со временем, а настройки предупреждений не переносятся на новые шаблоны URL-адресов. Это может привести к некорректным или отсутствующим оповещениям для интересующих вас шаблонов. Вы также можете рассмотреть возможность создания пользовательского шаблона URL, чтобы обеспечить стабильность этого шаблона.
Загрузка веб-страницы
Чтобы узнать рекомендуемые пороговые значения для измерения веб-показателей, см. документацию Core Web Vitals .
Визуализация экрана
Чтобы обеспечить оптимальное взаимодействие с приложением, в пользовательских сеансах не должно быть медленных и зависающих кадров. Мониторинг производительности рекомендует настраивать оповещения для зависших кадров, превышающих 1%, и настраивать оповещения для медленных кадров, превышающих 5%. Вы обнаружите, что эти значения присутствуют в качестве параметров по умолчанию во время настройки предупреждений о производительности. Чтобы узнать больше о чрезмерно медленных или зависших кадрах и других рекомендациях по повышению производительности приложений, см. руководство Google Play .