Obtener datos de informes de errores de la aplicación
Usa este método en la API de análisis de Microsoft Store para obtener datos agregados de informes de errores para la aplicación en formato JSON para un intervalo de fechas determinado y otros filtros opcionales. Este método solo puede recuperar errores que se hayan producido en los últimos 30 días. Esta información también está disponible en la sección Errores del informe de estado en el Centro de partners.
Puedes recuperar información adicional de errores mediante los métodos obtener detalles de errores, obtener seguimiento de la pila y descargar archivo CAB.
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.
Solicitar
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Encabezado de solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| Autorización | cadena | 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 Store de la aplicación para la que quieres recuperar los datos de informes de errores. 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í |
| startDate | date | Fecha de inicio del intervalo de fechas de los datos de informes de errores que se van a recuperar. La fecha actual es el valor predeterminado. Si aggregationLevel es día, semana o mes, este parámetro debe especificar una fecha con el formato mm/dd/yyyy. Si aggregationLevel es hora, este parámetro puede especificar una fecha con el formato mm/dd/yyyy o una fecha y hora con el formato yyyy-mm-dd hh:mm:ss.Nota: Este método solo puede recuperar los errores que se hayan producido en los últimos 30 días. |
No |
| endDate | date | Fecha de finalización del intervalo de fechas de los datos de informes de errores que se van a recuperar. La fecha actual es el valor predeterminado. Si aggregationLevel es día, semana o mes, este parámetro debe especificar una fecha con el formato mm/dd/yyyy. Si aggregationLevel es hora, este parámetro puede especificar una fecha con el formato mm/dd/yyyy o una fecha y hora con el formato yyyy-mm-dd hh:mm:ss. |
No |
| top | int | Número de filas de datos que se van a devolver en la solicitud. Si no se especifica, el valor predeterminado y el valor máximo es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo “Siguiente” que puedes usar para solicitar la siguiente página de datos. | No |
| skip | int | Número de filas que se omiten en la consulta. Usa este parámetro para pasar de página en conjuntos de datos grandes. Por ejemplo, top=10000 y skip=0 recupera las primeras 10000 filas de datos, top=10000 y skip=10000 recupera las siguientes 10000 filas de datos, etc. | No |
| filter | string | Una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un nombre de campo del cuerpo de la respuesta y el valor que están asociados a los operadores eq o ne, y las instrucciones se pueden combinar mediante y u o. Los valores de cadena deben estar entre comillas simples en el parámetro de filtro. Puedes especificar los campos siguientes desde el cuerpo de la respuesta:
|
No |
| aggregationLevel | string | Especifica el intervalo de tiempo para el que se van a recuperar los datos agregados. Puede ser una de las siguientes cadenas: hora, día, semana o mes. Si no se especifica nada, el valor predeterminado es día. Si indicas semana o mes, los valores failureName y failureHash están limitados a 1000 depósitos.Nota: Si especificas hora, solo puedes recuperar datos de errores de las 72 horas anteriores. Para recuperar datos de errores anteriores a 72 horas, especifica día u otro de los niveles de agregación. | No |
| orderby | string | Instrucción que ordena los valores de los datos en los resultados. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede estar formado por una de las siguientes cadenas:
El parámetro order es opcional y puede ser asc o desc para especificar el orden ascendente o descendente de cada campo. El valor predeterminado es asc. Este es un ejemplo de cadena orderby: orderby=date,market |
No |
| groupby | string | Instrucción que aplica la agregación de datos solo a los campos especificados. Puedes especificar los siguientes campos:
Las filas de datos devueltas contendrán los campos especificados en el parámetro groupby, además de los siguientes:
El parámetro groupby se puede usar con el parámetro aggregationLevel. Por ejemplo: &groupby=failureName,market&aggregationLevel=week |
No |
Ejemplo de solicitud
En los ejemplos siguientes se muestran varias solicitudes para obtener datos de informes de errores. Reemplaza el valor applicationId por el Id. de Store de tu aplicación.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'phone' HTTP/1.1
Authorization: Bearer <your access token>
Respuesta
Response body
| Valor | Tipo | Descripción |
|---|---|---|
| Value | array | Matriz de objetos que contienen datos agregados de informes de errores. Para obtener más información sobre los datos de cada objeto, consulta la sección valores de error 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 se introducce el valor 10000 para el parámetro top de la solicitud, pero hay más de 10000 filas de errores para la consulta. |
| TotalCount | integer | Número total de filas que figura en el resultado de datos de la consulta. |
Valores del error
Los elementos de la matriz Value contienen los valores siguientes.
| Valor | Tipo | Descripción |
|---|---|---|
| date | string | La primera fecha del intervalo de fechas de los datos de errores, en formato yyyy-mm-dd. Si la solicitud especifica un solo día, este valor es esa fecha. Si la solicitud especifica un intervalo de fechas más largo, este valor es la primera fecha de ese intervalo de fechas. En el caso de las solicitudes que especifican un valor aggregationLevel de hora, este valor también incluye un valor de hora en formato hh:mm:ss. |
| applicationId | string | El Id. de Store de la aplicación para la que quieres recuperar los datos de error. |
| applicationName | string | Nombre para mostrar de la aplicación. |
| failureName | string | Nombre del error, que consta de cuatro partes: una o varias clases de problemas, un código de comprobación de errores o excepciones, el nombre de la imagen donde se produjo el error y el nombre de la función asociada. |
| failureHash | string | El identificador único del error. |
| symbol | string | Símbolo asignado a este error. |
| osVersion | string | Una de las siguientes cadenas que especifica la versión del sistema operativo en la que se produjo el error:
|
| osRelease | string | Una de las siguientes cadenas que especifica la versión del sistema operativo o el anillo de distribución de paquetes piloto (como subpoblación dentro de la versión del sistema operativo) en la que se produjo el error. Para Windows 11: versión 2110 Para Windows 10:
Para Windows Server 1709:
Para Windows Server 2016:
Para Windows 8.1:
Para Windows 7:
Si se desconoce la versión del sistema operativo o el anillo de distribución de paquestes piloto, este campo tiene el valor Desconocido. |
| eventType | string | Una de las cadenas siguientes:
|
| market | string | El código de país ISO 3166 del mercado del dispositivo. |
| deviceType | string | Una de las siguientes cadenas que indica el tipo de dispositivo en el que se produjo el error:
|
| packageName | string | Nombre único del paquete de la aplicación asociado a este error. |
| packageVersion | string | La versión del paquete de la aplicación que está asociada a este error. |
| deviceCount | number | Número de dispositivos únicos que corresponden a este error para el nivel de agregación especificado. |
| eventCount | number | Número de eventos que se atribuyen a este error para el nivel de agregación especificado. |
Nota:
Este método solo puede recuperar errores que se hayan producido en los últimos 30 días.
Ejemplo de solicitud y respuesta
En el fragmento de código siguiente se muestra un ejemplo de solicitud y un cuerpo de la respuesta en formato JSON para esa solicitud.
Solicitud de muestra
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=07/02/2022&endDate=07/20/2022&top=10&skip=0&filter=market eq 'US'&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&orderby=date
HTTP/1.1
Authorization: Bearer <your access token>
Respuesta de ejemplo
{
"Value": [
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
"failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
"symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "PC",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 6.0,
"eventCount": 1.05263157894737
},
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
"failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
"symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "Unknown",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 7.14285714285714,
"eventCount": 1.05263157894737
},
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_twinapi.appcore.dll!WaitCoalesced",
"failureHash": "233e04bb-7a3d-eb28-c316-1120aa9defc0",
"symbol": "twinapi.appcore.dll!WaitCoalesced",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "PC",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 6.0,
"eventCount": 8.94736842105263
}
],
"@nextLink": "failurehits?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2022/07/02&endDate=2022/07/21&top=10&skip=10&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&filter=market eq 'US'&orderby=date",
"TotalCount": 443
}
Temas relacionados
- Informe de estado
- Obtener los detalles de un error en la aplicación
- Obtener el seguimiento de la pila de un error en la aplicación
- Descargar el archivo CAB asociado a un error en la aplicación
- Acceso a datos analíticos mediante los servicios de Microsoft Store
- Obtener los datos de las adquisiciones de la aplicación
- Obtener los datos de las adquisiciones de complementos
- Obtener las valoraciones de la aplicación
- Obtener las opiniones de la aplicación
Comentarios
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: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de