Analisar problemas do Firebase Crashlytics usando a janela App Quality Insights

É possível verificar e realizar ações nos dados de falhas do app no Firebase Crashlytics diretamente no Android Studio. Essa integração extrai dados de stack trace e estatísticas de falhas do Crashlytics na janela de ferramentas App Quality Insights no ambiente de desenvolvimento integrado do Android Studio para que você não precise alternar entre seu navegador e o ambiente de desenvolvimento integrado do Studio. As equipes de desenvolvimento podem se beneficiar dos principais recursos, incluindo:

  • 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.

Se você ainda não usa o Crashlytics e quer saber mais sobre o que ele tem a oferecer, consulte Firebase Crashlytics.

Começar

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. Os painéis Issues, Sample Stack Trace e Details aparecem preenchidos com relatórios do Crashlytics.

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. Se o projeto inclui vários módulos de apps, verifique se o módulo em que você quer conferir os dados de eventos está selecionado no menu suspenso de módulo.
  2. 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.
  3. O painel Issues mostra os principais eventos de que o Crashlytics tem dados, e as falhas mais impactantes aparecem primeiro na lista.
  4. O painel com o stack trace mostra detalhes sobre a ocorrência mais recente do evento em que você clicou no painel Issues. Você pode conferir o stack trace do evento e clicar nele para acessar as linhas relevantes na sua base de código.

    Há também informações sobre o tipo de dispositivo afetado, a versão do Android e o horário em que o evento ocorreu, assim como um link para o evento no painel do Firebase Crashlytics. Clique no botão Close para fechar um problema diretamente no painel.

  5. 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.
  6. 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.
  7. Use os diversos filtros para refinar determinados subconjuntos de eventos. É possível marcar ou desmarcar eventos que sejam fatais ou não fatais , assim como filtrar por horário, versão do app, indicador do Crashlytics, marca e modelo do dispositivo e versão da plataforma Android. Para os estados de indicadores do Crashlytics, um problema é considerado como reaberto quando ele já foi fechado, mas voltou a ocorrer em uma nova versão do app.

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 com facilidade.

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.

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 se conectar ao Crashlytics novamente e retornar a um estado on-line, clique em Reconnect.

Opção "Reconnect" da janela "App Quality Insights" no modo off-line.