Freigeben über

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 die Stapelüberwachung nur für einen Fehler herunterladen, der in den letzten 30 Tagen aufgetreten ist. Stapelüberwachungen sind auch im Integritätsbericht für Desktopanwendungen im Partner Center verfügbar.

Bevor Sie diese Methode verwenden können, müssen Sie zunächst die Get-Details für einen Fehler in der 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

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

  • Falls noch nicht geschehen, 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. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
  • Rufen Sie den ID-Hash der CAB-Datei ab, 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 zu einem bestimmten Fehler in Ihrer App abzurufen, und verwenden Sie den cabIdHash-Wert im Antworttext dieser Methode.

Anfordern

Anforderungssyntax

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

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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 jeden Analysebericht für Ihre Desktopanwendung im 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 zu einem bestimmten Fehler in Ihrer Anwendung abzurufen, und verwenden Sie den cabIdHash-Wert im Antworttext dieser Methode. Ja

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe dieser Methode eine Stapelablaufverfolgung 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 Frame mit Stapelablaufverfolgungsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie im Abschnitt "Stapelablaufverfolgungswerte " weiter unten.
@nextLink Zeichenfolge Wenn zusätzliche Datenseiten vorhanden sind, enthält diese Zeichenfolge einen URI, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. Dieser Wert wird beispielsweise zurückgegeben, wenn der oberste Parameter der Anforderung auf 10 festgelegt ist, für die Abfrage jedoch mehr als 10 Fehlerzeilen vorhanden sind.
TotalCount integer Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage.

Stapelablaufverfolgungswerte

Elemente im Value-Array enthalten die folgenden Werte.

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

Beispielantwort

Im folgenden Beispiel wird ein Beispiel für einen JSON-Antworttext für diese Anforderung veranschaulicht.

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