Preguntas frecuentes y solución de problemas de Performance Monitoring

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

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

   1. En Xcode (v12.2 como mínimo), selecciona Product > Scheme > Edit scheme.
   2. Selecciona Run en el menú de la izquierda y, luego, haz clic en la pestaña Arguments.
   3. En la sección Arguments Passed on Launch, agrega -FIRDebugEnabled.

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

3. Performance Monitoring etiqueta los mensajes de registro con Firebase/Performance para que puedas filtrarlos.

4. Verifica los siguientes tipos de registros que indican que Performance Monitoring registra los 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, dentro 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 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. Asegúrate de que el SDK de Performance Monitoring no se inhabilite mediante alguna de las siguientes funciones en el archivo Info.plist:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Asegúrate de que Performance Monitoring no se inhabilite durante el tiempo de ejecución (Swift | Obj-C).

3. 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 utilizar la versión más reciente del SDK de iOS (8.2.0). Los seguimientos de renderización de pantalla solo están disponibles en la versión 5.0.0 o posterior.

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

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. Verifica la configuración de los seguimientos de código personalizados que se instrumentaron con la API de Trace 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. Revisa los mensajes de registro para asegurarte de que Performance Monitoring registre los seguimientos de código personalizados esperados.

3. 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 Rendimiento

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

1. Verifica si hay bibliotecas de red no compatibles. Performance Monitoring recopila automáticamente métricas de las solicitudes de red en las que se usan las siguientes bibliotecas de red:

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

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

2. 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.

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

Obtén más información sobre cómo Performance Monitoring agrega datos de solicitudes de red en los patrones de URL.

También puedes probar los patrones de URL personalizados.

Cuando hago clic en las pestañas En el dispositivo o Red en la consola, se me dirige automáticamente a la parte inferior de la pestaña Panel. ¿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.

Pronto eliminaremos las pestañas En el dispositivo y Red. Por el momento, cuando haces clic en ellas, te llevamos al lugar nuevo, la tabla de seguimientos, que se encuentra en la parte inferior de la pestaña Panel.

La tabla de seguimientos incluye la misma información que mostraban las pestañas En el dispositivo y Red, pero con algunas funciones adicionales, como 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 ver las métricas y los datos, visita la página de descripción general de la consola (iOS | Android | Web).

Ten en cuenta que todavía puedes navegar a las pestañas En el dispositivo y Red haciendo clic en el nombre de un seguimiento en la tabla correspondiente (lo que te lleva a la página Métricas del seguimiento) y, luego, seleccionando la ruta de navegación de la parte superior de la pantalla.

Mis datos de Performance Monitoring tardan 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 casi en tiempo real de mi app?

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: v7.3.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: v7.3.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.