Preguntas frecuentes y solución de problemas de supervisión del rendimiento

Cómo ver mensajes de registro para eventos de rendimiento

1. Habilite el registro de depuración, de la siguiente manera:

   1. En Xcode (mínimo v13.3.1), seleccione Producto > Esquema > Editar esquema .
   2. Seleccione Ejecutar en el menú de la izquierda, luego seleccione la pestaña Argumentos .
   3. En la sección Argumentos pasados ​​en el lanzamiento , agregue -FIRDebugEnabled .

2. Verifique sus mensajes de registro para ver si hay mensajes de error.

3. Performance Monitoring etiqueta sus mensajes de registro con Firebase/Performance para que pueda filtrar sus mensajes de registro.

4. Verifique los siguientes tipos de registros que indican que Performance Monitoring está registrando eventos de rendimiento:

   • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. Haga clic en la URL para ver sus datos en la consola de Firebase. Es posible que los datos tarden unos minutos en actualizarse en el tablero.

Si su aplicación no registra eventos de rendimiento, consulte los consejos para la solución de problemas .

Se agregó el SDK a la aplicación, pero la consola aún dice que se agregue el SDK

Firebase puede detectar si agregó correctamente el SDK de monitoreo de rendimiento a su aplicación cuando recibe información de eventos (como interacciones de aplicaciones) de su aplicación. Por lo general, dentro de los 10 minutos posteriores al inicio de su aplicación, el panel de rendimiento de la consola Firebase muestra el mensaje "SDK detectado". Luego, dentro de los 30 minutos, el tablero muestra los datos procesados ​​iniciales.

Si han pasado más de 10 minutos desde que agregó la última versión de SDK a su aplicación y aún no ve ningún cambio, verifique sus mensajes de registro para asegurarse de que Performance Monitoring esté registrando eventos. Pruebe los pasos de solución de problemas apropiados como se describe a continuación para solucionar un mensaje de detección de SDK retrasado.

La consola dice que se detectó el SDK, pero no se muestran datos

Performance Monitoring procesa los datos de eventos de rendimiento antes de mostrarlos en el panel de rendimiento .

Si han pasado más de 24 horas desde que apareció el mensaje "SDK detectado" y aún no ve los datos, verifique el Panel de estado de Firebase en caso de que haya una interrupción conocida. Si no hay interrupción, comuníquese con Firebase Support .

La aplicación no registra eventos de rendimiento

Si no ve mensajes de registro para eventos de rendimiento , intente los siguientes pasos de solución de problemas:

1. Asegúrese de que el SDK de supervisión del rendimiento no esté deshabilitado mediante ninguno de los siguientes indicadores en su archivo Info.plist :

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Asegúrese de que la supervisión del rendimiento no esté deshabilitada en tiempo de ejecución ( Swift | Obj-C ).

3. Si no puede encontrar nada que esté deshabilitado en su aplicación, comuníquese con el Soporte de Firebase .

Faltan datos de seguimiento de pantalla en el panel de rendimiento

Si le faltan datos para los seguimientos de representación de pantalla, intente los siguientes pasos de solución de problemas:

1. Asegúrese de estar utilizando la última versión del SDK de las plataformas de Apple (v10.4.0). Los seguimientos de representación de pantalla solo están disponibles con v5.0.0 o posterior.

2. Performance Monitoring no crea seguimientos de representación de pantalla para controladores de vista de contenedor (como UINavigationController y UITabBarController ). Si solo faltan datos para estas pantallas, entonces este es el comportamiento esperado.

Faltan datos de seguimiento personalizados en el panel de rendimiento

¿Está viendo datos de rendimiento para seguimientos recopilados automáticamente, pero no para seguimientos de código personalizados ? Pruebe los siguientes pasos de solución de problemas:

1. Verifique la configuración de seguimientos de códigos personalizados instrumentados a través de Trace API , especialmente los siguientes:

   • Los nombres para los seguimientos de códigos personalizados y las métricas personalizadas deben cumplir los siguientes requisitos: sin espacios en blanco iniciales ni finales, sin caracteres de subrayado ( _ ) iniciales y una longitud máxima de 32 caracteres.
   • Todos los seguimientos deben iniciarse y detenerse. Cualquier rastreo que no se inicie, no se detenga o se detenga antes de comenzar no se registrará.

2. Verifique sus mensajes de registro para asegurarse de que Performance Monitoring esté registrando los rastros de código personalizados esperados.

3. Si Performance Monitoring está registrando eventos, pero no se muestran datos después de 24 horas, comuníquese con Firebase Support .

Faltan datos de solicitud de red en el panel de rendimiento

Si le faltan datos de solicitud de red, intente los siguientes pasos de solución de problemas:

1. Verifique la incompatibilidad de la biblioteca de red. Performance Monitoring recopila automáticamente métricas para solicitudes de red que utilizan las siguientes bibliotecas de red:

   • Para Swift: URLSession y URLConnection
   • Para Objective-C: NSURLSession y NSURLConnection

   Tenga en cuenta que puede agregar monitoreo personalizado para solicitudes de red .

2. Tenga en cuenta lo siguiente:

   • Según el comportamiento de su código y las bibliotecas de redes utilizadas por su código, es posible que la supervisión del rendimiento solo informe sobre las solicitudes de red que se completan. Esto significa que es posible que no se informen las conexiones HTTP/S que se dejan abiertas.

   • Performance Monitoring no informa sobre solicitudes de red con encabezados Content-Type no válidos. Sin embargo, se seguirán aceptando solicitudes de red sin los encabezados Content-Type .

Los datos de solicitud de red no se agregan como se esperaba

Obtenga más información sobre cómo Performance Monitoring agrega datos de solicitudes de red bajo patrones de URL.

¡También puede probar patrones de URL personalizados !

¿Qué sucedió con los problemas principales en la tarjeta de rendimiento en la página de inicio del proyecto?

Reemplazamos los principales problemas con alertas recientes como seguimiento de nuestra reciente introducción de alertas, que le notifican automáticamente cuando se superan los umbrales que estableció. Los problemas ahora están en desuso y se reemplazan por alertas.

El selector de aplicaciones en la parte superior de la tarjeta Rendimiento filtra las entradas de alerta en Alertas recientes . Solo se muestran las tres alertas más recientes para las aplicaciones seleccionadas.

Para obtener más información sobre las alertas, consulte Configurar alertas para problemas de rendimiento .

¿Qué pasó con la capacidad de establecer umbrales para problemas en la consola?

Performance Monitoring admite alertas para métricas que superan los umbrales definidos. Para evitar confusiones con estos umbrales configurables para las métricas de rendimiento, eliminamos la capacidad de configurar umbrales para problemas .

¿Qué pasó con la información de Detalles y Métricas en Firebase console?

Reemplazamos las páginas de Detalles y Métricas con una interfaz de usuario (UI) centralizada y recientemente rediseñada para mejorar la forma en que soluciona los problemas. Esta nueva interfaz de usuario de solución de problemas ofrece la misma funcionalidad principal que ofrecieron Detalles y Métricas. Para obtener más información sobre la solución de problemas, consulte Ver más datos para un seguimiento específico .

¿Por qué el número de muestras no es el que esperaba?

Performance Monitoring recopila datos de rendimiento de los dispositivos de usuario de su aplicación. Si su aplicación tiene muchos usuarios o si la aplicación genera una gran cantidad de actividad de rendimiento, la supervisión del rendimiento puede limitar la recopilación de datos a un subconjunto de dispositivos para reducir la cantidad de eventos procesados. Estos límites son lo suficientemente altos como para que, incluso con menos eventos, los valores de las métricas sigan siendo representativos de la experiencia de la aplicación de su usuario.

Para gestionar el volumen de datos que recopilamos, Performance Monitoring utiliza las siguientes opciones de muestreo:

• Limitación de velocidad en el dispositivo : para evitar que un dispositivo envíe ráfagas repentinas de seguimientos, limitamos la cantidad de seguimientos de solicitud de red y código enviados desde un dispositivo a 300 eventos cada 10 minutos. Este enfoque protege al dispositivo de instrumentaciones en bucle que pueden enviar grandes cantidades de datos de rendimiento y evita que un solo dispositivo distorsione las mediciones de rendimiento.

• Muestreo dinámico : Performance Monitoring recopila aproximadamente 100 millones de eventos para seguimientos de código y 100 millones para seguimientos de solicitudes de red por aplicación en todos los usuarios de la aplicación. Se obtiene una frecuencia de muestreo dinámica en los dispositivos (usando Firebase Remote Config) para determinar si un dispositivo aleatorio debe capturar y enviar rastros. Un dispositivo que no está seleccionado para el muestreo no envía ningún evento. La frecuencia de muestreo dinámico es específica de la aplicación y se ajusta para garantizar que el volumen total de datos recopilados se mantenga por debajo del límite.

  Las sesiones de usuario envían datos adicionales y detallados desde el dispositivo de un usuario, lo que requiere más recursos para capturar y enviar los datos. Para minimizar el impacto de las sesiones de usuario, Performance Monitoring también puede restringir la cantidad de sesiones.

• Limitación de frecuencia del lado del servidor : para garantizar que las aplicaciones no excedan el límite de muestreo, Performance Monitoring puede usar el muestreo del lado del servidor para descartar algunos eventos recibidos de los dispositivos. Si bien este tipo de limitación no cambia la efectividad de nuestras métricas, puede causar cambios menores en los patrones, incluidos los siguientes:

  • El número de seguimientos puede diferir del número de veces que se ejecutó un fragmento de código.
  • Los rastros que están estrechamente acoplados en el código pueden tener cada uno un número diferente de muestras.

¿Qué pasó con la pestaña Problemas en la consola?

Reemplazamos la pestaña Problemas con la introducción de Alertas, que le notifica automáticamente cuando se superan los umbrales que estableció. Ya no necesita verificar manualmente Firebase console para determinar el estado de un umbral. Para obtener más información sobre las alertas, consulte Configurar alertas para problemas de rendimiento .

¿Qué pasó con las pestañas En dispositivo y Red en la consola? ¿Cómo veo los rastros que había en esas páginas?

Hemos rediseñado la sección Supervisión del rendimiento de Firebase console para que la pestaña Panel muestre sus métricas clave y todos sus seguimientos en un solo espacio. Como parte del rediseño, eliminamos las páginas En dispositivo y Red .

La tabla de seguimientos en la parte inferior de la pestaña Panel tiene la misma información que las pestañas En el dispositivo y Red , pero con algunas características adicionales, incluida la capacidad de ordenar sus seguimientos por el cambio porcentual para una métrica específica. Para ver todas las métricas y datos de un seguimiento específico, haga clic en el nombre del seguimiento en la tabla de seguimientos.

Vea sus rastros en las siguientes subpestañas de la tabla de rastros:

• Rastreos de solicitudes de red (tanto listos para usar como personalizados): subpestaña Solicitudes de red
• Seguimientos de código personalizados: subpestaña Seguimientos personalizados
• Rastreos de inicio de aplicación, aplicación en primer plano, aplicación en segundo plano: subpestaña Rastreos personalizados
• Rastros de representación de pantalla : subpestaña Representación de pantalla
• Rastros de carga de página: subpestaña Carga de página

Para obtener detalles sobre la tabla de seguimientos y la visualización de métricas y datos, visite la página de información general de la consola ( iOS+ | Android | Web ).

¿Por qué la cantidad de fotogramas lentos y congelados no es la que esperaba?

Los fotogramas de procesamiento lento y los fotogramas congelados se calculan con una frecuencia de actualización del dispositivo supuesta de 60 Hz. Si la frecuencia de actualización de un dispositivo es inferior a 60 Hz, cada cuadro tendrá un tiempo de procesamiento más lento porque se procesan menos cuadros por segundo. Los tiempos de renderizado más lentos pueden causar que se informen fotogramas más lentos o congelados porque más fotogramas se renderizarán más lento o se congelarán. Sin embargo, si la frecuencia de actualización de un dispositivo es superior a 60 Hz, cada cuadro tendrá un tiempo de renderizado más rápido. Esto puede hacer que se informen menos fotogramas lentos o congelados. Esta es una limitación actual en el SDK de Performance Monitoring.

Mis datos de Performance Monitoring están tardando más de lo esperado en exportarse a BigQuery. ¿No es en tiempo real?

Si habilitó la integración de BigQuery para Firebase Performance Monitoring, sus datos se exportarán a BigQuery entre 12 y 24 horas después del final del día (hora del Pacífico).

Por ejemplo, los datos del 19 de abril estarán disponibles en BigQuery el 20 de abril entre las 12:00 p. m. y la medianoche (todas las fechas y horas son la hora del Pacífico).

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

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.

How to view log messages for performance events

1. Enable debug logging, as follows:

   1. In Xcode (minimum v13.3.1), select Product > Scheme > Edit scheme .
   2. Select Run from the left menu, then select the Arguments tab.
   3. In the Arguments Passed on Launch section, add -FIRDebugEnabled .

2. Check your log messages for any error messages.

3. Performance Monitoring tags its log messages with Firebase/Performance so that you can filter your log messages.

4. Check for the following types of logs which indicate that Performance Monitoring is logging performance events:

   • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. Click on the URL to view your data in the Firebase console. It may take a few moments for the data to update in the dashboard.

If your app isn't logging performance events, review the troubleshooting tips .

Added the SDK to app, but console still says to add SDK

Firebase can detect if you've successfully added the Performance Monitoring SDK to your app when it receives event information (like app interactions) from your app. Usually within 10 minutes of starting your app, the Performance dashboard of the Firebase console displays an "SDK detected" message. Then, within 30 minutes, the dashboard displays the initial processed data.

If it's been more than 10 minutes since you added the latest version of SDK to your app, and you're still not seeing any change, check your log messages to make sure that Performance Monitoring is logging events. Try the appropriate troubleshooting steps as described below to troubleshoot a delayed SDK detection message.

Console says the SDK is detected, but no data is displayed

Performance Monitoring processes performance event data before displaying it in the Performance dashboard .

If it's been more than 24 hours since the "SDK detected" message appeared , and you're still not seeing data, then check the Firebase Status Dashboard in case there is a known outage. If there is no outage, contact Firebase Support .

App is not logging performance events

If you're not seeing log messages for performance events , try the following troubleshooting steps:

1. Make sure that the Performance Monitoring SDK is not disabled through either of the following flags in your Info.plist file:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Make sure that Performance Monitoring is not disabled at runtime ( Swift | Obj-C ).

3. If you can't find anything that's disabled in your app, contact Firebase Support .

Performance dashboard is missing screen trace data

If you're missing data for screen rendering traces, try the following troubleshooting steps:

1. Make sure that you're using the latest version of the Apple platforms SDK (v10.4.0). Screen rendering traces are only available with v5.0.0 or later.

2. Performance Monitoring doesn't create screen rendering traces for container view controllers (such as UINavigationController and UITabBarController ). If data is only missing for these screens, then this is expected behavior.

Performance dashboard is missing custom trace data

Are you seeing performance data for automatically collected traces but not for custom code traces ? Try the following troubleshooting steps:

1. Check the setup of custom code traces instrumented via the Trace API , especially the following:

   • Names for custom code traces and custom metrics must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 32 characters.
   • All traces must be started and stopped. Any trace that is not started, not stopped, or stopped before started will not be logged.

2. Check your log messages to make sure that Performance Monitoring is logging expected custom code traces.

3. If Performance Monitoring is logging events, but no data displays after 24 hours, contact Firebase Support .

Performance dashboard is missing network request data

If you're missing network request data, try the following troubleshooting steps:

1. Check for network library incompatibility. Performance Monitoring automatically collects metrics for network requests that use the following networking libraries:

   • For Swift: URLSession and URLConnection
   • For Objective-C: NSURLSession and NSURLConnection

   Note that you can add custom monitoring for network requests .

2. Be aware of the following:

   • Depending on the behavior of your code and networking libraries used by your code, Performance Monitoring might only report on network requests that are completed. This means that HTTP/S connections that are left open might not be reported.

   • Performance Monitoring does not report on network requests with invalid Content-Type headers. However, network requests without the Content-Type headers will still be accepted.

Network request data are not aggregating as expected

Learn more about how Performance Monitoring aggregates network request data under URL patterns.

You can also try out custom URL patterns !

What happened to Top Issues in the Performance card on Project home?

We replaced Top Issues with Recent Alerts as a follow-up to our recent introduction of alerts, which automatically notify you when the thresholds you set are crossed. Issues are now deprecated and replaced by alerts.

The apps selector at the top of the Performance card filters the alert entries under Recent Alerts . Only the three most recent alerts for the app(s) selected are displayed.

To learn more about alerts, see Set up alerts for performance issues .

What happened to the ability to set thresholds for issues in the console?

Performance Monitoring supports alerts for metrics that exceed defined thresholds. To avoid confusion with these configurable thresholds for performance metrics, we removed the ability to configure thresholds for issues .

What happened to the Details and Metrics information in the Firebase console?

We replaced the Details and Metrics pages with a newly redesigned, centralized user interface (UI) to improve how you troubleshoot issues. This new troubleshooting UI offers the same core functionality that Details and Metrics offered. To learn more about troubleshooting, see View more data for a specific trace .

Why is the number of samples not what I expect?

Performance Monitoring collects performance data from your app's user devices. If your application has many users or if the app generates a large amount of performance activity, Performance Monitoring might limit data collection to a subset of devices to reduce the number of processed events. These limits are high enough so that, even with fewer events, the metric values are still representative of your user's app experience.

To manage the volume of data that we collect, Performance Monitoring uses the following sampling options:

• On-device rate limiting : To prevent a device from sending sudden bursts of traces, we limit the number of code and network request traces sent from a device to 300 events every 10 mins. This approach protects the device from looped instrumentations that can send large amounts of performance data, and it prevents a single device from skewing the performance measurements.

• Dynamic sampling : Performance Monitoring collects approximately 100M events for code traces and 100M for network request traces per app across all app users. A dynamic sampling rate is fetched on devices (using Firebase Remote Config) to determine whether a random device should capture and send traces. A device that is not selected for sampling does not send any events. The dynamic sampling rate is app-specific and adjusts to ensure that the overall volume of collected data remains below the limit.

  User sessions send additional, detailed data from a user's device, requiring more resources to capture and send the data. To minimize the impact of user sessions, Performance Monitoring might also restrict the number of sessions.

• Server-side rate limiting : To ensure that apps don't exceed the sampling limit, Performance Monitoring might use server-side sampling to drop some events received from devices. Although this type of limiting doesn't change the effectiveness of our metrics, it may cause minor pattern shifts, including the following:

  • The number of traces can differ from the number of times that a piece of code was executed.
  • Traces that are closely coupled in code may each have a different number of samples.

What happened to the Issues tab in the console?

We replaced the Issues tab with the introduction of Alerts, which automatically notifies you when the thresholds you set are exceeded. You no longer need to manually check the Firebase console to determine the status of a threshold. To learn about Alerts, see Set up alerts for performance issues .

What happened to the On Device and Network tabs in the console? How do I view the traces that were on those pages?

We've redesigned the Performance Monitoring section of the Firebase console so that the Dashboard tab displays your key metrics and all your traces in one space. As part of the redesign, we removed the On device and Network pages.

The traces table at the bottom of the Dashboard tab has all the same information that the On device and Network tabs displayed, but with some added features, including the ability to sort your traces by the percentage change for a specific metric. To view all the metrics and data for a specific trace, click the trace name in the traces table.

View your traces in the following subtabs of the traces table:

• Network request traces (both out-of-the-box and custom) — Network requests subtab
• Custom code traces — Custom traces subtab
• App start, app-in-foreground, app-in-background traces — Custom traces subtab
• Screen rendering traces — Screen rendering subtab
• Page load traces — Page load subtab

For details about the traces table and viewing metrics and data, visit the console overview page ( iOS+ | Android | Web ).

Why is the number of slow and frozen frames not what I expected?

Slow rendering frames and frozen frames are calculated with an assumed device refresh rate of 60Hz. If a device refresh rate is lower than 60Hz, each frame will have a slower rendering time because fewer frames are rendered per second. Slower rendering times can cause more slow or frozen frames to be reported because more frames will be rendered slower or will freeze. However, if a device refresh rate is higher than 60Hz, each frame will have a faster rendering time. This can cause fewer slow or frozen frames to be reported. This is a current limitation in the Performance Monitoring SDK.

My Performance Monitoring data is taking longer than expected to be exported to BigQuery. Is it not real time?

If you have enabled the BigQuery integration for Firebase Performance Monitoring, your data will be exported to BigQuery 12 to 24 hours after the end of the day (Pacific Time).

For example, the data for April 19th will be available in BigQuery on April 20th between 12:00pm and midnight (all dates and times are Pacific Time).

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

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.