Firebase Performance Monitoring Help

You can use Firebase Performance Monitoring to monitor the performance characteristics of your app, including metrics for app start, and HTTP/S network requests made by your app.

A trace is a a report of performance data captured between two points in time in your app. An HTTP/S network request is a report that captures the time between when your app issues a request to a service endpoint and when the response from that endpoint is complete.

To learn more about Performance Monitoring, see Firebase Performance Monitoring overview. To add Performance Monitoring to your app, see the Get Started guide for iOS or Android.

Performance Monitoring is currently in beta release.

Review performance data in the dashboard

  1. On the Firebase console navigation bar, click Performance, and then click Dashboard if it is not already selected.

    The Performance Monitoring Dashboard
    This page shows you an overview of performance data for your app, including:
    • Traces by frequency, which shows the traces that occur the most frequently over the selected time frame.
    • Network success rate, which shows the percentage of successful HTTP/S network requests made by your app over time.
    • Network response latency, which shows the median network latency for HTTP/S network requests from your app across various locations.
    • Network response MIME types, which shows network traffic broken down by MIME type.
    • App start trace: Median duration, which shows the median app start time for the most widely used versions of your app.
  2. To change the time frame for the information shown in the dashboard, click the time frame list (date_range) and choose a time frame (24 hours to 6 months).
  3. To see additional details related to the Traces by frequency, Network success rate, or App start trace: median duration panels, click the links in the lower right corner of those panels.
  4. To see the percentage of successful HTTP/S network requests at a specific time, hover over the graph in the Network success rate panel.

  5. To see the percentile distribution of app start trace durations in your app, hover over the App start trace: median duration slider.

Monitor traces

  1. On the Firebase console navigation bar, click Performance, and then click Traces if it is not already selected.
    This page shows you the name, median duration and number of instances for each trace that exists in your app.
  2. To change how the traces list is ordered, click sort (arrow_downward) and choose Duration, Name or Instances.
  3. To change the time frame for the traces shown, click the time frame list (date_range) and choose a time frame (24 hours to 6 months).
  4. Scroll to the bottom of the traces list to change the number of traces shown per page or to move between pages using the directional arrows (chevron_left and chevron_right).

Monitor trace metrics

  1. On the Firebase console navigation bar, click Performance, and then click Traces if it is not already selected.
    This page shows you the name, median duration and number of instances for each trace that exists in your app.
  2. In the traces list, click a trace that you want to learn more about (for example, AppStart).
  3. To change the time frame for the metrics shown, click the time frame list (date_range) and choose a time frame (24 hours to 6 months).
  4. To change how the metrics for a trace are filtered, click Filter + next to the filter list icon (filter_list) and select a value from one of the following dimensions:

    • Country
    • Device
    • OS version
    • App version
    • Radio
    • Carrier
  5. On this page, you can see the metrics for the trace that you selected in aggregate, or over time:

    • To see metrics in aggregate, click Aggregate. This shows you each metric available for that trace, the highest and lowest reading for that metric over the selected time frame, and the median value for that metric over the selected time frame. You can see the percentile distribution for a metric by hovering over the slider for that metric. These values change if you change the Filter + settings or time frame (date_range).
    • To see metrics over time, click Over Time. This shows you each metric available for that trace, and the highest and lowest value for that metric at each point in time. It also shows the Delta of median, which measures the amount that the median for that metric changed over the selected time frame. You can see the median value for a metric at any point in time by hovering over the graph for that metric. These values change if you change the Filter + settings or time frame (date_range).

Monitor trace details

  1. On the Firebase console navigation bar, click Performance, and then click Traces if it is not already selected.
    This page shows you the name, median duration and number of instances for each trace that exists in your app.
  2. In the traces list, click a trace that you want to learn more about. (for example, AppStart).
  3. Under the metric that you want to learn more about (for example, Duration), click View More.
  4. To change the time frame for the metrics shown, click the time frame list (date_range) and choose a a time frame (24 hours to 6 months).
  5. To change how the details for a metric are filtered, click Filter + next to the filter list icon (filter_list) and select a value from one of the following dimensions:

    • Country
    • Device
    • OS version
    • App version
    • Radio
    • Carrier
  6. On this page, you can see the details for the metric that you selected in aggregate, or over time:

    • To see metric details in aggregate, click Aggregate. This shows you the selected metric across each available member, the median value for the metric for that member and where it falls in the range of values, and the % Instances (how many of the instances are represented by that member). You can see the percentile distribution for a metric by hovering over the slider for that metric. These values change if you change the Filter + settings or time frame (date_range).
    • To see metric details over time, click Over Time. This shows you the selected metric across each available member, the Delta of median, which measures the amount that the median for that metric changed over the selected time frame, and the % Instances (how many of the instances are represented by that member). You can see the median value for a metric at any point in time by hovering over the graph for that metric. These values change if you change the Filter + settings or time frame (date_range).

Monitor HTTP/S network requests

  1. On the Firebase console navigation bar, click Performance, and then click Network if it is not already selected.
    This page shows you the service endpoint, response time, success rate and number of HTTP/S network requests to that endpoint. Note that HTTP parameters are not included for effective aggregation of endpoints and to protect the privacy of end users.
  2. To change how the HTTP/S network requests list is ordered, click sort (arrow_downward) and choose Response time, Success rate or Requests.
  3. To change the time frame for the traces shown, click the time frame list (date_range) and choose a time frame (24 hours to 6 months).
  4. Scroll to the bottom of the list to change the number of HTTP/S network requests shown per page or to move between pages using the directional arrows (chevron_left and chevron_right).

Monitor HTTP/S network request metrics

  1. On the Firebase console navigation bar, click Performance, and then click Network if it is not already selected.
    This page shows you the service endpoint, response time, success rate and the number of HTTP/S network requests to that endpoint.
  2. In the HTTP/S network requests list, click a network request that you want to learn more about.
  3. To change the time frame for the metrics shown, click the time frame list (date_range) and choose a time frame (24 hours to 6 months).
  4. To change how the metrics for a HTTP/S network request are filtered, click Filter + next to the filter list icon (filter_list) and select a value from one of the following dimensions:

    • Country
    • Device
    • OS version
    • App version
    • Radio
    • Carrier
    • MIME type
  5. On this page, you can see the metrics for the network request that you selected in aggregate, or over time:

    • To see metrics in aggregate, click Aggregate. This shows you each metric available for that network request. For most metrics, you see the highest and lowest reading for that metric over the selected time frame, and the median value for that metric over the selected time frame. For the Success Rate metric, you see the percentage of successful response codes. You can see the percentile distribution for a metric by hovering over the slider for that metric. These values change if you change the Filter + settings or time frame (date_range).
    • To see metrics over time, click Over Time. This shows you each metric available for that network request. For most metrics, you see the highest and lowest reading for that metric over the selected time frame. It also shows the Delta of median, which measures the amount that the median for that metric changed over the selected time frame. For the Success Rate metric, it shows the change in the network request success rate over the selected time frame. You can see the median value for a metric at any point in time by hovering over the graph for that metric. These values change if you change the Filter + settings or time frame (date_range).

Monitor HTTP/S network request details

  1. On the Firebase console navigation bar, click Performance, and then click Network if it is not already selected.
    This page shows you the service endpoint, response time, success rate and the number of HTTP/S network requests to that endpoint.
  2. In the HTTP/S network requests list, click a network request that you want to learn more about.
  3. Under the metric that you want to learn more about (for example, Response Time), click View More.
  4. To change the time frame for the metrics shown, click the time frame list (date_range) and choose a a time frame (24 hours to 6 months).
  5. To change how the details for a metric are filtered, click Filter + next to the filter list icon (filter_list) and select a value from one of the following dimensions:

    • Country
    • Device
    • OS version
    • App version
    • Radio
    • Carrier
    • MIME type
  6. On this page, you can see the details for the metric that you selected in aggregate, or over time:

    • To see metric details in aggregate, click Aggregate. This shows you the selected metric across each available member, the median value for the metric for that member and where it falls in the range of values, and the % Instances (how many of the instances are represented by that member). You can see the percentile distribution for a metric by hovering over the slider for that metric. These values change if you change the Filter + settings or time frame (date_range).
    • To see metric details over time, click Over Time. This shows you the selected metric across each available member, the Delta of median, which measures the amount that the median for that metric changed over the selected time frame, and the % Instances (how many of the instances are represented by that member). You can see the median value for a metric at any point in time by hovering over the graph for that metric. These values change if you change the Filter + settings or time frame (date_range).

Send feedback about...

Need help? Visit our support page.