Partilhar via

Obter o rastreamento de pilha de um erro no seu aplicativo

  • Artigo

Use esse método na API de análise da Microsoft Store para obter o rastreamento de pilha de um erro em 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 de integridade no Partner Center.

Antes de usar esse método, você deve primeiro usar o método get details for an error in your app para recuperar a 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 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 get details for an error in your app para recuperar detalhes de um erro específico em seu aplicativo e use o valor cabId 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/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 da Loja do aplicativo para o qual você deseja obter o rastreamento de pilha. O ID da Store está disponível na página de identidade do aplicativo na Central de Parceiros. Um exemplo de ID da Store é 9WZDNCRFJ3Q8. Sim
Identificação do táxi string A ID exclusiva do arquivo CAB associado ao erro para o qual você deseja recuperar o rastreamento de pilha. Para obter essa ID, use o método get details for an error in your app para recuperar detalhes de um erro específico em 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 pela ID da Store para 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 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.

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ções e o corpo da resposta JSON para estas 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
}