Partilhar via

Obter o traço de pilha para um erro no seu aplicativo de desktop.

Use este método na API de análise da Microsoft Store para obter o stack trace de um erro numa aplicação de ambiente de trabalho que adicionou no programa Aplicação de Ambiente de Trabalho do Windows. Esse método só pode baixar o rastreamento de pilha para um erro que ocorreu nos últimos 30 dias. Os rastreamentos de pilha também estão disponíveis no relatório de integridade do para aplicativos de desktop no Partner Center.

Antes de poder usar este método, deve primeiro usar o método obter detalhes de um erro na sua aplicação de desktop para recuperar o hash de ID do ficheiro CAB que está associado ao erro para o qual pretende obter o rastreamento de pilha.

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.
  • Obtenha o hash de ID do arquivo CAB associado ao erro para o qual você deseja recuperar o rastreamento de pilha. Para obter esse valor, use o método obter detalhes de um erro na sua aplicação de desktop para recuperar detalhes de um erro específico na sua aplicação e utilize o valor cabIdHash no corpo da resposta desse método.

Solicitação

Sintaxe da solicitação

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

Cabeçalho da solicitação

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

Parâmetros de solicitação

Parâmetro Tipo Descrição Obrigatório
applicationId corda A ID do produto do aplicativo de desktop para o qual você deseja obter um rastreamento de pilha. Para obter a ID do produto de uma aplicação de desktop, abra qualquer relatório de análise para a sua aplicação de desktop no Partner Center (como o relatório de integridade) e extraia a ID do produto da URL. Sim
cabIdHash corda O hash de ID exclusivo do arquivo CAB associado ao erro para o qual você deseja recuperar o rastreamento de pilha. Para obter esse valor, use o método get details for an error na sua aplicação de desktop para recuperar detalhes de um erro específico na sua aplicação e use o valor cabIdHash no corpo da resposta desse método. Sim

Exemplo de solicitação

O exemplo a seguir demonstra como obter um rastreamento de pilha usando esse método. Substitua os parâmetros applicationId e cabIdHash pelos valores apropriados para seu aplicativo de desktop.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace?applicationId=10238467886765136388&cabIdHash=00001111-aaaa-2222-bbbb-3333cccc4444 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 cada um um quadro de dados de rastreamento de pilha. Para obter mais informações sobre os dados em cada objeto, consulte a seção valores de stack trace abaixo.
@nextLink corda 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 10, mas houver mais de 10 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 stack trace

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

Valor Tipo Descrição
nível corda O número do frame que este elemento representa na pilha de chamadas.
imagem corda O nome da imagem executável ou da biblioteca que contém a função chamada neste quadro de pilha.
função corda O nome da função que é chamada neste quadro de pilha. Isso só estará disponível se seu aplicativo incluir símbolos para o executável ou biblioteca.
Compensação corda O deslocamento de byte da instrução atual em relação ao início da função.

Exemplo de resposta

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

{
  "Value": [
    {
      "level": "0",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.MainPage.DoWork",
      "offset": "0x25C"
    }
    {
      "level": "1",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.MainPage.Initialize",
      "offset": "0x26"
    }
    {
      "level": "2",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.Start",
      "offset": "0x66"
    }
  ],
  "@nextLink": null,
  "TotalCount": 3
}
  • Last updated on