Obtén el seguimiento de la pila de un error en tu aplicación

2025-06-10

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 la traza de la pila de un error en la aplicación que se produjo en los últimos 30 días. Los seguimientos de la pila también están disponibles en la sección Errores del informe de mantenimiento del Centro de Partners.

Para poder usar este método, primero debe usar el método obtener detalles de un error en la aplicación para recuperar el identificador del archivo CAB asociado al error para el que desea obtener la traza de la 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 identificador del archivo CAB asociado al error para el que desea recuperar la traza de pila. Para obtener este identificador, utiliza el método para obtener detalles de un error en tu aplicación y recuperar los detalles de un error específico en 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	Solicitud de URI
OBTENER	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/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	ID de la tienda de la aplicación para la que quieres obtener el seguimiento de la pila. El identificador de la tienda está disponible en el Centro de asociados, en la página de identidad de la aplicación . Un ID de tienda como ejemplo es 9WZDNCRFJ3Q8.	Sí
cabId	cuerda / cadena	Identificador único del archivo CAB asociado al error para el que quiere obtener el rastreo de pila. Para obtener este identificador, utiliza el método para obtener detalles de un error en tu aplicación y recuperar los detalles de un error específico en tu aplicación, y usa el valor cabId en el cuerpo de la 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. Sustituya el valor de applicationId por el identificador de tienda para su 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>

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.

Nota:

Este método solo puede descargar la traza de la pila de un error en la aplicación que se produjo 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
}

Compartir a través de