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

bookmark_border Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

• Узнайте больше о том, как отслеживать проблемы с производительностью в консоли Firebase .

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

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

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

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

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

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

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

Вы можете просмотреть данные с этих следов в подсчете Traces Traces Table, которая находится в нижней части инструментальной панели производительности (узнайте больше об использовании консоли позже на этой странице).

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

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

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

Добавить пользовательские следы кода

Используйте API TRACE TRACE Performance Monitoring ( SWIFT | OBJ-C ), чтобы добавить пользовательские трассировки кода для мониторинга конкретного кода приложения.

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

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

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

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

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

Используйте API TRACE Performance Monitoring ( Swift | obj-C ), чтобы добавить пользовательские метрики в пользовательские трассировки кода.

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

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

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

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Создать пользовательские атрибуты для пользовательских трассов кода

Используйте API TRACE Performance Monitoring ( SWIFT | OBJ-C ), чтобы добавить пользовательские атрибуты в пользовательские следы кода.

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

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

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

  • Нет ведущего или следственного пробела, нет ведущего подчеркивания ( _ ) символов
  • Нет мест
  • Максимальная длина - 32 символа
  • Разрешенные символы для имени - это AZ , az и _ .

• Каждый пользовательский трассировку может записывать до 5 пользовательских атрибутов.

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

  Узнайте больше об этом руководстве

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Отслеживать, просмотреть и фильтровать данные о производительности

Отслеживайте конкретные метрики на панели панели

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

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

1. Перейдите на приборную панель Performance в консоли Firebase .
2. Нажмите на пустую метрическую карту, затем выберите существующую метрику, чтобы добавить на свою плату.
3. Нажмите more_vert на заполненной метрической карте для получения дополнительных параметров, например, для замены или удаления метрики.

Соглашение метрик показывает собранные метрические данные с течением времени, как в графической форме, так и в виде численного процентного изменения.

Узнайте больше об использовании приборной панели .

Просмотреть следы и их данные

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

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

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

Вы можете получить доступ к странице устранения неполадок следующими способами:

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

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

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

• Узнайте больше об использовании атрибутов для изучения данных о производительности.

• Узнайте больше о том, как отслеживать проблемы с производительностью в консоли Firebase .

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

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

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

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

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

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

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

Вы можете просмотреть данные с этих следов в подсчете Traces Traces Table, которая находится в нижней части инструментальной панели производительности (узнайте больше об использовании консоли позже на этой странице).

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

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

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

Добавить пользовательские следы кода

Используйте API TRACE TRACE Performance Monitoring ( SWIFT | OBJ-C ), чтобы добавить пользовательские трассировки кода для мониторинга конкретного кода приложения.

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

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

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

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

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

Используйте API TRACE Performance Monitoring ( Swift | obj-C ), чтобы добавить пользовательские метрики в пользовательские трассировки кода.

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

• Names for custom metrics must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 100 characters.
• Each custom code trace can record up to 32 metrics (including the default Duration metric).

To add a custom metric, add a line of code similar to the following each time that the event occurs. For example, this custom metric counts performance- related events that occur in your app, such as cache hits or retries.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Create custom attributes for custom code traces

Use the Performance Monitoring Trace API ( Swift | Obj-C ) to add custom attributes to custom code traces.

To use custom attributes, add code to your app that defines the attribute and associates it with a specific custom code trace. You can set the custom attribute anytime between when the trace starts and when the trace stops.

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

• Names for custom attributes must meet the following requirements:

  • No leading or trailing whitespace, no leading underscore ( _ ) character
  • No spaces
  • Max length is 32 characters
  • Allowed characters for the name are AZ , az , and _ .

• Each custom code trace can record up to 5 custom attributes.

• Please ensure that custom attributes do not contain any information that personally identifies an individual to Google.

  Learn more about this guideline

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Track, view, and filter performance data

Track specific metrics in your dashboard

To learn how your key metrics are trending, add them to your metrics board at the top of the Performance dashboard. You can quickly identify regressions by seeing week-over-week changes or verify that recent changes in your code are improving performance.

To add a metric to your metrics board, follow these steps:

1. Go to the Performance dashboard in the Firebase console.
2. Click an empty metric card, then select an existing metric to add to your board.
3. Click more_vert on a populated metric card for more options, for example to replace or remove a metric.

The metrics board shows collected metric data over time, both in graphical form and as a numerical percentage change.

Learn more about using the dashboard .

View traces and their data

To view your traces, go to the Performance dashboard in the Firebase console, scroll down to the traces table, then click the appropriate subtab. The table displays some top metrics for each trace, and you can even sort the list by the percentage change for a specific metric.

Performance Monitoring provides a troubleshooting page in the Firebase console that highlights metric changes, making it easy to quickly address and minimize the impact of performance issues on your apps and users. You can use the troubleshooting page when you learn about potential performance issues, for example, in the following scenarios:

• You select relevant metrics on the dashboard and you notice a big delta.
• In the traces table you sort to display the largest deltas at the top, and you see a significant percentage change.
• You receive an email alert notifying you of a performance issue.

You can access the troubleshooting page in the following ways:

• Filter by App version to view data about a past release or your latest release
• Filter by Device to learn how older devices handle your app
• Filter by Country to make sure your database location isn't affecting a specific region

Learn more about viewing data for your traces .

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

• Learn more about using attributes to examine performance data.

• Learn more about how to track performance issues in the Firebase console.

• Set up alerts for code changes that are degrading the performance of your app. For example, you can configure an email alert for your team if the duration of a specific custom code trace exceeds a threshold that you set.

• View detailed reports of user sessions in which you can see a specific trace in a timeline context of other traces collected during the same session.

Performance Monitoring collects traces to help you monitor the performance of your app. A trace is a report of performance data captured between two points in time in your app.

You can create your own traces to monitor performance data associated with specific code in your app. With a custom code trace , you can measure how long it takes your app to complete a specific task or a set of tasks, for example loading a set of images or querying your database.

The default metric for a custom code trace is its "duration" (the time between the starting and stopping points of the trace), but you can add custom metrics , as well.

In your code, you define the beginning and the end of a custom code trace using the APIs provided by the Performance Monitoring SDK.Custom code traces can be started anytime after they've been created, and they are thread safe.

Since the default metric collected for these traces is "duration", they are sometimes called "Duration traces".

You can view data from these traces in the Custom traces subtab of the traces table, which is at the bottom of the Performance dashboard (learn more about using the console later on this page).

Default attributes, custom attributes, and custom metrics

You can further configure a custom code trace to record custom metrics for performance-related events that occur within the trace's scope. For example, you can create a custom metric for the number of cache hits and misses or the number of times that the UI becomes unresponsive for a noticeable period of time.

Custom attributes and custom metrics display in the Firebase console alongside the default attributes and default metric for the trace.

Add custom code traces

Use the Performance Monitoring Trace API ( Swift | Obj-C ) to add custom code traces to monitor specific application code.

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

• An app can have multiple custom code traces.
• More than one custom code trace can run at the same time.
• Names for custom code traces must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 100 characters.
• Custom code traces support adding custom metrics and custom attributes .

To start and stop a custom code trace, wrap the code that you want to trace with lines of code similar to the following:

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Add custom metrics to custom code traces

Use the Performance Monitoring Trace API ( Swift | Obj-C ) to add custom metrics to custom code traces.

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

• Names for custom metrics must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 100 characters.
• Each custom code trace can record up to 32 metrics (including the default Duration metric).

To add a custom metric, add a line of code similar to the following each time that the event occurs. For example, this custom metric counts performance- related events that occur in your app, such as cache hits or retries.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Create custom attributes for custom code traces

Use the Performance Monitoring Trace API ( Swift | Obj-C ) to add custom attributes to custom code traces.

To use custom attributes, add code to your app that defines the attribute and associates it with a specific custom code trace. You can set the custom attribute anytime between when the trace starts and when the trace stops.

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

• Names for custom attributes must meet the following requirements:

  • No leading or trailing whitespace, no leading underscore ( _ ) character
  • No spaces
  • Max length is 32 characters
  • Allowed characters for the name are AZ , az , and _ .

• Each custom code trace can record up to 5 custom attributes.

• Please ensure that custom attributes do not contain any information that personally identifies an individual to Google.

  Learn more about this guideline

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Track, view, and filter performance data

Track specific metrics in your dashboard

To learn how your key metrics are trending, add them to your metrics board at the top of the Performance dashboard. You can quickly identify regressions by seeing week-over-week changes or verify that recent changes in your code are improving performance.

To add a metric to your metrics board, follow these steps:

1. Go to the Performance dashboard in the Firebase console.
2. Click an empty metric card, then select an existing metric to add to your board.
3. Click more_vert on a populated metric card for more options, for example to replace or remove a metric.

The metrics board shows collected metric data over time, both in graphical form and as a numerical percentage change.

Learn more about using the dashboard .

View traces and their data

To view your traces, go to the Performance dashboard in the Firebase console, scroll down to the traces table, then click the appropriate subtab. The table displays some top metrics for each trace, and you can even sort the list by the percentage change for a specific metric.

Performance Monitoring provides a troubleshooting page in the Firebase console that highlights metric changes, making it easy to quickly address and minimize the impact of performance issues on your apps and users. You can use the troubleshooting page when you learn about potential performance issues, for example, in the following scenarios:

• You select relevant metrics on the dashboard and you notice a big delta.
• In the traces table you sort to display the largest deltas at the top, and you see a significant percentage change.
• You receive an email alert notifying you of a performance issue.

You can access the troubleshooting page in the following ways:

• Filter by App version to view data about a past release or your latest release
• Filter by Device to learn how older devices handle your app
• Filter by Country to make sure your database location isn't affecting a specific region

Learn more about viewing data for your traces .

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

• Learn more about using attributes to examine performance data.

• Learn more about how to track performance issues in the Firebase console.

• Set up alerts for code changes that are degrading the performance of your app. For example, you can configure an email alert for your team if the duration of a specific custom code trace exceeds a threshold that you set.

• View detailed reports of user sessions in which you can see a specific trace in a timeline context of other traces collected during the same session.