Como monitorar dados de desempenho no console

Para ver os dados de desempenho em tempo real, verifique se seu app usa uma versão do SDK do Monitoramento de desempenho compatível com o processamento de dados em tempo real. Saiba mais sobre os dados de desempenho em tempo real.

Acompanhar as principais métricas no painel

Para saber qual é a tendência das suas principais métricas, adicione-as ao seu quadro de métricas na parte superior do painel Desempenho. É possível identificar rapidamente as regressões vendo alterações semanais ou verificar se as mudanças recentes no código estão melhorando o desempenho.

uma imagem do painel de métricas no painel do Monitoramento de desempenho do Firebase

Veja alguns exemplos de tendências que você pode acompanhar:

  • Um aumento no horário de início do app desde que você adicionou uma nova chamada de API de bloqueio à inicialização do app.
  • Uma queda no tamanho do payload de resposta de uma solicitação de rede desde a implementação do redimensionamento de imagens em tamanho original para miniaturas.
  • Uma diminuição na taxa de sucesso da rede de uma chamada de API de terceiros durante uma falha do ecossistema.

Cada membro de um projeto do Firebase pode configurar o próprio painel de métricas. É possível acompanhar as métricas que são importantes para você, enquanto outros membros do projeto podem acompanhar conjuntos completamente diferentes de métricas importantes nos seus próprios quadros.

Para adicionar uma métrica ao quadro, siga as etapas a seguir:

  1. Acesse o painel Desempenho no Console do Firebase.
  2. Clique em um card de métricas vazio e selecione uma métrica atual para adicionar ao quadro.
  3. Clique em um card de métricas preenchido para ver mais opções, como substituir ou remover uma métrica.

O quadro de métricas mostra os dados coletados ao longo do tempo, em forma de gráfico e como uma alteração percentual numérica.

  • Cada card de métricas exibe a alteração percentual no valor da métrica no período selecionado, bem como o valor da métrica coletado mais recentemente. A instrução na parte superior do quadro de métricas é uma interpretação da alteração percentual.
  • Por padrão, o quadro de métricas exibe o valor do 90º percentil da métrica, que se alinha ao Android vitals. Se você quiser visualizar como é a experiência de usuários de diferentes segmentos com seu app, selecione um percentil diferente na lista suspensa na parte superior da página do painel.
  • Se você tem versões diferentes do seu app, é possível ver a tendência do valor da métrica de uma versão comparada a outra e/ou comparada a todas as versões. Selecione as versões nas listas suspensas abaixo do gráfico.

O que significam as cores verde, vermelho e cinza?

A maioria das métricas tem uma direção de tendência desejada. Assim, o quadro de métricas usa cores para mostrar uma interpretação sobre a tendência positiva ou não dos dados da métrica.

Por exemplo, digamos que você esteja acompanhando o horário de início do seu app (um valor que deveria ser baixo). Se esse valor estiver aumentando, o quadro de métricas exibirá a alteração percentual da métrica em vermelho, chamando a atenção para um possível problema. No entanto, se o valor estiver diminuindo ou permanecer inalterado, o quadro de métricas exibirá a porcentagem em verde ou cinza, respectivamente.

Se uma métrica não tiver uma direção de tendência desejada óbvia, como o tamanho do payload da resposta para uma solicitação de rede, o quadro de métricas sempre exibirá a alteração percentual da métrica em cinza, independentemente da tendência dos dados.

O que significam as linhas contínuas e tracejadas?

  • Linha contínua azul-escura: o valor da métrica ao longo do tempo para todas as versões do app.
    Essa linha pode ser considerada o valor de referência do seu app.

  • Linha contínua verde-clara: o valor da métrica ao longo do tempo para uma versão específica do app
    Por padrão, o quadro de métricas exibe dados da versão mais recente. Para exibir uma versão diferente, use a primeira lista suspensa abaixo do gráfico.

  • Linha contínua cinza: o valor da métrica ao longo do tempo para outra versão específica do seu app
    Por padrão, o quadro de métricas não exibe dados para uma segunda versão. Para exibir uma segunda versão, use a segunda lista suspensa abaixo do gráfico.

  • Linha tracejada azul-clara: o valor da métrica para todas as versões em um momento específico no passado
    Por exemplo, se você optar por exibir um gráfico dos últimos sete dias e passar o cursor sobre o dia 30 de agosto, a linha tracejada azul-clara informará o valor da métrica para todas as versões no dia 23 de agosto.



Visualizar traces e os respectivos dados

É possível visualizar todos os traces do seu aplicativo na tabela de traces, na parte inferior do painel Desempenho. A tabela agrupa cada tipo de trace em uma subguia apropriada. Por exemplo, todos os traces de solicitação de rede são listados na subguia Solicitações de rede.

A tabela de traces exibe os valores de algumas métricas principais para cada trace, além da alteração percentual para o valor de cada métrica. Esses valores são calculados com base nas seleções de percentil e intervalo de tempo definidos na parte superior da guia Painel. Veja alguns exemplos:

  • Se você selecionar um percentil de 90% e um período de Últimos sete dias, o valor da métrica será o 90º percentil de dados coletados do dia mais recente, e a alteração percentual será a mudança desde sete dias antes.
  • Em seguida, se você alterar o período para Últimas 24 horas, o valor da métrica será a mediana dos dados coletados na hora mais recente, e a alteração percentual será a mudança desde 24 horas antes.

É possível classificar a lista de traces em cada subguia pelo valor da métrica ou pela alteração percentual para uma métrica específica. Isso pode ajudar você a identificar rapidamente possíveis problemas no seu app.

Para visualizar todas as métricas e os dados de um trace específico, clique no nome do trace na tabela de traces. Veja mais detalhes nas seções a seguir.

Visualizar mais dados de um trace específico

No Console do Firebase, o Monitoramento de desempenho disponibiliza uma página de solução de problemas que destaca mudanças de métricas. Ela facilita a resolução de problemas de desempenho e reduz o impacto deles nos apps e para os usuários. Use essa página ao se deparar com possíveis problemas de desempenho, como os apresentados nos cenários a seguir:

  • Você seleciona métricas relevantes no painel e nota um grande delta.
  • Na tabela de traces, você define uma classificação para mostrar os maiores deltas na parte de cima e vê uma alteração de porcentagem significativa.
  • Você recebe um alerta por e-mail sobre um problema de desempenho.

Para acessar a página de solução de problemas, você tem as opções a seguir:

  • No painel de métricas, clique no botão Visualizar detalhes da métrica.
  • Em qualquer card de métricas, selecione => Ver detalhes. A página de solução de problemas mostra informações sobre a métrica selecionada.
  • Na tabela de traces, clique no nome de algum deles ou em um valor de métrica na linha associada a esse trace.
  • Em um alerta por e-mail, clique em Investigar agora.

Ao clicar em um nome na tabela de traces, é possível mostrar os detalhes das métricas de interesse. Clique no botão Filtrar para filtrar os dados por atributo, por exemplo:

uma imagem dos dados do Monitoramento de desempenho do Firebase sendo filtrados por atributos
  • Filtre por Versão do app para visualizar dados de uma versão anterior ou da versão mais recente.
  • Filtre por Dispositivo para saber como os dispositivos mais antigos lidam com o app.
  • Filtrar por País para garantir que o local do banco de dados não está afetando uma região específica.

Visualizar todas as métricas coletadas de um trace

Ao clicar em um trace, é possível mostrar os detalhes das métricas de interesse:

  • Traces de solicitação de rede: as guias de métricas disponíveis são tempo de resposta, tamanho do payload da resposta, tamanho do payload da solicitação e taxa de sucesso.
  • Traces de início do app, app em primeiro plano, app em segundo plano e de código personalizados: a guia de métricas Duração está sempre disponível (a métrica padrão dessas tipos de traces). Em relação aos traces de código personalizados, se você adicionou métricas personalizadas aos traces, essas guias de métricas também são mostradas.
  • Traces de renderização de tela: as guias de métricas disponíveis são Renderização lenta e Frames congelados.

Veja um resumo do desempenho da métrica selecionada logo abaixo das guias. Isso inclui uma visão geral do tamanho de uma frase sobre a tendência da métrica ao longo do tempo e um gráfico para visualizar a distribuição dos dados em todo o período selecionado.

uma imagem do detalhamento dos códigos de erro do Monitoramento de desempenho do Firebase

Por exemplo, se a métrica selecionada for taxa de sucesso da rede, o gráfico vai mostrar um detalhamento de todos os códigos de erro e as porcentagens deles entre todas as respostas de erro, incluindo os códigos de erro excluídos no Console do Firebase.

Visualizar informações detalhadas sobre os dados

É possível filtrar e segmentar os dados por atributo ou clicar para visualizá-los no contexto de uma sessão de uso de app.

Por exemplo, para entender por que o tempo de resposta recente da rede está lento e se um país está afetando o desempenho, siga as etapas a seguir:

  1. Selecione País na lista suspensa de atributos.
  2. Na tabela, classifique pelo valor mais recente para ver os países que têm o maior impacto nos tempos de resposta de rede.
  3. Selecione os países com os valores mais recentes para colocá-los no gráfico. Em seguida, passe o cursor sobre a linha do tempo no gráfico para saber quando os tempos de resposta da rede diminuíram nesses países.
  4. Para investigar as causas principais dos problemas de tempo de resposta de rede em países específicos, adicione filtros e continue investigando outros atributos, como tipos de rádio e dispositivos.



Ver mais detalhes sobre sessões dos usuários

O Monitoramento de desempenho também fornece relatórios de sessões de usuários, que são períodos em que o app está em primeiro plano. Esses relatórios são associados a um trace específico e apresentam um trace em um contexto de cronograma de outros traces coletados pelo Monitoramento de desempenho durante essa mesma sessão.

Por exemplo, é possível ver seus traces de código personalizados alinhados na ordem em que eles foram iniciados (com as durações individuais), além de todos os traces de solicitação de rede que estavam acontecendo ao mesmo tempo.

O console exibe amostragens aleatórias dessas sessões de usuário. Elas estão disponíveis para apps para Apple e Android e para todos os tipos de traces, exceto os traces de renderização de tela.

Veja outros dados possíveis de visualizar sobre uma sessão de usuário:

uma imagem da página de sessões do monitoramento de desempenho do Firebase
  • Informações sobre o trace: informações detalhadas sobre o trace dessa sessão, incluindo horário de início, horário de término, atributos (como dispositivo e país) e quaisquer métricas aplicáveis a esse tipo de trace (por exemplo, duração de um trace de código personalizado ou tempo de resposta para um trace de solicitação de rede).
  • CPU: quanto tempo do usuário e do sistema o app consumiu durante a sessão.
  • Memória: a quantidade de memória heap que o app usou durante a sessão.

Como visualizar os dados das sessões

  1. Acesse o painel Desempenho no Console do Firebase, role a tela para baixo até a tabela de traces e clique na subguia apropriada para o trace de interesse.
  2. Clique no nome do trace na tabela para ver todas as métricas disponíveis.
  3. Para visualizar os dados de sessões do trace especificado, clique em Ver todas as sessões.
  4. Para ver as sessões associadas a um valor de atributo da métrica selecionada, passe o cursor sobre a linha desejada e clique no texto Sessões, que aparece na coluna mais à direita dessa linha.
uma imagem do trace do Monitoramento de desempenho do Firebase com um link para as sessões

Filtrar sessões por percentil

As sessões são distribuídas em percentis para cada métrica. As sessões em percentis menores têm métricas com valores mais baixos do que as sessões em percentis mais altos.

Para filtrar as sessões disponíveis por percentil, use a lista suspensa de percentis acima dos detalhes das sessões ou arraste as alças do gráfico.

uma imagem da página de sessões do monitoramento de desempenho do Firebase