Dela via

Hämta felrapporteringsdata för din app

  • Artikel

Använd den här metoden i Microsoft Store-analys-API:et för att hämta aggregerade felrapporteringsdata för din app i JSON-format för ett angivet datumintervall och andra valfria filter. Den här metoden kan bara hämta fel som inträffat under de senaste 30 dagarna. Den här informationen finns också i avsnittet Fel i Health-rapporten i Partnercenter.

Du kan hämta ytterligare felinformation genom att använda metoderna hämta felinformation, hämta stackspårningoch ladda ned CAB-fil.

Förutsättningar

Om du vill använda den här metoden måste du först göra följande:

  • Om du inte redan har gjort det, slutför alla krav för Microsoft Store-analys-API:et.
  • Hämta en Azure AD-åtkomsttoken som ska användas i begärandehuvudet för den här metoden. När du har fått en åtkomsttoken har du 60 minuter på dig att använda den innan den upphör att gälla. När token har upphört att gälla kan du skaffa en ny.

Begäran

Syntax för begäran

Metod Begär URI
FÅ https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits

Begärandehuvud

Rubrik Typ Beskrivning
Tillstånd sträng Krävs. Azure AD-åtkomsttoken i formuläret Bearer<token>.

Parametrar för begäran

Parameter Typ Beskrivning Krävs
applicationId sträng Store-ID:t för appen som du vill hämta felrapporteringsdata för. Store-ID:t är tillgängligt på sidan Appidentitet i Partnercenter. Ett exempel på butiks-ID är 9WZDNCRFJ3Q8. Ja
startdatum datum Startdatumet i datumintervallet för felrapporteringsdata som ska hämtas. Standardvärdet är det aktuella datumet. Om aggregationLevel är dag, veckaeller månad, bör den här parametern ange ett datum i formatet mm/dd/yyyy. Om aggregationLevel är timmekan den här parametern ange ett datum i formatet mm/dd/yyyy eller ett datum och en tid i formatet yyyy-mm-dd hh:mm:ss.

Obs! Den här metoden kan bara hämta fel som inträffat under de senaste 30 dagarna.		 Nej
** slutdatum datum Slutdatumet i datumintervallet för felrapporteringsdata som ska hämtas. Standardvärdet är det aktuella datumet. Om aggregationLevel är dag, veckaeller månad, bör den här parametern ange ett datum i formatet mm/dd/yyyy. Om aggregationLevel är timmekan den här parametern ange ett datum i formatet mm/dd/yyyy eller ett datum och en tid i formatet yyyy-mm-dd hh:mm:ss. Nej
topp Int Antalet rader med data som ska returneras i begäran. Det maximala värdet och standardvärdet om det inte anges är 10000. Om det finns fler rader i frågan innehåller svarstexten en nästa länk som du kan använda för att begära nästa sida med data. Nej
hoppa över Int Antalet rader som ska hoppa över i frågan. Använd den här parametern för att bläddra igenom stora datamängder. Till exempel hämtar top=10000 och skip=0 de första 1 0000 raderna med data, top=10000 och skip=10000 hämtar nästa 1 0000 rader med data och så vidare. Nej
filter sträng En eller flera instruktioner som filtrerar raderna i svaret. Varje påstående innehåller ett fältnamn från svarsdatadelen och ett värde som är associerat med eq eller ne operatorer, och påståendena kan kombineras med hjälp av och eller eller. Strängvärden måste omges av enkla citattecken i -filtret parametern. Du kan ange följande fält från svarstexten:

  • applicationName
  • felNamn
  • failureHash
  • symbol
  • osVersion
  • osRelease
  • händelsetyp
  • marknaden
  • enhetstyp
  • paketNamn
  • paketversion
  • datum
 Nej
aggregationsnivå sträng Anger det tidsintervall för vilket aggregerade data ska hämtas. Kan vara en av följande strängar: timme, dag, veckaeller månad. Om det är ospecificerat är standardvärdet dag. Om du anger vecka eller månadär failureName och failureHash-värden begränsade till 1 000 buckets.

Obs! Om du anger timmekan du endast hämta feldata från de senaste 72 timmarna. Om du vill hämta feldata som är äldre än 72 timmar anger du dag eller någon av de andra aggregeringsnivåerna.		 Nej
sorteringsordning sträng En instruktion som beställer resultatdatavärdena. Syntaxen är *orderby=field [order]. Parametern i fältet kan vara en (och bara en) av följande strängar:
  • applicationName
  • felNamn
  • failureHash
  • symbol
  • OS-version
  • operativsystemutgåva
  • händelsetyp
  • marknaden
  • enhetstyp
  • packageName
  • paketversion
  • datum

Parametern order är valfri och kan asc eller desc för att ange stigande eller fallande ordning för varje fält. Standardvärdet är asc.

Här är ett exempel orderby sträng: orderby=date

Obs! Alla parametrar måste vara från listan som stöds av groupby.

 Nej
gruppera efter sträng En instruktion som endast tillämpar dataaggregering på de angivna fälten. Du kan ange följande fält:
  • failureName
  • failureHash
  • symbol
  • OS-version
  • händelsetyp
  • marknaden
  • enhetstyp
  • paketNamn
  • packageVersion

De returnerade dataraderna innehåller de fält som anges i parametern groupby samt följande:

  • datum
  • applikations-ID
  • applicationName
  • enhetsantal
  • händelseräknare

Parametern groupby kan användas med parametern aggregationLevel. Till exempel: &grupperaefter=failureName,market&aggregationsnivå=vecka

Obs! Parametrarna får inte innehålla dubbletter.		 Nej

Exempel på begäran

I följande exempel visas flera begäranden om att hämta felrapporteringsdata. Ersätt värdet applicationId med store-ID:t för din 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>

Svar

Svarskropp

Värde Typ Beskrivning
Värde samling En matris med objekt som innehåller aggregerade felrapporteringsdata. Mer information om data i varje objekt finns i avsnittet felvärden nedan.
@nextLink sträng Om det finns ytterligare sidor med data innehåller den här strängen en URI som du kan använda för att begära nästa sida med data. Det här värdet returneras till exempel om den översta parametern för begäran är inställd på 10000 men det finns fler än 1 0000 rader med fel för frågan.
Totalantal heltal Det totala antalet rader i dataresultatet för frågan.

Felvärden

Element i matrisen Value innehåller följande värden.

Värde Typ Beskrivning
datum sträng Det första datumet i datumintervallet för feldata i formatet yyyy-mm-dd. Om begäran anger en enda dag är det här värdet det datumet. Om begäran anger ett längre datumintervall är det här värdet det första datumet i det datumintervallet. För begäranden som anger ett aggregeringNivå värdet timmeinnehåller det här värdet även ett tidsvärde i formatet hh:mm:ss.
applicationId sträng Store-ID:t för appen som du vill hämta feldata för.
applikationsnamn sträng Appens visningsnamn.
felnamn sträng Namnet på felet, som består av fyra delar: en eller flera problemklasser, en undantags-/buggkontrollkod, namnet på den bild där felet inträffade och det associerade funktionsnamnet.
failureHash sträng Den unika identifieraren för felet.
symbol sträng En symbol tilldelad för detta fel.
osVersion sträng En av följande strängar som anger operativsystemversionen där felet inträffade:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Okänd
osRelease sträng En av följande strängar som anger operativsystemets versions- eller flygring (som en underpopulation i OS-versionen) där felet inträffade.

För Windows 11: version 2110

För Windows 10:

  • version 1507
  • Version 1511
  • Version 1607
  • version 1703
  • version 1709
  • version 1803
  • förhandsversion
  • Insider Fast
  • Insider-långsam

För Windows Server 1709:

  • RTM

För Windows Server 2016:

  • version 1607

För Windows 8.1:

  • Uppdatering 1

För Windows 7:

  • Service Pack 1

Om operativsystemets versions- eller flygring är okänd har det här fältet värdet Okänd.
händelsetyp sträng En av följande strängar:
  • krasch
  • hänga
  • minne
  • jse
marknad sträng ISO 3166-landskoden för enhetsmarknaden.
enhetstyp sträng En av följande strängar som anger vilken typ av enhet felet inträffade på:
  • PC
  • Telefon
  • Console-Xbox En
  • Console-Xbox Series X
  • IoT
  • Holografisk
  • Okänd
paketsnamn sträng Det unika namnet på det apppaket som är associerat med det här felet.
paketversion sträng Den version av apppaketet som är associerat med det här felet.
enhetsantal nummer Antalet unika enheter som motsvarar det här felet för den angivna aggregeringsnivån.
antal händelser nummer Antalet händelser som tillskrivs det här felet för den angivna aggregeringsnivån.

Anteckning

Den här metoden kan bara hämta fel som inträffat under de senaste 30 dagarna.

Exempel på begäran och svar

Följande kodfragment visar ett exempel på begäran och JSON-svarstext för denna begäran.

Exempelbegäran

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>

Exempelsvar

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