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

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

1. Откройте инструменты разработчика вашего браузера (например, вкладку «Сеть» для Chrome Dev Tools или в сетевом мониторе для Firefox ).

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

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

4. Через несколько секунд найдите сетевой вызов firebaselogging.googleapis.com в инструментах разработчика браузера. Наличие этого сетевого вызова показывает, что браузер отправляет данные о производительности в Firebase.

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

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

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

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

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

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

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

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

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

1. Убедитесь, что пакет SDK для мониторинга производительности правильно инициализирован в вашем приложении.

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

   • performance.instrumentationEnabled

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

4. Закройте, а затем снова откройте вкладку веб-страницы. Проверьте еще раз регистрацию.

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

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

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

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

1. Имейте в виду, что мониторинг производительности регистрирует только первую метрику задержки ввода , когда пользователь щелкает веб-страницу в течение первых 5 секунд после загрузки страницы.

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

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

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

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

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

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

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

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

   • performance.dataCollectionEnabled

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как добавить меньший пакет SDK JS для мониторинга производительности с пространством имен («автономный» SDK) в мое веб-приложение?

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

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

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

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/9.8.1/firebase-performance-standalone.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);

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

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.