Freigeben über

Abrufen der Stapelverfolgung für einen Fehler in Ihrer Desktopanwendung

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

Bevor Sie diese Methode verwenden können, müssen Sie zunächst die Methode Details für einen Fehler in Ihrer Desktop-Anwendung abrufen verwenden, um den ID-Hash der CAB-Datei zu erhalten, die dem Fehler zugeordnet ist, dessen Stapelverfolgung Sie 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.
  • Rufen Sie ein Azure AD-Zugriffstoken ab , das im Anforderungsheader für diese Methode verwendet werden soll. 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 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 Methode unter Abrufen von Details zu einem Fehler in Ihrer Desktopanwendung, um Details zu einem bestimmten Fehler in Ihrer App abzurufen, und verwenden Sie den cabIdHash-Wert im Antworttext dieser Methode.

Anfrage

Anforderungssyntax

Methode Anforderungs-URI
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/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 Produkt-ID der Desktopanwendung, für die Sie einen Stack-Trace 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 (Kabinett-Identifikationshash) Schnur 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 Methode unter Abrufen von Details zu einem Fehler in Ihrer Desktopanwendung, um Details zu einem bestimmten Fehler in Ihrer Anwendung abzurufen, und verwenden Sie den cabIdHash-Wert im Antworttext dieser Methode. Ja

Beispielanfrage

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe dieser Methode einen Stack-Trace abrufen können. 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=00001111-aaaa-2222-bbbb-3333cccc4444 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.

Antwortbeispiel

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