Google стремится продвигать расовую справедливость для черных сообществ. Смотри как.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

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

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

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

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

Обратите внимание на следующее:

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

Атрибуты по умолчанию, пользовательские атрибуты и пользовательские метрики

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

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

Добавить пользовательские трассировки и пользовательские метрики

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

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

    const trace = perf.trace(' CUSTOM_TRACE_NAME ');
    trace.start();
    
    // code that you want to trace
    
    trace.stop();
    

    Узнайте больше об API для пользовательских трассировок .

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

    async function getInventory(inventoryIds) {
      const trace = perf.trace('inventoryRetrieval');
    
      // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
      trace.incrementMetric('numberOfIds', inventoryIds.length);
    
      // Measures the time it takes to request inventory based on the amount of inventory
      trace.start();
      const inventoryData = await retrieveInventory(inventoryIds);
      trace.stop();
    
      return inventoryData;
    }
    

Мониторинг пользовательских трасс и метрик в консоли

  1. В консоли Firebase перейдите на панель мониторинга производительности .

  2. Перейдите на вкладку « На устройстве », и вы сможете:

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

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

    • Используйте кнопку « фильтр» в верхнем левом углу информационной панели, чтобы выполнить базовую фильтрацию данных по атрибуту.

  3. Если щелкнуть конкретную трассировку, консоль отобразит обзор собранных данных на метрических карточках.

    • Используйте параметры в правом верхнем углу панели мониторинга, чтобы просмотреть данные как агрегированные или со временем .

    • Используйте кнопку « фильтр» в верхнем левом углу информационной панели, чтобы выполнить базовую фильтрацию данных по атрибуту.

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

Следующие шаги