Получите трассировку стека при возникновении ошибки в настольном приложении.

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

Прежде чем использовать этот метод, необходимо сначала воспользоваться методом получения сведений об ошибке в вашем настольном приложении, чтобы получить хэш идентификатора CAB-файла, связанного с ошибкой, для которой вы хотите получить трассировку стека.

Предпосылки

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

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

Просьба

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

Метод Запрос URI
ПОЛУЧАЙ https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace

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

Заголовок Тип Описание
Авторизация струна Обязательное. Токен доступа Azure AD в форме Bearer<токена>.

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

Параметр Тип Описание Обязательно
applicationId струна Идентификатор продукта настольного приложения, для которого требуется получить трассировку стека. Чтобы получить идентификатор продукта классического приложения, откройте любой отчет аналитики для классического приложения в Центре партнеров (например, отчет о работоспособности) и получите идентификатор продукта из URL-адреса. Да
cabIdHash струна Уникальный хэш идентификатора CAB-файла, связанного с ошибкой, для которой требуется получить трассировку стека. Чтобы получить это значение, используйте метод получения сведений об ошибке в настольном приложении для извлечения информации об определенной ошибке в вашем приложении и используйте значение cabIdHash в теле ответа этого метода. Да

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

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace?applicationId=10238467886765136388&cabIdHash=00001111-aaaa-2222-bbbb-3333cccc4444 HTTP/1.1
Authorization: Bearer <your access token>

Ответ

Основная часть ответа

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

Значения трассировки стека

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

Ценность Тип Описание
уровень струна Номер кадра, который этот элемент представляет в стеке вызовов.
образ струна Имя исполняемого файла или образа библиотеки, содержащего функцию, которая вызывается в этом кадре стека.
функция струна Имя функции, вызываемой в стеке этого кадра. Это доступно только в том случае, если приложение содержит символы для исполняемого файла или библиотеки.
смещение струна Смещение байтов текущей инструкции относительно начала функции.

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

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

{
  "Value": [
    {
      "level": "0",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.MainPage.DoWork",
      "offset": "0x25C"
    }
    {
      "level": "1",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.MainPage.Initialize",
      "offset": "0x26"
    }
    {
      "level": "2",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.Start",
      "offset": "0x66"
    }
  ],
  "@nextLink": null,
  "TotalCount": 3
}
  • Last updated on