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

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

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

必备条件

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

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

请求

请求语法

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

请求头

标头 类型 说明
授权 字符串 必需。 Azure AD 访问令牌的格式为 Bearertoken<>。

请求参数

参数 类型 描述 必需
applicationId 字符串 要为其获取堆栈跟踪的桌面应用程序的产品 ID。 若要获取桌面应用程序的产品 ID,请在合作伙伴中心打开桌面应用程序的分析报告(如运行状况报告)并从 URL 检索产品 ID。
cabIdHash string 获取与要检索堆栈跟踪的错误相关联的 CAB 文件的唯一 ID 哈希。 要获取此值,请使用获取桌面应用程序中的错误的详细信息方法来检索应用程序中特定错误的详细信息,并使用该方法的响应正文中的 cabIdHash 值。

请求示例

以下示例演示如何使用此方法获取堆栈跟踪。 将 applicationIdcabIdHash 值替换为桌面应用程序的相应值。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace?applicationId=10238467886765136388&cabIdHash=54ffb83a-e159-41d2-8158-f36f306cc01e HTTP/1.1
Authorization: Bearer <your access token>

响应

响应正文

类型 说明
Value array 一组对象,其中每个包含堆栈跟踪数据的一个帧。 有关每个对象中的数据的详细信息,请参阅以下堆栈跟踪值部分。
@nextLink string 如果存在其他数据页,则此字符串包含一个你可用来请求下一页数据的 URI。 例如,当请求的 top 参数设置为 10,但查询的错误超过 10 行时,就会返回此值。
TotalCount integer 查询的数据结果中的行总数。

堆栈跟踪值

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

Value 类型 说明
级别 string 此元素在调用堆栈中表示的帧编号。
image string 可执行文件或库映像的名称,包含在此堆栈帧中调用的函数。
function string 在此堆栈帧中调用的函数名称。 仅当应用包含可执行文件或库的符号时才可用。
offset string 相对于函数开始的当前指令的字节偏移量。

响应示例

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