Analisar problemas do Firebase Crashlytics e do Android vitals com a janela App Quality Insights

Você pode ver e realizar ações em dados de falhas do app de Firebase Crashlytics e Android vitals diretamente no Android Studio. Essa integração extrai dados de stack trace e falha estatísticas do Crashlytics e do Google Play nos Insights de qualidade do app janela de ferramentas no IDE do Studio, para que você não tenha que ir e voltar entre seu navegador e o IDE. As equipes de desenvolvimento podem se beneficiar dos principais recursos incluindo o seguinte:

  • Conferir linhas destacadas no código quando elas têm dados de eventos do Crashlytics relacionados.
  • Conferir os stack traces das principais falhas e clicar neles para acessar as linhas relevantes no código.
  • Conferir um resumo das estatísticas sobre os principais eventos não fatais e falhas, por exemplo, agrupadas por fabricante do dispositivo e versão do Android.
  • Filtrar eventos por atributos, incluindo gravidade, horário e versão do app.
  • Receber um link que abre a página do painel do Crashlytics com mais detalhes sobre o evento.
  • Receba insights que ajudam você a entender e resolver mais facilmente as causas-raiz de determinados problemas.

Os relatórios do Android vitals estão disponíveis para todos os apps publicados no Google Play. Se ainda não usa o Crashlytics e quer saber mais sobre ele ofertas, consulte Firebase Crashlytics:

Primeiros passos

Para conferir os dados do Crashlytics no Android Studio, você precisa configurar o Firebase e o Crashlytics no projeto do app. Para abrir o Firebase Assistente no Android Studio, clique em Tools > Firebase, depois em Crashlytics e siga o tutorial para adicionar o Firebase e o Crashlytics ao seu projeto. Saiba mais sobre o fluxo de trabalho do Firebase Assistente no Guia para iniciantes do Firebase para Android.

Se você já adicionou o Firebase e o Crashlytics ao seu app, clique no ícone de avatar para fazer login na conta de desenvolvedor no ambiente de desenvolvimento integrado. Depois de fazer login, clique na janela de ferramentas App Quality Insights. Você deve confira os painéis serem preenchidos com relatórios do Crashlytics.

Analisar o Android vitals

A janela App Quality Insights inclui dados do recurso Android vitals. Isso permite acessar com mais facilidade as principais métricas coletadas pelo Google Play e melhorar a experiência do usuário. Use o Android vitals para resolver problemas relacionados à estabilidade e melhorar a qualidade do app no Google Play.

Dados do Android vitals no Android Studio.

É possível conferir problemas do Android vitals, filtrá-los e navegar do stack trace para o código, tudo na janela de ferramentas App Quality Insights. Para começar, siga estas etapas:

  1. Faça login na sua conta de desenvolvedor no Android Studio usando o ícone de perfil no final da barra de ferramentas.
  2. Para abrir a janela App Quality Insights, clique na janela de ferramentas no Android Studio ou em View > Tool Windows > App Quality Insights.
  3. Clique na guia Android vitals em App Quality Insights.
  4. Opcional: para usar a integração do controle de versões em um build depurável, adicione o elemento mais recente SDK do Firebase Crashlytics (ou a Lista de materiais do Firebase para Android) ao seu app. Em seguida, adicione o seguinte ao arquivo build.gradle.kts ou build.gradle do módulo. Lançamento (não depuráveis) têm a flag ativada por padrão.

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Groovy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

A janela de ferramentas App Quality Insights tem dados avançados que oferecem insights sobre os eventos que os usuários estão encontrando, além de links para navegar rapidamente até as origens desses eventos.

Janela de ferramentas "App Quality Insights"

  1. Use o menu suspenso de ID do aplicativo para selecionar o ID do app que você quer analisar. Por exemplo, embora você possa trabalhar na versão de depuração do seu app no ambiente de desenvolvimento integrado, talvez você queira verificar dados de eventos da versão de produção do app que os usuários instalam.
  2. O painel Issues mostra os principais eventos de que o Crashlytics tem dados e as falhas mais impactantes aparecem antes na lista.
  3. Visualize eventos por variantes ou grupos de eventos com características semelhantes rastreamentos de pilha. A análise de eventos por variante ajuda a identificar as causas raiz de um acidente.
  4. A guia Stack trace mostra detalhes sobre a versão mais recente ocorrência do evento em que você clicou no painel Issues. É possível conferir rastreamento de pilha do evento e clique nele para acessar as linhas relevantes sua base de código. Se o código mudou desde a falha, clique em mostrar diferença ao lado do erro no stack trace para visualizar a diferença entre o código atual e a versão da base de código que gerou a falha.

    Opção para mostrar diferenças no stack trace de IQA.

    Há também informações sobre o tipo de dispositivo afetado, a versão do Android e a hora em que o evento ocorreu, bem como um link para o evento no painel do Firebase Crashlytics. Para procurar informações de vários eventos em um grupo: use as setas para a esquerda e para a direita. Clique em Encerrar problema para fechar um problema. diretamente no painel.

  5. As guias Chaves e Registros mostram pares de chave-valor e registros personalizados para cada relatório do Crashlytics.
  6. O painel Details detalha as contagens de falhas por tipo de dispositivo e versão do Android para que você possa determinar quais grupos de usuários são mais afetados. Ele também mostra quais versões do app apresentaram a falha e o número de usuários afetados.
  7. Leia e anexe notas aos problemas para que elas fiquem visíveis no console do Firebase e para seus colegas de equipe. Para escrever uma nota, selecione o problema desejado e abra o painel Notes. Você precisa ter permissão de gravação no projeto do Crashlytics para fazer isso. Os problemas com notas têm um ícone no painel Issues.
    Painel de notas de insights de qualidade do app.
  8. Use os diversos filtros para refinar determinados subconjuntos de eventos. Você pode marcar ou desmarcar eventos fatais , Não fatal , e ANRs , além de filtrar por horário, versão do app Crashlytics Signal, marca e modelo do dispositivo e versão da plataforma Android. Para o estados de indicador do Crashlytics, um problema é considerado reaberto quando foi fechado no passado e ocorreu novamente em uma nova versão do aplicativo.

Além de navegar do stack trace para o código, você também pode pular do código para o stack trace: o Android Studio agora anota linhas de código relacionadas a falhas com um ícone de gutter de falha. para que você possa localizar e depurar as falhas facilmente.

Quando você passa o cursor sobre o ícone de falha, aparece um pop-up que mostra quantos eventos envolvem essa linha de código e as frequências deles.

Resumo do evento ao passar o cursor sobre o ícone de falha

Clique no ícone de falha para uma lista mais detalhada de eventos, incluindo a frequência e o número de usuários afetados por um determinado evento. Clique em um evento específico para acessar os detalhes dele na janela de ferramentas App Quality Insights.

Lista de eventos quando você clica no ícone de falha.

Números diferentes no recurso Android vitals e no Crashlytics

O Android vitals e o Crashlytics podem informar valores diferentes para os números de usuários e eventos associados à mesma falha. Essas discrepâncias acontecem porque o Google Play e o Crashlytics podem detectar falhas em momentos diferentes e para usuários distintos. Confira alguns motivos pelos quais as contagens do Google Play e do Crashlytics podem ser diferentes:

  • O Google Play detecta falhas no momento da inicialização, enquanto o Crashlytics detecta falhas que ocorrem após a inicialização do SDK do Crashlytics.
  • Se um usuário desativar o relatório de erros ao comprar um novo smartphone, essas falhas não serão informadas ao Google Play. No entanto, o Crashlytics detectará falhas com base na Política de Privacidade do app.

Investigar com funcionalidade limitada quando estiver off-line

Se você fizer uma nova solicitação, por exemplo, clicando em Refresh, e o Android Studio não conseguir se comunicar com o Crashlytics, a janela App Quality Insights permitirá que você entre no Offline Mode.

A janela "App Quality Insights" oferece a opção de modo off-line.

Nesse modo, é possível continuar investigando problemas e os eventos mais recentes com os dados armazenados em cache. Determinadas funcionalidades, como mudar algumas opções de filtro ou problemas de fechamento, não estão disponíveis. Para tentar se conectar ao Crashlytics novamente e retornar a um estado on-line, clique em Reconnect