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

iOS+ Android Интернет

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

Первые проверки для устранения неполадок

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

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

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

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

1. Включите ведение журнала отладки следующим образом:

   1. В Xcode (минимум v13.3.1) выберите Product > Scheme > Edit Scheme.
   2. Выберите « Выполнить» в меню слева, затем перейдите на вкладку « Аргументы ».
   3. В разделе « Аргументы , передаваемые при запуске» добавьте -FIRDebugEnabled .

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

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

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

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

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

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

2. Проверьте панель состояния Firebase.

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

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

Если вы только начинаете работу с мониторингом производительности ( iOS+ | Android | Web ), следующие советы по устранению неполадок помогут решить проблемы, связанные с обнаружением Firebase SDK или отображением ваших первых данных о производительности в консоли Firebase.

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

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

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

Приложение регистрирует события: действия по устранению неполадок

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

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

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

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

2. Убедитесь, что ваш файл конфигурации Firebase ( Google-Service-Info.plist ) правильно добавлен в ваше приложение и что вы не изменили этот файл. В частности, проверьте следующее:

   • К имени файла конфигурации не добавляются дополнительные символы, например (2) .

   • Файл конфигурации находится в корне вашего проекта XCode и добавлен к правильным целям.

   • Идентификатор приложения Firebase Apple ( GOOGLE_APP_ID ), указанный в файле конфигурации, верен для вашего приложения. Найдите свой идентификатор приложения Firebase на карточке « Ваши приложения » в настройках « проекта» .

   Если что-то не так с файлом конфигурации в вашем приложении, попробуйте следующее:

   1. Удалите файл конфигурации, который у вас есть в вашем приложении.

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

3. Если SDK регистрирует события и кажется, что все настроено правильно, но вы по-прежнему не видите сообщение об обнаружении SDK или обработанные данные (через 2 часа), обратитесь в службу поддержки Firebase .

Приложение не регистрирует события: действия по устранению неполадок

1. Убедитесь, что SDK мониторинга производительности не отключен ни одним из следующих флагов в файле Info.plist :

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

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

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

Консоль говорит, что SDK обнаружен, но данные не отображаются

Мониторинг производительности обрабатывает данные о событиях производительности перед их отображением на панели мониторинга производительности .

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

Общее устранение неполадок

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

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

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

1. Убедитесь, что SDK мониторинга производительности не отключен ни одним из следующих флагов в файле Info.plist :

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

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

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

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

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

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

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

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

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

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

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

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

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

На панели производительности отсутствуют данные сетевого запроса

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

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

   • Для Swift: URLSession и URLConnection
   • Для цели-C: NSURLSession и NSURLConnection

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

2. Помните о следующем:

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

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

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

Узнайте больше о том, как мониторинг производительности объединяет данные сетевых запросов по шаблонам URL-адресов.

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

Часто задаваемые вопросы

iOS+ Android Интернет

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

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

Селектор приложений в верхней части карточки «Производительность» фильтрует записи предупреждений в разделе « Последние предупреждения ». Отображаются только три последних оповещения для выбранных приложений.

Дополнительные сведения об оповещениях см. в разделе Настройка оповещений о проблемах с производительностью .

Что случилось с возможностью устанавливать пороги проблем в консоли?

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

Что случилось с информацией о деталях и метриках в консоли Firebase?

Мы заменили страницы «Подробности» и «Метрики» обновленным централизованным пользовательским интерфейсом (UI), чтобы упростить устранение неполадок. Этот новый пользовательский интерфейс для устранения неполадок предлагает те же основные функции, что и детали и метрики. Дополнительные сведения об устранении неполадок см. в разделе Просмотр дополнительных данных для определенной трассировки .

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

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

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

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

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

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

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

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

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

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

Мы заменили вкладку «Проблемы» введением «Оповещений», которые автоматически уведомляют вас о превышении установленных вами пороговых значений. Вам больше не нужно вручную проверять консоль Firebase, чтобы определить статус порога. Дополнительные сведения об оповещениях см. в разделе Настройка оповещений о проблемах с производительностью .

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

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

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

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

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

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

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

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

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

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

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

Near real-time data processing and display

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

I've updated to a real-time compatible SDK version, but some of my users are still on old versions of my app. Do I continue to see their performance data in the Firebase console?

Yes! Regardless of which SDK version an app instance uses, you'll see performance data from all your users.

However, if you're looking at recent data (less than roughly 36 hours old), then the displayed data is from users of app instances using a real-time compatible SDK version. The non-recent data, though, includes performance data from all versions of your app.

Contacting Firebase Support

If you reach out to Firebase Support , always include your Firebase App ID. Find your Firebase App ID in the Your apps card of your Project settings .