获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Comience con la supervisión del rendimiento para Android

Antes de que empieces

Si aún no lo ha hecho, agregue Firebase a su proyecto de Android .

Paso 1 : agregue el SDK de monitoreo de rendimiento a su aplicación

Una vez que haya agregado el SDK de Monitoreo de rendimiento, Firebase comenzará a recopilar automáticamente datos para la visualización de la pantalla de su aplicación y datos relacionados con el ciclo de vida de su aplicación (como la hora de inicio de la aplicación). Para permitir que Firebase supervise las solicitudes de red, también debe agregar el complemento Gradle de supervisión de rendimiento (siguiente paso).

  1. En el archivo Gradle de tu módulo (a nivel de aplicación) (generalmente <project>/<app-module>/build.gradle ), agrega la dependencia para la biblioteca de Android Performance Monitoring. Recomendamos usar Firebase Android BoM para controlar el control de versiones de la biblioteca.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
        // Add the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf'
    }
    

    Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

    (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

    Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

    Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

    dependencies {
        // Add the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf:20.3.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
        // Add the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx'
    }
    

    Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

    (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

    Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

    Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

    dependencies {
        // Add the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx:20.3.0'
    }
    

  2. Vuelva a compilar su aplicación.

Paso 2 : agregue el complemento Gradle de monitoreo de rendimiento a su aplicación

Una vez que hayas agregado el complemento de Gradle de monitoreo de rendimiento, Firebase comenzará a recopilar datos automáticamente para las solicitudes de red HTTP/S . El complemento también le permite instrumentar seguimientos de código personalizados utilizando la anotación @AddTrace .

  1. En su archivo Gradle de nivel raíz (nivel de proyecto) ( <project>/build.gradle ), agregue el complemento Gradle de monitoreo de rendimiento como una dependencia de buildscript:

    buildscript {
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
    
        dependencies {
            ...
            // To benefit from the latest Performance Monitoring plugin features,
            // update your Android Gradle plugin dependency to at least v3.4.0
            classpath 'com.android.tools.build:gradle:7.2.0'
    
            // Make sure that you have the Google services Gradle plugin dependency
            classpath 'com.google.gms:google-services:4.3.14'
    
            // Add the dependency for the Performance Monitoring Gradle plugin
            classpath 'com.google.firebase:perf-plugin:1.4.2'
        }
    }
  2. En el archivo Gradle de tu módulo (nivel de aplicación) (generalmente <project>/<app-module>/build.gradle ), agrega el complemento de Gradle de monitoreo de rendimiento:

    plugins {
        id 'com.android.application'
    
        // Make sure that you have the Google services Gradle plugin
        id 'com.google.gms.google-services'
    
        // Add the Performance Monitoring Gradle plugin
        id 'com.google.firebase.firebase-perf'
        ...
    }
  3. Vuelva a compilar su aplicación.

Paso 3 : generar eventos de rendimiento para la visualización inicial de datos

Firebase comienza a procesar los eventos cuando agrega correctamente el SDK a su aplicación. Si todavía está desarrollando localmente, interactúe con su aplicación para generar eventos para la recopilación y el procesamiento de datos iniciales.

  1. Genere eventos cambiando su aplicación entre el fondo y el primer plano varias veces, interactuando con su aplicación navegando por las pantallas y/o activando solicitudes de red.

  2. Vaya al panel de rendimiento de la consola de Firebase. Debería ver su pantalla de datos inicial dentro de unos minutos.

    Si no ve una pantalla de sus datos iniciales, revise los consejos para la solución de problemas .

Paso 4 : (Opcional) Ver mensajes de registro para eventos de rendimiento

  1. Habilite el registro de depuración para la supervisión del rendimiento en el momento de la compilación agregando un elemento <meta-data> al archivo AndroidManifest.xml de su aplicación, así:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. Verifique sus mensajes de registro para ver si hay mensajes de error.

  3. Performance Monitoring etiqueta sus mensajes de registro con FirebasePerformance . Con el filtrado logcat, puede ver específicamente el seguimiento de la duración y el registro de solicitudes de red HTTP/S ejecutando el siguiente comando:

    adb logcat -s FirebasePerformance
  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 .

Paso 5 : (Opcional) Agregar monitoreo personalizado para código específico

Para monitorear los datos de rendimiento asociados con un código específico en su aplicación, puede instrumentar seguimientos de código personalizados .

Con un seguimiento de código personalizado, puede medir cuánto tiempo le toma a su aplicación completar una tarea específica o un conjunto de tareas, como cargar un conjunto de imágenes o consultar su base de datos. La métrica predeterminada para un seguimiento de código personalizado es su duración, pero también puede agregar métricas personalizadas, como aciertos de caché y advertencias de memoria.

En su código, define el principio y el final de un seguimiento de código personalizado (y agrega las métricas personalizadas deseadas) mediante la API proporcionada por el SDK de Performance Monitoring. Para las aplicaciones de Android, también puede monitorear la duración de métodos específicos usando la anotación @AddTrace .

Visite Agregar monitoreo para código específico para obtener más información sobre estas funciones y cómo agregarlas a su aplicación.

Paso 6 : implemente su aplicación y luego revise los resultados

Una vez que haya validado el Monitoreo del rendimiento con uno o más dispositivos de prueba, puede implementar la versión actualizada de su aplicación para sus usuarios.

Puede monitorear los datos de rendimiento en el panel de rendimiento de Firebase console.

Problemas conocidos

  • El complemento Performance Monitoring Gradle v1.1.0 puede causar una falta de coincidencia en las dependencias de Guava, lo que genera el siguiente error:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    Si ve este error, puede:

    • Actualice el complemento de Monitoreo de rendimiento a v1.1.1 o posterior (el más reciente es v1.4.2).

    • Reemplace la línea de dependencia del complemento de Monitoreo de rendimiento en su archivo Gradle de nivel raíz (nivel de proyecto) ( build.gradle ), de la siguiente manera:

      buildscript {
        // ...
      
        dependencies {
          // ...
      
          // Replace the standard Performance Monitoring plugin dependency line, as follows:
          classpath ('com.google.firebase:perf-plugin:1.1.0') {
                      exclude group: 'com.google.guava', module: 'guava-jdk5'
          }
        }
      }
      
  • Performance Monitoring informa el tamaño total de la carga útil para las solicitudes de red HTTP en función del valor establecido en el encabezado de longitud de contenido HTTP. Es posible que este valor no siempre sea exacto.

  • Performance Monitoring solo admite el proceso principal en aplicaciones de Android multiproceso.

Próximos pasos