Získání dat zasílání zpráv o chybách pro vaši aplikaci
Tuto metodu použijte v rozhraní API pro analýzu z Microsoft Storu, abyste získali agregovaná data hlášení chyb pro vaši aplikaci ve formátu JSON pro daný rozsah kalendářních dat a další volitelné filtry. Tato metoda může načíst pouze chyby, ke kterým došlo za posledních 30 dnů. Tyto informace jsou také k dispozici v části Selhání zprávy o stavu v Partnerském centru.
Další informace o chybě můžete načíst pomocí metod získat podrobnosti o chybě, získat trasování zásobníkua stáhnout soubor CAB.
Požadavky
Pokud chcete použít tuto metodu, musíte nejprve provést následující:
- Pokud jste to ještě neudělali, dokončete všechny předpoklady pro rozhraní API pro analytiku obchodu Microsoft Store.
- Získat přístupový token Azure AD a použít ho v hlavičce požadavku pro tuto metodu. Po získání přístupového tokenu ho budete mít 60 minut, než vyprší jeho platnost. Po vypršení platnosti tokenu můžete získat nový.
Prosba
Syntaxe požadavku
| Metoda | Identifikátor URI požadavku |
|---|---|
| DOSTAT | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Hlavička požadavku
| Záhlaví | Typ | Popis |
|---|---|---|
| Oprávnění | řetězec | Povinné. Přístupový token Azure AD ve formuláři Bearer<token>. |
Parametry požadavku
Příklad žádosti
Následující příklady ukazují několik požadavků na získání dat hlášení chyb. Hodnotu applicationId nahraďte ID Obchodu pro vaši aplikaci.
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>
Odpověď
Tělo odpovědi
Chybové hodnoty
Prvky v poli Hodnota obsahují následující hodnoty.
| Hodnota | Typ | Popis |
|---|---|---|
| datum | řetězec | První datum v rozsahu dat chyby ve formátu yyyy-mm-dd. Pokud požadavek určuje jeden den, jedná se o toto datum. Pokud požadavek určuje delší rozsah kalendářních dat, jedná se o první datum v daném rozsahu dat. Pro požadavky, které určují hodnotu aggregationLevelhodina, zahrnuje tato hodnota také časovou hodnotu ve formátu hh:mm:ss. |
| applicationId | řetězec | ID obchodu aplikace, pro kterou chcete načíst chybová data. |
| název aplikace | řetězec | Zobrazovaný název aplikace. |
| název poruchy | řetězec | Název chyby, která se skládá ze čtyř částí: jedna nebo více tříd problémů, kód kontroly výjimek nebo chyb, název obrázku, kde došlo k selhání, a název přidružené funkce. |
| chybaHash | řetězec | Jedinečný identifikátor chyby. |
| symbol | řetězec | Symbol přiřazený k této chybě. |
| osVersion | řetězec | Jeden z následujících řetězců, který určuje verzi operačního systému, ve které došlo k chybě:
|
| osRelease | řetězec | Jeden z následujících řetězců, který určuje vydání OS nebo testovací okruh (jako podskupinu v rámci verze OS), na kterém došlo k chybě. Pro Windows 11: verze 2110 Pro Windows 10:
Pro Windows Server 1709:
Pro Windows Server 2016:
Pro Windows 8.1:
Pokud používáte Windows 7:
Pokud je okruh vydání nebo testovací okruh operačního systému neznámý, má toto pole hodnotu Neznámý. |
| typ události | řetězec | Jeden z následujících řetězců:
|
| trh | řetězec | Kód země ISO 3166 na trhu zařízení. |
| typ zařízení | řetězec | Jeden z následujících řetězců, který označuje typ zařízení, na kterém došlo k chybě:
|
| packageName | řetězec | Jedinečný název balíčku aplikace, který je přidružený k této chybě. |
| packageVersion | řetězec | Verze balíčku aplikace, která je přidružená k této chybě. |
| počet zařízení | číslo | Počet jedinečných zařízení, která odpovídají této chybě pro zadanou úroveň agregace. |
| počet událostí | číslo | Počet událostí, které jsou přiřazeny k této chybě pro zadanou úroveň agregace. |
Poznámka
Tato metoda může načíst pouze chyby, ke kterým došlo za posledních 30 dnů.
Příklad požadavku a odpovědi
Následující fragment kódu ukazuje příklad požadavku a textu odpovědi JSON pro tento požadavek.
Ukázkový požadavek
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>
Ukázková odpověď
{
"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
}