Compartilhar via


Relatório de integridade

O relatório de integridade no Partner Center permite que você obtenha dados relacionados ao desempenho e à qualidade do seu aplicativo, incluindo falhas e eventos sem resposta. Você pode exibir esses dados no Partner Center ou baixar o relatório para exibir offline. Quando aplicável, é possível exibir rastreamentos de pilha e/ou arquivos CAB para depuração adicional.

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

Alterações na categorização de falhas de falha para editores de apps e jogos

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

Observação

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

Como os conjuntos de dados de integridade exibem insights 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 buckets de dados antigos e novos coexistirão.

Essas alterações afetariam o conjunto de dados de integridade disponível no Hub de Downloads, APIs Públicas, Interface do Usuário do Partner Center e APIs Programáticas para acesso aos conjuntos de dados do Hub de Download.

As seguintes alterações se aplicam à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
- ACCESS_VIOLATION_ACCESS_VIOLATION_
Todas as categorias mencionadas à esquerda serão 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_
- NO_MODULE_
-CÓDIGO_
- PROBABLY_NOT_USING_GS_
- STACK_COOKIE_CHECK_FAILURE
- GLOBAL_COOKIE_CORRUPT_
- INCORRECT_STACK_
- COOKIES_MATCH_
- RUNNING_ON_STACK_
- STRING_DEREFERENCE_
As categorias mencionadas são removidas dos nomes das falhas.

Aplicar filtros

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

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

  • Versão do pacote: a configuração padrão é Todos. Se o 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í-lo em uma das categorias predefinidas mostradas neste filtro. Para esses dispositivos, o modelo do dispositivo pode ser exibido na seção Log de falhas do relatório de detalhes da falha.
  • Versão do sistema operacional: o padrão é Todas as versões do sistema operacional, mas você pode escolher uma versão específica do sistema operacional.
  • Versão de lançamento do sistema operacional: o padrão é Todas as versões de lançamento do sistema operacional, mas você pode escolher uma versão de lançamento específica da versão do sistema operacional selecionada.
  • Área restrita: o padrão é Varejo, mas para produtos que usam várias áreas restritas de desenvolvimento (como jogos que se integram ao Xbox Live), você pode escolher uma específica aqui. Se o produto não usar sandboxes, esse filtro mostrará apenas Varejo e não será aplicável.)
  • Arquitetura: o padrão é Todas as arquiteturas, mas você pode escolher um tipo de arquitetura de sistema específico. Este filtro só está disponível quando 30D é selecionado.
  • PRAID: a configuração padrão é Todos, mas se você definiu várias IDs de aplicativo relativas ao pacote (PRAIDs) ao criar seu pacote de aplicativos, poderá optar por mostrar apenas dados relacionados a uma PRAID. Esse filtro não aparecerá se você não tiver definido várias PRAIDs.

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

Ocorrências de falhas

O gráfico Ocorrências de falha mostra o número de falhas e eventos diários que os clientes experimentaram ao usar seu aplicativo 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, você pode ver marcadores de círculo. Eles representam um aumento ou diminuição significativa 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 detectamos um aumento ou diminuição significativa em relação à semana anterior. Para ver mais detalhes sobre o que mudou, passe o cursor sobre o círculo.

Dica

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

Falhas atingidas pelo mercado

O gráfico Ocorrências de falha por mercado mostra o número total de falhas e eventos durante o período de tempo selecionado por mercado.

Você pode exibir esses dados em um formulário de tabela . O formulário de tabela mostrará cinco mercados por vez, classificados em ordem alfabética ou pelo número mais alto/menor de sessões de usuário. Você também pode baixar os dados para visualizar informações de todos os mercados juntos.

Versão do pacote

O gráfico Versão do pacote mostra o número total de falhas e eventos durante o período de tempo 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 essa ordem alternando a seta na coluna Ocorrências deste gráfico.

Falhas

O gráfico Falhas mostra o número total de falhas e eventos durante o período de tempo selecionado por nome de falha. O nome da falha, que é composto de quatro partes: uma ou mais classes de problema, um código de verificação de exceção/bug, o nome da imagem em que 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 para baixo a partir daí. Você pode inverter essa ordem alternando a seta na coluna Ocorrências deste gráfico. Para cada falha, mostramos também sua porcentagem do número total de falhas.

Dica

Às vezes, você pode ver uma entrada para Desconhecido nesta seção. Isso ocorre quando, apesar de nossos melhores esforços, não conseguimos coletar detalhes completos de 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 memória parciais/ruins e outros fatores.

Se você vir !unknown como parte de um nome de falha, isso significa que os símbolos não estavam presentes, portanto, não foi possível identificar o nome da falha. Certifique-se de incluir símbolos em seu pacote para obter uma análise precisa de falhas. Consulte Configurar um pacote de aplicativos. Por outro lado, nomes de falha que incluem !unknown_error_in_ e !unknown_function significam que não conseguimos reunir 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 você tiver incluído arquivos de símbolo, o relatório de detalhes da falha incluirá o número de ocorrências de falha 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 sistema operacional) e um link para o rastreamento de pilha e/ou arquivo CAB, se disponível.

Dica

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

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

Sessões e dispositivos sem falhas (30D)

O gráfico Sessões e dispositivos sem falhas mostra a porcentagem de dispositivos ou sessões de usuários que não sofreram falhas nos últimos 30 dias. Essas informações ajudam você a entender o quanto suas falhas estão afetando seus usuários. Por exemplo, um aplicativo pode ter 10.000 falhas em um dia. Se 90% dos seus dispositivos forem afetados, você provavelmente classificará isso como crítico e agirá para corrigi-lo imediatamente. No entanto, se isso representar apenas 5% dos dispositivos que usam seu aplicativo, a prioridade poderá ser menor.

Este gráfico tem duas guias:

  • Dispositivos sem falhas: mostra a porcentagem de dispositivos exclusivos que não tiveram uma falha em cada dia (durante os últimos 30 dias).
  • Sessões sem falhas: mostra a porcentagem de sessões de usuário exclusivas que não sofreram uma falha em cada dia (durante os últimos 30 dias).

Taxa de Acidentes

Uma taxa de Travamento é definida como a soma de Travamentos ocorridos em um Jogo dividido pela soma de Ativações ocorridas, em um período de tempo específico, para todos os Usuários que jogam o Jogo. Sempre que um jogo é aberto/recém-iniciado/iniciado para jogar, é contado como uma ativação. A linha do tempo de uma ativação e uma falha pode ser diferente. 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 qual Crash.