Recuperare i dati sulla segnalazione di errori per l'app

  • Articolo

Usare questo metodo nell'API di analisi di Microsoft Store per ottenere i dati aggregati sulla segnalazione degli errori per l'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 anche disponibili nella sezione Errori del report sull'integrità nel Centro per i partner.

È possibile recuperare informazioni aggiuntive sugli errori usando i metodi di recupero dei dettagli sugli errori, recupero dell'analisi dello stack e download del file CAB.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di 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, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiedi

Sintassi della richiesta

metodo URI della richiesta
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Parametro Tipo Descrizione Richiesto
applicationId string ID dello Store dell'app per cui si desidera recuperare i dati di segnalazione degli errori. L'ID dello Store è disponibile nella pagina di identity app nel Centro per i partner. Un esempio di ID dello Store è 9WZDNCRFJ3Q8. Sì
startDate data Data di inizio nell'intervallo di date dei dati di segnalazione degli errori da recuperare. L'impostazione predefinita è la data corrente. Se aggregationLevel è day, week o month, questo parametro deve specificare una data nel formato mm/dd/yyyy. Se aggregationLevel è hour, questo parametro può specificare una data nel formato mm/dd/yyyy o una data e ora nel formato yyyy-mm-dd hh:mm:ss.

Nota: questo metodo può recuperare solo gli errori che si sono verificati negli ultimi 30 giorni.		 No
endDate data Data di fine nell'intervallo di date dei dati di segnalazione degli errori da recuperare. L'impostazione predefinita è la data corrente. Se aggregationLevel è day, week o month, questo parametro deve specificare una data nel formato mm/dd/yyyy. Se aggregationLevel è hour, questo parametro può specificare una data nel formato mm/dd/yyyy o una data e ora nel formato yyyy-mm-dd hh:mm:ss. No
migliori int Numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito, se non specificati, sono pari a 10000. Se nella query sono presenti più righe, il corpo della risposta includerà un collegamento che consente di richiedere la pagina successiva dei dati. No
skip int Numero di righe da ignorare nella query. Usare questo parametro per scorrere i set di dati di grandi dimensioni. Ad esempio, top=10000 e skip=0 recupera le prime 10.000 righe di dati, top=10000 e skip=10000 recupera le 10.000 righe di dati successive e così via. No
filter string Una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un nome di campo del corpo della risposta e un valore associati agli operatori eq o ne e le istruzioni possono essere combinate usando and o or. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter. È possibile specificare i campi seguenti del corpo della risposta:

  • applicationName
  • failureName
  • failureHash
  • simbolo
  • osVersion
  • osRelease
  • eventType
  • market
  • deviceType
  • packageName
  • packageVersion
  • date
 No
aggregationLevel string Specifica l'intervallo di tempo per il quale recuperare i dati aggregati. Può essere una delle stringhe seguenti: hour, day, week o month. Se non è specificato, il valore predefinito è day. Se si specifica week o month, i valori failureName e failureHash sono limitati a 1.000 bucket.

Note: se si specifica hour, è possibile recuperare i dati sugli errori solo delle 72 ore precedenti. Per recuperare i dati sugli errori precedenti a 72 ore, specificare day o un altro livello di aggregazione.		 No
orderby string Istruzione che ordina i valori dei dati dei risultati. La sintassi è orderby=field [order],field [order],.... Il parametro field può essere una delle stringhe seguenti:
  • applicationName
  • failureName
  • failureHash
  • simbolo
  • osVersion
  • osRelease
  • eventType
  • market
  • deviceType
  • packageName
  • packageVersion
  • date

Il parametro order è facoltativo e può essere asc o desc per specificare l'ordine crescente o decrescente di ogni campo. Il valore predefinito è asc.

Di seguito è riportato un esempio di stringa orderby: orderby=date,market

 No
groupby string Istruzione che applica l'aggregazione dei dati solo ai campi specificati. È possibile specificare i campi seguenti:
  • failureName
  • failureHash
  • simbolo
  • osVersion
  • eventType
  • market
  • deviceType
  • packageName
  • packageVersion

Le righe di dati restituite conterranno i campi specificati nel parametro groupby e i seguenti:

  • date
  • applicationId
  • applicationName
  • deviceCount
  • eventCount

Il parametro groupby può essere usato con il parametro aggregationLevel. Ad esempio: &groupby=failureName,market&aggregationLevel=week

 No

Esempio di richiesta

Gli esempi seguenti illustrano diverse richieste di recupero di dati sulla segnalazione degli errori. Sostituire il valore applicationId con l'ID dello Store dell'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>

Response

Corpo della risposta

Valore Tipo Descrizione
valore matrice Matrice di oggetti che contengono dati aggregati sulla segnalazione degli errori. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori errori seguente.
@nextLink string Se vi sono ulteriori pagine di dati, la stringa conterrà un URI che è possibile usare per richiedere la pagina di dati successiva. Ad esempio, questo valore viene restituito se il parametro top della richiesta è impostato su 10000 ma vi sono più di 10.000 righe di errori per la query.
TotalCount integer Numero totale di righe nei risultati di dati per la query.

Valori dell'errore

Gli elementi nella matrice Value contengono i valori seguenti.

Valore Tipo Descrizione
data string Prima data nell'intervallo di date per i dati degli errore, in formato yyyy-mm-dd. Se la richiesta specifica un singolo giorno, questo valore corrisponde alla 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 specifica un valore aggregationLevel hour, questo valore include anche un valore di ora nel formato hh:mm:ss.
applicationId string ID dello Store dell'app per cui si desidera recuperare i dati sugli errori.
applicationName string Nome visualizzato dell'app.
failureName string Nome dell'errore, composto da quattro parti: una o più classi di problema, un codice di controllo eccezione/bug, il nome dell'immagine in cui si è verificato l'errore e il nome della funzione associata.
failureHash string Identificatore univoco per l'errore.
simbolo string Simbolo assegnato a questo errore.
osVersion string Una delle stringhe seguenti che specifica la versione del sistema operativo in cui si è verificato l'errore:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Unknown
osRelease string Una delle stringhe seguenti che specifica la release del sistema operativo o l'anello di anteprima (come sottopopolazione all'interno della versione del sistema operativo) in cui è si è verificato l'errore.

Per Windows 11: versione 2110

Per Windows 10:

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Version 1803
  • Release Preview
  • Insider Fast
  • Insider Slow

Per Windows Server 1709:

  • RTM

Per Windows Server 2016:

  • Version 1607

Per Windows 8.1:

  • Aggiornamento 1

Per Windows 7:

  • Service Pack 1

Se il rilascio del sistema operativo o l'anello di anteprima è sconosciuto, questo campo ha il valore Unknown.
eventType string Una delle stringhe seguenti:
  • crash
  • hang
  • memory
  • jse
market string Codice Paese ISO 3166 del mercato del dispositivo.
deviceType string Una delle stringhe seguenti che indica il tipo di dispositivo in cui si è verificato l'errore:
  • PC
  • Telefono
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Holographic
  • Unknown
packageName string Nome univoco del pacchetto dell'app associato a questo errore.
packageVersion string Versione del pacchetto dell'app associato a questo errore.
deviceCount number Numero di dispositivi univoci che corrispondono a questo errore per il livello di aggregazione specificato.
eventCount number 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
}