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

  • Artículo

Usa este método en la API de análisis de Microsoft Store para obtener el seguimiento de la pila de un error en la aplicación. Este método solo puede descargar el seguimiento de la pila de un error en la aplicación que se haya producido en los últimos 30 días. Los seguimientos de la pila también están disponibles en la sección Errores del informe de estado en el Centro de partners.

Para poder usar este método, debes emplear antes el método para obtener los detalles de un error en la aplicación para recuperar el identificador del archivo CAB que está asociado con el error para el que quieres recuperar el seguimiento de la pila.

Requisitos previos

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

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de análisis de Microsoft Store.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Si el token expira, puedes obtener uno nuevo.
  • Obtén el identificador del archivo CAB asociado con el error para el que quieres recuperar el seguimiento de la pila. Para obtener este identificador, usa el método obtener los detalles de un error en la aplicación para recuperar los detalles de un error específico de tu aplicación y usa el valor cabId en el cuerpo de la respuesta de ese método.

Solicitud

Sintaxis de la solicitud

Método URI de solicitud
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace

Encabezado de solicitud

Encabezado Tipo Descripción
Authorization string Necesario. Token de acceso de Azure AD con el formato Token de portador<>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId string El id. de la Tienda de la aplicación para la que quieres recuperar el seguimiento de la pila. El id. de la Tienda está disponible en la página Identidad de la aplicación en el Centro de partners. Un ejemplo de un id. de la Tienda sería 9WZDNCRFJ3Q8. Sí
cabId string El identificador exclusivo del archivo CAB asociado con el error para el que quieres recuperar el seguimiento de la pila. Para obtener este identificador, usa el método obtener los detalles de un error en la aplicación para recuperar los detalles de un error específico de tu aplicación y usa el valor cabId en el cuerpo de la respuesta de ese método. Sí

 

Ejemplo de solicitud

El siguiente ejemplo muestra cómo obtener un seguimiento de la pila con este método. Sustituye el valor applicationId por el id. de la Tienda de la aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 HTTP/1.1
Authorization: Bearer <your access token>

Response

Response body

Valor Tipo Descripción
Valor array Una matriz de objetos, todos los cuales contienen un marco de los datos de seguimiento de la pila. Para obtener más información sobre los datos de cada objeto, consulta la sección valores del rastreo de la pila que encontrarás a continuación.
@nextLink string Si hay páginas adicionales de datos, esta cadena contiene un URI que puedes usar para solicitar la siguiente página de datos. Por ejemplo, se devuelve este valor si el parámetro top de la solicitud está establecido en 10 000, pero resulta que hay más de 10 000 filas de errores de la solicitud.
TotalCount integer El número total de filas del resultado de datos de la consulta.

Valores del seguimiento de la pila

Los elementos de la matriz Value contienen los siguientes valores.

Valor Tipo Descripción
level string El número de marco que este elemento representa en la pila de llamadas.
imagen string El nombre del archivo ejecutable o la biblioteca de imágenes que contiene la función que se llama en este marco de la pila.
function cadena El nombre de la función que se llama en este marco de la pila. Está disponible únicamente si la aplicación incluye símbolos para el archivo ejecutable o la biblioteca.
offset string El desplazamiento de bytes de la instrucción actual en relación con el inicio de la función.

Nota:

Este método solo puede descargar el seguimiento de la pila de un error en la aplicación que se haya producido en los últimos 30 días.

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y cuerpo de respuesta JSON para esa solicitud.

Solicitud de ejemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1234567890123456789
HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

{
    "Value": [
        {
            "level": "0",
            "image": "Microsoft.Contoso",
            "function": "HANG_QUIESCE",
            "offset": "0x0000000000000000",
            "isBlamedFrame": true
        },
        {
            "level": "1",
            "image": "unknown.dll",
            "function": "[.ecxr]",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "2",
            "image": "ntdll.dll",
            "function": "RtlpHpSegFree",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "3",
            "image": "ntdll.dll",
            "function": "RtlpHpFreeHeap",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "4",
            "image": "ntdll.dll",
            "function": "RtlpFreeHeapInternal",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        }
    ],
    "TotalCount": 5
}