Recursos de diagnóstico

Nesta seção, você aprenderá sobre o conjunto de recursos disponível para o serviço de Diagnóstico do App Center.

Análise de crashes e erros

No Diagnóstico do App Center, você pode exibir dados de análise gerados automaticamente pelo App Center para entender quando ocorre uma falha ou erro em seu aplicativo.

Por padrão, o App Center exibe falhas e erros de um aplicativo por dia em uma exibição lado a lado.

Usando as guias no canto superior esquerdo, aprofunde-se em Falhas e Erros. Quando você faz isso, o gráfico esquerdo indica o número de falhas/erros por dia e o gráfico à direita mostra o número de usuários afetados. Filtre os gráficos por versão do aplicativo, período de tempo e status para uma exibição mais focada.

Agrupamento

O App Center Diagnostics agrupa falhas e erros por semelhanças, como o motivo do problema e onde ocorreu no aplicativo. Para cada grupo de erros e falha, o App Center exibe a linha de código que falhou, o nome da classe ou do método, o nome do arquivo, o número da linha, a falha ou o tipo de erro e a mensagem para que você entenda melhor esses grupos rapidamente. Selecione um grupo para exibir mais informações e acesse uma lista de relatórios e logs de problemas detalhados. Isso permite que você se aprofunde ainda mais e use nosso conjunto de recursos para entender melhor o comportamento do aplicativo durante uma falha ou um erro.

Se uma falha for causada por uma tentativa de chamada para uma URL que não foi bem-sucedida (como "Erro ao chamar azure.com ou google.com"), o App Center poderá agrupar falhas por essa URL. Por exemplo, todas as falhas de chamada para azure.com serão agrupadas juntas, e todas as falhas de chamada para google.com serão agrupadas juntas. No entanto, como removemos URLs acrescentadas com HTTP ou HTTPS do log de falhas, esse agrupamento só funcionará ao evitar essa sintaxe, por exemplo: "Erro ao chamar http://azure.com"" não será agrupado com outras chamadas do azure, mas "Erro ao chamar azure.com" será agrupado com relatórios de erro semelhantes.

Identificação do usuário

O recurso Diagnósticos do App Center permite anexar um identificador de usuário a falhas e erros. Para fazer isso, use o SDK do App Center em sua plataforma de destino Android, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms e MAUI/Xamarin. Você encontrará a ID de usuário associada a uma falha ou erro ao clicar em um problema dentro de um grupo.

Depois de anexar uma ID de usuário, você pode usar o recurso de pesquisa do App Center para pesquisar falhas com a ID especificada. Saiba como fazer isso seguindo a documentação de pesquisa do App Center.

Anexos

Na interface do usuário de diagnóstico do App Center, você pode exibir e baixar anexos binários e de texto de seus relatórios de falha e erro.

Você pode aprender a adicionar anexos aos seus relatórios de falha lendo a documentação de Falhas do SDK para seus aplicativos Android, iOS, macOS, React Native, UWP, WPF/WinForms e MAUI/Xamarin .

Os anexos para erros manipulados são suportados apenas para plataformas Android, Unity, UWP, WPF, WinForms e Xamarin. Saiba como adicionar anexos aos seus relatórios de erros na documentação do SDK para seus aplicativos Android, Unity, UWP, WPF/WinForms e MAUI/Xamarin .

Para exibir e baixar os anexos, selecione um grupo de erros ou falha, um relatório de dispositivo específico e clique na guia anexos.

Eventos Antes de um Crash

Acompanhe os eventos que levaram a uma falha para capturar informações úteis sobre o estado do seu aplicativo.

Para definir um evento personalizado, confira nossa Documentação do SDK para Android, iOS, macOS, React Native, Windows e MAUI/Xamarin.

Para exibir eventos antes de uma falha, selecione um grupo de falhas, um relatório de dispositivo específico e clique na guia eventos.

Pares de valor de chave

Você pode adaptar relatórios de erros enviados ao App Center para incluir contexto adicional para o erro passando um dicionário de valores de cadeia de caracteres (como pares chave/valor) para o TrackError método. Essas propriedades são opcionais. Para definir pares de valores chave, dê uma olhada na documentação do Android, MAUI/Xamarin, Unity, UWP e WPF/WinForms .

Exportar dados de diagnóstico

O App Center pode exportar dados brutos de diagnóstico (falhas e erros) para o Azure. Exporte dados de diagnóstico para o Armazenamento de Blobs para personalização dos dados.

Para exportar falhas, anexos e erros, você deve chamar a API de Configurações de Exportação:

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

exportEntities No campo da propriedade da API, você deve indicar que tipo de dados deseja exportar: falhas, erros, anexos. Ao fazer isso, as falhas totalmente simbolicadas e os rastreamentos de pilha correspondentes serão exportados.

Saiba mais sobre os benefícios e como exportar seus dados na documentação de exportação.

Fios

Em um relatório de falha, você pode ver os threads atuais que estavam ativos quando o aplicativo falhou. O thread que falhou está realçado em vermelho para que você entenda melhor o estado do aplicativo.

Configurar Alertas

Fique por dentro de suas falhas definindo as configurações de definição de aplicativo do App Center para enviar uma notificação por email. Você pode definir essa configuração por aplicativo para enviar um email imediatamente quando um novo grupo de falhas é criado ou enviar um email de resumo diário com as principais falhas do aplicativo. Para configurar estes alertas:

1. Faça logon no App Center e selecione seu aplicativo
2. No menu à esquerda, navegue até Configurações
3. Clique em Notificações por Email
4. Selecione Imediatamente, Diariamente ou Nunca. A configuração padrão é definida como Nunca.

Saiba mais sobre a notificação na documentação do painel do App Center.

Criar um rastreador de bugs

Você pode integrar ferramentas de rastreador de bugs de terceiros ao App Center para se manter informado e gerenciar melhor suas falhas. Leia a documentação do rastreador de bugs para saber como começar.

Carregar relatórios no App Center

A documentação para enviar falhas via API foi movida.