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

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um die Stapelüberwachung für einen Fehler in Ihrer App abzurufen. Diese Methode kann die Stapelüberwachung nur für einen App-Fehler herunterladen, der in den letzten 30 Tagen aufgetreten ist. Stapelüberwachungen sind auch im Abschnitt "Fehler " des Integritätsberichts 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 App-Methode verwenden, um die ID 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 die ID der CAB-Datei ab, die dem Fehler zugeordnet ist, für den Sie die Stapelablaufverfolgung abrufen möchten. Verwenden Sie zum Abrufen dieser ID die Get-Details für einen Fehler in der App-Methode , um Details zu einem bestimmten Fehler in Ihrer App abzurufen, und verwenden Sie den cabId-Wert im Antworttext dieser Methode.

Anfordern

Anforderungssyntax

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

Anforderungsheader

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

Anforderungsparameter

Parameter Typ Beschreibung Erforderlich
applicationId Zeichenfolge Die Store-ID der App, für die Sie die Stapelablaufverfolgung abrufen möchten. Die Store-ID ist auf der Seite "App-Identität" im Partner Center verfügbar. Ein Beispiel für die Store-ID ist 9WZDNCRFJ3Q8. Ja
cabId Zeichenfolge Die eindeutige ID der CAB-Datei, die dem Fehler zugeordnet ist, für den Sie die Stapelablaufverfolgung abrufen möchten. Verwenden Sie zum Abrufen dieser ID die Get-Details für einen Fehler in der App-Methode , um Details zu einem bestimmten Fehler in Ihrer App abzurufen, und verwenden Sie den cabId-Wert im Antworttext dieser Methode. Ja

 

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe dieser Methode eine Stapelablaufverfolgung abrufen. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre App.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 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.

Hinweis

Diese Methode kann die Stapelüberwachung nur für einen App-Fehler herunterladen, der in den letzten 30 Tagen aufgetreten ist.

Beispiel für Anforderung und Antwort

Die folgenden Codeausschnitte zeigen beispielweise Anforderungs- und JSON-Antworttext für diese Anforderung.

Beispiel-Anfrage

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

Beispiel für eine Antwort

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