Устранение неполадок и часто задаваемые вопросы о мониторинге производительности

Как посмотреть сообщения в журнале для событий производительности

1. Чтобы включить ведение журнала отладки для Performance Monitoring во время сборки, добавьте элемент <meta-data> в файл AndroidManifest.xml приложения, как показано ниже.

   <application>
       <meta-data
         android:name="firebase_performance_logcat_enabled"
         android:value="true" />
   </application>

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

3. Performance Monitoring помечает сообщения в журнале тегом FirebasePerformance. Используя фильтрацию logcat, вы можете просматривать трассировку продолжительности просмотра и журналы сетевых запросов HTTP/S, выполнив следующую команду:

   adb logcat -s FirebasePerformance

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

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

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

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

SDK добавлен в приложение, но в консоли по-прежнему предлагается добавить SDK

Firebase может определить, успешно ли вы добавили SDK Performance Monitoring в приложение, когда получает от него информацию о событиях (например, о взаимодействиях с приложением). Обычно в течение 10 минут после запуска приложения на панели Производительность в консоли Firebase появляется сообщение "SDK обнаружен". Затем в течение 30 минут на панели управления появятся первые обработанные данные.

Если вы добавили последнюю версию SDK в приложение более 10 минут назад, но по-прежнему не видите изменений, проверьте сообщения в журнале, чтобы убедиться, что Performance Monitoring регистрирует события. Чтобы устранить неполадки, связанные с задержкой сообщения об обнаружении SDK, выполните описанные ниже действия.

В SDK Console указано, что SDK обнаружен, но данные не показываются

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

Если с момента появления сообщения "SDK обнаружен" прошло более 24 часов, а данные по-прежнему не отображаются, проверьте панель мониторинга Firebase. Возможно, произошел сбой. Если сбоев нет, обратитесь в службу поддержки Firebase.

Приложение не регистрирует события производительности

Если вы не видите сообщения в журнале для событий производительности, попробуйте выполнить следующие действия по устранению неполадок:

1. Проверьте настройки плагина Gradle Performance Monitoring:

   1. Убедитесь, что вы правильно добавили плагин. В частности, проверьте следующее:

      • Вы добавили плагин (apply plugin: 'com.google.firebase.firebase-perf') в файл build.gradle модуля (на уровне приложения).
      • Вы добавили зависимость classpath для плагина (classpath 'com.google.firebase:perf-plugin:2.0.2') в файл build.gradle на уровне проекта.

   2. Убедитесь, что плагин не отключен с помощью следующих параметров:

      • instrumentationEnabled в файле build.gradle модуля (на уровне приложения).
      • firebasePerformanceInstrumentationEnabled в файле gradle.properties

2. Убедитесь, что SDK Performance Monitoring не отключен с помощью следующих флагов в файле AndroidManifest.xml:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Убедитесь, что Performance Monitoring не отключается во время выполнения.

4. Если вы не можете найти отключенные функции в приложении, обратитесь в службу поддержки Firebase.

На панели производительности нет данных об отслеживании экранов

Если у вас отсутствуют данные для трассировок отрисовки экрана, попробуйте выполнить следующие действия по устранению неполадок:

1. Убедитесь, что вы используете последнюю версию Android SDK (23.0.1). Трассировки отрисовки экрана доступны только в версии 15.2.0 и более поздних.

2. Убедитесь, что вы не отключили вручную аппаратное ускорение для экрана.

3. Убедитесь, что вы не используете DexGuard или Jack. Performance Monitoring несовместим с этими наборами инструментов.

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

   • Поддержка Jack прекращена, и его не рекомендуется использовать в приложениях.

На панели производительности нет данных о пользовательских трассировках

Вы видите данные об эффективности для автоматически собираемых трассировок, но не для трассировок специального кода? Попробуйте выполнить следующие действия по устранению неполадок:

1. Если вы добавили трассировки пользовательского кода с помощью Trace API, проверьте настройки трассировок, особенно следующие:

   • Названия трассировок пользовательского кода и специальных показателей должны соответствовать следующим требованиям: не содержать пробелов в начале и конце, не начинаться с символа подчеркивания (_) и иметь длину не более 32 символов.
   • Все трассировки должны быть запущены и остановлены. Любое отслеживание, которое не было запущено, не было остановлено или было остановлено до запуска, не будет зарегистрировано.

2. Если вы добавили трассировки пользовательского кода с помощью аннотации @AddTrace, проверьте настройки плагина Performance Monitoring Gradle:

   1. Убедитесь, что вы правильно добавили плагин. В частности, проверьте следующее:

      • Вы добавили плагин (apply plugin: 'com.google.firebase.firebase-perf') в файл build.gradle модуля (на уровне приложения).
      • Вы добавили зависимость classpath для плагина (classpath 'com.google.firebase:perf-plugin:2.0.2') в файл build.gradle на уровне проекта.

   2. Убедитесь, что плагин не отключен с помощью следующих параметров:

      • instrumentationEnabled в файле build.gradle модуля (на уровне приложения).
      • firebasePerformanceInstrumentationEnabled в файле gradle.properties

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

4. Если Performance Monitoring регистрирует события, но данные не появляются в течение 24 часов, обратитесь в службу поддержки Firebase.

На сводке производительности нет данных о сетевых запросах

Если у вас отсутствуют данные о сетевых запросах, попробуйте выполнить следующие действия по устранению неполадок:

1. Для приложений Android плагин Gradle Performance Monitoring позволяет использовать инструменты, которые обеспечивают автоматический мониторинг сетевых запросов HTTP/S. Проверьте, выполняются ли следующие условия:

   1. Убедитесь, что вы правильно добавили плагин. В частности, проверьте следующее:

      • Вы добавили плагин (apply plugin: 'com.google.firebase.firebase-perf') в файл build.gradle модуля (на уровне приложения).
      • Вы добавили зависимость classpath для плагина (classpath 'com.google.firebase:perf-plugin:2.0.2') в файл build.gradle на уровне проекта.

   2. Убедитесь, что плагин не отключен с помощью следующих параметров:

      • instrumentationEnabled в файле build.gradle модуля (на уровне приложения).
      • firebasePerformanceInstrumentationEnabled в файле gradle.properties

2. Проверьте, совместима ли библиотека сети. Performance Monitoring автоматически собирает показатели для сетевых запросов, в которых используются следующие сетевые библиотеки: OkHttp 3.x.x, URLConnection (Java) и Apache HttpClient.

   Обратите внимание, что вы можете добавить специальный мониторинг сетевых запросов.

3. Обратите внимание:

   • В зависимости от поведения вашего кода и используемых им сетевых библиотек Performance Monitoring может сообщать только о завершенных сетевых запросах. Это означает, что HTTP/S-подключения, оставленные открытыми, могут не регистрироваться.

   • Performance Monitoring несовместим с DexGuard и Jack.

     • DexGuard отключает мониторинг сетевых запросов HTTP/S.
     • Компилятор Jack больше не поддерживается, и его не рекомендуется использовать в приложениях.

   • Performance Monitoring не сообщает о сетевых запросах с недопустимыми заголовками Content-Type. Однако сетевые запросы без заголовков Content-Type по-прежнему будут приниматься.

Данные о сетевых запросах не агрегируются должным образом

Подробнее о том, как Performance Monitoring агрегирует данные о сетевых запросах по шаблонам URL…

Вы также можете попробовать собственные шаблоны URL.

Что случилось с разделом "Основные проблемы" на карточке "Эффективность" на главной странице проекта?

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

Меню выбора приложений в верхней части карточки "Эффективность" позволяет отфильтровать записи в разделе Недавние оповещения. Показываются только три последних оповещения для выбранных приложений.

Подробнее об оповещениях о проблемах производительности…

Почему в консоли больше нельзя задавать пороговые значения для проблем?

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

Что случилось с информацией в разделах Details (Сведения) и Metrics (Показатели) в консоли Firebase?

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

Почему количество образцов не соответствует моим ожиданиям?

Performance Monitoring собирает данные об эффективности с устройств пользователей вашего приложения. Если у вашего приложения много пользователей или оно генерирует большой объем данных о производительности, Performance Monitoring может ограничить сбор данных подмножеством устройств, чтобы уменьшить количество обрабатываемых событий. Эти ограничения достаточно высоки, чтобы даже при меньшем количестве событий значения показателей по-прежнему отражали удобство использования приложения.

Чтобы управлять объемом собираемых данных, в Performance Monitoring используются следующие варианты выборки:

• Ограничение частоты запросов на устройстве. Чтобы предотвратить внезапные всплески трассировок, мы ограничиваем количество трассировок кода и сетевых запросов, отправляемых с устройства, до 300 событий каждые 10 минут. Это позволяет защитить устройство от зацикленных инструментов, которые могут отправлять большие объемы данных об эффективности, и предотвращает искажение измерений эффективности одним устройством.

• Динамическая выборка. Performance Monitoring ежедневно собирает ограниченное количество трассировок кода и сетевых запросов для каждого приложения по всем его пользователям. Динамическая частота дискретизации извлекается на устройствах (с помощью Firebase Remote Config), чтобы определить, должно ли случайное устройство собирать и отправлять трассировки. Устройство, не выбранное для выборки, не отправляет события. Динамическая частота дискретизации зависит от приложения и корректируется так, чтобы общий объем собранных данных не превышал лимит.

  В проектах, в которых включена интеграция с BigQuery, лимит на количество трассировок сетевых запросов выше.

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

• Ограничение частоты запросов на стороне сервера. Чтобы приложения не превышали лимит выборки, Performance Monitoring может использовать выборку на стороне сервера для удаления некоторых событий, полученных от устройств. Хотя это не влияет на эффективность наших показателей, могут наблюдаться незначительные изменения в закономерностях, в том числе следующие:

  • Количество трассировок может отличаться от количества выполнений фрагмента кода.
  • Трассировки, тесно связанные в коде, могут иметь разное количество выборок.

Что случилось с вкладкой Проблемы в консоли?

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

Что случилось с вкладками На устройстве и Сеть в консоли? Как посмотреть трассировки, которые были на этих страницах?

Мы изменили дизайн раздела Performance Monitoring в консоли Firebase, чтобы на вкладке Панель управления показывались ключевые показатели и все трассировки. В рамках редизайна мы удалили страницы На устройстве и Сеть.

Таблица трассировок в нижней части вкладки Панель управления содержит ту же информацию, что и вкладки На устройстве и Сеть, но с некоторыми дополнительными функциями, включая возможность сортировки трассировок по процентному изменению определенного показателя. Чтобы посмотреть все показатели и данные для определенной трассировки, нажмите на ее название в таблице.

Просматривать трассировки можно на следующих вкладках таблицы:

• Трассировки сетевых запросов (как стандартные, так и специальные) – вложенная вкладка Сетевые запросы.
• Трассировки пользовательского кода – вложенная вкладка Пользовательские трассировки.
• Трассировки запуска приложения, а также его работы в активном и фоновом режимах – на вложенной вкладке Специальные трассировки.
• Трассировки отрисовки экрана – вложенная вкладка Отрисовка экрана.
• Трассировки загрузки страниц – вложенная вкладка Загрузка страницы

Подробные сведения о таблице трассировок, а также о просмотре показателей и данных можно найти на обзорной странице консоли (iOS+ | Android | Web).

Почему количество медленных и зависших кадров не соответствует моим ожиданиям?

При расчете медленной отрисовки и зависания кадров предполагается, что частота обновления экрана устройства составляет 60 Гц. Если частота обновления устройства ниже 60 Гц, время отрисовки каждого кадра будет больше, поскольку в секунду отрисовывается меньше кадров. Чем больше времени уходит на отрисовку, тем больше медленных или зависших кадров будет зарегистрировано. Однако если частота обновления устройства выше 60 Гц, время отрисовки каждого кадра будет меньше. Это может привести к тому, что в отчетах будет меньше медленных или зависших кадров. Это текущее ограничение в SDK Performance Monitoring.

Почему я не вижу трассировки фрагментов?

Чтобы просматривать данные об эффективности фрагментов в дополнение к данным о действиях в приложении, убедитесь, что в вашем приложении используется Performance Monitoring Android SDK версии 20.1.0 или более поздней. Подробнее о том, как добавить Performance Monitoring в приложение…

Как понять, какие трассировки связаны с фрагментами и действиями?

Каждый фрагмент и трассировка действий основаны на имени класса, определенном в вашем приложении. Каждая трассировка экрана содержит префикс st, за которым следует название класса. В консоли Firebase префикс удаляется. Подробнее о данных об эффективности отрисовки экрана (приложения для Apple и Android) …

Почему я вижу меньше трассировок фрагментов, чем других трассировок?

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

Как я узнаю, что у моего приложения есть проблемы с производительностью рендеринга?

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

После включения плагина Gradle Performance Monitoring сборка стала занимать много времени. Как это исправить?

Performance Monitoring для Android использует инструментирование байт-кода, чтобы предоставлять некоторые готовые функции, такие как мониторинг сетевых запросов HTTP/S. В процессе компиляции плагин проходит по всем классам приложения (включая зависимости), чтобы добавить в код инструменты, необходимые для измерения производительности сетевых запросов.

Вот некоторые ключевые факторы, способствующие увеличению времени сборки:

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

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

Начиная с версии 1.3.3 плагина Performance Monitoring, мы сосредоточились на значительном улучшении обработки инкрементной сборки и кэширования входных данных библиотеки. Чтобы сборка выполнялась быстрее, используйте последнюю версию плагина (2.0.2).

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

Что делать, если при сборке возникают ошибки из-за несовместимости библиотек с плагином Gradle Performance Monitoring?

Performance Monitoring для Android использует инструментирование байт-кода, чтобы предоставлять некоторые готовые функции, например мониторинг сетевых запросов HTTP/S. В процессе компиляции плагин проходит по всем классам приложения (включая зависимости), чтобы добавить в код инструменты, необходимые для измерения производительности сетевых запросов.

Если после интеграции с плагином Performance Monitoring вы получаете ошибки сборки, например JSR/RET are not supported with computeFrames option, это может быть связано с тем, что у вас также есть зависимость от библиотеки, несовместимой с плагином Gradle Performance Monitoring.

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

1. Обновите плагин Gradle Performance Monitoring до последней версии (не ниже 1.4.0).
2. Обновите плагин Android Gradle до версии 7.2.0 или более поздней.
3. Добавьте в файл build.gradle на уровне модуля (приложения) следующий флаг, чтобы исключить несовместимые классы и библиотеки из инструментирования:

   android {
     // ...
     androidComponents {
       onVariants(selector().all(), {
           instrumentation.excludes.add("example.incompatible.library")
       })
     }
   }

   Чтобы узнать больше о свойстве exclude API Instrumentation плагина Android Gradle, прочитайте статью Инструментирование.

Если вы столкнетесь с ошибками сборки из-за несовместимых библиотек, сообщите об этом на GitHub, чтобы мы могли исключить их из инструментария плагина Performance Monitoring.

Экспорт данных Performance Monitoring в BigQuery занимает больше времени, чем ожидалось. Они не обновляются в реальном времени?

Если вы включили интеграцию BigQuery для ресурса "Firebase Performance Monitoring", ваши данные будут экспортироваться в BigQuery через 12–24 часа после окончания дня (по тихоокеанскому времени).

Например, данные за 19 апреля будут доступны в BigQuery 20 апреля в период с 12:00 до 24:00 (все даты и время указаны по тихоокеанскому времени).

Сколько шаблонов URL можно создать?

Для одного приложения можно создать до 400 шаблонов собственных URL, а для одного домена в приложении – до 100.

Что означает "данные об эффективности практически в реальном времени"?

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

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

Как получать данные об эффективности приложения практически в реальном времени?

Чтобы воспользоваться преимуществами обработки данных почти в реальном времени, вам нужно лишь убедиться, что в вашем приложении используется версия SDK Performance Monitoring, совместимая с обработкой данных в реальном времени.

Ниже перечислены версии SDK, совместимые с передачей данных в реальном времени.

• iOS – 7.3.0 или более поздней версии.
• tvOS – 8.9.0 или более поздняя версия.
• Android – 19.0.10 или более поздняя (или Firebase Android BoM 26.1.0 или более поздняя).
• Web – 7.14.0 или более поздней версии.

Мы всегда рекомендуем использовать последнюю версию SDK, но любая из перечисленных выше версий позволит Performance Monitoring обрабатывать ваши данные практически в реальном времени.

Какие версии SDK Performance Monitoring совместимы с передачей данных в реальном времени?

Ниже перечислены версии SDK, совместимые с обработкой данных в реальном времени.

• iOS – 7.3.0 или более поздней версии.
• tvOS – 8.9.0 или более поздняя версия.
• Android – 19.0.10 или более поздняя (или Firebase Android BoM 26.1.0 или более поздняя).
• Web – 7.14.0 или более поздней версии.

Мы всегда рекомендуем использовать последнюю версию SDK, но любая из перечисленных выше версий позволит Performance Monitoring обрабатывать ваши данные практически в реальном времени.

Что произойдет, если я не обновлю приложение, чтобы использовать версию SDK, совместимую с функцией обновления в реальном времени?

Если в вашем приложении не используется версия SDK, совместимая с режимом реального времени, вы по-прежнему будете видеть все данные об эффективности приложения в консоли Firebase. Однако данные об эффективности будут появляться в отчетах примерно через 36 часов после сбора.

Я обновил SDK до версии, совместимой с отслеживанием в реальном времени, но некоторые пользователи все ещё работают со старыми версиями моего приложения. Будут ли данные об их эффективности по-прежнему отображаться в консоли Firebase?

Да! Независимо от того, какую версию SDK использует экземпляр приложения, вы увидите данные об эффективности от всех пользователей.

Однако если вы смотрите недавние данные (примерно за последние 36 часов), то они получены от пользователей экземпляров приложения, в которых используется версия SDK, совместимая с режимом реального времени. Однако более старые данные об эффективности включают информацию обо всех версиях приложения.

Почему я не вижу данные об эффективности в реальном времени?

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

• iOS – 7.3.0 или более поздней версии.
• tvOS – 8.9.0 или более поздняя версия.
• Android – 19.0.10 или более поздняя (или Firebase Android BoM 26.1.0 или более поздняя).
• Web – 7.14.0 или более поздней версии.

Мы всегда рекомендуем использовать последнюю версию SDK, но любая из перечисленных выше версий позволит Performance Monitoring обрабатывать ваши данные практически в реальном времени.