Antes de você começar
Se ainda não o fez, adicione o Firebase ao seu projeto Android .
Etapa 1 : adicionar o SDK de monitoramento de desempenho ao seu aplicativo
Depois de adicionar o SDK de monitoramento de desempenho, o Firebase começa automaticamente a coletar dados para a renderização da tela do seu aplicativo e dados relacionados ao ciclo de vida do seu aplicativo (como hora de início do aplicativo ). Para permitir que o Firebase monitore as solicitações de rede, você também deve adicionar o plug-in Gradle de monitoramento de desempenho (próxima etapa).
No arquivo Gradle do módulo (nível do aplicativo) (geralmente
<project>/<app-module>/build.gradle
), adicione a dependência para a biblioteca Android do Monitoramento de desempenho. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.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' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.
Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
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.1' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.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' }
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.
Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
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.1' }
Recompile seu aplicativo.
Etapa 2 : adicione o plug-in Gradle de monitoramento de desempenho ao seu aplicativo
Depois de adicionar o plug-in Gradle de monitoramento de desempenho, o Firebase começa a coletar dados automaticamente para solicitações de rede HTTP/S . O plug-in também permite instrumentar rastreamentos de código personalizados usando a anotação @AddTrace .
Em seu arquivo Gradle de nível raiz (nível de projeto) (
<project>/build.gradle
), adicione o plug-in Gradle de monitoramento de desempenho como uma dependência 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.15' // Add the dependency for the Performance Monitoring Gradle plugin classpath 'com.google.firebase:perf-plugin:1.4.2' } }
No arquivo Gradle do módulo (nível do aplicativo) (geralmente
<project>/<app-module>/build.gradle
), adicione o plug-in Gradle de monitoramento de desempenho: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' ... }
Recompile seu aplicativo.
Etapa 3 : Gerar eventos de desempenho para exibição de dados inicial
O Firebase começa a processar os eventos quando você adiciona o SDK ao seu aplicativo. Se você ainda estiver desenvolvendo localmente, interaja com seu aplicativo para gerar eventos para coleta e processamento inicial de dados.
Gere eventos alternando seu aplicativo entre o plano de fundo e o primeiro plano várias vezes, interagindo com seu aplicativo navegando pelas telas e/ou acionando solicitações de rede.
Acesse o painel de desempenho do console do Firebase. Você deve ver sua exibição de dados inicial em alguns minutos.
Se você não vir uma exibição de seus dados iniciais, revise as dicas de solução de problemas.
Etapa 4 : (Opcional) Exibir mensagens de log para eventos de desempenho
Habilite o log de depuração para monitoramento de desempenho no momento da compilação adicionando um elemento
<meta-data>
ao arquivoAndroidManifest.xml
do seu aplicativo, da seguinte forma:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
Verifique suas mensagens de log para quaisquer mensagens de erro.
O Monitoramento de desempenho marca suas mensagens de log com
FirebasePerformance
. Usando a filtragem logcat, você pode visualizar especificamente o rastreamento de duração e o registro de solicitação de rede HTTP/S executando o seguinte comando:adb logcat -s FirebasePerformance
Verifique os seguintes tipos de logs que indicam que o monitoramento de desempenho está registrando eventos de desempenho:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
Clique no URL para visualizar seus dados no console do Firebase. Pode levar alguns instantes para que os dados sejam atualizados no painel.
Se seu aplicativo não estiver registrando eventos de desempenho, revise as dicas de solução de problemas.
Etapa 5 : (opcional) adicionar monitoramento personalizado para código específico
Para monitorar os dados de desempenho associados a um código específico em seu aplicativo, você pode instrumentar rastreamentos de código personalizados .
Com um rastreamento de código personalizado, você pode medir quanto tempo seu aplicativo leva para concluir uma tarefa específica ou um conjunto de tarefas, como carregar um conjunto de imagens ou consultar seu banco de dados. A métrica padrão para um rastreamento de código personalizado é sua duração, mas você também pode adicionar métricas personalizadas, como acertos de cache e avisos de memória.
Em seu código, você define o início e o fim de um rastreamento de código personalizado (e adiciona quaisquer métricas personalizadas desejadas) usando a API fornecida pelo SDK de monitoramento de desempenho. Para aplicativos Android, você também pode monitorar a duração de métodos específicos usando a anotação @AddTrace .
Visite Adicionar monitoramento para código específico para saber mais sobre esses recursos e como adicioná-los ao seu aplicativo.
Etapa 6 : implante seu aplicativo e analise os resultados
Depois de validar o Monitoramento de desempenho usando um ou mais dispositivos de teste, você pode implantar a versão atualizada de seu aplicativo para seus usuários.
Você pode monitorar os dados de desempenho no painel de desempenho do Firebase console.
Problemas conhecidos
O plug-in Gradle de monitoramento de desempenho v1.1.0 pode causar uma incompatibilidade nas dependências do Guava, resultando no seguinte erro:
Error:Execution failed for task ':app:packageInstantRunResourcesDebug'. > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
Se você vir esse erro, você pode:
Atualize o plug-in de monitoramento de desempenho para v1.1.1 ou posterior (o mais recente é v1.4.2).
Substitua a linha de dependência do plug-in Monitoramento de desempenho em seu arquivo Gradle de nível raiz (nível de projeto) (
build.gradle
), da seguinte maneira: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' } } }
O Monitoramento de desempenho relata o tamanho total da carga útil para solicitações de rede HTTP com base no valor definido no cabeçalho de tamanho do conteúdo HTTP. Esse valor pode nem sempre ser preciso.
O monitoramento de desempenho oferece suporte apenas ao processo principal em aplicativos Android de vários processos.
Próximos passos
Revise e execute o exemplo de código do Monitoramento de desempenho do Android no GitHub .
Saiba mais sobre os dados coletados automaticamente pelo monitoramento de desempenho:
- Dados relacionados ao ciclo de vida do seu app, como hora de início do app
- Dados para renderização de tela em seu aplicativo
- Dados para solicitações de rede HTTP/S emitidas pelo seu app
Visualize, rastreie e filtre seus dados de desempenho no console do Firebase.
Adicione monitoramento para tarefas ou fluxos de trabalho específicos em seu aplicativo, instrumentando rastreamentos de código personalizados .