Ottenere i dati di segnalazione degli errori per l'app
Usa questo metodo nell'API di analisi di Microsoft Store per ottenere dati aggregati sulla segnalazione degli errori per la tua app in formato JSON per un determinato intervallo di date e altri filtri facoltativi. Questo metodo può recuperare solo gli errori che si sono verificati negli ultimi 30 giorni. Queste informazioni sono disponibili anche nella sezione Errori del report sulla salute nel Centro per i Partner.
È possibile recuperare informazioni aggiuntive sull'errore usando i metodi visualizzare i dettagli dell'errore, ottenere la traccia dello stacke scaricare il file CAB.
Prerequisiti
Per usare questo metodo, è prima necessario eseguire le operazioni seguenti:
- Se non l'hai già fatto, completa tutti i prerequisiti e per l'API di analisi del Microsoft Store.
- Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, si hanno 60 minuti per usarlo prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
Richiesta
Sintassi della richiesta
| Metodo | URI della richiesta |
|---|---|
| OTTIENI | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Intestazione della richiesta
| Intestazione | Digitare | Descrizione |
|---|---|---|
| Autorizzazione | corda | Obbligatorio. Token di accesso di Azure AD nel formato Bearer<token>. |
Parametri della richiesta
Esempio di richiesta
Gli esempi seguenti illustrano diverse richieste di recupero dei dati di segnalazione errori. Sostituire il valore di applicationId con l'ID dello Store della tua app.
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>
Risposta
Corpo della risposta
| Valore | Digitare | Descrizione |
|---|---|---|
| Valore | array | Matrice di oggetti che contengono dati aggregati sulla segnalazione degli errori. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione valori di errore e riportata di seguito. |
| @nextLink | corda | Se sono presenti pagine aggiuntive di dati, questa stringa contiene un URI che è possibile usare per richiedere la pagina successiva dei dati. Questo valore, ad esempio, viene restituito se il parametro superiore della richiesta è impostato su 10000, ma sono presenti più di 10000 righe di errore nella query. |
| Conteggio Totale | numero intero | Numero totale di righe nel risultato dei dati per la query. |
Valori di errore
Gli elementi nella matrice Value
| Valore | Digitare | Descrizione |
|---|---|---|
| dattero | corda | Prima data nell'intervallo di date per i dati di errore, nel formato yyyy-mm-dd. Se la richiesta specifica un singolo giorno, questo valore corrisponde a tale data. Se la richiesta specifica un intervallo di date più lungo, questo valore corrisponde alla prima data nell'intervallo di date. Per le richieste che specificano un valore di aggregationLevel di ora, questo valore include anche un'indicazione dell'ora nel formato hh:mm:ss. |
| applicationId | corda | ID dello Store dell'app per cui vuoi recuperare i dati degli errori. |
| nomeApplicazione | corda | Nome visualizzato dell'app. |
| nomeErrore | corda | Nome dell'errore, costituito da quattro parti: una o più classi di problemi, un codice di controllo di eccezione/bug, il nome dell'immagine in cui si è verificato l'errore e il nome della funzione associata. |
| hashErrore | corda | Identificatore univoco per l'errore. |
| simbolo | corda | Simbolo assegnato a questo errore. |
| Versione del sistema operativo | corda | Una delle stringhe seguenti che specifica la versione del sistema operativo in cui si è verificato l'errore:
|
| osRelease | corda | Una delle stringhe seguenti che specifica il rilascio del sistema operativo o l'anello di distribuzione (come sottogruppo all'interno della versione del sistema operativo) in cui si è verificato l'errore. Per Windows 11: versione 2110 Per Windows 10:
Per Windows Server 1709:
Per Windows Server 2016:
Per Windows 8.1:
Per Windows 7:
Se il rilascio del sistema operativo o il flighting ring è sconosciuto, questo campo ha il valore Sconosciuto. |
| tipoEvento | corda | Una delle stringhe seguenti:
|
| mercato | corda | Codice paese ISO 3166 del mercato dei dispositivi. |
| tipoDispositivo | corda | Una delle stringhe seguenti che indica il tipo di dispositivo in cui si è verificato l'errore:
|
| packageName | corda | Nome univoco del pacchetto dell'app associato a questo errore. |
| versione pacchetto | corda | Versione del pacchetto dell'app associato a questo errore. |
| deviceCount | numero | Numero di dispositivi univoci che corrispondono a questo errore per il livello di aggregazione specificato. |
| numeroEventi | numero | Numero di eventi attribuiti a questo errore per il livello di aggregazione specificato. |
Nota
Questo metodo può recuperare solo gli errori che si sono verificati negli ultimi 30 giorni.
Esempio di richiesta e risposta
Il frammento di codice seguente illustra una richiesta di esempio e il corpo della risposta JSON per tali richieste.
Richiesta di esempio
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>
Risposta di esempio
{
"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
}
Argomenti correlati
- report sulla salute
- Ottenere i dettagli per un errore nell'app
- Ottieni la traccia dello stack per un errore nell'app
- Scarica il file CAB per un errore nell'applicazione
- Accedere ai dati di analisi con i servizi di Microsoft Store
- Ottenere acquisizioni di app
- Acquisire componenti aggiuntivi
- Ottenere valutazioni delle app
- Ottenere le recensioni delle app