Investigue um relatório de falha de aplicativo mobile

O Crash report de monitoramento de mobilefornece um resumo e detalhes detalhados sobre falhas, incluindo:

• Detalhamento do dispositivo e do sistema operacional
• Versão do aplicativo
• Contagem de ocorrências
• Usuário único afetado
• Uma linha do tempo da interação e do evento associado ao acidente
• Detalhes detalhados de uma amostra de ocorrências

Ver o relatório de falha

Para visualizar um relatório de falha:

1. Vá para

   one.newrelic.com > All capabilities > Mobile > (select an app) > Exceptions > Crash analysis

   .

2. Na tabela

   Crash list

   , selecione qualquer linha.

3. Revise o resumo e as informações detalhadas do relatório de falha selecionado.

4. Opcional: consulte ou compartilhe os dados do gráfico.

5. Opcional: exporte para o Xcode ou ressimbolize seu código-fonte para facilitar a depuração.

6. Para registrar um ticket, selecione qualquer uma das opções integradas ao seu sistema.

7. Para fechar o relatório de falhas: Na parte superior do relatório, selecione

   Mark resolved

   .

8. Para retornar à tabela

   Crash list

   : Na parte superior do relatório, selecione

   Back to crash analysis

   .

Ver detalhes detalhados do relatório de falhas

Use qualquer uma das funções de interface de usuário padrão do New Relic para obter informações detalhadas. A página Crash report inclui diversas opções adicionais.

Resumo da falha

O resumo da falha contém informações agregadas sobre todas as ocorrências desta falha:

• Crash identifier:

  O identificador exclusivo desta falha, que contém informações como nome da exceção, arquivo, linha, mensagem e função da falha

• Crash occurrences chart:

  Um gráfico que mostra o número de ocorrências desta falha específica durante o período selecionado desde a primeira vez que a falha foi detectada

• Breakdown of crash type:

  Um gráfico de barras empilhadas mostrando o detalhamento das versões do sistema operacional onde ocorreu a falha ou dos dispositivos afetados

• Users affected and occurrences:

  Conta o número de usuários únicos e o número de vezes que a falha ocorreu

Contagem de ocorrências

Se o agente mobile tiver coletado mais de uma ocorrência de falha, você poderá percorrer as amostras.

Trilha do evento

A trilha de evento mostra todos os tipos de eventos cronológicos que levaram a uma falha.

Você pode classificar a trilha de evento cronologicamente em ambas as direções, embora o padrão seja mostrar primeiro o evento mais antigo, geralmente o lançamento de um aplicativo. Filtre os eventos por tipo de evento (ou seja, interação, Solicitação ou Erro de Solicitação), reordene o registro de data e hora crescente ou decrescente dos eventos e clique para expandir cada evento para ver mais detalhes sobre o que aconteceu. Por exemplo, se quiser investigar um evento Request, você poderá expandir o evento e examinar responseTime e requestUrl.

Detalhes

Cada amostra de falha fornece detalhes sobre o dispositivo onde ocorreu a falha, incluindo:

• App version: A versão do aplicativo onde ocorreu a falha

• Device type: O dispositivo específico onde ocorreu a falha

• OS version: A versão do sistema operacional do dispositivo

• RAM used: A quantidade de memória usada pelo aplicativo no momento da falha

• Disk free: A quantidade de espaço livre em disco no dispositivo no momento da falha

• Attributes: Detalhes sobre o atributo relacionado ao relatório de falhas que você pode recolher ou expandir para uma análise mais profunda

  Se aplicável, você pode Export crash details usar o Xcode ou ressimbolizar seu código-fonte para facilitar a depuração.

Rastreamento de pilha

O stack trace do thread que gerou a exceção de falha aparece abaixo dos detalhes da falha. Cada quadro da stack mostra o nome da biblioteca ou do pacote e o método associado a esse quadro stack .

O agente tenta detectar qual quadro da stack contém a falha de programação responsável pelo erro. Se detectado, esse quadro stack aparecerá em vermelho.

Para visualizar o estado de threads diferentes do thread com falha, selecione See all threads.

• Os aplicativos iOS mostrarão apenas nomes de métodos de código-fonte e números de linha se você tiver carregado o dSYM para cada compilação do seu aplicativo.
• Os aplicativos Android que usam o ProGuard terão os nomes dos pacotes e métodos desofuscados se você tiver ativado o upload de mapas do ProGuard.
• Os relatórios de falhas nativos do Android mostrarão apenas o nome do arquivo de origem e as compensações relativas do código.

Relatório de falhas nativo do Android

A partir do agente New Relic Android versão 6.7.0, para ajudar a rastrear e diagnosticar falhas nativas, os relatórios e a análise foram aprimorados para incluir violação de sinal e outras falhas que ocorrem no nível do código nativo durante o tempo de execução.

Essas melhorias incluem:

• Relatórios de falhas nativas - sinalizam violação e outras falhas relatadas pelo aplicativo durante o tempo de execução, incluindo

  • Sinal 4 (instrução ilegal)
  • Sinal 6 (terminação anormal)
  • Sinal 7 (erro de barramento/acesso incorreto à memória)
  • Sinal 8 (exceção de ponto flutuante)
  • Sinal 11 (Segmentação violação/referência de memória inválida)

• Exceções de tempo de execução nativo O agente nativo reportará quaisquer exceções C++ não tratadas lançadas pelo aplicativo durante o tempo de execução e as reportará como exceções tratadas. Exceções não tratadas geralmente são fatais e travam o aplicativo.

• Condições de aplicativo não respondendo (ANR) O agente nativo detectará e relatará condições de aplicativo não respondendo em que uma atividade ou thread de serviço foi bloqueado por mais tempo do que o tempo permitido pelo Android, que é de 5 segundos para atividades em primeiro plano e de 5 a 200 segundos para serviços. As condições ANR serão relatadas como uma exceção tratada (em vez de falhas), uma vez que não são consideradas condições fatais.

Você pode visualizar informações detalhadas sobre falhas nativas na interface de usuárioCrash analysis do New Relic Mobile ou receber notificações de falhas por e-mail. Você também pode explorar mais profundamente os dados de falhas com o New Relic Insights ou integrá-los a sistemas de tickets para uma investigação mais aprofundada.

Configuração

A configuração requer a adição de uma dependência adicional no arquivo build.gradle dos projetos de aplicativo que iniciam o agente New Relic :

dependencies {
    implementation 'com.newrelic.agent.android:agent-ndk:1.+'
}

Os artefatos do agente nativo do Android podem ser encontrados no MavenCentral e seguem convenções de controle de versão semântica. Consulte as notas de versão do agente Android para obter detalhes completos sobre lançamentos e downloads.

Comece

No código do aplicativo onde o agente New Relic é adicionado (geralmente MainActivity), habilite o sinalizador do recurso NativeReporting antes de iniciar o agente:

NewRelic.enableFeature(FeatureFlag.NativeReporting);
NewRelic
      .withApplicationToken("<appToken>")
      .start(this.getApplication());

Desativar relatórios de falhas nativos

Se você quiser usar outra ferramenta nativa de relatório de falhas, desative o relatório de falhas nativo do New Relic Mobile chamando NewRelic.disableFeature{FeatureFlag/NativeReporting) antes da inicialização do agente. Por exemplo:

NewRelic.disableFeature(FeatureFlag.NativeReporting);
NewRelic
      .withApplicationToken("<appToken>")
      .start(this.getApplication());

Depure o repórter de falhas nativo

O relatório de falhas para Android foi projetado para funcionar com outra estrutura de relatórios de falhas, encadeando o manipulador de exceções não capturadas, se já estiver registrado.

Quaisquer problemas que surjam durante o relatório aparecerão no logcat. Cada vez que a New Relic detecta uma violação, ela é registrada no nível DEBUG . Por exemplo, para uma violação de segmento, você veria

Signal 11 intercepted: Segmentation violation (invalid memory reference)
Invoking previous handler for signal 11

A entrega de relatórios nativos é adiada até a próxima invocação do aplicativo, portanto, você não verá relatórios de falhas na interface do usuário do New Relic Mobile até que o aplicativo seja lançado novamente. No caso de uma falha, o agente nativo geralmente não terá tempo ou estabilidade suficiente para processar o relatório. Em vez disso, os dados do relatório são rapidamente gravados no armazenamento local, para serem processados na próxima vez que o aplicativo for lançado.

Resolução de problemas

Os relatórios nativos são armazenados no dispositivo como arquivos JSON em /data/data/{app package name}/cache/newrelic/reports. Este diretório não deve conter nenhum relatório após o lançamento do aplicativo após uma falha. Tal como acontece com outras informações de tempo de execução do agente, o agente nativo grava seu status no logcat para combinar com o status do tempo de execução do agente. A tag de log do agente Android é com.newrelic.android e pode ser isolada de outros logs de tempo de execução executando 'adb logcat | grep "com.newrelic.android" da casca.