Comece com o monitoramento de desempenho para Flutter

Este guia de início rápido descreve como configurar o Firebase Performance Monitoring para ajudar você a obter insights sobre as características de desempenho dos seus aplicativos Flutter.

Antes de você começar

Se ainda não o fez, configure e inicialize o Firebase em seu projeto Flutter.

Etapa 1 : adicione o monitoramento de desempenho ao seu aplicativo

  1. No diretório raiz do seu projeto Flutter, execute o seguinte comando para instalar o plugin Performance Monitoring Flutter:

    flutter pub add firebase_performance

  2. No diretório raiz do seu projeto Flutter, execute o seguinte comando:

    flutterfire configure

    A execução deste comando garante que a configuração do Firebase do seu aplicativo Flutter esteja atualizada e, para Android, adiciona o plug-in Gradle de monitoramento de desempenho necessário ao seu aplicativo.

  3. Depois de concluído, reconstrua seu projeto Flutter:

    flutter run

Depois de adicionar o SDK do Monitoramento de desempenho, o Firebase começa a coletar automaticamente dados relacionados ao ciclo de vida do seu aplicativo (como horário de início do aplicativo ) e dados para solicitações de rede HTTP/S .

No Flutter, o monitoramento automático do desempenho da renderização de tela não é possível para telas individuais do Flutter. Um único controlador de visualização encapsula todo o seu aplicativo Flutter nativamente, de modo que o SDK nativo do Firebase subjacente não reconhece as transições de tela.

Etapa 2 : gerar eventos de desempenho para exibição inicial de dados

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.

  1. Continue desenvolvendo seu aplicativo usando um simulador ou dispositivo de teste.

  2. Gere eventos alternando seu aplicativo entre segundo plano e primeiro plano várias vezes, interagindo com seu aplicativo navegando pelas telas e/ou acionando solicitações de rede.

  3. Acesse o painel Desempenho do console do Firebase. Você deverá ver a exibição inicial dos dados em alguns minutos.

    Se você não vir seus dados iniciais, revise as dicas de solução de problemas .

Etapa 3 : (opcional) visualizar mensagens de log para eventos de desempenho

  1. Verifique suas mensagens de log em busca de mensagens de erro.

    O Monitoramento de Desempenho marca suas mensagens de log com as tags a seguir para que você possa filtrar suas mensagens de log:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

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

  3. Clique no URL para visualizar seus dados no console do Firebase. Pode levar alguns instantes para que os dados sejam atualizados no painel.

Etapa 4 : (opcional) adicionar monitoramento personalizado para código específico

Para monitorar os dados de desempenho associados a um código específico no seu aplicativo, você pode instrumentar rastreamentos de código personalizados .

Com um rastreamento de código personalizado, você pode medir quanto tempo leva para seu aplicativo 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 ocorrências de cache e avisos de memória.

No 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 do Performance Monitoring.

Visite Adicionar monitoramento para código específico para saber mais sobre esses recursos e como adicioná-los ao seu aplicativo.

Etapa 5 : implantar seu aplicativo e analisar os resultados

Depois de validar o Monitoramento de Desempenho usando um emulador e um ou mais dispositivos de teste, você poderá implantar a versão atualizada do seu aplicativo para seus usuários.

Você pode monitorar os dados de desempenho no painel Desempenho do console do Firebase.

Próximos passos