Recursos de diagnóstico

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

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 falhas 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 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.

Importante

O gráfico de usuários afetados requer dados de sessão do módulo análise do App Center. Inicie os módulos Crashes e Analytics para calcular porcentagens precisas do usuário afetado. Sem Análise, falhas e erros podem parecer afetar 100% de usuários.

Observação

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

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 chamada com falha para uma URL (como "Erro ao chamar azure.com ou google.com"), o App Center poderá agrupar falhas por essa URL. Por exemplo, todas as chamadas com falha para azure.com são agrupadas e todas as chamadas com falha para google.com são agrupadas. No entanto, como o App Center remove do relatório de falhas as URLs precedidas por HTTP ou HTTPS, esse agrupamento só funciona quando você evita essa sintaxe. Por exemplo, "Erro ao chamar http://azure.com"" não é agrupado com outras chamadas a azure.com, mas "Erro ao chamar azure.com" é agrupado com relatórios de erros 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 tratados são compatíveis apenas com 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 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 uma falha

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

Esse recurso requer o módulo análise do App Center. Para definir um evento personalizado, confira a 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 chave-valor

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 .

Observação

Esse recurso só é compatível atualmente com os erros nas plataformas Android, iOS, Xamarin, React Native, Unity, UWP, WinForms e WPF.

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, todas as falhas totalmente simbolizadas e os respectivos rastreamentos de pilha 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.

Observação

No Windows, o relatório mostra apenas o rastreamento de pilha do thread que apresentou a falha. 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 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 carregar falhas via API foi movida.