Relatório sobre a saúde
O relatório Integridade no Partner Center permite obter dados relacionados ao desempenho e à qualidade do seu aplicativo, incluindo falhas e eventos que não respondem. 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, você pode recuperar programaticamente os dados neste relatório usando a API REST de análise da Microsoft Store.
Alterações de categorização de falha de falha para editores de Apps & Games
Para melhorar a precisão e a qualidade do rastreamento de falhas, há mudanças planejadas para 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.
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 integridade 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 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, UI do Partner Center ou APIs programáticas para acesso aos conjuntos de dados do Hub de Download.
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 - ACCESS_VIOLATION_ACCESS_VIOLATION_ |
Todas as categorias mencionadas à esquerda sã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_ - CODE_ - 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 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ê 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 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 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 selecionada do sistema operacional.
- Sandbox: o padrão é Varejo, mas para produtos que usam várias sandboxes de desenvolvimento (como jogos que se integram ao Xbox Live), você pode 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 a opção 30D está selecionada.
- 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.
Falha atinge
O gráfico Acertos de falha mostra o número de falhas diárias e eventos que os clientes experimentaram ao usar seu aplicativo durante o período de tempo 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. 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 informações relacionadas a alterações significativas nos últimos 30 dias no relatório Insights.
Falha atingida pelo mercado
O gráfico Falhas atingidas 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 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 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 Hits 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. 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 acertos no topo e continuamos descendo a partir daí. Você pode inverter essa ordem alternando a seta na coluna Hits deste gráfico. Para cada falha, também mostramos sua porcentagem do número total de falhas.
Gorjeta
À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 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/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, 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 aplicativo. Em contraste, nomes de falha que incluem !unknown_error_in_ e !unknown_function significam que não fomos capazes de reunir detalhes completos por vários outros motivos.
Para exibir o relatório 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 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, compilação do sistema operacional) e um link para o rastreamento de pilha e/ou arquivo 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 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 de prevalência de pilha, que mostra as pilhas superiores 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 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: mostra a percentagem de dispositivos únicos que não sofreram uma falha 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 Crash
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 - o que a ativação levou a qual Crash.