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


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

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

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

В коде вы определяете начало и конец трассировки пользовательского кода с помощью API, предоставляемых SDK Performance Monitoring.

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

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

Данные этих трассировок можно посмотреть на вложенной вкладке Специальные трассировки в таблице трассировок внизу панели Производительность. Подробнее об использовании консоли рассказывается ниже.

Стандартные и настраиваемые атрибуты, а также специальные показатели

Для трассировок специального кода Performance Monitoring автоматически регистрирует атрибуты по умолчанию (общие метаданные, такие как версия приложения, страна, устройство и т. д.), чтобы вы могли фильтровать данные для трассировки в консоли Firebase. Вы также можете добавлять и отслеживать настраиваемые атрибуты (например, уровень игры или свойства пользователя).

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

Настраиваемые атрибуты и специальные показатели отображаются в консоли Firebase рядом с атрибутами и показателями по умолчанию для трассировки.

Добавление трассировок собственного кода

Используйте Performance Monitoring Trace API, чтобы добавить пользовательские трассировки кода для мониторинга определенного кода приложения.

Обратите внимание:

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

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

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

Как добавить пользовательские показатели в трассировки пользовательского кода

Используйте Performance Monitoring Trace API, чтобы добавить специальные показатели в трассировки пользовательского кода.

Обратите внимание:

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

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

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

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

Обратите внимание:

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

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

  • Не используйте настраиваемые атрибуты, содержащие информацию, позволяющую идентифицировать личность.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

Как отслеживать, просматривать и фильтровать данные об эффективности

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

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

Чтобы добавить показатель на панель показателей, перейдите на панель управления Производительность в консоли Firebase и откройте вкладку Панель управления. Нажмите на пустую карточку показателя и выберите показатель, который хотите добавить на доску. Нажмите на значок с тремя точками (⋮) на карточке показателя, чтобы увидеть дополнительные параметры, например замену или удаление показателя.

На панели показателей отображаются собранные данные за определенный период времени в виде графика и процентного изменения.

Подробнее о том, как использовать главную панель…

Как посмотреть трассировки и их данные

Чтобы посмотреть трассировки, перейдите на панель управления Эффективность в консоли Firebase, прокрутите страницу вниз до таблицы трассировок и выберите нужную вкладку. В таблице показаны основные показатели для каждого трассировщика. Вы можете отсортировать список по процентному изменению определенного показателя.

Если вы нажмете на название трассировки в таблице, то сможете перейти к различным экранам, чтобы изучить трассировку и получить подробные сведения об интересующих вас показателях. На большинстве страниц можно использовать кнопку Фильтр (в левом верхнем углу экрана), чтобы отфильтровать данные по атрибуту, например:

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

Подробнее о том, как просматривать данные трассировки…

Дальнейшие действия