Freigeben über

Rufen Sie die Stapelverfolgung für einen Fehler in Ihrer App ab

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um die Stapelverfolgung für einen Fehler in Ihrer App abzurufen. Diese Methode kann nur den Stack-Trace für einen Anwendungsfehler herunterladen, der in den letzten 30 Tagen aufgetreten ist. Stack-Traces sind auch im Abschnitt Fehler des Integritätsberichts im Partnercenter verfügbar.

Bevor Sie diese Methode verwenden können, müssen Sie zuerst die Methode "Details zu einem Fehler in Ihrer App abrufen" verwenden, um die ID der CAB-Datei abzurufen, die dem Fehler zugeordnet ist, für den Sie den Stapelverlauf abrufen möchten.

Voraussetzungen

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

  • Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API aus.
  • Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten 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 Stapelverfolgung abrufen möchten. Verwenden Sie zum Abrufen dieser ID die Methode zur Abrufung von Fehlerdetails in Ihrer App, um spezifische Details zu einem Fehler in Ihrer App abzurufen, und verwenden Sie den Wert cabId im Antwortkörper dieser Methode.

Anfrage

Anforderungssyntax

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

Anforderungs-Kopfzeile

Kopfzeile Typ BESCHREIBUNG
Autorisierung Schnur Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Parameter Typ BESCHREIBUNG Erforderlich
Anwendungs-ID Schnur 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 eine Store-ID ist 9WZDNCRFJ3Q8. Ja
cabId Schnur 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 Methode zur Abrufung von Fehlerdetails in Ihrer App, um spezifische Details zu einem Fehler in Ihrer App abzurufen, und verwenden Sie den Wert cabId im Antwortkörper dieser Methode. Ja

 

Beispielanfrage

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe dieser Methode einen Stack-Trace abrufen können. Ersetzen Sie den Wert applicationId mit der Store-ID Ihrer 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

Antwortkörper

Wert Typ BESCHREIBUNG
Wert Array Ein Array von Objekten, die jeweils einen Frame mit Stack-Trace-Daten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie im Abschnitt "Stapelablaufverfolgungswerte " weiter unten.
@nextLink Schnur 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.
Gesamtzahl Integer Die Gesamtanzahl der Zeilen des Abfrageergebnisses.

Stack-Trace-Werte

Elemente im Value-Array enthalten die folgenden Werte.

Wert Typ BESCHREIBUNG
Niveau Schnur Die Framenummer, die dieses Element im Aufrufstapel darstellt.
Bild Schnur Der Name der ausführbaren Datei oder der Bibliotheksdatei, die die Funktion enthält, die in diesem Stackframe aufgerufen wird.
Funktion Schnur 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 Schnur Der Byte-Offset der aktuellen Instruktion relativ zum Anfang der Funktion.

Hinweis

Diese Methode kann nur den Stack-Trace für einen Anwendungsfehler herunterladen, der in den letzten 30 Tagen aufgetreten ist.

Beispiel für Anforderung und Antwort

Die folgenden Codeausschnitte zeigen einige Beispielanforderungen und den JSON-Antwortkörper für diese Anforderungen.

Beispielanforderung

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

Beispielantwort

{
    "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
}
  • Last updated on