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

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

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

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

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

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

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

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

Включите журнал отладки:
1. В Xcode (версии 26.2 или более поздней) выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).
2. В меню слева нажмите Run (Выполнить) и перейдите на вкладку Arguments (Аргументы).
3. В разделе Arguments Passed on Launch (Аргументы, передаваемые при запуске) добавьте -FIRDebugEnabled.
Проверьте сообщения в журнале на наличие сообщений об ошибках.
Performance Monitoring помечает сообщения в журнале тегом Firebase/Performance, чтобы вы могли их фильтровать.
Проверьте, есть ли в журнале следующие типы записей, которые указывают на то, что Performance Monitoring регистрирует события производительности:
- Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
- Logging network request trace: URL
Нажмите на URL, чтобы посмотреть данные в консоли Firebase. Обновление данных на панели управления может занять несколько минут.

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

2. Проверьте панель мониторинга Firebase

Проверьте панель мониторинга Firebase, чтобы узнать, нет ли известных сбоев в работе Firebase или Performance Monitoring.

Начало работы с Performance Monitoring

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

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

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

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

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

Если вы все ещё разрабатываете приложение локально, попробуйте сгенерировать больше событий для сбора данных:
1. Продолжайте разрабатывать приложение, используя симулятор или тестовое устройство.
2. Сгенерируйте события, несколько раз переключив приложение между фоновым и активным режимами, взаимодействуя с приложением, перемещаясь по экранам и/или запуская сетевые запросы.
Убедитесь, что файл конфигурации Firebase (Google-Service-Info.plist) правильно добавлен в приложение и не был изменен. В частности, проверьте следующее:
- В конец названия файла конфигурации не были добавлены лишние символы, например (2).
- Файл конфигурации находится в корневой папке проекта XCode и добавлен в нужные целевые объекты.
- Идентификатор приложения Firebase для Apple (GOOGLE_APP_ID), указанный в файле конфигурации, соответствует вашему приложению. Идентификатор приложения Firebase можно найти на карточке Ваши приложения в разделе Настройки проекта.
Если вы обнаружили ошибку в файле конфигурации, попробуйте сделать следующее:
1. Удалите файл конфигурации, который сейчас используется в приложении.
2. Следуйте этим инструкциям, чтобы скачать новый файл конфигурации и добавить его в приложение Apple.
Если SDK регистрирует события и все настроено правильно, но вы по-прежнему не видите сообщение об обнаружении SDK или обработанные данные (по прошествии двух часов), обратитесь в службу поддержки Firebase.

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

Убедитесь, что SDK Performance Monitoring не отключен с помощью следующих флагов в файле Info.plist:
- firebase_performance_collection_enabled
- firebase_performance_collection_deactivated
Убедитесь, что Performance Monitoring не отключен во время выполнения (Swift | Obj-C).
Если вы не можете найти отключенные функции в приложении, обратитесь в службу поддержки Firebase.

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

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

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

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

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

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

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

Убедитесь, что SDK Performance Monitoring не отключен с помощью следующих флагов в файле Info.plist:
- firebase_performance_collection_enabled
- firebase_performance_collection_deactivated
Убедитесь, что Performance Monitoring не отключен во время выполнения (Swift | Obj-C).
Если вы не можете найти отключенные функции в приложении, обратитесь в службу поддержки Firebase.

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

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

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

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

Проверьте настройки трассировок специального кода, добавленных с помощью Trace API. Обратите особое внимание на следующее:
- Названия трассировок пользовательского кода и специальных показателей должны соответствовать следующим требованиям: не содержать пробелов в начале и конце, не начинаться с символа подчеркивания (_) и не превышать 32 символа.
- Все трассировки должны быть запущены и остановлены. Трассировка, которая не была запущена, не была остановлена или была остановлена до запуска, не будет зарегистрирована.
Проверьте сообщения в журнале, чтобы убедиться, что Performance Monitoring регистрирует ожидаемые трассировки пользовательского кода.
Если Performance Monitoring регистрирует события, но данные не появляются в течение 24 часов, обратитесь в службу поддержки Firebase.

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

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

Проверьте, совместима ли библиотека сети. Performance Monitoring автоматически собирает показатели сетевых запросов, в которых используются следующие сетевые библиотеки:
- Для Swift: URLSession и URLConnection.
- Для Objective-C: NSURLSession и NSURLConnection.
Обратите внимание, что вы можете добавить специальный мониторинг сетевых запросов.
Обратите внимание:
- В зависимости от поведения вашего кода и используемых им сетевых библиотек 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 Гц, время отрисовки каждого кадра будет меньше. Это может привести к тому, что в отчетах будет меньше медленных или зависших кадров. Это текущее ограничение в Performance Monitoring SDK.

Экспорт данных 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, совместимую с сигналами в реальном времени?

Если ваше приложение не использует версию 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 или более поздней версии.

Как обратиться в службу поддержки Firebase

При обращении в службу поддержки Firebase всегда указывайте идентификатор приложения Firebase. Идентификатор приложения Firebase можно найти на карточке Ваши приложения в разделе Настройки проекта.