Monitore a estabilidade da versão mais recente do seu app

O lançamento de uma nova versão do app para dispositivos móveis para produção é uma das partes mais empolgantes do desenvolvimento de apps, mas também pode ser uma das mais estressantes. Sua equipe precisa acompanhar a adoção da versão, novos bugs e o impacto deles, uma comparação com versões anteriores e muito mais.

Esta página descreve várias ferramentas oferecidas pelo Firebase para monitorar os dados necessários para se sentir confiante sobre o lançamento do app para dispositivos móveis.

Use o painel Monitoramento de lançamentos para analisar os dados relacionados à versão.

O painel Monitoramento de lançamentos no console Firebase é fornecido pelo Firebase Crashlytics. É um único painel para monitorar a versão de produção mais recente. O painel é atualizado quase em tempo real e oferece uma visão de alto nível das métricas de lançamento mais importantes, incluindo métricas sem falhas, captação de versões, comparações com versões anteriores e quaisquer novos problemas da versão.

Esse novo painel melhora a página Versão mais recente no console. Em comparação com essa página, o painel Monitoramento da versão adiciona mais informações, exibe dados úteis sem a necessidade do Google Analytics e carrega mais rapidamente.

Importante: antes de tentar usar o painel, recomendamos consultar as perguntas frequentes "Quais builds posso ver no painel Monitoramento de lançamentos?". Em particular, verifique se o app usa pelo menos as seguintes versões do SDK do Crashlytics:
Plataformas da Apple: v10.8.0+ | Android: v18.6.0+ (BoM v32.6.0+) | Flutter: v3.4.5+ | Unity: 11.7.0+

Recursos do painel

• Relatórios em tempo real
  Todos os gráficos são atualizados quase em tempo real. Logo após implantar a versão mais recente, você poderá observar os usuários interagindo com essa versão. Se alguns desses usuários apresentarem falhas, você vai saber o impacto imediatamente nos gráficos de métricas sem falhas.

• Comparação e comparação de mercado com base em versões anteriores
  É possível conferir a estabilidade da versão mais recente no contexto das versões anteriores. O painel permite comparar as métricas em tempo real da versão mais recente e até dois builds lançados anteriormente.

• Principais problemas novos
  É possível conferir as novas falhas da versão mais recente à medida que elas chegam. Na tabela Principais problemas novos, é possível monitorar o impacto dos problemas detectados pela primeira vez na versão mais recente. Assim, você pode decidir rapidamente se interrompe ou desfaz a versão.

Requisitos para o painel

Para conferir a versão mais recente no painel Monitoramento de lançamentos, faça o seguinte:

1. Confira se o app usa pelo menos as seguintes versões do SDK do Crashlytics:
   Plataformas da Apple: v10.8.0+ | Android: v18.6.0+ (BoM v32.6.0+) | Flutter: v3.4.5+ | Unity: 11.7.0+

2. Publique uma nova versão do app para produção para ter um número suficiente de usuários engajados com a versão mais recente.

Perguntas frequentes sobre o painel

Quais são as versões do SDK necessárias para usar o painel Monitoramento da versão?

Para que um build apareça no painel, ele precisa usar pelo menos as seguintes versões do SDK do Crashlytics:
Plataformas da Apple: v10.8.0+ | Android: v18.6.0+ (BoM v32.6.0+) | Flutter: v3.4.5+ | Unity: 11.7.0+

Essas versões do SDK costumam ser chamadas de versões "com suporte a sessões", porque podem enviar dados de sessões para o Crashlytics, o que é necessário para muitos dos novos recursos do Crashlytics, como o painel Release Monitoring.

Por que o painel Release Monitoring mostra a mensagem "Aguardando mais usuários interagirem"?

Para que um build apareça no painel, ele precisa atender a todos os requisitos a seguir:

• O build usa pelo menos as seguintes versões do SDK Crashlytics:
  Plataformas da Apple: v10.8.0+ | Android: v18.6.0+ (BoM v32.6.0+) | Flutter: v3.4.5+ | Unity: 11.7.0+

• O build tem um número suficiente de usuários nos últimos três dias:

  • O build precisa ter pelo menos 500 usuários únicos OU

  • O build tem pelo menos 1% do total de usuários e tem pelo menos dois usuários únicos.

Quais builds podem ser visualizados no painel Release Monitoring?

O painel Monitoramento de lançamentos tem como objetivo ajudar você com as versões de produção, ou seja, builds que têm um número significativo de usuários.

Para que um build apareça no painel, ele precisa atender a todos os requisitos a seguir:

• O build usa pelo menos as seguintes versões do SDK Crashlytics:
  Plataformas da Apple: v10.8.0+ | Android: v18.6.0+ (BoM v32.6.0+) | Flutter: v3.4.5+ | Unity: 11.7.0+

• O build tem um número suficiente de usuários nos últimos três dias:

  • O build precisa ter pelo menos 500 usuários únicos OU

  • O build tem pelo menos 1% do total de usuários e tem pelo menos dois usuários únicos.

(Para apps distribuídos pelo Google Play) Se um app tiver um link Google Play, o painel vai mostrar todos os builds listados na faixa de produção Play, mesmo que o Crashlytics não tenha recebido nenhum registro de sessões ou detectado usuários ativos para esse build.

Para visualizar dados no painel de comparações ou porcentagem de usuários ativos, é preciso ter lançado pelo menos dois builds que atendam aos requisitos anteriores.

Como os valores mostrados no gráfico Usuários ativos são determinados ou calculados?

Primeiro, é útil entender algumas das terminologias envolvidas no gráfico Usuários ativos:

• Uma sessão é um período contínuo em que um usuário está engajado com um aplicativo. Uma nova sessão começa quando o app é inicializado a frio ou fica em primeiro plano após pelo menos 30 minutos em segundo plano.

• Os usuários ativos de um build específico são o número de usuários que iniciaram uma sessão usando esse build, agrupados por hora.

• Total de usuários (ativos) é o número de usuários que iniciaram uma sessão em qualquer build do app que usa uma versão do SDK compatível com sessões, agrupados por hora.

No gráfico Usuários ativos, o valor percentual e a contagem de usuários ativos que sempre aparecem no gráfico são dos últimos 60 minutos (ou, se não houveram usuários ativos nos últimos 60 minutos, do período da última hora que teve dados). Por exemplo, na captura de tela de exemplo, havia 90 usuários ativos para o build 6.0.0 (600) nos últimos 60 minutos, o que representa 22,1% do total de usuários (ativos) do app.

Quando você passa o mouse sobre as linhas no gráfico Usuários ativos, a porcentagem de usuários ativos é calculada com base na contagem de usuários ativos do período de uma hora em que você está passando o cursor.

Para conferir a porcentagem de usuários ativos, é necessário ter lançado pelo menos dois builds que atendam aos requisitos descritos na seção de perguntas frequentes "Quais builds podem ser visualizados no painel Monitoramento de lançamentos?".

Por que a porcentagem de usuários ativos está em 0%?

A porcentagem de usuários ativos é baseada nos dados da sessão recebidos, e não em outros dados, como dados do Google Play ou relatórios de erros.

Por que não vejo as comparações e/ou a porcentagem de usuários ativos?

Se esta for a primeira vez que você lança o app com uma versão compatível do SDK Crashlytics, o Crashlytics não terá dados de sessão anteriores para comparar.

Configurar alertas

Vários produtos do Firebase, incluindo Crashlytics, podem enviar alertas por vários motivos específicos para cada produto. Para receber alertas, é necessário ter as permissões necessárias.

Para monitorar a estabilidade da versão mais recente, é possível configurar alertas do Performance Monitoring e do Crashlytics. Especificamente para Crashlytics, é possível configurar estes alertas:

• Use alertas de velocidade para notificar sua equipe se algum problema individual no app ultrapassar um limite definido no console do Firebase.

• Envie alertas sobre problemas novos ou reincidentes para o canal de notificação preferido:

  • Use as integrações de alerta configuradas no console do Firebase para Jira, Slack e PagerDuty.

  • Configure alertas avançados para serviços de terceiros usando Cloud Functions for Firebase.

Garanta um lançamento tranquilo antes de lançar

Antes de lançar a versão mais recente, use alguns dos seguintes serviços e recursos para garantir uma versão tranquila.

Usar serviços de teste de pré-lançamento

O Firebase oferece dois produtos que podem ajudar nos testes de pré-lançamento: Test Lab e App Distribution. Esses dois serviços podem ser integrados aos seus fluxos de CI/CD.

O Firebase Test Lab é uma infraestrutura de teste de apps baseada na nuvem que permite testar seu app em uma variedade de dispositivos e configurações. Assim, você pode entender melhor como ele vai funcionar para usuários ativos.

E quando estiver tudo pronto para colocar seu build mais recente nas mãos de testadores confiáveis, use Firebase App Distribution. É possível gerenciar as distribuições de pré-lançamento para a plataforma Apple e Android no mesmo lugar.

Usar serviços de lançamento e testes limitados

Use Firebase Remote Config para lançar novos recursos com um mecanismo de lançamento gradual ou teste esses recursos em um grupo de teste limitado.

O Firebase também oferece o A/B Testing para que você possa testar alterações na interface, nos recursos ou nas campanhas de engajamento do seu app para saber como elas afetam suas principais métricas (como receita e retenção) antes de implementá-las amplamente.