获取桌面应用程序中的错误的堆栈跟踪

2025-05-08

在 Microsoft 应用商店分析 API 中使用此方法，获取您已添加到 Windows 桌面应用程序计划的桌面应用程序中的错误堆栈跟踪。此方法只能下载过去 30 天内发生的错误的堆栈跟踪。合作伙伴中心桌面应用程序的运行状况报告中也提供了堆栈跟踪。

在使用此方法之前，必须先使用获取桌面应用程序方法中错误的详细信息，以检索与要检索堆栈跟踪的错误关联的 CAB 文件的 ID 哈希。

先决条件

若要使用此方法，首先需要执行以下操作：

完成 Microsoft Store 分析 API 的所有先决条件（如果尚未这样做）。
获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。获取访问令牌后，在它到期前，你有 60 分钟的使用时间。令牌过期后，可以获取一个新令牌。
获取与要检索堆栈跟踪的错误关联的 CAB 文件的 ID 哈希。若要获取此值，请使用获取桌面应用程序中错误的详细信息方法检索应用中特定错误的详细信息，并在该方法的响应正文中使用 cabIdHash 值。

请求

请求语法

方法	请求 URI
获取	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace`

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌，形式为Bearer<token>。

请求参数

参数	类型	DESCRIPTION	必选
应用ID	字符串	您想要获取堆栈追踪的桌面应用程序的产品 ID。若要获取桌面应用程序的产品 ID，请在合作伙伴中心（如运行状况报告）中打开桌面应用程序的任何分析报告，并从 URL 检索产品 ID。	是的
出租车ID哈希 (cabIdHash)	字符串	与要检索堆栈跟踪的错误关联的 CAB 文件的唯一 ID 哈希。若要获取此值，请使用获取桌面应用程序方法中错误的详细信息，以检索应用程序中特定错误的详细信息，并在该方法的响应正文中使用 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>

响应

响应体

价值	类型	DESCRIPTION
价值	数组	包含多个对象的数组，每个对象中包含一帧堆栈跟踪数据。有关每个对象中的数据的详细信息，请参阅下面的堆栈跟踪值部分。
@nextLink	字符串	如果有其他数据页，此字符串包含可用于请求下一页数据的 URI。例如，如果请求的顶部参数设置为 10，但查询的错误行数超过 10 行，则返回此值。
总计数	整数	查询的数据结果中的行总数。

堆栈跟踪值

Value 数组中的元素包含以下值。

价值	类型	DESCRIPTION
级别	字符串	此元素在调用堆栈中表示的帧编号。
图像	字符串	包含此堆栈帧中调用的函数的可执行文件或库映像的名称。
功能	字符串	在此堆栈帧中调用的函数的名称。仅当应用包含可执行文件或库的符号时，此选项才可用。
抵消	字符串	当前指令相对于函数开头的字节偏移量。

响应示例

以下示例演示此请求的示例 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
}

通过