Primeros pasos con Performance Monitoring para Flutter

En esta guía de inicio rápido, se describe cómo configurar Firebase Performance Monitoring para ayudarte a obtener estadísticas sobre las características de rendimiento de tus apps de Flutter.

Antes de comenzar

Si aún no lo has hecho, configura e inicializa Firebase en tu proyecto de Flutter.

Paso 1: Agrega Performance Monitoring a la app

  1. Desde el directorio raíz de tu proyecto de Flutter, ejecuta el siguiente comando para instalar el complemento de Performance Monitoring para Flutter:

    flutter pub add firebase_performance
    
  2. En el directorio raíz de tu proyecto de Flutter, ejecuta el siguiente comando:

    flutterfire configure
    

    Ejecutar el comando garantiza que la configuración de Firebase de tu app de Flutter esté actualizada y, en el caso de Android, agrega el complemento de Gradle de Performance Monitoring necesario a tu app.

  3. Cuando termines, vuelve a crear el proyecto de Flutter:

    flutter run
    

Una vez que agregues el SDK de Performance Monitoring, Firebase comienza a recopilar automáticamente datos relacionados con el ciclo de vida de la app (como la hora de inicio) y datos para solicitudes de red de HTTP/S.

En Flutter, no se puede supervisar automáticamente el rendimiento del procesamiento de pantalla en pantallas individuales de Flutter. Un solo controlador de vista encapsula tu app de Flutter completa de forma nativa para que el SDK nativo de Firebase subyacente no reconozca las transiciones de pantalla.

Paso 2: Genera eventos de rendimiento para obtener una visualización inicial de los datos

Firebase comienza a procesar los eventos cuando agregas correctamente el SDK a tu app. Si aún estás desarrollando de manera local, interactúa con la app a fin de generar eventos para la recopilación y el procesamiento de datos iniciales.

  1. Sigue desarrollando la app con un emulador o un dispositivo de prueba.

  2. Puedes generar eventos si alternas varias veces la ejecución de la app entre el primer y segundo plano, si interactúas con la app mediante la navegación por las pantallas o si activas solicitudes de red.

  3. Ve al panel Rendimiento de Firebase console. Deberías ver tus datos iniciales en pocos minutos.

    Si no ves los datos iniciales, revisa las sugerencias para solucionar problemas.

Paso 3: Revisa los mensajes de registro de los eventos de rendimiento (opcional)

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

    Performance Monitoring marca sus mensajes de registro con las siguientes etiquetas para que puedas filtrarlos:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance
  2. 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
  3. Haz clic en la URL para ver tus datos en Firebase console. Los datos pueden tardar unos minutos en actualizarse en el panel.

Paso 4: Agrega supervisión personalizada para código específico (opcional)

Para supervisar los datos de rendimiento asociados con una parte específica del código de tu app, puedes instrumentar seguimientos de código personalizados.

Con un seguimiento de código personalizado, puedes medir cuánto tiempo tarda la app en completar una tarea o un conjunto de tareas en específico, como cargar un conjunto de imágenes o consultar la base de datos. La métrica predeterminada de un seguimiento de código personalizado es su duración, pero también puedes agregar métricas personalizadas, como aciertos de caché y advertencias de memoria.

En el código, tú defines el inicio y el final de un seguimiento de código personalizado (y agregas cualquier métrica personalizada que desees) con la API que proporciona el SDK de Performance Monitoring.

Consulta cómo agregar supervisión personalizada para código específico si necesitas más información sobre estas funciones y cómo agregarlas a tu app.

Paso 5: Implementa tu app y revisa los resultados

Una vez que hayas validado Performance Monitoring con un emulador y uno o más dispositivos de prueba, puedes implementar la versión actualizada de la app para los usuarios.

Puedes supervisar los datos de rendimiento en el panel Rendimiento de Firebase console.

Próximos pasos