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

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 (v9.0.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 Интернет

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обработка и отображение данных практически в реальном времени

Что означают данные о производительности «почти в реальном времени»?

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

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

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

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

Это версии SDK, совместимые с режимом реального времени:

• iOS — v7.3.0 или новее
• tvOS — v8.9.0 или новее
• Android — v19.0.10 или новее (или Firebase Android BoM v26.1.0 или новее)
• Интернет — v7.14.0 или новее

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

Какие версии Performance Monitoring SDK считаются совместимыми с режимом реального времени?

Это версии SDK, совместимые с обработкой данных в реальном времени:

• iOS — v7.3.0 или новее
• tvOS — v8.9.0 или новее
• Android — v19.0.10 или новее (или Firebase Android BoM v26.1.0 или новее)
• Интернет — v7.14.0 или новее

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

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

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

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 .