Nosso recurso de monitoramento de exceções tratadas ajuda a identificar fatores significativos que contribuem para uma experiência ruim com aplicativos móveis e a usar dados filtráveis para encontrar uma solução mais rapidamente. Você também pode usar a API de exceções tratadas para personalizar os dados enviados e usar NRQL para consultar e compartilhar os dados.
one.newrelic.com > All capabilities > Mobile > (select an app) > Exceptions > Handled exceptions: À medida que você explora a riqueza de dados nos gráficos e na tabela, use grupos e filtros para descobrir padrões que ajudam a determinar a causa raiz das exceções de aplicativos móveis.
Recurso
Lidar com exceções à medida que elas ocorrem pode ajudar a melhorar a experiência do usuário no aplicativo mobile, mas não é suficiente para capturar exceções. Você também precisa saber como evitá-los. Nosso recurso de exceções tratadas ajuda você a responder a estes tipos de perguntas:
- Quantos tipos diferentes de exceções tratadas estão ocorrendo? Uma alta taxa de ocorrência pode indicar que você precisa fazer alterações nos sistemas backend .
- Por que o uso do aplicativo pelo usuário resulta em um try/catch? Qual é o contexto das exceções?
- Quando as respostas de um ambiente de teste às exceções tratadas podem indicar problemas adicionais e mais sérios?
- O que teria causado uma falha se a exceção não tivesse sido detectada na produção? O que mais (no código ou na API backend ) ainda está afetando a experiência do usuário?
Ao usar exceções tratadas, você pode identificar e resolver esses tipos de problemas mais rapidamente.
Requisitos
Para visualizar dados de exceções tratadas, seu aplicativo precisa atender a estes requisitos:
Gráficos de porcentagem de exceção
Comece com os gráficos de porcentagem Users affected e Sessions affected para ver se há picos, quedas ou padrões inesperados com exceções em geral. Se o gráfico Users affected estiver vazio, significa que não houve sessões de usuário durante o período selecionado.
Use isso para responder perguntas como:
- Há algum pico próximo ao lançamento de uma versão recente?
- Existe um período em que a porcentagem de usuários foi afetada significativamente pela exceção?
- Existem períodos sem intercorrências?
Para examinar os dados com mais detalhes: Abaixo de qualquer gráfico, selecione Expand chart.
Grupos e filtros
Use os grupos e filtros para examinar o atributo de falhas, dispositivos, locais ou outro atributo personalizado com mais detalhes. Você pode selecionar um grupo e filtrar dados específicos. Use isso para fazer coisas como:
Agrupe a lista por local de exceção (padrão), causa, compilação ou versão do aplicativo, dispositivos, conexões ou outro atributo personalizado. Isso permite descobrir padrões em suas exceções para determinar a causa raiz.
Use o seletor de hora para ajustar o período de tempo atualmente selecionado.
Filtre por um
Version
específico ou por um ou mais atributo
Filter
, como
appVersion,exceptionLocationMethod,lastInteraction, ou qualquer uma da lista mais longa de atributo padrão e personalizado.
Os filtros atualmente selecionados aparecem na parte superior da página da interface. Você pode fechá-los, adicionar outros filtros ou selecionar outros grupos e filtros.
Principais locais de exceção
Use a tabela Top exception locations para localizar ou classificar padrões no tipo de exceção selecionado nos grupos e filtros. Isso inclui:
- Locais recorrentes no stack trace
- Versão do aplicativo mobile
- Número de ocorrências
- Número de usuários afetados durante o período selecionado
Por exemplo, você pode agrupar por Exception Message, filtrar a mensagem timeout e selecionar locais de tempo limite individuais na tabela para revisar o encadeamento stack trace e os detalhes sobre cada ocorrência.
- Para filtrar ou agrupar por outro atributo, utilize a janela de busca da tabela, ou selecione algum dos filtros disponíveis. Por exemplo, filtre por tipo de ocorrência, dispositivo, local específico ou qualquer atributo personalizado.
- Para procurar outros padrões históricos, altere o período selecionado.
Criador de links de consulta
Handled exceptions gráficos usam atributo padrão para eventos móveis (incluindo MobileHandledException), juntamente com qualquer atributo personalizado que você adicionou a este tipo de evento. Quando você passa o mouse sobre os gráficos, links diretos aparecem abaixo deles. Esses links para o criador de consulta permitem que você analise os dados do seu aplicativo mobile ainda mais profundamente.
View query
link: Visualize a consulta NRQL usada para calcular os dados do gráfico.
View in query builder
link: Visualize o gráfico e compartilhe-o com outras pessoas.
Tabela de locais de exceção
A tabela Exception locations complementa os gráficos. Ele lista onde as cinco principais exceções tratadas aparecem no thread stack trace e as vincula a detalhes relevantes. Cada linha ajuda você a encontrar respostas para perguntas como:
- Quantas dessas exceções ocorreram dentro do período selecionado?
- Uma versão específica do aplicativo possui um número maior (ou menor) de usuários afetados?
- Qual exceção tem o menor número de ocorrências?
Você pode alterar a ordem de classificação ou as opções de filtro para se concentrar apenas nos tipos de exceções que são mais importantes para você e suas equipes. Para visualizar detalhes adicionais do thread para cada ocorrência da exceção, selecione um registro na tabela Top exceptions location .
Detalhes da ocorrência de exceção tratada
Para visualizar detalhes de cada ocorrência de uma exceção tratada:
Vá para
one.newrelic.com > All capabilities > Mobile > (select an app) > Exceptions > Handled exceptions
.
Na tabela
Top exception locations
, selecione uma exceção tratada em qualquer linha.
A página Occurrences mostra detalhes sobre a exceção selecionada, incluindo dados detalhados por tipo de dispositivo ou sistema operacional, número de usuários afetados, total de ocorrências no período selecionado, atributo e muito mais.
one.newrelic.com > All capabilities > Mobile > (select an app) > Exceptions > Handled exceptions > (select an exception) > Occurrences: Use os detalhes do thread para examinar melhor os padrões no stack trace para uma exceção tratada.
If you want to... | Do this |
|---|---|
Encontre padrões gerais | Na página Occurrences :
|
Encontre padrões mais específicos | Faça um dos seguintes:
|
Encontre padrões de atributo | Revise as listas de
|
Consultar ou visualizar os dados da ocorrência | Use o New Relic para consultar os dados ou criar um painel que você pode visualizar ou compartilhar. |
Trilha de evento para uma ocorrência
O gráfico Event trail permite ver o evento de carimbo de data/hora que leva a uma exceção tratada.
one.newrelic.com > All capabilities > Mobile > (select an app) > Exceptions > Handled exceptions > (click an exception) > (scroll down to Event trail chart): Visualize a trilha de evento para eventos que levaram a uma exceção tratada.
Rastreamento de pilha não simbolizado
A New Relic não armazena rastreamento de pilha não simbolizado para exceções tratadas. Isso é diferente da crash trilha de evento. Você pode fazer upload de um dSYM posteriormente, conforme necessário, pois novas exceções tratadas serão simbolizadas.
API de exceções tratadas
Nosso recurso Handled exceptions inclui automaticamente um atributo padrão que você pode usar para explorar seus dados de exceções tratadas no criador de consulta e obter detalhes específicos:
Use o método
recordHandledExceptions().consulte o tipo de evento
MobileHandledException. Para obter mais informações, consulte os exemplos de NRQL para.
Criar atributo personalizado e evento
Você também pode atributo personalizado e evento personalizado. Depois de criá-los, selecione e consulte o atributo na página Handled exceptions .