Obtener el seguimiento de pila asociado a 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 la pila de un error en una aplicación de escritorio que hayas agregado al programa Aplicación de escritorio de Windows. Este método solo puede descargar el seguimiento de la pila para un error que se produjo en los últimos 30 días. Los seguimientos de pila también están disponibles en el informe de estado de las aplicaciones de escritorio 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 de escritorio para recuperar el hash de 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 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.
- Obtenga el hash de identificador del archivo CAB asociado al error para el que desea recuperar el seguimiento de la pila. Para obtener este valor, usa los detalles de obtención de un error en el método de la aplicación de escritorio para recuperar los detalles de un error específico en la aplicación y usa el valor cabIdHash en el cuerpo de 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/desktop/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 | Identificador de producto de la aplicación de escritorio para la que desea obtener un seguimiento de la pila. Para obtener el identificador de producto de una aplicación de escritorio, abra cualquier informe de análisis para la aplicación de escritorio en el Centro de partners (como el informe de estado) y recupere el identificador de producto de la dirección URL. | Sí |
cabIdHash | cadena | Hash de identificador único del archivo CAB asociado al error para el que desea recuperar el seguimiento de la pila. Para obtener este valor, use los detalles de obtención de un error en el método de aplicación de escritorio para recuperar los detalles de un error específico en la aplicación y use el valor cabIdHash en el cuerpo de respuesta de ese método. | Yes |
Ejemplo de solicitud
El siguiente ejemplo muestra cómo obtener un seguimiento de la pila con este método. Reemplace los parámetros applicationId y cabIdHash 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=54ffb83a-e159-41d2-8158-f36f306cc01e 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 | cadena | 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. |
Ejemplo de respuesta
En el ejemplo siguiente se muestra el cuerpo de una respuesta JSON de ejemplo realizada 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
}
Temas relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de