На этой странице приведены советы по устранению неполадок для начала работы с мониторингом производительности или использования функций и инструментов мониторинга производительности.
Первые проверки для устранения неполадок
Следующие две проверки являются общими рекомендациями, рекомендуемыми для всех перед дальнейшим устранением неполадок.
1. Проверьте сообщения журнала на наличие событий производительности
Проверьте сообщения журнала, чтобы убедиться, что SDK мониторинга производительности фиксирует события производительности.
Включите ведение журнала отладки следующим образом:
- В Xcode (минимум v13.3.1) выберите Product > Scheme > Edit Scheme.
- Выберите « Выполнить» в меню слева, затем перейдите на вкладку « Аргументы ».
- В разделе « Аргументы , передаваемые при запуске» добавьте
-FIRDebugEnabled
.
Проверьте сообщения журнала на наличие сообщений об ошибках.
Мониторинг производительности помечает сообщения журнала тегами
Firebase/Performance
, чтобы вы могли фильтровать сообщения журнала.Проверьте следующие типы журналов, которые указывают на то, что мониторинг производительности регистрирует события производительности:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
Нажмите на URL-адрес, чтобы просмотреть свои данные в консоли Firebase. Обновление данных на панели мониторинга может занять некоторое время.
Если ваше приложение не регистрирует события производительности, ознакомьтесь с советами по устранению неполадок .
2. Проверьте панель состояния Firebase.
Проверьте панель состояния Firebase на случай известных сбоев в работе Firebase или мониторинга производительности.
Начало работы с мониторингом производительности
Если вы только начинаете работу с мониторингом производительности ( iOS+ | Android | Web ), следующие советы по устранению неполадок помогут решить проблемы, связанные с обнаружением Firebase SDK или отображением ваших первых данных о производительности в консоли Firebase.
Firebase может определить, успешно ли вы добавили пакет SDK для мониторинга производительности в свое приложение, когда он получает информацию о событиях (например, о взаимодействиях с приложением) из вашего приложения. Обычно в течение 10 минут после запуска приложения на панели производительности консоли Firebase отображается сообщение «Обнаружен SDK». Затем в течение 30 минут на дашборде отображаются исходные обработанные данные.
Если с момента добавления последней версии SDK в приложение прошло более 10 минут, но вы по-прежнему не видите никаких изменений, проверьте сообщения журнала , чтобы убедиться, что мониторинг производительности регистрирует события. Попробуйте выполнить соответствующие действия по устранению неполадок, как описано ниже, чтобы устранить неполадки с отложенным сообщением об обнаружении SDK.
Если вы все еще ведете локальную разработку, попробуйте создать больше событий для сбора данных:
Продолжайте разрабатывать приложение с помощью симулятора или тестового устройства.
Создавайте события, несколько раз переключая ваше приложение между фоновым и передним планом, взаимодействуя с вашим приложением, перемещаясь между экранами и/или инициируя сетевые запросы.
Убедитесь, что ваш файл конфигурации Firebase (
Google-Service-Info.plist
) правильно добавлен в ваше приложение и что вы не изменили этот файл. В частности, проверьте следующее:К имени файла конфигурации не добавляются дополнительные символы, например
(2)
.Файл конфигурации находится в корне вашего проекта XCode и добавлен к правильным целям.
Идентификатор приложения Firebase Apple (
GOOGLE_APP_ID
), указанный в файле конфигурации, верен для вашего приложения. Найдите свой идентификатор приложения Firebase на карточке « Ваши приложения » в настройках « проекта» .
Если что-то не так с файлом конфигурации в вашем приложении, попробуйте следующее:
Удалите файл конфигурации, который у вас есть в вашем приложении.
Следуйте этим инструкциям , чтобы загрузить новый файл конфигурации и добавить его в свое приложение Apple.
Если SDK регистрирует события и кажется, что все настроено правильно, но вы по-прежнему не видите сообщение об обнаружении SDK или обработанные данные (через 2 часа), обратитесь в службу поддержки Firebase .
Убедитесь, что SDK мониторинга производительности не отключен ни одним из следующих флагов в файле
Info.plist
:-
firebase_performance_collection_enabled
-
firebase_performance_collection_deactivated
-
Убедитесь, что мониторинг производительности не отключен во время выполнения ( Swift | Obj-C ).
Если вы не можете найти ничего отключенного в своем приложении, обратитесь в службу поддержки Firebase .
Мониторинг производительности обрабатывает данные о событиях производительности перед их отображением на панели мониторинга производительности .
Если с момента появления сообщения «Обнаружен SDK» прошло более 24 часов , а данные по-прежнему не отображаются, проверьте панель состояния Firebase на случай известного сбоя. Если сбоя нет, обратитесь в службу поддержки Firebase .
Общее устранение неполадок
Если вы успешно добавили SDK и используете мониторинг производительности в своем приложении, следующие советы по устранению неполадок могут помочь в решении общих проблем, связанных с функциями и инструментами мониторинга производительности.
Если вы не видите сообщения журнала о событиях производительности , попробуйте выполнить следующие действия по устранению неполадок:
Убедитесь, что SDK мониторинга производительности не отключен ни одним из следующих флагов в файле
Info.plist
:-
firebase_performance_collection_enabled
-
firebase_performance_collection_deactivated
-
Убедитесь, что мониторинг производительности не отключен во время выполнения ( Swift | Obj-C ).
Если вы не можете найти ничего отключенного в своем приложении, обратитесь в службу поддержки Firebase .
Если у вас отсутствуют данные для трассировки рендеринга экрана, попробуйте выполнить следующие действия по устранению неполадок:
Убедитесь, что вы используете последнюю версию пакета SDK для платформ Apple (v9.0.0). Трассировки рендеринга экрана доступны только в версии 5.0.0 или выше.
Мониторинг производительности не создает трассировки рендеринга экрана для контроллеров представлений контейнеров (таких как
UINavigationController
иUITabBarController
). Если данные отсутствуют только для этих экранов, то это ожидаемое поведение.
Вы видите данные о производительности для автоматически собираемых трассировок, но не для пользовательских трассировок кода ? Попробуйте выполнить следующие действия по устранению неполадок:
Проверьте настройку пользовательских трассировок кода, инструментированных через Trace API , особенно следующие:
- Имена для пользовательских трассировок кода и пользовательских метрик должны соответствовать следующим требованиям: не должно быть начальных или конечных пробелов, не должно быть начального символа подчеркивания (
_
), а максимальная длина — 32 символа. - Все трассировки должны быть запущены и остановлены. Любая трассировка, которая не запущена, не остановлена или остановлена до запуска, не регистрируется.
- Имена для пользовательских трассировок кода и пользовательских метрик должны соответствовать следующим требованиям: не должно быть начальных или конечных пробелов, не должно быть начального символа подчеркивания (
Проверьте сообщения журнала , чтобы убедиться, что мониторинг производительности регистрирует ожидаемые пользовательские трассировки кода.
Если мониторинг производительности регистрирует события, но данные не отображаются по прошествии 24 часов, обратитесь в службу поддержки Firebase .
Если вам не хватает данных сетевого запроса, попробуйте выполнить следующие действия по устранению неполадок:
Проверьте несовместимость сетевой библиотеки. Мониторинг производительности автоматически собирает метрики для сетевых запросов , использующих следующие сетевые библиотеки:
- Для Swift: URLSession и URLConnection
- Для цели-C: NSURLSession и NSURLConnection
Обратите внимание, что вы можете добавить настраиваемый мониторинг сетевых запросов .
Помните о следующем:
В зависимости от поведения вашего кода и сетевых библиотек, используемых вашим кодом, мониторинг производительности может сообщать только о выполненных сетевых запросах. Это означает, что оставленные открытыми соединения HTTP/S могут не сообщаться.
Мониторинг производительности не сообщает о сетевых запросах с недопустимыми заголовками
Content-Type
. Однако сетевые запросы без заголовковContent-Type
по-прежнему будут приниматься.
Узнайте больше о том, как мониторинг производительности объединяет данные сетевых запросов по шаблонам URL-адресов.
Вы также можете попробовать собственные шаблоны URL !
Часто задаваемые вопросы
Мониторинг производительности собирает данные о производительности с пользовательских устройств вашего приложения. Если у вашего приложения много пользователей или если приложение генерирует большое количество действий производительности, мониторинг производительности может ограничить сбор данных подмножеством устройств, чтобы уменьшить количество обрабатываемых событий. Эти ограничения достаточно высоки, чтобы даже при меньшем количестве событий значения метрик по-прежнему отражали работу вашего приложения с пользователем.
Для управления объемом данных, которые мы собираем, мониторинг производительности использует следующие параметры выборки:
Ограничение скорости на устройстве : чтобы устройство не отправляло внезапные пакеты трассировок, мы ограничиваем количество трассировок кода и сетевых запросов, отправляемых с устройства, до 300 событий каждые 10 минут. Этот подход защищает устройство от зацикленных инструментов, которые могут отправлять большие объемы данных о производительности, и предотвращает искажение измерений производительности одним устройством.
Динамическая выборка . Мониторинг производительности собирает примерно 100 млн событий для трассировок кода и 100 млн для трассировок сетевых запросов на приложение для всех пользователей приложения. Динамическая частота дискретизации выбирается на устройствах (с помощью Firebase Remote Config), чтобы определить, должно ли случайное устройство захватывать и отправлять трассировки. Устройство, не выбранное для выборки, не отправляет никаких событий. Частота динамической выборки зависит от приложения и настраивается таким образом, чтобы общий объем собираемых данных оставался ниже установленного предела.
Сеансы пользователей отправляют дополнительные подробные данные с устройства пользователя, что требует дополнительных ресурсов для сбора и отправки данных. Чтобы свести к минимуму влияние пользовательских сеансов, мониторинг производительности также может ограничивать количество сеансов.
Ограничение скорости на стороне сервера . Чтобы убедиться, что приложения не превышают лимит выборки, мониторинг производительности может использовать выборку на стороне сервера для удаления некоторых событий, полученных от устройств. Хотя этот тип ограничения не влияет на эффективность наших показателей, он может привести к незначительным изменениям шаблона, в том числе следующим:
- Количество трассировок может отличаться от количества выполнений фрагмента кода.
- Трассировки, тесно связанные в коде, могут иметь разное количество выборок.
Мы заменили вкладку «Проблемы» введением «Оповещений», которые автоматически уведомляют вас о превышении установленных вами пороговых значений. Вам больше не нужно вручную проверять консоль Firebase, чтобы определить статус порога. Дополнительные сведения об оповещениях см. в разделе Настройка оповещений о проблемах с производительностью .
Мы изменили дизайн раздела «Мониторинг производительности» консоли Firebase, чтобы на вкладке « Панель мониторинга » отображались ваши ключевые показатели и все ваши трассировки в одном месте. В рамках редизайна мы удалили страницы « На устройстве » и « Сеть» .
Таблица трассировок в нижней части вкладки « Панель мониторинга » содержит ту же информацию, что и на вкладках « На устройстве » и « Сеть» , но с некоторыми дополнительными функциями, включая возможность сортировки трассировок по процентному изменению определенной метрики. Чтобы просмотреть все метрики и данные для определенной трассировки, щелкните имя трассы в таблице трассировок.
Просмотрите свои трассировки на следующих вложенных вкладках таблицы трассировок:
- Трассировки сетевых запросов (как стандартные, так и пользовательские) — вложенная вкладка « Сетевые запросы »
- Пользовательские трассировки кода — вкладка Пользовательские трассировки
- Запуск приложения, трассировка приложения на переднем плане, трассировка приложения в фоновом режиме — вложенная вкладка « Пользовательские трассировки »
- Трассировки рендеринга экрана — Подвкладка рендеринга экрана
- Трассировки загрузки страницы — вложенная вкладка загрузки страницы
Дополнительные сведения о таблице трассировки и просмотре метрик и данных см. на странице обзора консоли ( iOS+ | Android | Web ).
Мониторинг производительности поддерживает оповещения для метрик, которые превышают определенные пороговые значения. Чтобы избежать путаницы с этими настраиваемыми пороговыми значениями для показателей производительности, мы убрали возможность настраивать пороговые значения для проблем .
Если вы включили интеграцию 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, но любая версия, указанная выше, позволит Мониторингу производительности обрабатывать ваши данные практически в реальном времени.
Это версии SDK, совместимые с обработкой данных в реальном времени:
- iOS — v7.3.0 или новее
- tvOS — v8.9.0 или новее
- Android — v19.0.10 или новее (или Firebase Android BoM v26.1.0 или новее)
- Интернет — v7.14.0 или новее
Обратите внимание, что мы всегда рекомендуем использовать последнюю версию SDK, но любая версия, указанная выше, позволит Мониторингу производительности обрабатывать ваши данные практически в реальном времени.
Если ваше приложение не использует версию SDK, совместимую с режимом реального времени, вы все равно будете видеть все данные о производительности вашего приложения в консоли Firebase. Однако отображение данных о производительности будет задержано примерно на 36 часов с момента их сбора.
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 .