Partilhar via

Recursos de diagnóstico

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

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

Análise de falhas e erros

No Diagnóstico do App Center, você pode visualizar os dados analíticos 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 erros de um aplicativo por dia em uma exibição lado a lado.

Usando as guias superiores esquerdas, 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 direito mostra o número de usuários afetados. Filtre os gráficos por versão do aplicativo, período de tempo e status para obter 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 análises sobre falhas e erros

Agrupamento

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

Se uma falha for causada por uma chamada com falha para um URL (como "Erro ao chamar azure.com ou google.com"), o App Center pode agrupar as falhas por esse URL (por exemplo, todas as falhas ao chamar azure.com serão agrupadas, e o mesmo acontecerá com as falhas ao chamar google.com). No entanto, como removemos URLs prefixadas 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 "Error calling azure.com" será agrupado com relatórios de erros semelhantes.

O App Center agrupa falhas e erros com base em semelhanças

Identificação do Utilizador

O Diagnóstico do App Center permite que você anexe um ID de usuário às suas 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á o ID de usuário associado a uma falha ou erro ao clicar em um problema dentro de um grupo.

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

Anexos

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

Você pode aprender como adicionar anexos aos seus relatórios de falhas 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 tratados são suportados apenas para as 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 visualizar e transferir os anexos, selecione um grupo de falhas ou erros, um relatório de dispositivo específico e, em seguida, clique no separador anexos.

O App Center permite-lhe adicionar anexos aos seus relatórios de falhas e erros

Eventos antes de um acidente

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

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

Para ver eventos antes de uma falha, selecione um grupo de falhas, um relatório de dispositivo específico e, em seguida, clique no separador de eventos.

O App Center permite que você acompanhe os eventos que levaram ao seu acidente

Pares de valor-chave

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. Estas propriedades são opcionais. Para definir pares de valores de chave, dê uma olhada em nossa documentação para Android, MAUI/Xamarin, Unity, UWP e WPF/WinForms .

Observação

Este recurso só é suportado para Android, iOS, Xamarin, React Native, Unity, UWP, WinForms e WPF Errors atualmente.

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 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 e como exportar seus dados na documentação de exportação.

Fios

Em um relatório de falhas, você pode ver os threads atuais que estavam ativos quando o aplicativo travou. O thread que falhou é destacado a vermelho para que compreenda melhor o estado da aplicação.

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. Mostrar o estado de outros threads no momento da falha não é suportado no Windows.

Configurar Alertas

Mantenha-se a par das suas falhas definindo as definições da sua aplicação App Center para enviar uma notificação por e-mail. Você pode definir essa configuração por aplicativo para enviar um email imediatamente quando um novo grupo de falhas for criado ou enviar um e-mail de resumo diário com as principais falhas do seu aplicativo. Para configurar esses alertas:

  1. Inicie sessão no App Center e selecione a sua aplicação
  2. No menu à esquerda, navegue até Configurações
  3. Clique em Notificações por e-mail
  4. Selecione Imediatamente, Diariamente ou Nunca. A configuração padrão é definida como Nunca.

Configuração de captura de ecrã: Problemas com a frequência de notificações por e-mail

Você pode saber mais sobre notificações em nossa documentação do painel 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 para o App Center

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

  • Last updated on