Partilhar via

Obter dados de relatório de erros para a sua aplicação de ambiente de trabalho

Use esse método na API de análise da Microsoft Store para obter dados agregados de relatório de erros para um aplicativo da área de trabalho que você adicionou ao programa Aplicativo da Área de Trabalho do Windows. Este método só pode recuperar erros que ocorreram nos últimos 30 dias. Essas informações também estão disponíveis no relatório de integridade do para aplicativos de desktop no Partner Center.

Pré-requisitos

Para usar esse método, você precisa primeiro fazer o seguinte:

  • Se ainda não o fez, preencha todos os pré-requisitos para a API de análise da Microsoft Store.
  • Obtenha um token de acesso do Azure AD para usar no cabeçalho da solicitação para esse método. Depois de obter um token de acesso, você tem 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.

Solicitação

Sintaxe da solicitação

Método Solicitar URI
Obtém https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização cordão Obrigatório O token de acesso Azure AD no formato Bearer<token>.

Parâmetros de solicitação

Parâmetro Tipo Descrição Obrigatório
applicationId cordão O ID do produto da aplicação de ambiente de trabalho para o qual pretende recuperar dados de relatório de erros. Para obter a ID do produto de um aplicativo da área de trabalho, abra qualquer relatório de análise para seu aplicativo da área de trabalho no Partner Center (como o relatório de integridade) e recupere a ID do produto da URL. Sim
data de início data A data de início do intervalo de datas dos dados de relatório de erros a recuperar, no formato mm/dd/yyyy. O padrão é a data atual.

Observação: Este método só pode recuperar erros que ocorreram nos últimos 30 dias.		 Não
data de término data A data final no intervalo de datas dos dados de relatório de erros a serem recuperados, no formato mm/dd/yyyy. O padrão é a data atual. Não
Início Int O número de linhas de dados a serem retornadas na solicitação. O valor máximo e o valor padrão, se não especificado, é 10000. Se houver mais linhas na consulta, o corpo da resposta incluirá um próximo link que você pode usar para solicitar a próxima página de dados. Não
pular Int O número de linhas a serem ignoradas na consulta. Use este parâmetro para percorrer grandes conjuntos de dados. Por exemplo, top=10000 e skip=0 recupera as primeiras 10000 linhas de dados, top=10000 e skip=10000 recupera as próximas 10000 linhas de dados e assim por diante. Não
filtro cordão Uma ou mais declarações que filtram as linhas da resposta. Cada instrução contém um nome de campo do corpo da resposta e valor que estão associados com os operadores eq ou ne , e as instruções podem ser combinadas usando e ou ou. Os valores de cadeia de caracteres devem estar entre aspas simples no parâmetro do filtro . Você pode especificar os seguintes campos do corpo da resposta:

  • nome_do_arquivo
  • applicationVersion
  • failureName
  • failureHash
  • símbolo
  • osVersão
  • osConstruir
  • osLançamento
  • TipoDeEvento
  • mercado
  • Tipo de dispositivo
  • Nome do produto
  • data
 Não
Nível de Agregação cordão Especifica o intervalo de tempo para o qual recuperar dados agregados. Pode ser uma das seguintes cadeias de caracteres: dia, semana ou mês. Se não for especificado, o padrão é dia. Se você especificar semana ou mês, os valores failureName e failureHash serão limitados a 1000 buckets.

 Não
ordenar por cordão Uma instrução que ordena os valores de dados resultantes. A sintaxe é orderby=field [order],field [order],.... O parâmetro field pode ser uma das seguintes strings:
  • nome_do_arquivo
  • applicationVersion
  • failureName
  • failureHash
  • símbolo
  • osVersão
  • osConstruir
  • osLançamento
  • TipoDeEvento
  • mercado
  • Tipo de dispositivo
  • Nome do produto
  • data
O parâmetro order é opcional e pode ser asc ou desc para especificar a ordem crescente ou decrescente para cada campo. O padrão é asc.

Aqui está um exemplo orderby string: orderby=date,market

 Não
agrupar por cordão Uma instrução que aplica a agregação de dados somente aos campos especificados. Você pode especificar os seguintes campos:
  • failureName
  • failureHash
  • símbolo
  • osVersão
  • TipoDeEvento
  • mercado
  • Tipo de dispositivo

As linhas de dados retornadas conterão os campos especificados no parâmetro groupby , bem como o seguinte:

  • data
  • applicationId
  • nome_do_aplicativo
  • eventCount

O parâmetro groupby pode ser usado com o parâmetro aggregationLevel . Por exemplo: &groupby=failureName,market&aggregationLevel=week

 Não

Exemplo de solicitação

Os exemplos a seguir demonstram várias solicitações para obter dados de relatório de erros. Substitua o valor applicationId pelo ID do produto para seu aplicativo da área de trabalho.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Resposta

Corpo da resposta

Valor Tipo Descrição
Valor conjunto Uma matriz de objetos que contêm dados agregados de relatório de erros. Para obter mais informações sobre os dados em cada objeto, consulte a seção relativa aos valores de erro abaixo.
@nextLink cordão Se houver páginas adicionais de dados, essa cadeia de caracteres conterá um URI que você pode usar para solicitar a próxima página de dados. Por exemplo, esse valor será retornado se o parâmetro superior da solicitação estiver definido como 10000, mas houver mais de 10000 linhas de erros para a consulta.
Contagem total número inteiro O número total de linhas no resultado de dados para a consulta.

Valores de erro

Os elementos na matriz Value contêm os seguintes valores.

Valor Tipo Descrição
data cordão A primeira data no intervalo de datas para os dados de erro, especificada no formato yyyy-mm-dd. Se a solicitação especificar um único dia, esse valor será essa data. Se a solicitação especificar um intervalo de datas maior, esse valor será a primeira data nesse intervalo de datas. Para solicitações que especificam um valor de nível de agregação de hora , esse valor também inclui um valor de tempo no formato hh:mm:ss.
applicationId cordão O ID do produto da aplicação de desktop para o qual foram recuperados dados de erro.
Nome do produto cordão O nome de apresentação da aplicação de ambiente de trabalho tal como derivado dos metadados do(s) ficheiro(s) executável(eis) associado(s).
nome_do_aplicativo cordão A determinar
nome do ficheiro cordão O nome do ficheiro executável da aplicação de desktop.
nome da falha cordão O nome da falha, que é composto por quatro partes: uma ou mais classes de problema, um código de verificação de exceção/bug, o nome da imagem onde a falha ocorreu e o nome da função associada.
Hash de falha cordão O identificador exclusivo do erro.
símbolo cordão O símbolo atribuído a este erro.
osConstruir cordão O número de compilação composto por quatro partes do sistema operativo no qual o erro ocorreu.
osVersão cordão Uma das seguintes cadeias de caracteres que especifica a versão do sistema operacional na qual o aplicativo da área de trabalho está instalado:

  • Janelas 7
  • Windows 8.1
  • Janelas 10
  • Janelas 11
  • Windows Server 2016
  • Windows Server 1709
  • Desconhecido
osLançamento do sistema operativo cordão Uma das seguintes cadeias de caracteres que especifica a versão do sistema operativo ou o anel de voo (como uma subpopulação dentro da versão do sistema operativo) onde ocorreu o erro.

Para Windows 11: Versão 2110

Para o Windows 10:

  • Versão 1507
  • Versão 1511
  • Versão 1607
  • Versão 1703
  • Versão 1709
  • Versão 1803
  • Versão prévia de lançamento
  • Insider Rápido
  • Insider Lento

Para o Windows Server 1709:

  • RTM

Para o Windows Server 2016:

  • Versão 1607

Para Windows 8.1:

  • Atualização 1

Para o Windows 7:

  • Pacote de serviço 1

Se a versão do SO ou o anel de lançamento for desconhecido, este campo terá o valor Desconhecido.
tipo de evento cordão Uma das seguintes cadeias de caracteres que indica o tipo de evento de erro:
  • acidente
  • pendurar
  • memória
  • JSE
mercado cordão O código de país ISO 3166 do mercado de dispositivos.
Tipo de dispositivo cordão Uma das seguintes cadeias de caracteres que especifica o tipo de dispositivo no qual o erro ocorreu:

  • Computador Pessoal
  • Servidor
  • Comprimido
  • Desconhecido
versãoDaAplicação cordão A versão do executável do aplicativo em que o erro ocorreu.
contagemDeEventos número O número de eventos atribuídos a esse erro para o nível de agregação especificado.

Exemplo de resposta

O exemplo a seguir demonstra um corpo de resposta JSON de exemplo para essa solicitação.

{
  "Value": [
    {
      "date": "2018-02-01",
      "applicationId": "10238467886765136388",
      "productName": "Contoso Demo",
      "appName": "Contoso Demo",
      "fileName": "contosodemo.exe",
      "failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
      "failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
      "symbol": "hardware_disk!Unknown",
      "osBuild": "10.0.15063.850",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "eventType": "crash",
      "market": "US",
      "deviceType": "PC",
      "applicationVersion": "2.2.2.0",
      "eventCount": 0.0012422360248447205
    }
  ],
  "@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
  "TotalCount": 21
}
  • Last updated on