Получение данных отчетов об ошибках для классического приложения

Статья
01/10/2024

Используйте этот метод в API аналитики Microsoft Store, чтобы получить статистические данные отчетов об ошибках для классического приложения, добавленного в программу классических приложений Windows. Этот метод может получить только ошибки, возникшие за последние 30 дней. Эти сведения также доступны в отчете о работоспособности классических приложений в Центре партнеров.

Необходимые компоненты

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

Если это еще не сделано, выполните все предварительные требования для API аналитики Microsoft Store.
Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый.

Запросить

Синтаксис запроса

Способ	URI запроса
GET	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits`

Заголовок запроса

Верхний колонтитул	Тип	Описание
Авторизация	строка	Обязательный. Маркер доступа Azure AD в маркере> носителя<формы.

Параметры запроса

Параметр	Тип	Описание	Обязательное поле
applicationId	строка	Идентификатор продукта классического приложения, для которого требуется получить данные отчетов об ошибках. Чтобы получить идентификатор продукта классического приложения, откройте любой отчет аналитики для классического приложения в Центре партнеров (например , отчет о работоспособности) и получите идентификатор продукта из URL-адреса.	Да
startDate	Дата	Дата начала в диапазоне дат для получения данных отчетов об ошибках в формате `mm/dd/yyyy`. Значение по умолчанию — текущая дата. Примечание. Этот метод может получать только ошибки, возникшие за последние 30 дней.	No
endDate	Дата	Дата окончания в диапазоне дат для получения данных отчетов об ошибках в формате `mm/dd/yyyy`. Значение по умолчанию — текущая дата.	No
популярное	INT	Количество строк данных, возвращаемых в запросе. Максимальное значение и значение по умолчанию, если не указано значение 10000. Если в запросе есть больше строк, текст ответа содержит следующую ссылку, которую можно использовать для запроса следующей страницы данных.	No
skip	INT	Количество строк, пропускаемых в запросе. Используйте этот параметр для страницы с помощью больших наборов данных. Например, top=10000 и skip=0 извлекает первые 10000 строк данных, top=10000 и skip=10000 извлекает следующие 10000 строк данных и т. д.	No
Фильтр	строка	Одна или несколько инструкций, которые фильтруют строки в ответе. Каждая инструкция содержит имя поля из текста ответа и значения, связанного с операторами eq или ne, и операторы могут быть объединены с помощью или или. Строковые значения должны быть окружены одними кавычками в параметре фильтра . В тексте ответа можно указать следующие поля: fileName applicationVersion failureName failureHash символ osVersion osBuild osRelease eventType рынок deviceType productName date	No
aggregationLevel	строка	Указывает диапазон времени, для которого требуется получить статистические данные. Может быть одной из следующих строк: день, неделя или месяц. Если не указано, значение по умолчанию равно дню. Если указать неделю или месяц, значения failureName и failureHash ограничены 1000 контейнерами.	No
orderby	строка	Инструкция, которая упорядочивает значения результирующих данных. Синтаксис — orderby=field [order], field [order],.... Параметр поля может быть одной из следующих строк: fileName applicationVersion failureName failureHash символ osVersion osBuild osRelease eventType рынок deviceType productName date Параметр order является необязательным и может быть asc или desc , чтобы указать возрастание или убывание для каждого поля. Значение по умолчанию — asc. Ниже приведен пример строки заказа : orderby=date,market	No
groupby	строка	Инструкция, которая применяет агрегирование данных только к указанным полям. Можно указать следующие поля: failureName failureHash символ osVersion eventType рынок deviceType Возвращаемые строки данных будут содержать поля, указанные в параметре groupby , а также следующие: date applicationId applicationName eventCount Параметр groupby можно использовать с параметром aggregationLevel . Например: &groupby=failureName,market&aggregationLevel=week	No

Пример запроса

В следующих примерах показано несколько запросов на получение данных отчетов об ошибках. Замените значение applicationId идентификатором продукта для классического приложения.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Response

Текст ответа

Значение	Тип	Описание
Значение	array	Массив объектов, содержащих статистические данные отчетов об ошибках. Дополнительные сведения о данных в каждом объекте см . в разделе об ошибках ниже.
@nextLink	строка	Если есть дополнительные страницы данных, эта строка содержит универсальный код ресурса (URI), который можно использовать для запроса следующей страницы данных. Например, это значение возвращается, если верхний параметр запроса имеет значение 10000, но для запроса имеется более 10000 строк ошибок.
TotalCount	integer	Общее количество строк в результатах данных для запроса.

Ошибочные значения

Элементы в массиве значений содержат следующие значения.

Значение	Тип	Описание
Дата	строка	Первая дата в диапазоне дат для данных об ошибках в формате `yyyy-mm-dd`. Если запрос задает один день, это значение является этой датой. Если запрос задает более длинный диапазон дат, это значение является первой датой в этом диапазоне дат. Для запросов, указывающих значение агрегированияLevel часа, это значение также включает значение времени в формате`hh:mm:ss`.
applicationId	строка	Идентификатор продукта классического приложения, для которого вы получили данные об ошибках.
productName	строка	Отображаемое имя классического приложения, полученное из метаданных связанных исполняемых файлов.
appName	строка	Подлежит уточнению
fileName	строка	Имя исполняемого файла для классического приложения.
failureName	строка	Имя сбоя, состоящее из четырех частей: один или несколько классов проблем, код проверки исключений и ошибок, имя изображения, в котором произошел сбой, и связанное имя функции.
failureHash	строка	Уникальный идентификатор ошибки.
symbol	строка	Символ, назначенный этой ошибке.
osBuild	строка	Четырехкомпонентный номер сборки ОС, в которой произошла ошибка.
osVersion	строка	Одна из следующих строк, указывающая версию ОС, в которой установлено классическое приложение: Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 Unknown
osRelease	строка	Одна из следующих строк, указывающая выпуск ОПЕРАЦИОННОй системы или кольцо переключения (как подпопление в версии ОС), в котором произошла ошибка. Для Windows 11: версия 2110 Для Windows 10: Версия 1507 Версия 1511 Версия 1607 Версия 1703 Версия 1709 Версия 1803 Предварительная версия выпуска Быстрая предварительная оценка Медленное выполнение программы предварительной оценки Для Windows Server 1709: RTM Для Windows Server 2016 Версия 1607 Для Windows 8.1: Обновление 1 Для Windows 7: Пакет обновления 1 Если выпуск ОС или кольцо полетов неизвестно, это поле имеет значение Unknown.
eventType	строка	Одна из следующих строк, указывающих тип события ошибки: авария вешать memory jse
на рынок	строка	Код страны ISO 3166 рынка устройств.
deviceType	строка	Одна из следующих строк, указывающая тип устройства, на котором произошла ошибка: ПК Сервер Таблетка Unknown
applicationVersion	строка	Версия исполняемого файла приложения, в которой произошла ошибка.
eventCount	number	Количество событий, которые относятся к этой ошибке для указанного уровня агрегирования.

Пример ответа

В следующем примере показан пример текста ответа JSON для этого запроса.

{
  "Value": [
    {
      "date": "2018-02-01",
      "applicationId": "10238467886765136388",
      "productName": "Contoso Demo",
      "appName": "Contoso Demo",
      "fileName": "contosodemo.exe",
      "failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
      "failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
      "symbol": "hardware_disk!Unknown",
      "osBuild": "10.0.15063.850",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "eventType": "crash",
      "market": "US",
      "deviceType": "PC",
      "applicationVersion": "2.2.2.0",
      "eventCount": 0.0012422360248447205
    }
  ],
  "@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
  "TotalCount": 21
}

Поделиться через

Получение данных отчетов об ошибках для классического приложения

Необходимые компоненты

Запросить

Синтаксис запроса

Заголовок запроса

Параметры запроса

Пример запроса

Response

Текст ответа

Ошибочные значения

Пример ответа

Обратная связь

Дополнительные ресурсы

Поделиться через

Получение данных отчетов об ошибках для классического приложения

Необходимые компоненты

Запросить

Синтаксис запроса

Заголовок запроса

Параметры запроса

Пример запроса

Response

Текст ответа

Ошибочные значения

Пример ответа

См. также

Обратная связь

Дополнительные ресурсы