Mendapatkan data pelaporan kesalahan untuk aplikasi Anda
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 laporan Kesehatan di Pusat Mitra.
Anda dapat mengambil informasi kesalahan tambahan dengan menggunakan dapatkan detail kesalahan, mendapatkan pelacakan tumpukan, dan mengunduh metode 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 Azure ACTIVE Directory untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.
Permintaan
Minta sintaks
| Metode | URI Permintaan |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Header permintaan
| Header | Jenis | Deskripsi |
|---|---|---|
| Otorisasi | string | Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<. |
Parameter permintaan
| Parameter | Jenis | Deskripsi | Wajib diisi |
|---|---|---|---|
| applicationId | string | ID Penyimpanan aplikasi yang ingin Anda ambil data pelaporan kesalahannya. ID Toko tersedia di halaman Identitas aplikasi di Pusat Mitra. Contoh ID Penyimpanan adalah 9WZDNCRFJ3Q8. | Ya |
| startDate | date | Tanggal mulai dalam rentang tanggal data pelaporan kesalahan untuk diambil. Defaultnya adalah tanggal saat ini. Jika agregasiLevel adalah hari, minggu, atau bulan, parameter ini harus menentukan tanggal dalam format mm/dd/yyyy. Jika agregasiLevel 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. |
No |
| endDate | date | Tanggal akhir dalam rentang tanggal data pelaporan kesalahan untuk diambil. Defaultnya adalah tanggal saat ini. Jika agregasiLevel adalah hari, minggu, atau bulan, parameter ini harus menentukan tanggal dalam format mm/dd/yyyy. Jika agregasiLevel adalah jam, parameter ini dapat menentukan tanggal dalam format mm/dd/yyyy atau tanggal dan waktu dalam format yyyy-mm-dd hh:mm:ss. |
No |
| atas | 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. | No |
| skip | int | Jumlah baris yang akan dilewati dalam kueri. Gunakan parameter ini untuk halaman melalui himpunan data besar. Misalnya, top=10000 dan skip=0 mengambil 10000 baris data pertama, top=10000 dan skip=10000 mengambil 10000 baris data berikutnya, dan sebagainya. | No |
| filter | string | 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:
|
No |
| agregasiLevel | string | Menentukan rentang waktu untuk mengambil data agregat. Dapat berupa salah satu string berikut: jam, hari, minggu, atau bulan. Jika tidak ditentukan, defaultnya adalah hari. Jika Anda menentukan minggu atau bulan, nilai failureName dan failureHash dibatasi hingga 1000 wadah.Catatan: Jika Anda menentukan jam, Anda hanya dapat mengambil data kesalahan dari 72 jam sebelumnya. Untuk mengambil data kesalahan yang lebih lama dari 72 jam, tentukan hari atau salah satu tingkat agregasi lainnya. | No |
| urut berdasarkan | string | Pernyataan yang mengurutkan nilai data hasil. Sintaksnya adalah orderby=field [order],field [order],.... Parameter bidang dapat berupa salah satu string berikut:
Parameter pesanan bersifat opsional, dan dapat berupa asc atau desc untuk menentukan urutan naik atau turun untuk setiap bidang. Defaultnya adalah asc. Berikut adalah contoh string orderby : orderby=date,market |
No |
| groupby | string | Pernyataan yang menerapkan agregasi data hanya ke bidang yang ditentukan. Anda dapat menentukan bidang berikut:
Baris data yang dikembalikan akan berisi bidang yang ditentukan dalam parameter groupby serta yang berikut ini:
Parameter groupby dapat digunakan dengan parameter agregasiLevel . Misalnya: &groupby=failureName,market&aggregationLevel=week |
No |
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>
Respons
Isi respons
| Value | Jenis | Deskripsi |
|---|---|---|
| Value | array | Array objek yang berisi data pelaporan kesalahan agregat. Untuk informasi selengkapnya tentang data di setiap objek, lihat bagian nilai kesalahan di bawah ini. |
| @nextLink | string | Jika ada halaman data tambahan, string ini berisi URI yang dapat Anda gunakan untuk meminta halaman data berikutnya. Misalnya, nilai ini dikembalikan jika parameter teratas permintaan diatur ke 10000 tetapi ada lebih dari 10000 baris kesalahan untuk kueri. |
| TotalCount | Integer | Jumlah total baris dalam hasil data untuk kueri. |
Nilai kesalahan
Elemen dalam array Nilai berisi nilai berikut.
| Value | Jenis | Deskripsi |
|---|---|---|
| date | 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 agregasiTingkat jam, nilai ini juga menyertakan nilai waktu dalam format hh:mm:ss. |
| applicationId | string | ID Penyimpanan aplikasi yang ingin Anda ambil data kesalahannya. |
| applicationName | string | Nama tampilan aplikasi. |
| failureName | 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 | string | Pengidentifikasi unik untuk kesalahan tersebut. |
| simbol | string | Simbol yang ditetapkan untuk kesalahan ini. |
| osVersion | string | Salah satu string berikut yang menentukan versi OS tempat kesalahan terjadi:
|
| osRelease | string | Salah satu string berikut yang menentukan rilis OS atau cincin penerbangan (sebagai subpopulasi dalam versi OS) tempat kesalahan terjadi. Untuk Windows 11: Versi 2110 Untuk Windows 10:
Untuk Windows Server 1709:
Untuk Windows Server 2016:
Untuk Windows 8.1:
Untuk Windows 7:
Jika rilis OS atau cincin penerbangan tidak diketahui, bidang ini memiliki nilai Tidak Diketahui. |
| eventType | string | Salah satu string berikut:
|
| market | string | Kode negara ISO 3166 dari pasar perangkat. |
| deviceType | string | Salah satu string berikut yang menunjukkan jenis perangkat tempat kesalahan terjadi:
|
| packageName | string | Nama unik paket aplikasi yang terkait dengan kesalahan ini. |
| packageVersion | string | Versi paket aplikasi yang terkait dengan kesalahan ini. |
| deviceCount | number | Jumlah perangkat unik yang sesuai dengan kesalahan ini untuk tingkat agregasi yang ditentukan. |
| eventCount | number | Jumlah peristiwa yang dikaitkan dengan kesalahan ini untuk tingkat agregasi yang ditentukan. |
Catatan
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.
Permintaan 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
}
Topik terkait
- Laporan kesehatan
- Mendapatkan detail untuk kesalahan di aplikasi Anda
- Dapatkan jejak tumpukan untuk kesalahan di aplikasi Anda
- Unduh file CAB untuk kesalahan di aplikasi Anda
- Mengakses data analitik menggunakan layanan Microsoft Store
- Mendapatkan akuisisi aplikasi
- Mendapatkan akuisisi add-on
- Mendapatkan peringkat aplikasi
- Mendapatkan ulasan aplikasi
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk