Relatório sobre a saúde

O relatório Saúde no Partner Center permite obter dados relacionados ao desempenho e à qualidade da sua aplicação, incluindo falhas e eventos não responsivos. Você pode exibir esses dados no Partner Center ou baixar o relatório para exibir offline. Quando aplicável, você pode visualizar rastreamentos de pilha e/ou arquivos CAB para depuração adicional.

Como alternativa, pode recuperar programaticamente os dados deste relatório usando a API REST de análise da Microsoft Store.

Alterações na categorização de falhas para publicadores de Apps e Games

Para melhorar a precisão e a qualidade do rastreamento de falhas, estão planejadas mudanças para as categorizações de falhas de crash. As alterações mencionadas serão aplicadas aos insights do conjunto de dados de saúde a partir de 15 de outubro de 2024.

Nota

Os insights para 15 de outubro de 2024 começarão a aparecer em 15 ou 16 de outubro de 2024. Para informações anteriores a 15 de outubro de 2024, não haverá alterações.

Como os conjuntos de dados de saúde exibem informações dos últimos 30 dias, haverá um período de transição entre 15 de outubro e 15 de novembro de 2024, durante o qual os conjuntos de dados antigos e novos coexistirão.

Essas alterações afetariam o conjunto de dados de saúde disponível no Hub de Downloads, APIs públicas, interface do Partner Center e APIs programáticas para acesso aos conjuntos de dados do Hub de Downloads.

As seguintes alterações aplicam-se às Categorias que precedem os nomes de falha.

Categorias	Alterações
- INVALID_POINTER_READ - INVALID_POINTER_WRITE - INVALID_POINTER_EXECUTE - BAD_INSTRUCTION_PTR - NULL_INSTRUCTION_PTR SOFTWARE_NX_FAULT - VIOLAÇÃO_DE_ACESSO_VIOLAÇÃO_DE_ACESSO_	Todas as categorias mencionadas à esquerda deverão ser agrupadas na nova categoria ACCESS_VIOLATION.
- ACCESS_VIOLATION_FAIL_FAST	As falhas que começam com a categoria são renomeadas para FAIL_FAST.
- STACK_BUFFER_OVERRUN_STACK_BUFFER_OVERRUN	Renomeado para STACK_BUFFER_OVERRUN
- MISSING_GSFRAME_ - GS_FALSE_POSITIVE_ - GS_POSITIVE_ - GS_NOT_UP2DATE_ - GS_UP2DATE_NOT_KNOWN_ - GS_UNKNOWN_ - GS_COOKIE_INIT_ - GS_SUSPECT_ - ZERO_CANARY_WITH_SE - MINGLY_INTACT_BP_ - SEM_MÓDULO_ - CODE_ - PROBABLY_NOT_USING_GS_ - FALHA_NA_VERIFICAÇÃO_DO_COOKIE_DE_PILHA - CORRUPÇÃO_DE_COOKIE_GLOBAL_ - INCORRECT_STACK_ - COOKIES_MATCH_ - RUNNING_ON_STACK_ - STRING_DEREFERENCE_ (desreferenciação de string)	As categorias mencionadas são removidas dos nomes de falha.

Aplicar filtros

Na parte superior da página, você pode selecionar o período de tempo para o qual deseja mostrar os dados. A seleção padrão é 72H (72 horas), mas você pode escolher 30D em vez de mostrar dados dos últimos 30 dias. Os dados são mostrados no seu fuso horário local para a visualização 72H e em UTC para a visualização 30D .

Você pode também expandir Filtros para filtrar todos os dados desta página por versão do pacote, mercado e/ou tipo de dispositivo.

• Versão do pacote: A configuração padrão é Todos. Se seu aplicativo incluir mais de um pacote, você poderá escolher um específico aqui.
• Mercado: o filtro padrão é Todos os mercados, mas você pode limitar os dados a um ou mais mercados.
• Tipo de dispositivo: a configuração padrão é Todos, mas você pode optar por mostrar dados para apenas um tipo de dispositivo específico. A categoria Outros inclui dispositivos em que a marca/modelo é reconhecida, mas não podemos incluí-la em uma das categorias predefinidas mostradas neste filtro. Para esses dispositivos, o modelo do dispositivo pode ser visualizado na seção Registro de falhas do relatório Detalhes da falha.
• Versão do sistema operacional: o padrão é Todas as versões do SO, mas podes escolher uma versão específica.
• Versão de lançamento do sistema operativo: o padrão é Todas as versões de lançamento do sistema operativo, mas pode escolher uma versão de lançamento específica da versão selecionada do sistema operativo.
• Sandbox: o padrão é Retail, mas para produtos que utilizam várias sandboxes de desenvolvimento (como jogos que se integram ao Xbox Live), pode-se escolher uma específica aqui. (Se o seu produto não usar sandboxes, este filtro mostrará apenas Retalho e não será aplicável.)
• Arquitetura: O padrão é Todas as arquiteturas, mas você pode escolher um tipo específico de arquitetura do sistema. Este filtro só está disponível quando 30D está selecionado.
• PRAID: A configuração padrão é Todos, mas se você definiu vários PRAIDs (IDs de aplicativo relativos ao pacote) ao criar seu pacote de aplicativo, poderá optar por mostrar apenas os dados relacionados a um PRAID. Esse filtro não aparecerá se você não tiver definido vários PRAIDs.

As informações em todos os gráficos listados abaixo refletirão o intervalo de datas e os filtros selecionados. Algumas seções também permitem que você aplique filtros adicionais.

Ocorreu uma falha

O gráfico Ocorrências de falhas mostra o número de falhas diárias e eventos que os clientes experimentaram ao usar a sua aplicação durante o período selecionado. Cada tipo de evento que seu aplicativo experimentou é rastreado separadamente: falhas, travamentos, exceções de JavaScript e falhas de memória.

Quando o período de tempo 30D é selecionado, pode ver marcadores de círculo. Estes representam um aumento ou diminuição significativo em um determinado valor que achamos que você vai querer saber. A data em que o círculo aparece representa o final da semana em que detetamos um aumento ou diminuição significativo em comparação com a semana anterior. Para ver mais detalhes sobre o que mudou, passe o mouse sobre o círculo.

Gorjeta

Você pode ver mais perceções relacionadas a alterações significativas nos últimos 30 dias no relatório de Insights.

Falha atingida pelo mercado

O gráfico Falhas por mercado mostra o número total de falhas e eventos ao longo do período de tempo selecionado, segmentado por mercado.

Você pode visualizar esses dados em forma de tabela. O formulário de tabela mostrará cinco mercados de cada vez, classificados alfabeticamente ou pelo maior / menor número de sessões de usuários. Você também pode baixar os dados para visualizar informações de todos os mercados juntos.

Versão de pacote

O gráfico Versão do Pacote mostra o número total de crashes e eventos durante o período selecionado por versão do pacote. Por padrão, mostramos a versão do pacote que teve mais acessos no topo e continuamos descendo a partir daí. Você pode inverter esta ordem alternando a seta na coluna Hits deste gráfico.

Falhas

O gráfico Falhas mostra o número total de acidentes e eventos durante o período de tempo selecionado por nome de falha. Cada nome de falha é composto por quatro partes: uma ou mais classes de problema, um código de verificação de exceção/bug, o nome da imagem/driver onde a falha ocorreu e o nome da função associada. Por padrão, mostramos a falha que teve mais ocorrências no topo e continuamos a partir daí para baixo. Pode inverter essa ordem ao alternar a seta na coluna Acertos deste gráfico. Para cada falha, também mostramos sua porcentagem do número total de falhas.

Gorjeta

Às vezes, pode aparecer uma entrada para Desconhecido nesta secção. Isso ocorre quando, apesar de nossos melhores esforços, não conseguimos coletar detalhes completos para uma ou mais falhas, que serão agrupadas em Desconhecido. Na maioria das vezes, isso ocorre devido a restrições de armazenamento, mas também pode ser resultado das configurações de privacidade de um dispositivo, problemas de conexão de rede, despejos de falhas parciais/incorretos e outros fatores.

Se você vir !unknown como parte de um nome de falha, isso significa que os símbolos não estavam presentes, então não foi possível identificar o nome da falha. Certifique-se de incluir símbolos em seu pacote para obter uma análise de falhas precisa. Consulte Configurar um pacote de aplicação. Pelo contrário, nomes de falha que incluem !unknown_error_in_ e !unknown_function significam que não conseguimos obter detalhes completos por vários outros motivos.

Para exibir o relatório de detalhes da falha para uma falha específica, selecione o nome da falha. Se tiver incluído ficheiros de símbolo, o relatório Detalhes da Falha incluirá o número de ocorrências no último mês e um log de falhas que lista os detalhes da ocorrência (data, versão do pacote, tipo de dispositivo, modelo do dispositivo, build do SO) e um link para o traço de pilha ou ficheiro CAB, se disponível.

Gorjeta

Os arquivos CAB só estarão disponíveis quando a falha ocorreu em um computador usando uma compilação do Windows Insider, portanto, nem todas as falhas incluirão a opção de download CAB. Para mostrar apenas falhas com ficheiros CAB, selecione Falhas com downloads no filtro de seção. Você também pode clicar no cabeçalho Links no registo de falhas Failure log para ordenar os resultados para que as falhas que incluem arquivos CAB apareçam no topo da lista.

Na página de Detalhes da falha, você também verá o gráfico de prevalência de pilha, que mostra as principais pilhas que contribuíram para a falha, ordenadas por porcentagem, e o gráfico de configuração do dispositivo (30D), que fornece detalhes sobre a configuração dos dispositivos que experienciaram a falha.

Sessões e dispositivos sem falhas (30D)

O gráfico de Sessões e Dispositivos Sem Falhas mostra a percentagem de dispositivos ou sessões de utilizador que não sofreram uma falha nos últimos 30 dias. Estas informações ajudam-no a compreender até que ponto as suas falhas estão a afetar os seus utilizadores. Por exemplo, um aplicativo pode ter 10.000 falhas em um dia. Se 90% dos seus dispositivos forem afetados, você provavelmente classificaria isso como crítico e agiria para corrigi-lo imediatamente. No entanto, se isso representar apenas 5% dos dispositivos que usam seu aplicativo, a prioridade pode ser menor.

Este gráfico tem dois separadores:

• Dispositivos sem falhas (crash-free): mostra a percentagem de dispositivos únicos que não sofreram falhas em cada dia (durante os últimos 30 dias).
• Sessões sem falhas: mostra a percentagem de sessões de utilizadores únicos que não sofreram uma falha em cada dia (durante os últimos 30 dias).

Taxa de Falhas

Uma taxa de Falhas é definida como a soma de Falhas ocorridas para um Jogo dividida pela soma das Ativações ocorridas, por um período de tempo específico, para todos os Usuários que jogam o Jogo. Sempre que um Jogo é aberto/recém-iniciado/lançado para jogar é contado como uma ativação. A linha do tempo de uma ativação e de uma falha pode diferir. Pode acontecer que a ativação tenha ocorrido hoje, mas o acidente ocorreu no dia seguinte. A taxa de falhas é contada apenas dentro do período de tempo mencionado. Ele não fornece informações sobre qual ativação levou a que falha.