Abrufen von Fehlerberichtsdaten für Ihre App

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 finden Sie auch im Abschnitt Fehler im Integritätsbericht in Partner Center.

Sie können zusätzliche Fehlerinformationen abrufen, indem Sie die Fehlerdetails abrufen, Stack-Trace abrufen und CAB-Datei herunterladen.

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.

Anfrage

Anforderungssyntax

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

Anforderungsheader

Kopfzeile	type	Beschreibung
Ermächtigung	Zeichenfolge	Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Parameter	type	Beschreibung	Erforderlich
Anwendungs-ID	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 eine Store-ID ist 9WZDNCRFJ3Q8.	Ja
Startdatum	Datum	Das Startdatum im Datumsbereich der abzurufenden Fehlerberichtsdaten. Der Standardwert ist das aktuelle Datum. Wenn aggregationLevelTag, Woche oder Monat ist, sollte dieser Parameter ein Datum im Format mm/dd/yyyyangeben. Wenn aggregationLeveleine 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. Anmerkung: Diese Methode kann nur Fehler abrufen, die in den letzten 30 Tagen aufgetreten sind.	Nein
Enddatum	Datum	Das Enddatum im Datumsbereich der abzurufenden Fehlerberichtsdaten. Der Standardwert ist das aktuelle Datum. Wenn aggregationLevelTag, Woche oder Monat ist, sollte dieser Parameter ein Datum im Format mm/dd/yyyyangeben. Wenn aggregationLeveleine 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.	Nein
Oben	INT	Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximalwert und der Standardwert, wenn nicht angegeben ist, 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
hüpfen	INT	Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze durchzublättern. 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 Antworttext und Wert, die dem Eq - oder ne-Operator zugeordnet sind, und Anweisungen können mit undoder oder kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filterparameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben: Name der Anwendung FehlerName failureHash Symbol Betriebssystemversion osVeröffentlichung eventType Markt Gerätetyp Paketname Paketversion Datum	Nein
Aggregationsniveau	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 nicht angegeben, ist der Standardwert Tag. Wenn Sie Woche oder Monat angeben, sind die Fehlername - und failureHash-Werte auf 1000 Buckets beschränkt. Anmerkung: Wenn Sie Stunden 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.	Nein
Sortierung nach	Zeichenfolge	Eine Anweisung, die die Ergebnisdatenwerte anordnet. Die Syntax lautet *orderby=field [order]. Der Feldparameter kann eine (und nur eine) der folgenden Zeichenfolgen sein: Name der Anwendung FehlerName failureHash Symbol Betriebssystemversion osVeröffentlichung eventType Markt Gerätetyp Paketname Paketversion Datum Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Der Standardwert ist asc. Nachfolgend sehen Sie ein Beispiel für eine Orderby-Zeichenfolge : orderby=date Hinweis: Jeder Parameter muss aus der Liste stammen, die von groupby unterstützt wird.	Nein
GruppierenNach	Zeichenfolge	Eine Anweisung, die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder angeben: FehlerName failureHash Symbol Betriebssystemversion eventType Markt Gerätetyp Paketname Paketversion Die zurückgegebenen Datenzeilen enthalten die im Groupby-Parameter angegebenen Felder sowie folgendes: Datum Anwendungs-ID Name der Anwendung deviceCount (englisch) eventCount (englisch) Der parameter groupby kann mit dem aggregationLevel-Parameter verwendet werden. Beispiel: &groupby=failureName,market&aggregationLevel=week Hinweis: Die Parameter dürfen keine Duplikate enthalten.	Nein

Beispielanforderung

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	type	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.
Gesamtzahl	Integer	Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage.

Fehlerwerte

Elemente im Value-Array enthalten die folgenden Werte.

Wert	type	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.
Anwendungs-ID	Zeichenfolge	Die Store-ID der App, für die Sie Fehlerdaten abrufen möchten.
Anwendungsname	Zeichenfolge	Der Anzeigename der App.
Fehlername	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.
FehlerHash	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
osVeröffentlichung	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 Versionsvorschau Insider schnell Insider Langsam Für Windows Server 1709: RTM Für Windows Server 2016: Version 1607 Für Windows 8.1: Aktualisierung 1 Für Windows 7: Servicepaket 1 Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf.
Ereignistyp	Zeichenfolge	Eine der folgenden Zeichenfolgen: Absturz hängen Gedächtnis JSE
Markt	Zeichenfolge	Der ISO 3166-Ländercode des Gerätemarktes.
Gerätetyp	Zeichenfolge	Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem der Fehler aufgetreten ist: PC Telefon Console-Xbox Eins Console-Xbox Serie X Iot Holographisch Unbekannt
Paketname	Zeichenfolge	Der eindeutige Name des App-Pakets, das diesem Fehler zugeordnet ist.
Paketversion	Zeichenfolge	Die Version des App-Pakets, das diesem Fehler zugeordnet ist.
Geräteanzahl	Zahl	Die Anzahl eindeutiger Geräte, die diesem Fehler für die angegebene Aggregationsebene entsprechen.
Ereigniszählung	Zahl	Die Anzahl der Ereignisse, die diesem Fehler für die angegebene Aggregationsebene zugeordnet werden.

Anmerkung

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

Beispiel für Anforderung und Antwort

Der folgende Codeausschnitt zeigt eine Beispielanforderung und den JSON-Antwortinhalt für diese Anforderung.

Beispielanforderung

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>

Beispielantwort

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

Zugehörige Themen

• Gesundheitsbericht
• Rufen Sie Details zu einem Fehler in Ihrer App ab
• Abrufen der Stapelüberwachung für einen Fehler in Ihrer App
• Herunterladen der CAB-Datei für einen Fehler in Ihrer App
• Zugreifen auf Analysedaten mithilfe von Microsoft Store-Diensten
• Abrufen von App-Käufen
• Abrufen von Add-On-Käufen
• Abrufen von App-Bewertungen
• Abrufen von App-Rezensionen