Начало работы с Мониторингом производительности для Flutter

В этом кратком руководстве рассказывается, как настроить Firebase Performance Monitoring, чтобы получать статистику об эффективности приложений Flutter.

Подготовка

Если вы ещё этого не сделали, настройте и инициализируйте Firebase в проекте Flutter.

Шаг 1. Добавьте Performance Monitoring в приложение

  1. Чтобы установить плагин Performance Monitoring Flutter, выполните следующую команду в корневом каталоге проекта Flutter:

    flutter pub add firebase_performance

  2. В корневом каталоге проекта Flutter выполните следующую команду:

    flutterfire configure

    Эта команда позволяет убедиться, что конфигурация Firebase в приложении Flutter актуальна, и добавляет в приложение для Android необходимый плагин Gradle для Мониторинга производительности.

  3. После этого пересоберите проект Flutter:

    flutter run

После добавления SDK Performance Monitoring Firebase автоматически начинает собирать данные, связанные с жизненным циклом приложения (например, время начала работы приложения), и данные о сетевых запросах HTTP/S.

Во Flutter автоматическое отслеживание производительности отрисовки экранов невозможно для отдельных экранов Flutter. Один контроллер представления инкапсулирует все приложение Flutter, поэтому Firebase SDK не распознает переходы между экранами.

Шаг 2. Сгенерируйте события производительности для первоначального отображения данных

Firebase начнет обрабатывать события, когда вы добавите SDK в приложение. Если вы все ещё разрабатываете приложение локально, взаимодействуйте с ним, чтобы генерировать события для первоначального сбора и обработки данных.

  1. Продолжайте разрабатывать приложение, используя симулятор или тестовое устройство.

  2. Сгенерируйте события, несколько раз переключив приложение между фоновым и активным режимами, взаимодействуя с приложением, перемещаясь по экранам и/или запуская сетевые запросы.

  3. Перейдите на панель Производительность в консоли Firebase. Первые данные должны появиться в течение нескольких минут.

    Если вы не видите исходные данные, ознакомьтесь с советами по устранению неполадок.

Шаг 3. (Необязательно.) Просмотрите сообщения в журнале о событиях производительности

  1. Проверьте сообщения в журнале на наличие сообщений об ошибках.

    Мониторинг производительности помечает сообщения в журнале следующими тегами, чтобы вы могли фильтровать сообщения в журнале:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Проверьте, есть ли в журналах следующие типы записей, которые указывают на то, что Performance Monitoring регистрирует события производительности:

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. Нажмите на URL, чтобы посмотреть данные в консоли Firebase. Обновление данных на панели управления может занять несколько минут.

Шаг 4. (Необязательно.) Добавьте специальный мониторинг для определенного кода

Чтобы отслеживать данные о производительности, связанные с определенным кодом в приложении, вы можете использовать трассировку пользовательского кода.

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

В коде вы определяете начало и конец трассировки пользовательского кода (и добавляете любые нужные пользовательские показатели), используя API, предоставляемый SDK Performance Monitoring.

Чтобы узнать больше об этих функциях и о том, как добавить их в приложение, прочитайте статью Как добавить мониторинг для определенного кода.

Шаг 5. Разверните приложение и проверьте результаты

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

Данные об эффективности можно отслеживать на панели Performance (Эффективность) в консоли Firebase.

Дальнейшие действия