Primeros pasos con Performance Monitoring para iOS

Antes de comenzar

Si aún no lo has hecho, agrega Firebase a tu proyecto de iOS.

Paso 1: Agrega Performance Monitoring a la app

  1. Abre el Podfile que creaste para el proyecto (o ejecuta pod init a fin de crear uno) y, luego, agrega la siguiente línea en la sección de destino:

    pod 'Firebase/Performance'
  2. En el directorio del Podfile, ejecuta el siguiente comando para instalar el SDK de Performance Monitoring:

    pod install
  3. Abre el archivo .xcworkspace con Xcode.

  4. Importa el módulo de Firebase en UIApplicationDelegate:

    Swift

    import Firebase

    Objective‑C

    @import Firebase;
  5. Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu app:

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective‑C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. Vuelve a compilar la app.

Firebase ahora supervisa los seguimientos de duración automáticos y las solicitudes de red HTTP/S automáticas.

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

Firebase puede detectar si agregaste correctamente el SDK a tu app cuando recibe información de eventos (como las interacciones de la app). Si todavía desarrollas de manera local, interactúa con la app para generar eventos a fin de detectar el SDK y realizar una recopilación y procesamiento iniciales de los datos.

  1. Sigue desarrollando la app con un simulador 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, interactúas con la app mediante la navegación por las pantallas o activas solicitudes de red.

  3. Ve a la sección Rendimiento de Firebase console para ver si Firebase detectó el SDK.

    Si no ves el mensaje “SDK detectado”, revisa las sugerencias para solucionar problemas.

  4. Performance Monitoring procesa los datos de eventos de rendimiento antes de mostrarlos en el panel Rendimiento. Deberías ver los datos iniciales en un plazo de 24 horas después de ver el mensaje de detección del SDK.

    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. Habilita el registro de depuración de la siguiente manera:

    1. En Xcode (v10.3 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
    • Logging network request trace: URL

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

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

Puedes crear seguimientos personalizados para supervisar los datos de rendimiento asociados con código específico de tu app.

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

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

Visita Agrega supervisión personalizada para código específico de tu app a fin de obtener más información sobre estas funciones y descubrir cómo agregarlas a tu app.

Paso 5: Implementa tu app y revisa los resultados

Una vez que hayas validado Performance Monitoring con el simulador de Xcode 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.

Problemas conocidos

  • Performance Monitoring tiene problemas de compatibilidad conocidos con GTMSQLite. Recomendamos no emplear Performance Monitoring con apps que usan GTMSQLite.
  • Es posible que las referencias a métodos después de llamar a FirebaseApp.configure() interfieran en el SDK de Performance Monitoring.
  • Los problemas conocidos del Simulador de iOS entre las versiones 8.0 y 8.2 impiden que Performance Monitoring capture eventos de rendimiento. Estos problemas se corrigieron en el Simulador de iOS 8.3 y en las versiones posteriores.
  • Las conexiones establecidas con backgroundSessionConfiguration de NSURLSession tendrán tiempos de conexión más largos de lo esperado. Estas conexiones se ejecutan fuera del proceso, y los tiempos reflejan los eventos de devolución de llamada en curso.

Pasos siguientes