Compartilhar via

Obter o rastreamento de pilha de um erro no aplicativo da área de trabalho

  • Artigo

Use esse método na API de análise da Microsoft Store para obter o rastreamento de pilha de um erro em um aplicativo da área de trabalho que você adicionou ao programa Aplicativo da Área de Trabalho do Windows. Esse método só pode baixar o rastreamento de pilha para um erro ocorrido nos últimos 30 dias. Os rastreamentos de pilha também estão disponíveis no relatório de integridade para aplicativos da área de trabalho no Partner Center.

Antes de usar esse método, você deve primeiro usar os detalhes de obtenção de um erro no método do aplicativo da área de trabalho para recuperar o hash de ID do arquivo CAB associado ao erro para o qual você deseja recuperar o rastreamento de pilha.

Pré-requisitos

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

  • Se você ainda não fez isso, conclua todos os pré-requisitos da API de análise da Microsoft Store.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. 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 get details for an error in your desktop application para recuperar detalhes de um erro específico em seu aplicativo e use o valor cabIdHash no corpo da resposta desse método.

Solicitar

Sintaxe da solicitação

Método URI da solicitação
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização string Obrigatório. O token de acesso do Azure AD no Token<de portador> do formulário.

Parâmetros da solicitação

Parâmetro Tipo Descrição Obrigatório
applicationId string A ID do produto do aplicativo da área de trabalho para o qual você deseja obter um rastreamento de pilha. Para obter o ID do produto (product ID) de um aplicativo da área de trabalho, abra um relatório de análise para o aplicativo da área de trabalho na Central de Parceiros (como o relatório de integridade) e recupere o ID do produto (product ID) na URL. Sim
cabIdHash string 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 in your desktop application para recuperar detalhes de um erro específico em seu aplicativo 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 da área de trabalho.

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 Type Descrição
Valor matriz Uma matriz de objetos, cada um contendo um quadro de dados de rastreamento de pilha. Para obter mais informações sobre os dados em cada objeto, consulte a seção de valores de rastreamento de pilha abaixo.
@nextLink string Se houver páginas adicionais de dados, essa sequência conterá um URI que você poderá usar para solicitar a próxima página de dados. Por exemplo, esse valor será retornado se o parâmetro top da solicitação for definido como 10, mas houver mais de 10 linhas de erros para a consulta.
TotalCount Número inteiro O número total de linhas no resultado de dados da consulta.

Valores de rastreamento de pilha

Os elementos na matriz Value contêm os valores a seguir.

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

Exemplo de resposta

Veja a seguir um exemplo de corpo de resposta JSON 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
}