Abrufen von Fehlerberichtsdaten für Ihre App

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um aggregierte Fehlerberichtsdaten für Ihre App im JSON-Format für einen bestimmten Zeitraum und andere optionale Filter abzurufen. Diese Methode kann nur Fehler abrufen, die in den letzten 30 Tagen aufgetreten sind. Diese Informationen sind auch im Abschnitt Fehler des Berichts "Integrität" im Partner Center verfügbar.

Sie können zusätzliche Fehlerinformationen abrufen, indem Sie die Fehlerdetails abrufen, Stapelüberwachung abrufen und CAB-Dateimethoden herunterladen.

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.

Anfordern

Anforderungssyntax

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

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 Fehlerberichtsdaten abgerufen werden sollen. 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
startDate date Das Startdatum im Datumsbereich der abzurufenden Fehlerberichtsdaten. Die Standardeinstellung ist das aktuelle Datum. Wenn aggregationLevel Tag, Woche oder Monat ist, sollte dieser Parameter ein Datum im Format mm/dd/yyyy angeben. Wenn aggregationLevel Stunde ist, kann dieser Parameter ein Datum im Format mm/dd/yyyy oder ein Datum und eine Uhrzeit im Format yyyy-mm-dd hh:mm:ssangeben.

Hinweis: Diese Methode kann nur Fehler abrufen, die in den letzten 30 Tagen aufgetreten sind.		 No
endDate date Das Enddatum im Datumsbereich der abzurufenden Fehlerberichtsdaten. Die Standardeinstellung ist das aktuelle Datum. Wenn aggregationLevel Tag, Woche oder Monat ist, sollte dieser Parameter ein Datum im Format mm/dd/yyyy angeben. Wenn aggregationLevel Stunde ist, kann dieser Parameter ein Datum im Format mm/dd/yyyy oder ein Datum und eine Uhrzeit im Format yyyy-mm-dd hh:mm:ssangeben. No
Oben int Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Höchstwert und der Standardwert, falls nicht angegeben, ist 10000. Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. Nein
skip int Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. Beispielsweise ruft top=10000 und skip=0 die ersten 10000 Datenzeilen ab, top=100000 und skip=10000 ruft die nächsten 10000 Datenzeilen usw. ab. Nein
filter Zeichenfolge Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antwortkörper und einen Wert, die mit den Operatoren eq oder ne verbunden sind, und Anweisungen können mit and oder or kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben:

  • applicationName
  • failureName
  • failureHash
  • Symbol
  • osVersion
  • osRelease
  • eventType
  • market
  • deviceType
  • Paketname
  • packageVersion
  • date
 No
aggregationLevel Zeichenfolge Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Dies kann eine der folgenden Zeichenfolgen sein: Stunde, Tag, Woche oder Monat. Wenn keine Angabe erfolgt, lautet der Standardwert Tag. Wenn Sie Woche oder Monat angeben, sind die failureName- und failureHash-Werte auf 1000 Buckets beschränkt.

Hinweis: Wenn Sie Stunde angeben, können Sie Fehlerdaten nur aus den vorherigen 72 Stunden abrufen. Wenn Sie Fehlerdaten abrufen möchten, die älter als 72 Stunden sind, geben Sie den Tag oder eine der anderen Aggregationsebenen an.		 No
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte anordnet. Die Syntax ist orderby=Feld [order], Feld [order],.... Der Feld-Parameter kann eine der folgenden Zeichenfolgen sein:
  • applicationName
  • failureName
  • failureHash
  • Symbol
  • osVersion
  • osRelease
  • eventType
  • market
  • deviceType
  • Paketname
  • packageVersion
  • date

Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Die Standardeinstellung ist asc.

Hier ist ein Beispiel für eine orderby-Zeichenfolge: orderby=date,market

 Nein
groupby Zeichenfolge Eine Anweisung, die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder angeben:
  • failureName
  • failureHash
  • Symbol
  • osVersion
  • eventType
  • market
  • deviceType
  • Paketname
  • packageVersion

Die zurückgegebenen Datenzeilen enthalten die im groupby-Parameter angegebenen Felder sowie Folgendes:

  • Datum
  • applicationId
  • applicationName
  • deviceCount
  • eventCount

Der groupby-Parameter kann mit dem aggregationLevel-Parameter verwendet werden. Beispiel: &groupby=failureName,market&aggregationLevel=week

 No

Anforderungsbeispiel

Die folgenden Beispiele veranschaulichen mehrere Anforderungen für das Abrufen von Fehlerberichtsdaten. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre App.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'phone' HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antworttext

Wert Typ BESCHREIBUNG
Wert array Ein Array von Objekten, die aggregierte Fehlerberichtsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt Fehlerwerte.
@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. Beispielsweise wird dieser Wert zurückgegeben, wenn der oberste Parameter der Anforderung auf 10000 festgelegt ist, aber für die Abfrage mehr als 10000 Zeilen mit Fehlern vorhanden sind.
TotalCount integer Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage.

Fehlerwerte

Elemente im Value-Array enthalten die folgenden Werte.

Wert Typ Beschreibung
Datum Zeichenfolge Das erste Datum im Datumsbereich für die Fehlerdaten im Format yyyy-mm-dd. Wenn die Anforderung einen einzelnen Tag angibt, ist dieser Wert dieses Datum. Wenn die Anforderung einen längeren Datumsbereich angibt, ist dieser Wert das erste Datum in diesem Datumsbereich. Für Anforderungen, die einen aggregationLevel-Wert der Stunde angeben, enthält dieser Wert auch einen Zeitwert im Format hh:mm:ss.
applicationId Zeichenfolge Die Store-ID der App, für die Sie Fehlerdaten abrufen möchten.
applicationName Zeichenfolge Der Anzeigename der App.
failureName Zeichenfolge Der Name des Fehlers, der aus vier Teilen besteht: einer oder mehreren Problemklassen, einem Ausnahme-/Fehlerüberprüfungscode, dem Namen des Bilds, in dem der Fehler aufgetreten ist, und dem zugehörigen Funktionsnamen.
failureHash Zeichenfolge Der eindeutige Bezeichner für den Fehler.
Symbol Zeichenfolge Das diesem Fehler zugewiesene Symbol.
osVersion Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, für die der Fehler aufgetreten ist:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8,1
  • Windows 10
  • Windows 11
  • Unbekannt
osRelease Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion oder den Flighting-Ring (als Unterpopulation innerhalb der Betriebssystemversion) angibt, für die der Fehler aufgetreten ist.

Für Windows 11: Version 2110

Für Windows 10:

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Version 1803
  • Vorschauversion
  • Insider Fast
  • Insider Slow

Für Windows Server 1709:

  • RTM

Für Windows Server 2016:

  • Version 1607

Für Windows 8,1:

  • Update 1

Für Windows 7:

  • Service Pack 1

Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf.
eventType Zeichenfolge Eine der folgenden Zeichenfolgen:
  • crash
  • hang
  • memory
  • jse
Markt Zeichenfolge Der ISO 3166-Ländercode des Gerätemarktes.
deviceType Zeichenfolge Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem der Fehler aufgetreten ist:
  • PC
  • Telefonnummer
  • Konsolen-Xbox One
  • Konsolen-Xbox Series X
  • IoT
  • Holographisch
  • Unbekannt
packageName Zeichenfolge Der eindeutige Name des App-Pakets, das diesem Fehler zugeordnet ist.
packageVersion Zeichenfolge Die Version des App-Pakets, das diesem Fehler zugeordnet ist.
deviceCount Zahl Die Anzahl eindeutiger Geräte, die diesem Fehler für die angegebene Aggregationsebene entsprechen.
eventCount Zahl Die Anzahl der Ereignisse, die diesem Fehler für die angegebene Aggregationsebene zugeordnet werden.

Hinweis

Diese Methode kann nur Fehler abrufen, die in den letzten 30 Tagen aufgetreten sind.

Beispiel für Anforderung und Antwort

Der folgende Codeausschnitt veranschaulicht einen Beispieltext für Anforderungs- und JSON-Antwort für diese Anforderung.

Beispiel-Anfrage

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=07/02/2022&endDate=07/20/2022&top=10&skip=0&filter=market eq 'US'&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&orderby=date
HTTP/1.1
Authorization: Bearer <your access token>

Beispiel für eine Antwort

{
    "Value": [
        {
            "date": "2022-07-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
            "failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
            "symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
            "osVersion": "6.3.9600",
            "osRelease": "RTM",
            "osArchitecture": null,
            "eventType": "hang",
            "market": "US",
            "deviceType": "PC",
            "praid": null,
            "packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
            "packageVersion": "2.5.2.34894",
            "ram": null,
            "massStorage": null,
            "cpu": null,
            "cpuManufacturer": null,
            "cpuFamilyName": null,
            "sandboxId": null,
            "deviceCount": 6.0,
            "eventCount": 1.05263157894737
        },
        {
            "date": "2022-07-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
            "failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
            "symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
            "osVersion": "6.3.9600",
            "osRelease": "RTM",
            "osArchitecture": null,
            "eventType": "hang",
            "market": "US",
            "deviceType": "Unknown",
            "praid": null,
            "packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
            "packageVersion": "2.5.2.34894",
            "ram": null,
            "massStorage": null,
            "cpu": null,
            "cpuManufacturer": null,
            "cpuFamilyName": null,
            "sandboxId": null,
            "deviceCount": 7.14285714285714,
            "eventCount": 1.05263157894737
        },
        {
            "date": "2022-07-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "failureName": "APPLICATION_HANG_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_twinapi.appcore.dll!WaitCoalesced",
            "failureHash": "233e04bb-7a3d-eb28-c316-1120aa9defc0",
            "symbol": "twinapi.appcore.dll!WaitCoalesced",
            "osVersion": "6.3.9600",
            "osRelease": "RTM",
            "osArchitecture": null,
            "eventType": "hang",
            "market": "US",
            "deviceType": "PC",
            "praid": null,
            "packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
            "packageVersion": "2.5.2.34894",
            "ram": null,
            "massStorage": null,
            "cpu": null,
            "cpuManufacturer": null,
            "cpuFamilyName": null,
            "sandboxId": null,
            "deviceCount": 6.0,
            "eventCount": 8.94736842105263
        }
    ],
    "@nextLink": "failurehits?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2022/07/02&endDate=2022/07/21&top=10&skip=10&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&filter=market eq 'US'&orderby=date",
    "TotalCount": 443
}