Introdução ao Monitoramento de desempenho para Flutter

Neste guia de início rápido, descrevemos como configurar o Monitoramento de desempenho do Firebase para que você possa ter insights sobre as características de desempenho dos apps do Flutter.

Antes de começar

Configure e inicialize o Firebase no seu projeto criado com o Flutter, caso ainda não tenha feito isso.

Etapa 1: adicionar o Monitoramento de desempenho ao seu app

1. No diretório raiz do projeto do 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 projeto do Flutter, execute o seguinte comando:

   flutterfire configure
   

   A execução desse comando garante que a configuração do Firebase do seu app criado com o Flutter está atualizada e, para Android, adiciona o plug-in do Gradle do Monitoramento de desempenho necessário ao seu app.

3. Após a conclusão, recrie seu projeto do Flutter:

   flutter run
   

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

No flutter, o monitoramento automático de desempenho da renderização de tela não está disponível para telas individuais do serviço. Um único controlador de visualização encapsula todo o aplicativo do Flutter de forma nativa. Assim, o SDK nativo do Firebase não reconhece as transições de tela.

Observação: ao adicionar o Monitoramento de desempenho ao seu app, o SDK da Configuração remota é incluído como dependência. Se você já usa esse recurso, não verá nenhuma diferença. Mas se ainda não conhece a Configuração remota, consulte a documentação dela para saber mais sobre os vários recursos que você poderá acessar no seu app.

Etapa 2: gerar eventos de desempenho para a 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 de dados iniciais.

Observação: o SDK do Monitoramento de desempenho agrupa os eventos localmente e os envia ao Firebase a cada 30 segundos ou quando o app volta para o primeiro plano. Portanto, há um atraso entre uma interação do app e quando o Firebase recebe as informações de evento do aplicativo.

1. Continue desenvolvendo o app usando um simulador ou dispositivo de teste.

2. Gere eventos alternando o app entre o plano de fundo e o primeiro plano várias vezes. Interaja com o app navegando pelas telas e/ou acionando solicitações de rede.

3. Acesse o painel Desempenho do Console do Firebase. Você verá sua exibição de dados inicial em alguns minutos.

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

Etapa 3: (opcional) ver se há eventos de desempenho nas mensagens de registro

1. Verifique se há mensagens de erro nas mensagens de registro.

   O Monitoramento de desempenho marca as mensagens de registro com as seguintes tags para que você possa filtrá-las:

   • iOS+: Firebase/Performance
   • Android: FirebasePerformance

2. Verifique os seguintes tipos de registro 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 ver seus dados no Console do Firebase. Pode levar alguns instantes até 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 app, instrumente traces de código personalizados.

Com um trace de código personalizado, é possível avaliar quanto tempo o app 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 de um trace de código personalizado é a duração, mas também é possível adicionar métricas personalizadas, como ocorrências em cache e avisos de memória.

No seu código, você define o início e o fim de um trace de código personalizado (e adiciona a métrica personalizada que quiser) usando a API fornecida pelo SDK do Monitoramento de desempenho.

Acesse Adicionar monitoramento para códigos específicos para saber mais sobre esses recursos e como adicioná-los ao seu app.

Etapa 5: implantar seu app e analisar os resultados

Depois de validar o Monitoramento de desempenho usando um emulador, além de um ou mais dispositivos de teste, vai ser possível implantar a versão atualizada do seu app para os usuários.

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

Próximas etapas

• Saiba mais sobre os dados coletados automaticamente pelo Monitoramento de desempenho:

  • Dados relacionados ao ciclo de vida do app, como o horário de início.
  • Dados para solicitações de rede HTTP/S emitidos pelo app.

• Visualize, acompanhe e filtre os dados de desempenho no Console do Firebase.

• Adicione o monitoramento para tarefas ou fluxos de trabalho específicos no app instrumentando traces de código personalizados.

• Use atributos para filtrar dados de desempenho.