Edit

Get the stack trace for an error in your desktop application

  • Article

Use this method in the Microsoft Store analytics API to get the stack trace for an error in a desktop application that you have added to the Windows Desktop Application program. This method can only download the stack trace for an error that occurred in the last 30 days. Stack traces are also available in the Health report for desktop applications in Partner Center.

Before you can use this method, you must first use the get details for an error in your desktop application method to retrieve the ID hash of the CAB file that is associated with the error for which you want to retrieve the stack trace.

Prerequisites

To use this method, you need to first do the following:

  • If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Obtain an Azure AD access token to use in the request header for this method. After you obtain an access token, you have 60 minutes to use it before it expires. After the token expires, you can obtain a new one.
  • Get the ID hash of the CAB file that is associated with the error for which you want to retrieve the stack trace. To get this value, use the get details for an error in your desktop application method to retrieve details for a specific error in your app, and use the cabIdHash value in the response body of that method.

Request

Request syntax

Method Request URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace

Request header

Header Type Description
Authorization string Required. The Azure AD access token in the form Bearer <token>.

Request parameters

Parameter Type Description Required
applicationId string The product ID of the desktop application for which you want to get a stack trace. To get the product ID of a desktop application, open any analytics report for your desktop application in Partner Center (such as the Health report) and retrieve the product ID from the URL. Yes
cabIdHash string The unique ID hash of the CAB file that is associated with the error for which you want to retrieve the stack trace. To get this value, use the get details for an error in your desktop application method to retrieve details for a specific error in your application, and use the cabIdHash value in the response body of that method. Yes

Request example

The following example demonstrates how to get a stack trace using this method. Replace the applicationId and cabIdHash parameters with the appropriate values for your desktop application.

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>

Response

Response body

Value Type Description
Value array An array of objects that each contain one frame of stack trace data. For more information about the data in each object, see the stack trace values section below.
@nextLink string If there are additional pages of data, this string contains a URI that you can use to request the next page of data. For example, this value is returned if the top parameter of the request is set to 10 but there are more than 10 rows of errors for the query.
TotalCount integer The total number of rows in the data result for the query.

Stack trace values

Elements in the Value array contain the following values.

Value Type Description
level string The frame number that this element represents in the call stack.
image string The name of the executable or library image that contains the function that is called in this stack frame.
function string The name of the function that is called in this stack frame. This is available only if your app includes symbols for the executable or library.
offset string The byte offset of the current instruction relative to the start of the function.

Response example

The following example demonstrates an example JSON response body for this request.

{
  "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
}