Preguntas frecuentes y solución de problemas de Performance Monitoring

Cómo visualizar los mensajes de registro de los eventos de rendimiento

1. Agrega un elemento <meta-data> al archivo AndroidManifest.xml de la app para habilitar el registro de depuración de Performance Monitoring en el tiempo de compilación, como en el siguiente ejemplo:

   <application>
       <meta-data
         android:name="firebase_performance_logcat_enabled"
         android:value="true" />
   </application>

2. Revisa si hay mensajes de error en los mensajes de registro.

3. Performance Monitoring etiqueta sus mensajes de registro con FirebasePerformance. Con el filtro de logcat, puedes ver de forma específica el seguimiento de duración y el registro de solicitudes de red HTTP/S mediante la ejecución del siguiente comando:

   adb logcat -s FirebasePerformance

4. Verifica 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. Haz clic en la URL para ver tus datos en Firebase console. Los datos pueden tardar unos minutos en actualizarse en el panel.

Si tu app no registra eventos de rendimiento, revisa las sugerencias para solucionar problemas.

Se agregó el SDK a la app, pero Console sigue diciendo que debe realizarse el agregado correspondiente

Firebase puede detectar si agregaste correctamente el SDK de Performance Monitoring a tu app cuando recibe información de eventos de esta (como las interacciones con la app). Por lo general, en el panel Rendimiento de Firebase console se muestra el mensaje “Se detectó el SDK” en un plazo de 10 minutos después de iniciar la app. Luego, en el término de 30 minutos, se muestran los datos procesados iniciales en el panel.

Si transcurrieron más de 10 minutos desde que agregaste la versión más reciente del SDK a tu app y aún no ves ningún cambio, verifica tus mensajes de registro para asegurarte de que Performance Monitoring registra eventos. Aplica los pasos que correspondan de la descripción que aparece a continuación para solucionar problemas relacionados con mensajes retrasados de detección del SDK.

Console indica 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 pasaron más de 24 horas desde que apareció el mensaje “Se detectó el SDK” y aún no ves los datos, consulta el panel de estado de Firebase en caso de que haya una interrupción conocida. Si no hay interrupciones, comunícate con el equipo de Asistencia de Firebase.

La app no registra los eventos de rendimiento

Si no ves mensajes de registro de eventos de rendimiento, prueba estos pasos para solucionar problemas:

1. Verifica de la siguiente manera la configuración del complemento de Gradle para Performance Monitoring:

   1. Confirma que agregaste el complemento correctamente. Debes verificar lo siguiente:

      • Agregaste el complemento (apply plugin: 'com.google.firebase.firebase-perf') al archivo build.gradle del módulo (nivel de la app)
      • Incluiste la dependencia de ruta de clase del complemento (classpath 'com.google.firebase:perf-plugin:1.4.2') en el archivo build.gradle a nivel de proyecto.

   2. Asegúrate de que el complemento no se inhabilite mediante alguna de las siguientes funciones:

      • instrumentationEnabled en el archivo build.gradle del módulo (nivel de la app)
      • firebasePerformanceInstrumentationEnabled en el archivo gradle.properties

2. Comprueba que el SDK de Performance Monitoring no esté inhabilitado mediante cualquiera de las siguientes marcas en el archivo AndroidManifest.xml:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Asegúrate de que Performance Monitoring no esté inhabilitado durante el tiempo de ejecución.

4. Si no encuentras recursos inhabilitados en la app, comunícate con el equipo de Asistencia de Firebase.

Faltan datos de seguimiento de pantalla en el Panel de rendimiento

Si faltan datos de seguimientos de renderización de pantalla, sigue estos pasos para solucionar problemas:

1. Asegúrate de usar la versión más reciente del SDK de Android (v21.0.2). Los seguimientos de renderización de pantalla solo están disponibles en la versión 15.2.0 o posterior.

2. Asegúrate de no haber inhabilitado manualmente la aceleración de hardware para alguna pantalla.

3. Asegúrate de no usar DexGuard o Jack. Performance Monitoring no es compatible con estas cadenas de herramientas.

   • DexGuard inhabilita la recopilación automática de los seguimientos del inicio de la app, la app en primer plano y en segundo plano. Sin embargo, cualquier seguimiento de código personalizado debería comportarse de manera normal si la app usa DexGuard.

   • Jack está obsoleto y, por lo general, no debes usarlo en la app.

Faltan datos de seguimientos personalizados en el Panel de rendimiento

¿Ves los datos de rendimiento de seguimientos recopilados de forma automática pero no los de seguimientos de código personalizados? Prueba los pasos que aparecen a continuación para solucionar problemas:

1. Si instrumentaste seguimientos de código personalizado a través de la API de Trace, verifica la configuración de los seguimientos y, en especial, controla lo siguiente:

   • Los nombres de métricas personalizadas y seguimientos de código personalizados no deben incluir espacios en blanco al inicio ni al final, ni comenzar con guion bajo (_), y no pueden tener más de 32 caracteres.
   • Todos los seguimientos deben iniciarse y detenerse. No se registrará ningún seguimiento que no se inicie o no se detenga, o bien que se detenga antes de comenzar.

2. Si instrumentaste seguimientos de código personalizado a través de la notación @AddTrace, verifica la configuración del complemento de Gradle de Performance Monitoring:

   1. Confirma que agregaste el complemento correctamente. Debes verificar lo siguiente:

      • Agregaste el complemento (apply plugin: 'com.google.firebase.firebase-perf') al archivo build.gradle del módulo (nivel de la app)
      • Incluiste la dependencia de ruta de clase del complemento (classpath 'com.google.firebase:perf-plugin:1.4.2') en el archivo build.gradle a nivel de proyecto.

   2. Asegúrate de que el complemento no se inhabilite mediante alguna de las siguientes funciones:

      • instrumentationEnabled en el archivo build.gradle del módulo (nivel de la app)
      • firebasePerformanceInstrumentationEnabled en el archivo gradle.properties

3. Revisa los mensajes de registro para asegurarte de que Performance Monitoring registre los seguimientos de código personalizados esperados.

4. Si Performance Monitoring registra eventos, pero no se muestran datos después de 24 horas, comunícate con el equipo de Asistencia de Firebase.

Faltan datos de solicitudes de red en el Panel de rendimiento

Si faltan datos de solicitudes de red, prueba estos pasos para solucionar problemas:

1. En las apps para Android, el complemento de Gradle de Performance Monitoring habilita la instrumentación que ofrece supervisión automática de Solicitudes de red HTTP/S. Verifica lo siguiente:

   1. Confirma que agregaste el complemento correctamente. Debes verificar lo siguiente:

      • Agregaste el complemento (apply plugin: 'com.google.firebase.firebase-perf') al archivo build.gradle del módulo (nivel de la app)
      • Incluiste la dependencia de ruta de clase del complemento (classpath 'com.google.firebase:perf-plugin:1.4.2') en el archivo build.gradle a nivel de proyecto.

   2. Asegúrate de que el complemento no se inhabilite mediante alguna de las siguientes funciones:

      • instrumentationEnabled en el archivo build.gradle del módulo (nivel de la app)
      • firebasePerformanceInstrumentationEnabled en el archivo gradle.properties

2. Verifica si hay bibliotecas de red no compatibles. Performance Monitoring recopila automáticamente métricas de las solicitudes de red que usan las siguientes bibliotecas de red: OkHttp 3.x.x, URLConnection de Java y Apache HttpClient.

   Ten en cuenta que puedes agregar supervisión personalizada para las solicitudes de red.

3. Algunas consideraciones:

   • Según el comportamiento de tu código y las bibliotecas de herramientas de redes que este use, es posible que Performance Monitoring informe solo las solicitudes de red que se completan. Eso significa que tal vez no se informen las conexiones HTTP/S que quedan abiertas.

   • Performance Monitoring no es compatible con DexGuard ni Jack.

     • DexGuard inhabilita la supervisión de las solicitudes de red HTTP/S.
     • Jack está obsoleto y, por lo general, no debes usarlo en la app.

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

Los datos de solicitudes de red no se agregan del modo previsto

Más información sobre cómo Performance Monitoring agrega datos de solicitudes de red en patrones de URL.

También puedes probar los patrones de URL personalizados.

¿Qué sucedió con la sección de problemas principales en la tarjeta Rendimiento de la página principal del proyecto?

Reemplazamos Problemas principales por Alertas recientes para continuar con la actual implementación de las alertas, que te notifican automáticamente cuando se sobrepasan los umbrales que configuraste. Los problemas dejaron de estar disponibles y se reemplazaron por alertas.

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

Para obtener más información sobre las alertas, consulta Configura alertas de problemas de rendimiento.

¿Qué sucedió con la capacidad de establecer umbrales para los problemas en console?

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

¿Qué sucedió con la información de detalles y métricas en Firebase console?

Reemplazamos las páginas Detalles y Métricas por una interfaz de usuario (IU) centralizada, que se rediseñó recientemente para mejorar la solución de problemas. Esta nueva IU para solucionar problemas ofrece la misma funcionalidad principal que ofrecían Detalles y Métricas. Si quieres saber más sobre la solución de problemas, consulta Visualiza más datos de un seguimiento específico.

¿Por qué la cantidad de muestras no es la que esperaba?

Performance Monitoring recopila datos de rendimiento de los dispositivos de los usuarios de tu app. Si tu aplicación tiene muchos usuarios o si genera una gran cantidad de actividad de rendimiento, Performance Monitoring podría 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 la métrica sean representativos de la experiencia de la app del usuario.

Para administrar el volumen de datos que recopilamos, Performance Monitoring usa las siguientes opciones de muestreo:

• Límite de frecuencia integrado en el dispositivo: Para evitar que un dispositivo envíe aumentos repentinos de actividad de seguimientos, limitamos la cantidad de seguimientos de solicitudes de red y código que se envían desde un dispositivo a 300 eventos cada 10 minutos. Este enfoque protege el dispositivo de las instrumentación 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 una cantidad limitada de seguimientos de código y de solicitudes de red por app a diario en todos los usuarios de la app. Se recupera una tasa de muestreo dinámico en los dispositivos (con Firebase Remote Config) para determinar si un dispositivo aleatorio debe captar y enviar seguimientos. Un dispositivo que no está seleccionado para el muestreo no envía ningún evento. La tasa de muestreo dinámico es específica de la app y se ajusta para garantizar que el volumen general de los datos recopilados se mantenga por debajo del límite.

  Los proyectos que habilitaron la integración de BigQuery reciben un límite más alto para la cantidad de seguimientos de solicitudes de red.

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

• Límite de frecuencia del servidor: Para garantizar que las apps no superen el límite de muestreo, Performance Monitoring puede usar el muestreo del servidor a fin de descartar algunos eventos recibidos de dispositivos. Aunque este tipo de límite no cambia la eficacia de nuestras métricas, puede causar leves cambios en los patrones, incluidos los siguientes:

  • La cantidad de seguimientos puede ser diferente de la cantidad de veces que se ejecutó un fragmento de código.
  • Los seguimientos que están estrechamente vinculados en el código pueden tener una cantidad diferente de muestras.

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

Reemplazamos la pestaña Problemas por Alertas, que te notifica automáticamente cuando se superan los límites que estableciste. Ya no necesitas verificar manualmente Firebase console para determinar el estado de un umbral. Para obtener más información sobre Alertas, consulta Configura alertas de problemas de rendimiento.

¿Qué sucedió con las pestañas En el dispositivo y Red de la consola? ¿Cómo puedo ver los seguimientos que estaban en esas páginas?

Rediseñamos la sección Performance Monitoring de Firebase console para que la pestaña Panel muestre tus métricas clave y todos los seguimientos en un solo espacio. Como parte del nuevo diseño, quitamos las páginas En el dispositivo y Red.

La tabla de seguimientos en la parte inferior de la pestaña Panel contiene la misma información que las pestañas En el dispositivo y Red, pero con algunas funciones adicionales, incluida la capacidad de ordenar los seguimientos según el cambio porcentual de una métrica específica. Para ver todas las métricas y los datos de un seguimiento específico, haz clic en su nombre en la tabla correspondiente.

Observa tus seguimientos en las siguientes pestañas secundarias de la tabla:

• Seguimientos de solicitudes de red (listos para usar y personalizados): Pestaña secundaria Solicitudes de red
• Seguimientos de código personalizado: Pestaña secundaria Seguimientos personalizados
• Seguimientos del inicio de la app, app en primer plano y app en segundo plano: Pestaña secundaria Seguimientos personalizados
• Seguimientos de renderización de pantalla: Pestaña secundaria Renderización de pantalla
• Seguimientos de carga de página: Pestaña secundaria Carga de página

Si quieres obtener más información sobre la tabla de seguimientos y la visualización de las métricas y los datos, visita la página de descripción general de console (iOS+ | Android | Web).

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

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

¿Por qué no puedo ver los seguimientos de fragmentos?

Para ver el rendimiento de los fragmentos, además de la actividad en la app, asegúrate de que esta use el SDK de Performance Monitoring para Android, versión 20.1.0 o posterior. Para obtener más información, consulta Agrega Performance Monitoring a la app.

¿Cómo puedo saber qué seguimientos están relacionados con fragmentos y actividades?

Cada uno de los seguimientos de fragmentos y actividades se basa en el nombre de clase, como se define en tu aplicación. Cada uno de los seguimientos de pantalla contiene el prefijo st seguido del nombre de la clase. En Firebase console, se quita el prefijo. Para conocer más detalles, consulta Obtén más información sobre los datos de rendimiento de renderización de pantalla (apps para Apple y Android) .

¿Por qué veo menos seguimientos de fragmentos que otros?

Performance Monitoring realiza muestreo de eventos en todos los eventos recopilados en un dispositivo. Este enfoque nos permite recopilar los eventos mínimos necesarios de los dispositivos de los usuarios a fin de proporcionar métricas de rendimiento.

¿Cómo me notifican si hay un problema con el rendimiento de renderización de mi aplicación?

Performance Monitoring te permite configurar alertas para las métricas que te interesan. En el caso de los seguimientos de renderización de pantalla generados, puedes configurar alertas para recibir notificaciones cuando el porcentaje de fotogramas congelados y lentos supere el umbral que configuraste.

Mis tiempos de compilación son altos después de habilitar el complemento de Gradle de Performance Monitoring. ¿Cómo puedo mejorarlos?

Performance Monitoring para Android usa instrumentación de código de bytes para proporcionar algunas funciones incorporadas, como la supervisión de solicitudes de red HTTP/S. Durante la compilación, se deben realizar iteraciones en todas las clases de tu app (incluidas las dependencias) a fin de instrumentar el código fundamental para medir el rendimiento de las solicitudes de red de tu aplicación.

Estos son algunos de los factores clave que aumentan el tiempo de compilación:

• Cantidad de clases o archivos
• Tamaño de cada una de esas clases (líneas de código)
• La configuración de tu máquina
• Compilación inicial frente a una compilación posterior (las compilaciones posteriores suelen ser más rápidas que la compilación inicial)

Para optimizar el tiempo de compilación, considera modular tu código.

A partir de la versión v1.3.3 del complemento de Performance Monitoring, nos enfocamos en realizar mejoras considerables en el procesamiento incremental de las compilaciones y el almacenamiento en caché de las entradas de las bibliotecas. Para recibir las mejoras de tiempo de compilación más recientes, asegúrate de usar la versión más reciente del plugin (v1.4.2).

Ten en cuenta que puedes inhabilitar el complemento de Performance Monitoring para las compilaciones de depuración a nivel local si quieres que los tiempos de compilación no sean largos. Sin embargo, no se recomienda este enfoque en las compilaciones de producción, ya que podría provocar mediciones de rendimiento perdidas para las solicitudes de red en tu app.

¿Qué hago si recibo errores de compilación debido a bibliotecas incompatibles con el complemento de Gradle de Performance Monitoring?

Performance Monitoring para Android usa instrumentación de código de bytes para proporcionar algunas funciones incorporadas, como la supervisión de solicitudes de red HTTP/S. Durante la compilación, se deben realizar iteraciones en todas las clases de tu app (incluidas las dependencias) a fin de instrumentar el código fundamental para medir el rendimiento de las solicitudes de red de tu aplicación.

Si recibes errores de compilación, como JSR/RET are not supported with computeFrames option o errores similares después de integrar el complemento de Performance Monitoring, es posible que se deba a que tienes una dependencia de una biblioteca que no es compatible con el complemento de Gradle de Performance Monitoring.

Para solucionarlo, sigue estos pasos a fin de excluir clases o bibliotecas incompatibles de modo que se instrumenten:

1. Actualiza a la versión más reciente del complemento de Gradle de Performance Monitoring (v1.4.0 como mínimo).
2. Actualiza el complemento de Android para Gradle a la versión 7.2.0 o posterior.
3. Agrega la siguiente marca al archivo build.gradle de tu módulo (a nivel de app) para excluir las clases y bibliotecas incompatibles de la instrumentación:

   android {
     // ...
     androidComponents {
       onVariants(selector().all(), {
           instrumentation.excludes.add("example.incompatible.library")
       })
     }
   }

   Para obtener más información sobre la propiedad exclude de la API de Instrumentation del complemento de Android para Gradle, consulta Instrumentación.

Informa un error en GitHub cuando encuentres problemas de compilación debido a bibliotecas incompatibles, a fin de que también se los pueda excluir de la instrumentación del complemento de Performance Monitoring.

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

Si habilitaste la integración de BigQuery para Firebase Performance Monitoring, tus datos se exportarán a BigQuery de 12 a 24 horas después de que termine el 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 corresponden a la hora del Pacífico).

¿Qué significan los datos de rendimiento “casi en tiempo real”?

Firebase Performance Monitoring procesa los datos de rendimiento recopilados a medida que se presentan, lo que permite visualizar los datos casi en tiempo real en Firebase console. Los datos procesados se muestran en la consola unos pocos minutos después de su recopilación (por eso usamos el término “casi en tiempo real”).

Para aprovechar el procesamiento de datos casi en tiempo real, asegúrate de que tu app use una versión del SDK compatible con el tiempo real.

¿Cómo obtengo los datos de rendimiento de mi app casi en tiempo real?

Para aprovechar el procesamiento de datos casi en tiempo real, solo necesitas asegurarte de que la app use una versión del SDK de Performance Monitoring compatible con el procesamiento de datos en tiempo real.

Estas son las versiones del SDK compatibles con los datos en tiempo real:

• iOS: 7.3.0 o versiones posteriores
• tvOS: v8.9.0 o posterior
• Android: v19.0.10 o posterior (o Firebase Android BoM v26.1.0 o posterior)
• Web: v7.14.0 o posterior

Ten en cuenta que siempre recomendamos usar la versión más reciente del SDK, pero cualquier versión mencionada anteriormente permitirá que Performance Monitoring procese tus datos casi en tiempo real.

¿Qué versiones del SDK de Performance Monitoring se consideran compatibles con los datos en tiempo real?

Estas son las versiones del SDK compatibles con el procesamiento de datos en tiempo real:

• iOS: 7.3.0 o versiones posteriores
• tvOS: v8.9.0 o posterior
• Android: v19.0.10 o posterior (o Firebase Android BoM v26.1.0 o posterior)
• Web: v7.14.0 o posterior

Ten en cuenta que siempre recomendamos usar la versión más reciente del SDK, pero cualquier versión mencionada anteriormente permitirá que Performance Monitoring procese tus datos casi en tiempo real.

¿Qué sucede si no actualizo mi app para que use una versión del SDK compatible con los datos en tiempo real?

Si tu app no usa una versión del SDK compatible con los datos en tiempo real, seguirás viendo todos los datos de rendimiento de la app en Firebase console. Sin embargo, la visualización de los datos de rendimiento se retrasará aproximadamente 36 horas desde el momento de su recopilación.

Actualizamos a una versión del SDK compatible con datos en tiempo real, pero algunos de mis usuarios aún usan versiones antiguas de mi app. ¿Seguiré viendo sus datos de rendimiento en Firebase console?

Sí. Independientemente de la versión del SDK que use una instancia de app, verás los datos de rendimiento de todos tus usuarios.

Sin embargo, si buscas datos recientes (menos de 36 horas de antigüedad), los datos que se muestran provienen de usuarios de instancias de la app que usan una versión del SDK compatible en tiempo real. Sin embargo, los datos no recientes incluyen datos de rendimiento de todas las versiones de la app.