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

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

1. Откройте инструменты разработчика в браузере (например, вкладку Network (Сеть) в Chrome или Network Monitor (Монитор сети) в Firefox).

2. Обновите веб-приложение в браузере.

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

4. Через несколько секунд найдите в инструментах разработчика браузера сетевой вызов firebaselogging.googleapis.com. Наличие этого сетевого вызова показывает, что браузер отправляет данные о производительности в 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 правильно инициализирован в вашем приложении.

2. Убедитесь, что SDK Performance Monitoring не отключен с помощью следующего флага:

   • performance.instrumentationEnabled

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

4. Закройте и снова откройте вкладку с веб-страницей. Проверьте, ведется ли запись в журнал.

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

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

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

В современных приложениях _fid не используется, поскольку показатель Interaction to Next Paint (INP) заменил First Input Delay (FID).

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

1. Добавьте устаревший полифил FID.

2. Убедитесь, что пользователь взаимодействует со страницей в течение пяти секунд после ее загрузки. Performance Monitoring регистрирует FID только в течение этого периода.

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

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

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

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

   Обратите внимание, что при использовании метода record() вам не нужно явно запускать или останавливать трассировку.

2. Убедитесь, что сбор данных Performance Monitoring не отключен с помощью следующего флага:

   • performance.dataCollectionEnabled

     Этот флаг управляет сбором данных только для трассировок пользовательского кода (не для всех данных).

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

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

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

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

• Performance Monitoring автоматически собирает показатели сетевых запросов, которые передает API браузера. В этих отчетах не учитываются неудачные сетевые запросы.

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

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

Подробнее о том, как Performance Monitoring агрегирует данные о сетевых запросах по шаблонам URL…

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

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

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

Меню выбора приложений в верхней части карточки "Эффективность" позволяет отфильтровать записи в разделе Недавние оповещения. Показываются только три последних оповещения для выбранных приложений.

Подробнее об оповещениях о проблемах производительности…

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

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

Что случилось с информацией в разделах Details (Сведения) и Metrics (Показатели) в консоли Firebase?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как добавить в веб-приложение более компактный Performance Monitoring JS SDK с пространствами имен (автономный SDK)?

Если Performance Monitoring – единственный продукт Firebase в вашем приложении, вы можете использовать отдельный SDK Performance Monitoring (и рекомендуемый скрипт заголовка ниже), если вас интересует:

• использование библиотеки с пространством имен
• уменьшить размер пакета SDK;
• откладывать инициализацию SDK до загрузки страницы;

Чтобы добавить в приложение отдельный SDK Performance Monitoring и отложить его инициализацию до загрузки страницы, выполните следующие действия:

1. Добавьте следующий скрипт в заголовок индексного файла.
2. Обязательно добавьте объект конфигурации проекта Firebase вашего приложения.

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

где:

• performance_standalone – 'https://www.gstatic.com/firebasejs/13.0.0/firebase-performance.js'.
• firebaseConfig – объект конфигурации Firebase вашего приложения.

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

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

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