Compartilhar via

Obtenha o rastreamento de pilha de um erro em seu aplicativo

Use este método na API de análise da Microsoft Store para obter o stack trace de um erro no seu aplicativo. Esse método só pode baixar o rastreamento de pilha para um erro de aplicativo que ocorreu nos últimos 30 dias. Os rastreamentos de pilha também estão disponíveis na seção Falhas do relatório Health no Partner Center.

Antes de usar esse método, você deve primeiro usar o método obter detalhes de um erro no seu aplicativo para recuperar a ID do arquivo CAB associado ao erro para o qual você deseja recuperar o rastreamento de pilha.

Pré-requisitos

Para usar esse 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. Depois de obter um token de acesso, você terá 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.
  • Obtenha a ID do arquivo CAB associado ao erro para o qual você deseja recuperar o rastreamento de pilha. Para obter essa ID, use o método obter detalhes para um erro no seu aplicativo para recuperar detalhes de um erro específico no seu aplicativo, e use o valor cabId no corpo da resposta desse método.

Solicitação

Sintaxe da solicitação

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

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização cadeia de caracteres 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
ID do aplicativo cadeia de caracteres A ID da Loja do aplicativo para o qual você deseja obter o rastreamento de pilha. O ID da Loja está disponível na página de identidade do aplicativo na seção do Centro de Parceiros. Um exemplo de ID de loja é 9WZDNCRFJ3Q8. Sim
Identificação do táxi cadeia de caracteres O ID exclusivo do arquivo CAB associado ao erro para o qual você deseja obter o rastreamento de pilha. Para obter essa ID, use o método obter detalhes para um erro no seu aplicativo para recuperar detalhes de um erro específico no seu aplicativo, e use o valor cabId 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 o valor applicationId pelo ID da loja do seu aplicativo.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 HTTP/1.1
Authorization: Bearer <your access token>

Resposta

Corpo da resposta

Valor Tipo 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 cadeia de caracteres 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 for definido como 10, mas houver mais de 10 linhas de erros para a consulta.
ContagemTotal número inteiro O número total de linhas no resultado dos dados da consulta.

Valores de rastros de pilha

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

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

Observação

Esse método só pode baixar o rastreamento de pilha para um erro de aplicativo que ocorreu nos últimos 30 dias.

Exemplo de solicitação e resposta

Os snippets de código a seguir demonstram alguns exemplos de solicitação e corpo de resposta JSON para essas solicitações.

Solicitação de exemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1234567890123456789
HTTP/1.1
Authorization: Bearer <your access token>

Resposta de exemplo

{
    "Value": [
        {
            "level": "0",
            "image": "Microsoft.Contoso",
            "function": "HANG_QUIESCE",
            "offset": "0x0000000000000000",
            "isBlamedFrame": true
        },
        {
            "level": "1",
            "image": "unknown.dll",
            "function": "[.ecxr]",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "2",
            "image": "ntdll.dll",
            "function": "RtlpHpSegFree",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "3",
            "image": "ntdll.dll",
            "function": "RtlpHpFreeHeap",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "4",
            "image": "ntdll.dll",
            "function": "RtlpFreeHeapInternal",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        }
    ],
    "TotalCount": 5
}