Recuperare l'analisi dello stack per un errore nell'app
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
}