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í získání podrobností o chybě, získání trasování zásobníku a stažení souboru 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ískejte přístupový token Azure AD , který se použije 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 formě Bearer<token>.

Parametry požadavku

Parametr Typ Popis Požadováno
ID aplikace řetězec ID aplikace v obchodě, pro kterou chcete získat data o hlášení chyb. ID obchodu je k dispozici na stránce identity aplikace v Partnerském centru. Příklad ID obchodu je 9WZDNCRFJ3Q8. Ano
datum zahájení datum Počáteční datum rozsahu dat o hlášení chyb, která chcete načíst. Výchozí hodnota je aktuální datum. Pokud dnetýdne nebo měsíc, měl by tento parametr zadat datum ve formátu . Pokud je aggregationLevelhodina, může tento parametr specifikovat datum ve formátu mm/dd/yyyy nebo datum a čas ve formátu yyyy-mm-dd hh:mm:ss.

Poznámka: Tato metoda může načíst pouze chyby, ke kterým došlo za posledních 30 dnů.
Ne
datum ukončení datum Koncové datum v rozsahu dat hlášení chyb, která mají být načtena. Výchozí hodnota je aktuální datum. Pokud dnetýdne nebo měsíc, měl by tento parametr zadat datum ve formátu . Pokud je aggregationLevelhodina, může tento parametr specifikovat datum ve formátu mm/dd/yyyy nebo datum a čas ve formátu yyyy-mm-dd hh:mm:ss. Ne
vrchol Int Počet řádků dat, které se mají v požadavku vrátit. Maximální hodnota a výchozí hodnota, pokud není zadána, je 1 0000. Pokud dotaz obsahuje více řádků, text odpovědi obsahuje další odkaz, který můžete použít k vyžádání další stránky dat. Ne
přeskočit Int Počet řádků, které se mají v dotazu přeskočit. Pomocí tohoto parametru můžete procházet velké datové sady. Například top=100000 a skip=0 načte prvních 1 0000 řádků dat, top=10000 a skip=10000 načte dalších 1 0000 řádků dat atd. Ne
filtr řetězec Jeden nebo více příkazů, které filtrují řádky v odpovědi. Každý příkaz obsahuje název pole z těla odpovědi a hodnoty, které jsou přidruženy k operátorům eq nebo ne, a příkazy lze kombinovat pomocí nebonebo. Řetězcové hodnoty musí být v parametru filtru ohraničeny jednoduchými uvozovkami. V textu odpovědi můžete zadat následující pole:

  • název aplikace
  • názevChyby
  • failureHash
  • symbol
  • verze operačního systému
  • osRelease
  • typ události
  • trh
  • typ zařízení
  • packageName
  • Verze balíčku
  • datum
Ne
úroveň agregace řetězec Určuje časový rozsah, pro který se mají načítat agregovaná data. Může to být jeden z následujících řetězců: hodina, den, týden nebo měsíc. Pokud není zadáno, výchozí hodnota je . Pokud zadáte týden nebo měsíc, hodnoty failureName a failureHash jsou omezené na 1 000 kbelíků.

Poznámka: Pokud zadáte hodinu, můžete načíst chybová data pouze z předchozích 72 hodin. Pokud chcete načíst data chyb starší než 72 hodin, zadejte den nebo jednu z dalších úrovní agregace.
Ne
seřadit podle řetězec Výrok, který seřadí hodnoty výsledných dat. Tato syntaxe je *orderby=field [order]. Parametr pole může být jeden (a pouze jeden) z následujících řetězců:
  • název aplikace
  • názevChyby
  • failureHash
  • symbol
  • verze operačního systému
  • osRelease
  • typ události
  • trh
  • typ zařízení
  • packageName
  • Verze balíčku
  • datum

Parametr pořadí je volitelný a může být asc nebo desc k určení vzestupného nebo sestupného pořadí pro každé pole. Výchozí hodnota je asc.

Tady je příklad řetězce orderby : orderby=date

Poznámka: Libovolný parametr musí být ze seznamu podporovaného groupby.

Ne
skupinování řetězec Příkaz, který použije agregaci dat pouze na zadaná pole. Můžete zadat následující pole:
  • názevChyby
  • failureHash
  • symbol
  • verze operačního systému
  • typ události
  • trh
  • typ zařízení
  • packageName
  • Verze balíčku

Vrácené datové řádky budou obsahovat pole zadaná v parametru groupby a také následující:

  • datum
  • applicationId
  • název aplikace
  • počet zařízení
  • eventCount

Parametr groupby lze použít s parametrem aggregationLevel . Příklad: &groupby=failureName,market&aggregationLevel=week

Poznámka: Parametry nemusí obsahovat duplicity.
Ne

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 Storu 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

Hodnota Typ Popis
Hodnota pole Pole objektů, které obsahují agregovaná data hlášení chyb. Více informací o datech v jednotlivých objektech najdete v oddíle chybových hodnot níže.
@nextLink řetězec Pokud jsou k dispozici další stránky dat, obsahuje tento řetězec identifikátor URI, který můžete použít k vyžádání další stránky dat. Tato hodnota se například vrátí, pokud je horní parametr požadavku nastavený na 1 0000, ale dotaz obsahuje více než 1 0000 řádků chyb.
CelkovýPočet celé číslo Celkový počet řádků ve výsledku dat dotazu.

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 aggregationLevelhodiny, tato hodnota obsahuje také časovou hodnotu ve formátu hh:mm:ss.
ID aplikace ř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.
značka ř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ě:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Neznámý
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:

  • Verze 1507
  • Verze 1511
  • Verze 1607
  • Verze 1703
  • Verze 1709
  • Verze 1803
  • Release Preview
  • Insider Fast
  • Insider Slow

Pro Windows Server 1709:

  • RTM

Pro Windows Server 2016:

  • Verze 1607

Pro Windows 8.1:

  • Aktualizace 1

Pokud používáte Windows 7:

  • Service Pack 1

Pokud je verze nebo 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ů:
  • havárie
  • pověsit
  • paměť
  • jse
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ě:
  • Osobní počítač
  • Telefon
  • Console-Xbox One
  • Console-Xbox Série X
  • Iot
  • Holografický
  • Neznámý
název balíčku řetězec Jedinečný název balíčku aplikace, který je přidružený k této chybě.
verze balíčku ř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
}