Erros de solicitação de grupo: Analisar falhas de rede

Erros de solicitação de rede que ocorrem devido a problemas no servidor ou falhas de rede podem deixar seu aplicativo móvel lento e impactar negativamente a experiência do usuário. Use a página de erros de solicitação para entender o que está causando erros de HTTP e compartilhe dados acionáveis com sua equipe para resolver os problemas subjacentes.

Ver a página de erros de solicitação

Para visualizar a página de erros de solicitação, vá para one.newrelic.com > All capabilities > Mobile > (select an app) > Request errors.

Fluxo de trabalho recomendado

Recomendamos a seguinte abordagem para investigar erros de solicitação HTTP e falhas de rede, permitindo que você obtenha uma compreensão completa do erro, identifique fatores contribuintes e implemente estratégias de depuração eficazes:

1. Analise detalhadamente um único erro: para visualizar detalhes sobre um erro de solicitação ou falha de rede, clique na linha da tabela de grupos de erros. Aqui você pode visualizar as informações da solicitação, o atributo da solicitação e o corpo da resposta, além de obter mais informações sobre o erro.

2. Consultar e compartilhar dados de erros: Para explorar os dados por trás de qualquer um dos gráficos ou listas na página de erros HTTP:

   • Em qualquer gráfico, clique no menu … e depois clique em View query.
   • A partir do criador da consulta, você pode adicionar os dados de erro a um dashboard e compartilhá-los por meio de um link permanente.

   Para se aprofundar nos dados de erro, consulte seus dados para o seguinte evento e atributo:

   • MobileRequestError evento e atributo
   • MobileRequest evento e atributo

3. Altere como a página agrupa e classifica erros e falhas de rede: faça seleções usando as barras de atributos e filtros na parte superior da página. Por padrão, os erros são agrupados por domínio de solicitação e caminho de solicitação.

4. Filtrar por erros específicos e falhas de rede: selecione um erro ou falha usando vários filtros na barra de filtros.

5. Veja quais filtros você aplicou ou remova filtros: Os filtros selecionados são exibidos na barra de filtros. Para limpar filtros, selecione o X ao lado do filtro que deseja limpar.

6. Alterar a janela de tempo: Selecione um novo período de tempo no dropdown seletor de horas.

7. Exibir informações para uma versão específica do aplicativo: selecione a versão cujos gráficos e listas você deseja ver no dropdown de versões. Por padrão, todas as versões disponíveis são exibidas.

As seções abaixo descrevem o que você pode fazer na página de erros de solicitação.

Guia de triagem

A guia de triagem mostra uma visão geral dos erros não resolvidos e como eles se correlacionam com a taxa de erros. A tabela de grupos de erros lista grupos de erros por ocorrência e permite que você os atribua a usuários que podem investigá-los e corrigi-los.

Guia de erros de solicitação de grupo

Na aba de erros do grupo você pode:

• Avalie as tendências gerais de erros de solicitação de HTTP e de rede: veja uma visão geral dos erros de solicitação e taxas de erros em vários domínios de solicitação e tipos e versões de aplicativos móveis. Use esses dados para identificar e corrigir rapidamente suas solicitações de API.

• Filtrar para análise mais aprofundada: use grupos e filtros para focar em atributos de solicitação específicos, como tipo de solicitação, caminho de solicitação, tipo de erro ou qualquer atributo personalizado que você tenha definido.

• Identificar padrões: examine a tabela de erros de solicitação para tendências relacionadas ao domínio de solicitação, caminhos de solicitação e frequência de ocorrência.

• Investigue erros de solicitação individuais: selecione um relatório de erro de solicitação para visualizar seu distributed trace, trilha de evento, corpo de resposta, atributo e outros detalhes relevantes necessários para uma depuração eficaz.

• Atualizar status do erro: marque o erro da solicitação como Resolved [Resolvido] ou atribua-o a um membro específico da equipe que possa controlar e examinar o problema e, então, implantar uma correção.

Solicitar detalhes do erro

Na página de erros de solicitação, clique em um erro específico para ver:

• Jornadas do usuário: exibe os diferentes caminhos e ações que um usuário realizou que levaram ao erro.
• Gráfico de todas as ocorrências: exibe a frequência de um erro de solicitação durante o período selecionado, a partir de sua detecção inicial. Você pode visualizar os dados agregados de todas as ocorrências ou uma análise por versão do aplicativo.
• Análise do tipo de erro: exibe a distribuição desses erros de solicitação entre diferentes versões do sistema operacional ou dispositivos afetados.

Os erros resolvidos incluem um banner contendo detalhes sobre o usuário que resolveu o erro da solicitação e o timestamp da resolução. Observe que as políticas de monitoramento de Mobile Retenção de dados se aplicam, permitindo que você filtre por erros resolvidos para análise histórica quando necessário.

Perfis

Ao analisar um erro específico, a seção de perfis fornece detalhes visuais sobre diferenças significativas na frequência de diferentes valores para eventos de erro HTTP. Para cada atributo, o perfil de erro inclui:

• Um mapa de calor mostrando como o atributo do erro é distribuído para valores que mais se desviam
• Um rótulo comparando a distribuição do atributo de erro com a de outros erros

Triagem

Quando você analisa um erro específico, a seção de triagem associa a ocorrência de erro específica que você está visualizando ao grupo de erros criado pelo sistema. Esses grupos de erros criados pelo sistema são identificados por uma impressão digital exclusiva. É essa impressão digital exclusiva que permite que você classifique grupos de erros por atualizações de status ou atribuições.

Para obter mais informações sobre como os grupos de erros são criados, consulte Como funcionam os grupos de erros e, para saber mais sobre status e atribuições, consulte Monitoramento de erros.

Distributed trace

Quando você observa um erro específico, a seção distributed trace rastreia e observa suas solicitações conforme elas fluem pelo seu aplicativo, percorrendo vários serviços até chegar à conclusão. Ao visualizar todo o caminho da solicitação em diferentes serviços, você pode identificar rapidamente falhas ou gargalos de desempenho.

Para saber mais sobre como funciona distributed tracing , consulte Rastrear solicitações em seus microsserviços.

Resposta

Uma resposta típica a uma solicitação compreende um cabeçalho de resposta e um corpo de resposta, que juntos transmitem informações sobre o sucesso ou falha da solicitação. O cabeçalho de resposta contém metadados sobre o servidor, enquanto o corpo da resposta contém informações sobre a saída, incluindo um código de sucesso ou falha e a mensagem correspondente.

Capturamos o corpo da resposta para solicitações sempre que disponível, exibindo-o na página de detalhes de erros de solicitação para agilizar a depuração.

Trilha do evento

Quando você analisa um erro específico, a trilha de eventos fornece um log cronológico de todos os eventos que levaram ao erro da solicitação, o que ajuda na análise da causa raiz. Eles podem ser eventos New Relic monitor por padrão ou eventos personalizados. A trilha de eventos é classificada cronologicamente, começando pelo evento mais antigo, que normalmente é o lançamento do aplicativo, mas você pode modificar o seguinte:

• Classificar: alternar entre ordem crescente e decrescente
• Filtragem de eventos: Filtrar por tipo de evento, como app launch, request, request error ou user actions.
• Detalhes do evento: expanda eventos individuais para inspecionar seus atributos, como errorType, responseTime ou requestUrl para eventos solicitados.

Depois de classificar e filtrar seu evento, você pode se aprofundar um pouco mais no evento que levou ao erro examinando:

• Trilhas personalizadas: utilize o SDK da Record trilhas para criar eventos MobileBreadcrumb personalizados. Isso permite que você log interações específicas do aplicativo que podem ser relevantes para investigar seu erro.
• Exceções tratadas: use os métodos do SDK Record Handled Exception para iOS e Android para anotar onde as exceções são tratadas no seu aplicativo. Essas anotações preencherão automaticamente a trilha de evento do crash.

Para obter orientação sobre como aprimorar a trilha de evento de acidentes com dados personalizados, consulte Registrar trilhas.

Para aproveitar totalmente nossas ferramentas de análise de falhas, certifique-se de:

1. Use o SDK móvel para criar eventos MobileBreadcrumb ou MobileHandledException personalizados.
2. Ative o evento MobileRequest para capturar dados de solicitação de rede.

Atributo

Quando você analisa um erro específico, cada amostra de erro de solicitação inclui um conjunto abrangente de atributos que fornecem informações detalhadas sobre a solicitação, a resposta e o parâmetro específico que acionou o erro. Esses atributos oferecem insights valiosos sobre o contexto do erro e ajudam a entender a causa raiz.

Resolução de problemas

• Lembre-se de que os perfis são desativados quando não há perfis disponíveis que correspondam aos filtros aplicados.
• trace distribuído para solicitações provavelmente conterá apenas uma ocorrência, pois é um único evento HTTP registrado em nosso sistema.
• Falhas de rede não têm corpo de resposta.
• O agente móvel mantém uma lista de tipos de exceção. Em alguns casos, exceções personalizadas geradas pelo aplicativo ficam fora desta lista. Quando isso acontece, Unknown pode aparecer na página Caixa de entrada de erros do celular. Se você encontrar Unknown em sua lista de erros e precisar de ajuda para pesquisar quais tipos de exceção estão sendo perdidos, obtenha suporte em support.newrelic.com.