Comece com o Monitoramento de desempenho para Flutter

Este 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 : adicionar o monitoramento de desempenho ao seu aplicativo

  1. No diretório raiz do seu projeto Flutter, execute o seguinte comando para instalar o plug-in do Flutter de monitoramento de desempenho:

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

    flutterfire configure
    

    A execução desse 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 hora de início do aplicativo ) e dados para solicitações de rede HTTP/S .

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

Etapa 2 : 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 de dados iniciais.

  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 sua exibição de dados inicial em alguns minutos.

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

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

  1. Verifique suas mensagens de log para quaisquer mensagens de erro.

    O Monitoramento de Desempenho marca suas mensagens de log com as seguintes tags 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 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 as métricas personalizadas desejadas) usando a API fornecida pelo SDK do Monitoramento de desempenho.

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

Etapa 5 : implante seu aplicativo e analise os resultados

Depois de validar o Monitoramento de desempenho usando um emulador e um ou mais dispositivos de teste, você pode 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