Abrufen der Stapelüberwachung für einen Fehler in Ihrer Desktopanwendung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um die Stapelablaufverfolgung für einen Fehler in einer Desktopanwendung abzurufen, die Sie dem Windows-Desktopanwendungsprogramm hinzugefügt haben. Diese Methode kann nur die Stapelablaufverfolgung für einen Fehler herunterladen, der in den letzten 30 Tagen aufgetreten ist. Stapelablaufverfolgungen sind auch im Integritätsbericht für Desktopanwendungen in Partner Center verfügbar.

Bevor Sie diese Methode verwenden können, müssen Sie zuerst die Get-Details für einen Fehler in Ihrer Desktopanwendungsmethode verwenden, um den ID-Hash der CAB-Datei abzurufen, die dem Fehler zugeordnet ist, für den Sie die Stapelablaufverfolgung abrufen möchten.

Voraussetzungen

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:

  • Wenn Sie dies noch nicht getan haben, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
  • Rufen Sie den ID-Hash der CAB-Datei ab, die dem Fehler zugeordnet ist, für den Sie die Stapelablaufverfolgung abrufen möchten. Um diesen Wert abzurufen, verwenden Sie die Get-Details für einen Fehler in Ihrer Desktopanwendungsmethode , um Details für einen bestimmten Fehler in Ihrer App abzurufen, und verwenden Sie den wert cabIdHash im Antworttext dieser Methode.

Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace

Anforderungsheader

Header type BESCHREIBUNG
Authorization Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>.

Anforderungsparameter

Parameter Typ BESCHREIBUNG Erforderlich
applicationId Zeichenfolge Die Produkt-ID der Desktopanwendung, für die Sie eine Stapelablaufverfolgung abrufen möchten. Um die Produkt-ID einer Desktopanwendung abzurufen, öffnen Sie einen beliebigen Analysebericht für Ihre Desktopanwendung in Partner Center (z. B. den Integritätsbericht), und rufen Sie die Produkt-ID aus der URL ab. Ja
cabIdHash Zeichenfolge Der eindeutige ID-Hash der CAB-Datei, die dem Fehler zugeordnet ist, für den Sie die Stapelablaufverfolgung abrufen möchten. Verwenden Sie zum Abrufen dieses Werts die Get-Details für einen Fehler in der Desktopanwendungsmethode , um Details für einen bestimmten Fehler in Ihrer Anwendung abzurufen, und verwenden Sie den wert cabIdHash im Antworttext dieser Methode. Ja

Anforderungsbeispiel

Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Methode eine Stapelüberwachung abrufen. Ersetzen Sie die Parameter applicationId und cabIdHash durch die entsprechenden Werte für Ihre Desktopanwendung.

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>

Antwort

Antworttext

Wert Typ BESCHREIBUNG
Wert array Ein Array von Objekten, die jeweils einen einzelnen Frame der Stapelüberwachungsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt Stapelüberwachungswerte.
@nextLink Zeichenfolge Wenn weitere Seiten mit Daten vorhanden sind, enthält diese Zeichenfolge einen URI, mit dem Sie die nächste Seite mit Daten anfordern können. Beispielsweise wird dieser Wert zurückgegeben, wenn der Parameter top der Anforderung auf 10 festgelegt ist, es jedoch mehr als 10 Zeilen mit Fehlern für die Abfrage gibt.
TotalCount integer Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage.

Stapelüberwachungswerte

Elemente im Array Value enthalten die folgenden Werte.

Wert Typ Beschreibung
Level Zeichenfolge Die Framenummer, die dieses Element im Aufrufstapel darstellt.
image Zeichenfolge Den Namen der ausführbaren Datei oder des Bibliothekbilds, die/das die Funktion enthält, die in diesem Stapelframe aufgerufen wird.
Funktion Zeichenfolge Der Name der Funktion, die in diesem Stapelframe aufgerufen wird. Dies ist nur verfügbar, wenn Ihre App Symbole für die ausführbare Datei oder die Bibliothek enthält.
offset Zeichenfolge Der Byte-Offset der aktuellen Anweisung relativ zum Start der Funktion.

Antwortbeispiel

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.

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