Recuperare l'analisi dello stack per un errore nell'app

  • Articolo

Usare questo metodo nell'API di analisi di Microsoft Store per ottenere l'analisi dello stack per un errore nell'app. Questo metodo può solo scaricare l'analisi dello stack per un errore dell'app che si è verificato negli ultimi 30 giorni. Le analisi dello stack sono anche disponibili nella sezione Errori del report sull'integrità del centro per i partner.

Per poter usare questo metodo, è innanzitutto necessario usare il metodo di recupero dei dettagli per un errore nell'app per recuperare l'ID del file CAB associato all'errore per cui si desidera recuperare l'analisi dello stack.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
  • Ottenere l'ID del file CAB associato all'errore per cui si desidera recuperare l'analisi dello stack. Per ottenere questo ID, usare il metodo di recupero dei dettagli su un errore nell'app per recuperare i dettagli su un errore specifico nell'app e usare il valore cabId nel corpo della risposta di tale metodo.

Richiedi

Sintassi della richiesta

metodo URI della richiesta
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Parametro Tipo Descrizione Richiesto
applicationId string ID dello Store dell'app per cui si desidera ottenere l'analisi dello stack. L'ID dello Store è disponibile nella pagina di identity app nel Centro per i partner. Un esempio di ID dello Store è 9WZDNCRFJ3Q8. Sì
cabId string ID univoco del file CAB associato all'errore per cui si desidera recuperare l'analisi dello stack. Per ottenere questo ID, usare il metodo di recupero dei dettagli su un errore nell'app per recuperare i dettagli su un errore specifico nell'app e usare il valore cabId nel corpo della risposta di tale metodo. Sì

 

Esempio di richiesta

L'esempio seguente illustra come ottenere un'analisi dello stack usando questo metodo. Sostituire il valore applicationId con l'ID dello Store dell'app.

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

Response

Corpo della risposta

Valore Tipo Descrizione
valore matrice Matrice di oggetti che contengono un frame di dati di analisi dello stack. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori analisi dello stack seguente.
@nextLink string Se vi sono ulteriori pagine di dati, la stringa conterrà un URI che è possibile usare per richiedere la pagina di dati successiva. Ad esempio, questo valore viene restituito se il parametro top della richiesta è impostato su 10 ma vi sono più di 10 righe di errori per la query.
TotalCount integer Numero totale di righe nei risultati di dati per la query.

Valori analisi dello stack

Gli elementi nella matrice Value contengono i valori seguenti.

Valore Tipo Descrizione
level string Numero di frame che questo elemento rappresenta nello stack di chiamate.
image string Nome dell'immagine della libreria o eseguibile che contiene la funzione chiamata in questo stack frame.
function string Nome della funzione chiamata in questo stack frame. Questa opzione è disponibile solo se l'app include simboli per l'eseguibile o la libreria.
offset string Offset di byte dell'istruzione corrente rispetto all'inizio della funzione.

Nota

Questo metodo può solo scaricare l'analisi dello stack per un errore dell'app che si è verificato negli ultimi 30 giorni.

Esempio di richiesta e risposta

I frammenti di codice seguenti illustrano alcune richieste di esempio e il corpo della risposta JSON per tali richieste.

Richiesta di esempio

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

Risposta di esempio

{
    "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
}