Recuperare l'analisi dello stack per un errore nell'applicazione desktop

  • Articolo

Usare questo metodo nell'API di analisi di Microsoft Store API per ottenere l'analisi dello stack per un errore in un'applicazione desktop aggiunta al programma per applicazioni desktop di Windows. Questo metodo può solo scaricare l'analisi dello stack per un errore che si è verificato negli ultimi 30 giorni. Le analisi dello stack sono anche disponibili nel report sull'integrità per le applicazioni desktop nel Centro per i partner.

Per poter usare questo metodo, è innanzitutto necessario usare il metodo di recupero dei dettagli per un errore nell'applicazione desktop per recuperare l'hash 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'hash ID del file CAB associato all'errore per cui si desidera recuperare l'analisi dello stack. Per ottenere questo valore, usare il metodo di recupero dei dettagli su un errore nell'applicazione desktop per recuperare i dettagli su un errore specifico nell'app e usare il valore cabIdHash 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/desktop/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 prodotto dell'applicazione desktop per cui si desidera ottenere un'analisi dello stack. Per ottenere l'ID prodotto di un'applicazione desktop, aprire qualsiasi report di analisi nel Centro per i partner per l'applicazione desktop (ad esempio il report sull'integrità) e recuperare l'ID prodotto dall'URL. Sì
cabIdHash string Hash ID univoco del file CAB associato all'errore per cui si desidera recuperare l'analisi dello stack. Per ottenere questo valore, usare il metodo di recupero dei dettagli su un errore nell'applicazione desktop per recuperare i dettagli su un errore specifico nell'applicazione e usare il valore cabIdHash 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 i parametri applicationId e cabIdHash con valori appropriati per l'applicazione desktop.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace?applicationId=10238467886765136388&cabIdHash=54ffb83a-e159-41d2-8158-f36f306cc01e 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.
funzione 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.

Risposta di esempio

L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.

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