Obtener datos de informes de errores para tu 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 produjeron 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.
Prerrequisitos
Para usar este método, primero debe hacer lo siguiente:
- Si aún no lo has hecho, completa todos los requisitos previos de la API de análisis de Microsoft Store.
- Obtener un token de acceso de Azure AD para usar 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.
Solicitud
Sintaxis de 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 | string | Obligatorio. 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 tienda de la aplicación para la que deseas 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 ID de Tienda de ejemplo es 9WZDNCRFJ3Q8. | Sí |
| fechaDeInicio | fecha | Fecha de inicio del intervalo de fechas de los datos de informes de errores que se van a recuperar. El valor predeterminado es la fecha actual. Si el nivel de agregación es día, semana, o mes, este parámetro debe especificar una fecha en 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 produjeron en los últimos 30 días. |
No |
| fecha de fin | fecha | Fecha de finalización del intervalo de fechas de los datos de informes de errores que se van a recuperar. El valor predeterminado es la fecha actual. Si el nivel de agregación 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. El valor máximo y el valor predeterminado si no se especifica es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo siguiente que puede usar para solicitar la siguiente página de datos. | No |
| skip | int | Número de filas que se van a omitir en la consulta. Use este parámetro para paginar 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 |
| filtro | 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 un valor que están asociados a los operadores eq o ne, y las instrucciones se pueden combinar utilizando y o o. Los valores de cadena deben estar rodeados de comillas simples en el parámetro filtro. Puede 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, semanao 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 especifica hora, solo podrá recuperar datos de error de las últimas 72 horas. Para recuperar datos de error anteriores a 72 horas, especifique día o uno de los otros 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]. El parámetro del campo puede ser uno, y solo uno, de las cadenas siguientes:
El parámetro orden es opcional y se puede especificar como asc o desc para indicar un orden ascendente o descendente para cada campo. El valor predeterminado es asc. Este es un ejemplo de cadena orderby: orderby=date Nota: Cualquier parámetro debe estar en la lista compatible con groupby. |
No |
| groupby | string | Instrucción que aplica la agregación de datos solo a los campos especificados. Puede especificar los siguientes campos:
Las filas de datos devueltas contendrán los campos especificados en el parámetro groupby
El parámetro groupby se puede usar con el parámetro aggregationLevel. Por ejemplo: &groupby=failureName,market&aggregationLevel=week Nota: Es posible que los parámetros no contengan duplicados. |
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
Cuerpo de la respuesta
| Valor | Tipo | Descripción |
|---|---|---|
| Valor | 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 puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor retorna si el parámetro top de la solicitud se fija en 10000, pero existen más de 10000 filas con errores en la consulta. |
| TotalCount | integer | Número total de filas en el resultado de los datos de la consulta. |
Valores de error
Los elementos en la matriz de Valor contienen los siguientes valores.
| Valor | Tipo | Descripción |
|---|---|---|
| fecha | string | La primera fecha del intervalo de fechas de los datos de error, en el 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 la tienda de la aplicación para la que deseas obtener los datos de error. |
| nombre de la aplicación | string | Nombre para mostrar de la aplicación. |
| nombre del fallo | 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 | Identificador único del error. |
| símbolo | 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. |
| tipoDeEvento | string | Una de las cadenas siguientes:
|
| mercado | string | El código de país ISO 3166 del mercado de dispositivos. |
| tipo de dispositivo | 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 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 produjeron 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 respuesta JSON para esa solicitud.
Solicitud de ejemplo
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 para un error en tu aplicación
- acceder a datos de análisis mediante servicios de Microsoft Store
- Obtener los datos de las adquisiciones de la aplicación
- Obtener los datos de las adquisiciones de complementos
- Obtener clasificaciones de aplicaciones
- Obtener revisiones de aplicaciones