Ler em inglês

Compartilhar via


Recursos de diagnóstico

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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 erros e falhas

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 as falhas e os erros do aplicativo por dia em uma exibição lado a lado.

Usando as guias superiores à esquerda, faça uma busca detalhada 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.

Observação

O App Center filtra informações potencialmente confidenciais. Exemplos de informações confidenciais que serão filtradas são URLs, cadeias de caracteres JSON e IDs de solicitação.

O App Center mostra a análise de falhas e erros

Agrupamento

Os grupos de diagnóstico do App Center falham e erros por semelhanças, como o motivo do problema e onde o problema 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 chamada com falha a uma URL (como "Erro ao chamar azure.com ou google.com") o App Center poderá agrupar falhas por essa URL (por exemplo, todas as azure.com falharam ao chamar azure.com serão agrupadas e não chamarão google.com serão agrupadas). No entanto, como removemos URLs preteridas 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.

Erros e falhas de grupos do App Center com base em semelhanças

Identificação do usuário

O Diagnóstico do App Center permite anexar uma ID de usuário às falhas e erros. Para fazer isso, use o SDK do App Center em sua plataforma de destino Android, Apache Cordova, 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 falhas do SDK para seus aplicativos Android, iOS, macOS, React Native, UWP, WPF/WinForms e MAUI/Xamarin.

Os anexos para erros manipulados têm suporte apenas para plataformas Android, Unity, UWP, WPF, WinForms e Xamarin. Saiba como adicionar anexos aos seus relatórios de erro 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.

O App Center permite que você adicione anexos aos relatórios de falha e erro

Eventos antes de uma falha

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

Para definir um evento personalizado, marcar 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.

O App Center permite que você acompanhe eventos que levaram à sua falha

Pares chave-valor

Você pode personalizar os 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 de chave, dê uma olhada em nossa documentação do Android, MAUI/Xamarin, Unity, UWP e WPF/WinForms .

Observação

Esse recurso só tem suporte para Erros android, iOS, Xamarin, React Native, Unity, UWP, WinForms e WPF hoje.

Exportar dados de diagnóstico

O App Center pode exportar dados brutos de diagnóstico (falhas e erros) para o Azure. Exporte diagnóstico dados 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 simbólicas completas e os rastreamentos de pilha correspondentes serão exportados.

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

Threads

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.

O App Center mostra os threads atuais no momento da falha

Observação

No Windows, o relatório mostra apenas o rastreamento de pilha do thread que falhou. Não há suporte para mostrar o estado de outros threads no momento da falha no Windows.

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 esses alertas:

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

Configuração de captura de tela Falha na frequência de notificação por email

Você pode saber mais sobre a notificação em nossa documentação dashboard do App Center.

Criar um rastreador de bugs

Você pode integrar ferramentas de rastreador de bugs de terceiros com o 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 carregar falhas por meio da API foi movida.