Pobieranie danych raportowania błędów dla aplikacji
Użyj tej metody w interfejsie API analizy sklepu Microsoft Store, aby uzyskać zagregowane dane raportowania błędów dla aplikacji w formacie JSON dla danego zakresu dat i innych opcjonalnych filtrów. Ta metoda może pobierać tylko błędy, które wystąpiły w ciągu ostatnich 30 dni. Te informacje są również dostępne w sekcji Niepowodzenia raportu Zdrowie w Centrum partnerskim.
Dodatkowe informacje o błędach można uzyskać, stosując metody uzyskać szczegóły błędu, uzyskać ślad stosu, oraz pobrać plik CAB.
Warunki wstępne
Aby użyć tej metody, należy najpierw wykonać następujące czynności:
- Jeśli jeszcze tego nie zrobiłeś, wykonaj wszystkie wymagania wstępne dla interfejsu API analizy Microsoft Store.
- Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.
Prośba
Składnia żądania
| Metoda | URI żądania |
|---|---|
| POBIERZ | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Nagłówek żądania
| Nagłówek | Typ | Opis |
|---|---|---|
| Autoryzacja | struna | Wymagane. Token dostępu usługi Azure AD w postaci Bearer<tokenu>. |
Parametry żądania
Przykład żądania
W poniższych przykładach pokazano kilka żądań dotyczących pobierania danych raportowania błędów. Zastąp wartość applicationId identyfikatorem sklepu dla aplikacji.
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>
Odpowiedź
Treść odpowiedzi
Wartości błędów
Elementy w tablicy Value zawierają następujące wartości.
| Wartość | Typ | Opis |
|---|---|---|
| data | struna | Pierwsza data w zakresie dat dla danych o błędach w formacie yyyy-mm-dd. Jeśli żądanie określa jeden dzień, ta wartość jest tą datą. Jeśli żądanie określa dłuższy zakres dat, ta wartość jest pierwszą datą w tym zakresie dat. W przypadku żądań określających wartość agregacji Levelgodziny, ta wartość zawiera również wartość czasu w formacie hh:mm:ss. |
| applicationId | struna | Identyfikator sklepu aplikacji, dla której chcesz pobrać dane o błędach. |
| nazwaAplikacji | struna | Nazwa wyświetlana aplikacji. |
| nazwaAwarii | struna | Nazwa błędu, która składa się z czterech części: co najmniej jednej klasy problemu, kodu sprawdzania wyjątku/błędu, nazwy obrazu, w którym wystąpił błąd i skojarzonej nazwy funkcji. |
| sygnatura błędu | struna | Unikatowy identyfikator błędu. |
| symbol | struna | Symbol przypisany do tego błędu. |
| osVersion | struna | Jeden z następujących ciągów określający wersję systemu operacyjnego, w której wystąpił błąd:
|
| osRelease | struna | Jeden z poniższych ciągów, który określa wydanie systemu operacyjnego lub pierścień testowy (jako podpopulacja w wersji systemu operacyjnego), na którym wystąpił błąd. Dla Windows 11: Wersja 2110 W systemie Windows 10:
W systemie Windows Server 1709:
W systemie Windows Server 2016:
Dla systemu Windows 8.1:
Dla systemu Windows 7:
Jeśli wersja systemu operacyjnego lub pierścień testowy jest nieznany, to pole ma wartość Nieznany. |
| typZdarzenia | struna | Jeden z następujących ciągów:
|
| rynek | struna | Kod kraju ISO 3166 dla rynku urządzeń. |
| typ urządzenia | struna | Jeden z następujących ciągów wskazujący typ urządzenia, na którym wystąpił błąd:
|
| packageName | struna | Unikatowa nazwa pakietu aplikacji skojarzonego z tym błędem. |
| wersja pakietu | struna | Wersja pakietu aplikacji skojarzona z tym błędem. |
| liczba urządzeń | liczba | Liczba unikatowych urządzeń, które odpowiadają temu błędowi dla określonego poziomu agregacji. |
| liczbaWydarzeń | liczba | Liczba zdarzeń przypisanych do tego błędu dla określonego poziomu agregacji. |
Notatka
Ta metoda może pobierać tylko błędy, które wystąpiły w ciągu ostatnich 30 dni.
Przykład żądania i odpowiedzi
Poniższy fragment kodu przedstawia przykładowe żądanie i treść odpowiedzi JSON dla tego żądania.
Przykładowe żądanie
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>
Przykładowa odpowiedź
{
"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
}
Tematy pokrewne
- Raport zdrowotny
- Pobierz szczegóły błędu w swojej aplikacji
- Pobierz ślad stosu dla błędu w aplikacji
- Pobierz plik CAB do naprawy błędu w aplikacji
- Uzyskiwanie dostępu do danych analitycznych przy użyciu usług microsoft Store
- Uzyskiwanie przejęć aplikacji
- uzyskaj zakupy dodatkowe
- Uzyskiwanie ocen aplikacji
- Uzyskiwanie recenzji aplikacji