Получение данных отчетов об ошибках для приложения
Используйте этот метод в API аналитики Microsoft Store, чтобы получить статистические данные отчетов об ошибках для приложения в формате JSON для заданного диапазона дат и других необязательных фильтров. Этот метод может получить только ошибки, возникшие за последние 30 дней. Эти сведения также доступны в разделе
Дополнительные сведения об ошибке можно получить с помощью методов для получения сведений об ошибке, для получения трассировки стекаи для скачивания CAB-файла.
Необходимые условия
Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:
- Если это еще не сделано, выполните все предварительные требования для API аналитики Microsoft Store.
- Получите токен доступа Azure AD, чтобы использовать в заголовке запроса для этого метода. После получения маркера доступа у вас есть 60 минут, чтобы использовать его до истечения срока действия. По истечении срока действия токена, вы можете получить новый.
Просьба
Синтаксис запроса
| Метод | URI запроса |
|---|---|
| ПОЛУЧИТЬ | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Заголовок запроса
| Заголовок | Тип | Описание |
|---|---|---|
| Авторизация | струна | Обязательно. Токен доступа Azure AD в виде токена носителя<токена>. |
Параметры запроса
Пример запроса
В следующих примерах показано несколько запросов на получение данных отчетов об ошибках. Замените значение applicationId идентификатором Магазина для приложения.
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>
Ответ
Текст ответа
Значения ошибок
Элементы массива значения содержат следующие значения.
| Ценность | Тип | Описание |
|---|---|---|
| дата | струна | Первая дата в диапазоне дат для данных об ошибках в формате "yyyy-mm-dd". Если запрос задает один день, это значение является этой датой. Если запрос задает более длинный диапазон дат, это значение является первой датой в этом диапазоне дат. Для запросов, указывающих уровень агрегирования со значениемчаса, это значение также включает значение времени в формате hh:mm:ss. |
| applicationId | струна | Идентификатор магазина приложения, для которого требуется получить данные об ошибках. |
| имя приложения | струна | Отображаемое имя приложения. |
| название ошибки | струна | Имя сбоя, состоящее из четырех частей: один или несколько классов проблем, код проверки исключений и ошибок, имя изображения, в котором произошел сбой, и связанное имя функции. |
| failureHash | струна | Уникальный идентификатор ошибки. |
| символ | струна | Символ, назначенный этой ошибке. |
| osVersion | струна | Одна из следующих строк, указывающая версию ОС, в которой произошла ошибка:
|
| osRelease | струна | Одна из следующих строк, указывающая выпуск операционной системы или тестовое кольцо (как подгруппу в версии ОС), в котором произошла ошибка. Для Windows 11: версия 2110 Для Windows 10:
Для Windows Server 1709:
Для Windows Server 2016:
Для Windows 8.1:
Для Windows 7:
Если неизвестен выпуск операционной системы или тестовое кольцо, это поле имеет значение Неизвестно. |
| тип события | струна | Одна из следующих строк:
|
| рынок | струна | Код страны по ISO 3166 для рынка устройств. |
| тип устройства | струна | Одна из следующих строк, указывающих тип устройства, на котором произошла ошибка:
|
| имя пакета | струна | Уникальное имя пакета приложения, связанного с этой ошибкой. |
| версия пакета | струна | Версия пакета приложения, связанного с этой ошибкой. |
| количество устройств | число | Количество уникальных устройств, соответствующих этой ошибке для указанного уровня агрегирования. |
| количество событий | число | Количество событий, которые относятся к этой ошибке для указанного уровня агрегирования. |
Заметка
Этот метод может получить только ошибки, возникшие за последние 30 дней.
Пример запроса и ответа
В следующем фрагменте кода показан пример текста запроса и текста ответа JSON для этого запроса.
Пример запроса
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>
Пример ответа
{
"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
}
Связанные разделы
- отчет о состоянии здоровья
- Получение сведений об ошибке в приложении
- Получите трассировку стека для ошибки в вашем приложении
- Скачать CAB-файл ошибки в вашем приложении
- Получить доступ к аналитическим данным с помощью служб Microsoft Store
- Получение приобретений приложений
- приобретение надстроек
- Оценки приложений
- Получение отзывов приложений