Compartir a través de

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 para un error de 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 en el Centro de partners.

Para poder usar este método, primero debe usar los detalles de obtención de un error en el método de la aplicación para recuperar el identificador del archivo CAB asociado al error para el que desea recuperar el seguimiento de la pila.

Requisitos previos

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

  • Si aún no lo has hecho, completa todos los requisitos previos de la API de análisis de Microsoft Store.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido 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 el seguimiento de la pila. Para obtener este identificador, usa los detalles de obtención de un error en el método de la aplicación para recuperar los detalles de un error específico en la aplicación y usa el valor cabId en el cuerpo de la respuesta de ese método.

Solicitar

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
Autorización 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 Id. de la Tienda de la aplicación para la que quieres obtener el seguimiento de la pila. El Id. de Store está disponible en la página Identidad de la aplicación del Centro de partners. Un ejemplo de Id. de Store es 9WZDNCRFJ3Q8. Sí
cabId string Identificador único del archivo CAB asociado al error para el que desea recuperar el seguimiento de la pila. Para obtener este identificador, usa los detalles de obtención de un error en el método de la aplicación para recuperar los detalles de un error específico en la 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. Reemplaza el valor applicationId por el Id. de Store de tu 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 la respuesta

Valor Tipo Descripción
Valor array 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 valores de seguimiento de la pila a continuación.
@nextLink string Si hay páginas adicionales de datos, esta cadena contiene un URI que se 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 para la consulta.
TotalCount integer Número total de filas que figura en el resultado de datos de la consulta.

Valores de seguimiento de pila

Los elementos de la matriz Value contienen los valores siguientes.

Valor Tipo Descripción
level string Número de marco que este elemento representa en la pila de llamadas.
imagen string Nombre de la imagen ejecutable o de biblioteca que contiene la función a la que se llama en este marco de pila.
function string 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.
offset string 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 para un error de 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 del cuerpo de la respuesta en formato JSON de esa solicitud.

Solicitud de muestra

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
}