Compartir a través de

Obtener el seguimiento de la pila de un error en la aplicación de escritorio

Usa este método en la API de análisis de Microsoft Store para obtener el seguimiento de pila de un error en una aplicación de escritorio que has agregado al programa de Aplicaciones de Escritorio de Windows . Este método solo puede descargar la traza de la pila de un error ocurrido en los últimos 30 días. Los seguimientos de pila también están disponibles en el Informe de salud de para aplicaciones de escritorio en el Centro de Partners.

Para poder usar este método, primero debe usar el método para obtener los detalles de un error en su aplicación de escritorio y así recuperar el hash de identificador del archivo CAB asociado al error para el cual desea recuperar la traza de pila.

Prerrequisitos

Para usar este método, primero debe hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de análisis de Microsoft Store.
  • Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
  • Obtenga el hash de identificador del archivo CAB relacionado con el error para el que desea recuperar la traza. Para obtener este valor, use el método para obtener detalles de un error en su aplicación de escritorio para recuperar los detalles de un error específico en su aplicación, y utilice el valor cabIdHash en el cuerpo de respuesta de ese método.

Solicitud

Sintaxis de la solicitud

Método Solicitud de URI
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId cuerda / cadena Identificador de producto para la aplicación de escritorio para la que desea obtener una traza de pila. Para obtener el identificador de producto de una aplicación de escritorio, abra cualquier informe de análisis de para la aplicación de escritorio en el Centro de Partners (como el informe de estado de ) y recupere el identificador de producto de la dirección URL. Sí
cabIdHash cuerda / cadena Hash de identificador único del archivo CAB asociado al error para el que desea recuperar la traza. Para obtener este valor, utilice el método para obtener detalles de un error en tu aplicación de escritorio y use el valor cabIdHash en el cuerpo de respuesta de ese método. Sí

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo obtener un seguimiento de pila mediante este método. Reemplace los parámetros applicationId ycabIdHash por los valores adecuados para la aplicación de escritorio.

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>

Respuesta

Cuerpo de respuesta

Importancia Tipo Descripción
Importancia arreglo Matriz de objetos que contienen un marco de datos de seguimiento de pila. Para obtener más información sobre los datos de cada objeto, consulte la sección siguiente: valores de seguimiento de pila .
@nextLink cuerda / cadena Si hay páginas adicionales de datos, esta cadena contiene un URI que puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor se devuelve si el parámetro superior de la solicitud se establece en 10, pero hay más de 10 filas de errores en la consulta.
Conteo Total entero Número total de filas en el resultado de los datos de la consulta.

Valores de seguimiento de pila

Los elementos de la matriz Value contienen los valores siguientes.

Importancia Tipo Descripción
nivel cuerda / cadena Número de marco que este elemento representa en la pila de llamadas.
imagen cuerda / cadena Nombre de la imagen ejecutable o de biblioteca que contiene la función a la que se llama en este marco de pila.
función cuerda / cadena Nombre de la función a la que se llama en este marco de pila. Esto solo está disponible si la aplicación incluye símbolos para el archivo ejecutable o la biblioteca.
compensar cuerda / cadena Desplazamiento en bytes de la instrucción actual en relación con el inicio de la función.

Ejemplo de respuesta

En el ejemplo siguiente se muestra un cuerpo de respuesta JSON de ejemplo para esta solicitud.

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