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

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

1. Включите журнал отладки, выполнив следующие действия:

   1. В Xcode (версии 26.2 или более поздней) выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).
   2. В меню слева нажмите Run (Выполнить) и перейдите на вкладку Arguments (Аргументы).
   3. В разделе Arguments Passed on Launch (Аргументы, передаваемые при запуске) добавьте -FIRDebugEnabled.

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

3. Performance Monitoring помечает сообщения в журнале тегом Firebase/Performance, чтобы вы могли их фильтровать.

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. Убедитесь, что SDK Performance Monitoring не отключен с помощью следующих флагов в файле Info.plist:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Убедитесь, что Performance Monitoring не отключен во время выполнения (Swift | Obj-C).

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

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

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

1. Убедитесь, что вы используете последнюю версию SDK для платформ Apple (13.0.0). Трассировки отрисовки экрана доступны только в версии 5.0.0 и более поздних.

2. Performance Monitoring не создает трассировки отрисовки экрана для контроллеров представления контейнера (таких как UINavigationController и UITabBarController). Если данные отсутствуют только для этих экранов, то это ожидаемое поведение.

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

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

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

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

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

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

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

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

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

   • Для Swift: URLSession и URLConnection.
   • Для Objective-C: NSURLSession и NSURLConnection.

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

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

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

   • 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 в 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 обрабатывать ваши данные практически в реальном времени.