Bagikan melalui

Mendapatkan data pelaporan kesalahan untuk aplikasi Anda

  • Artikel

Gunakan metode ini di API analitik Microsoft Store untuk mendapatkan data pelaporan kesalahan agregat untuk aplikasi Anda dalam format JSON untuk rentang tanggal tertentu dan filter opsional lainnya. Metode ini hanya dapat mengambil kesalahan yang terjadi dalam 30 hari terakhir. Informasi ini juga tersedia di bagian Kegagalan dari laporan kesehatan di Pusat Mitra.

Anda dapat mengambil informasi kesalahan tambahan dengan menggunakan metode untuk mendapatkan detail kesalahan, metode untuk mendapatkan jejak tumpukan, dan metode untuk mengunduh file CAB.

Prasyarat

Untuk menggunakan metode ini, Anda harus terlebih dahulu melakukan hal berikut:

  • Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API analitik Microsoft Store.
  • Dapatkan token akses Microsoft Azure AD untuk digunakan di header permintaan untuk metode ini. Setelah Anda mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakannya sebelum kedaluwarsa. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.

Permintaan

Sintaksis permintaan

Metode Meminta URI
DAPAT https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits

Header permintaan

Header Jenis Deskripsi
Otorisasi tali Diperlukan. Token akses Azure AD dalam bentuk Bearer token<>.

Parameter permintaan

Parameter Jenis Deskripsi Diperlukan
applicationId tali ID Penyimpanan aplikasi yang ingin Anda ambil data pelaporan kesalahannya. ID Toko tersedia di halaman identitas aplikasi di Pusat Mitra. Contoh ID Toko adalah 9WZDNCRFJ3Q8. Ya
tanggalMulai tanggal Tanggal mulai dalam rentang tanggal pengambilan data pelaporan kesalahan. Defaultnya adalah tanggal saat ini. Jika tingkat agregasi adalah hari, minggu, atau bulan, parameter ini harus menentukan tanggal dalam format mm/dd/yyyytersebut. Jika tingkat agregasi adalah jam , parameter ini dapat menentukan tanggal dalam format mm/dd/yyyy atau tanggal dan waktu dalam format yyyy-mm-dd hh:mm:ss.

Catatan: Metode ini hanya dapat mengambil kesalahan yang terjadi dalam 30 hari terakhir.		 Tidak
tanggalAkhir tanggal Tanggal akhir dari rentang tanggal data pelaporan kesalahan untuk diambil. Defaultnya adalah tanggal saat ini. Jika tingkat agregasi adalah hari, minggu, atau bulan, parameter ini harus menentukan tanggal dalam format mm/dd/yyyy. Jika tingkat agregasi adalah jam, parameter ini dapat menentukan tanggal dalam format mm/dd/yyyy atau tanggal serta waktu dalam format yyyy-mm-dd hh:mm:ss. Tidak
puncak Int Jumlah baris data yang akan dikembalikan dalam permintaan. Nilai maksimum dan nilai default jika tidak ditentukan adalah 10000. Jika ada lebih banyak baris dalam kueri, isi respons menyertakan tautan berikutnya yang bisa Anda gunakan untuk meminta halaman data berikutnya. Tidak
lewati Int Jumlah baris yang akan dilewati dalam kueri. Gunakan parameter ini untuk menelusuri himpunan data yang besar. Misalnya, top=10000 dan skip=0 mengambil 10000 baris data pertama, top=10000 dan skip=10000 mengambil 10000 baris data berikutnya, dan sebagainya. Tidak
saringan tali Satu atau beberapa pernyataan yang memfilter baris dalam respons. Setiap pernyataan berisi nama bidang dari isi respons dan nilai yang terkait dengan operator eq atau ne, dan pernyataan dapat digabungkan menggunakan dan atau atau. Nilai string harus dikelilingi oleh tanda kutip tunggal dalam parameter filter . Anda dapat menentukan bidang berikut dari isi respons:

  • applicationName
  • namaKegagalan
  • failureHash
  • simbol
  • osVersion
  • osRelease
  • jenisAcara
  • pasar
  • jenisPerangkat
  • packageName
  • packageVersion
  • tanggal
Tidak
tingkat agregasi tali Menentukan rentang waktu untuk mengambil data agregat. Bisa menjadi salah satu string berikut: jam, hari, minggu, atau bulan. Jika tidak ditentukan, nilai default adalah hari. Jika Anda menentukan minggu atau bulan, nilai failureName dan failureHash dibatasi hingga 1000 buckets.

Catatan: Jika Anda menentukan jam, Anda hanya dapat mengambil data kesalahan hingga 72 jam sebelumnya. Untuk mengambil data kesalahan yang lebih lama dari 72 jam, tentukan hari atau salah satu tingkat agregasi lainnya.		 Tidak
orderby string Pernyataan yang mengurutkan nilai data hasil. Sintaksnya adalah *orderby=field [order]. Bidang parameter dapat berupa satu (dan hanya satu) dari string berikut:
  • applicationName
  • namaKegagalan
  • failureHash
  • simbol
  • osVersion
  • osRelease
  • jenisPeristiwa
  • pasar
  • deviceType
  • packageName
  • packageVersion
  • tanggal

Parameter urutan bersifat opsional, dan dapat menaik atau menurun untuk menentukan urutan naik atau turun untuk setiap bidang. Defaultnya adalah asc.

Berikut adalah contoh string orderby: orderby=date

Catatan: Parameter apa pun harus berasal dari daftar yang didukung oleh groupby.

 Tidak
groupby string Pernyataan yang menerapkan agregasi data hanya ke bidang yang ditentukan. Anda dapat menentukan bidang berikut:
  • namaKegagalan
  • failureHash
  • simbol
  • osVersion
  • eventType
  • pasar
  • deviceType
  • packageName
  • packageVersion

Baris data yang dikembalikan akan berisi bidang yang ditentukan dalam parameter groupby serta yang berikut ini:

  • tanggal
  • applicationId
  • applicationName
  • deviceCount
  • jumlahAcara

Parameter groupby dapat digunakan dengan parameter level agregasi. Misalnya: &kelompokkan berdasarkan=namaKegagalan,pasar&tingkatAgregasi=minggu

Catatan: Parameter mungkin tidak berisi duplikat.		 Tidak

Contoh permintaan

Contoh berikut menunjukkan beberapa permintaan untuk mendapatkan data pelaporan kesalahan. Ganti nilai applicationId dengan ID Toko untuk aplikasi Anda.

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>

Jawaban

Isi respons

Nilai Jenis Deskripsi
Nilai Array Sekumpulan objek yang berisi data pelaporan kesalahan terakumulasi. Untuk informasi selengkapnya tentang data di setiap objek, lihat bagian nilai kesalahan bawah ini.
@nextLink benang Jika ada halaman data tambahan, string ini berisi URI yang dapat Anda gunakan untuk meminta halaman data berikutnya. Misalnya, nilai ini dikembalikan jika parameter atas permintaan diatur ke 10000 tetapi ada lebih dari 10000 baris kesalahan untuk kueri.
JumlahTotal bilangan bulat Jumlah total baris dalam hasil data untuk kueri.

Nilai kesalahan

Elemen dalam array Nilai berisi nilai berikut.

Nilai Jenis Deskripsi
tanggal string Tanggal pertama dalam rentang tanggal untuk data kesalahan, dalam format yyyy-mm-dd. Jika permintaan menentukan satu hari, nilai ini adalah tanggal tersebut. Jika permintaan menentukan rentang tanggal yang lebih panjang, nilai ini adalah tanggal pertama dalam rentang tanggal tersebut. Untuk permintaan yang menentukan nilai level agregasi dengan nilaijam , nilai ini juga menyertakan nilai waktu dalam format .
applicationId tali ID Toko dari aplikasi yang ingin Anda ambil data kesalahannya.
namaAplikasi string Nama tampilan aplikasi.
namaKegagalan string Nama kegagalan, yang terdiri dari empat bagian: satu atau beberapa kelas masalah, kode pemeriksaan pengecualian/bug, nama gambar tempat kegagalan terjadi, dan nama fungsi terkait.
failureHash tali Pengidentifikasi unik untuk kesalahan tersebut.
lambang tali Simbol yang ditetapkan untuk kesalahan ini.
osVersion string Salah satu string berikut yang menentukan versi OS tempat kesalahan terjadi:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Tidak Diketahui
osRelease string Salah satu string berikut yang menentukan rilis OS atau lingkaran pengujian (sebagai subpopulasi dalam versi OS) tempat kesalahan terjadi.

Untuk Windows 11: versi 2110

Untuk Windows 10:

  • Versi 1507
  • versi 1511
  • versi 1607
  • versi 1703
  • versi 1709
  • versi 1803
  • Pratinjau Rilis
  • Insider Fast
  • Insider Slow

Untuk Windows Server 1709:

  • RTM

Untuk Windows Server 2016:

  • Versi 1607

Untuk Windows 8.1:

  • Pembaruan 1

Untuk Windows 7:

  • Paket Layanan 1

Jika rilis OS atau ring pengujian tidak diketahui, bidang ini memiliki nilai Tidak Diketahui.
eventType tali Salah satu string berikut:
  • crash
  • gantung
  • memori
  • jse
pasar string Kode negara ISO 3166 dari pasar perangkat.
jenis perangkat string Salah satu string berikut yang menunjukkan jenis perangkat tempat kesalahan terjadi:
  • PC
  • Telepon
  • Console-Xbox Satu
  • Console-Xbox Seri X
  • IoT
  • Holografik
  • Tidak Diketahui
packageName tali Nama unik paket aplikasi yang terkait dengan kesalahan ini.
versiPaket tali Versi paket aplikasi yang terkait dengan kesalahan ini.
jumlahPerangkat angka Jumlah perangkat unik yang sesuai dengan kesalahan ini untuk tingkat agregasi yang ditentukan.
jumlahAcara angka Jumlah peristiwa yang dikaitkan dengan kesalahan ini untuk tingkat agregasi yang ditentukan.

Nota

Metode ini hanya dapat mengambil kesalahan yang terjadi dalam 30 hari terakhir.

Contoh Permintaan dan Respons

Cuplikan kode berikut menunjukkan contoh permintaan dan isi respons JSON untuk permintaan tersebut.

Permohonan Sampel

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>

Respons Sampel

{
    "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
}