Uygulamanız için hata raporlama verilerini alma
Belirli bir tarih aralığı ve diğer isteğe bağlı filtreler için uygulamanızın toplu hata raporlama verilerini JSON biçiminde almak için Microsoft Store analiz API'sinde bu yöntemi kullanın. Bu yöntem yalnızca son 30 gün içinde oluşan hataları alabilir. Bu bilgiler, İş Ortağı Merkezi'ndeki Sağlık raporuHataları bölümünde de mevcuttur.
hata ayrıntılarını al, yığın izleme çözümlerini alve CAB dosyasını indir yöntemlerini kullanarak ek hata bilgilerini edinebilirsiniz.
Önkoşullar
Bu yöntemi kullanmak için önce aşağıdakileri yapmanız gerekir:
- Henüz yapmadıysanız Microsoft Store analiz API'si için tüm
önkoşullarını tamamlayın. - Bu yöntemin istek üst bilgisinde kullanmak üzere bir Azure AD erişim belirteci alın. Erişim belirtecini aldıktan sonra süresi dolmadan önce kullanmak için 60 dakikanız olur. Belirtecin süresi dolduktan sonra yenisini alabilirsiniz.
İstek
İstek söz dizimi
Yöntem | İstek URI'si |
---|---|
AL | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
İstek üst bilgisi
Üstbilgi | Tür | Açıklama |
---|---|---|
İzin | dizgi | Gerekli. Azure AD Taşıyıcı<belirteci biçiminde>erişim belirteci. |
İstek parametreleri
Parametre | Tür | Açıklama | Gerekli |
---|---|---|---|
applicationId | dizgi | Hata raporlama verilerini almak istediğiniz uygulamanın Mağaza Kimliği. Mağaza Kimliği, İş Ortağı Merkezi'ndeki Uygulama Kimliği sayfasında kullanılabilir. Örnek mağaza kimliği 9WZDNCRFJ3Q8'dir. | Evet |
başlangıçTarihi | tarih | Alınacak hata raporlama verisinin tarih aralığındaki başlangıç tarihi. Varsayılan değer geçerli tarihtir. mm/dd/yyyy biçiminde bir tarih veya yyyy-mm-dd hh:mm:ss biçiminde bir tarih ve saat belirtebilir.
Not: Bu yöntem yalnızca son 30 gün içinde oluşan hataları alabilir. |
Hayır |
bitiş tarihi | tarih | Alınacak hata raporu verilerinin tarih aralığının bitiş tarihi. Varsayılan değer geçerli tarihtir.
toplama düzeyigün, haftaveya ayise, bu parametre mm/dd/yyyy biçiminde bir tarih belirtmelidir.
toplama düzeyisaatise, bu parametre mm/dd/yyyy formatında bir tarih veya yyyy-mm-dd hh:mm:ss formatında bir tarih ve saat belirtebilir. |
Hayır |
üst | Int | İstekte döndürülecek veri satırlarının sayısı. En büyük değer ve belirtilmezse varsayılan değer 10000'dir. Sorguda daha fazla satır varsa, yanıt gövdesi bir sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantı içerir. | Hayır |
atlamak | Int | Sorguda atlanacak satır sayısı. Büyük veri kümelerini sayfalandırmak için bu parametreyi kullanın. Örneğin, top=10000 ve skip=0 ilk 10000 veri satırını alır; top=10000 ve skip=10000 sonraki 10000 veri satırını alır, vb. | Hayır |
filtre | dizgi | Yanıttaki satırları filtreleyen bir veya daha fazla ifade. Her ifade, yanıt gövdesinden ve eq veya ne operatörleriyle ilişkili bir alan adı ve değer içerir ve ifadeler ve veya ya dakullanılarak birleştirilebilir. Dize değerleri, filtresi parametresinde tek tırnak içine alınmalıdır. Yanıt gövdesinden aşağıdaki alanları belirtebilirsiniz:
|
Hayır |
toplamaDüzeyi | dizgi | Toplama verilerinin alındığı zaman aralığını belirtir. Şu dizelerden biri olabilir: saat, gün, haftaveya ay. Belirtilmezse, varsayılan gün'dir. hafta veya aybelirtirseniz, failureName ve failureHash değerleri 1000 demetle sınırlıdır. Not:saatbelirtirseniz, hata verilerini yalnızca önceki 72 saat içinde alabilirsiniz. 72 saatten eski hata verilerini almak için gün veya diğer toplama düzeylerinden birini belirtin. | Hayır |
sıralama ölçütü | karakter dizisi | Sonuç veri değerlerini sıralayan bir deyim. Sözdizimi şu şekildedir: *orderby=field [order].
alan parametresi aşağıdaki dizelerden biri (ve yalnızca biri) olabilir:
İşte bir örnek orderby dizesi: orderby=date Not: Herhangi bir parametre |
Hayır |
groupby | dizgi | Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim. Aşağıdaki alanları belirtebilirsiniz:
Döndürülen veri satırları, groupby parametresinde belirtilen alanları ve aşağıdakileri içerir:
groupby parametresi toplamaDüzey parametresiyle kullanılabilir. Örneğin: &gruplaya=girişAdı,pazar&toplamaDüzeyi=hafta Not: Parametreler yinelenenler içermeyebilir. |
Hayır |
İstek örneği
Aşağıdaki örneklerde hata raporlama verilerini almaya yönelik çeşitli istekler gösterilmektedir. applicationId değerini uygulamanızın Mağaza Kimliği ile değiştirin.
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>
Yanıt
Yanıt gövdesi
Değer | Tür | Açıklama |
---|---|---|
Değer | dizi | Toplu hata raporlama verileri içeren bir nesne dizisi. Her nesnedeki veriler hakkında daha fazla bilgi için aşağıdaki hata değerleri bölümüne bakın. |
@nextLink | dizgi | Ek veri sayfaları varsa, bu dize sonraki veri sayfasını istemek için kullanabileceğiniz bir URI içerir. Örneğin, isteğin üst parametresi 10000 olarak ayarlanmışsa ancak sorgu için 10000'den fazla hata satırı varsa bu değer döndürülür. |
ToplamSayı | tam sayı | Sorgunun veri sonucundaki toplam satır sayısı. |
Hata değerleri
Value dizisindeki öğeler aşağıdaki değerleri içerir.
Değer | Tür | Açıklama |
---|---|---|
tarih | dizgi | Hata verileri için, tarih aralığındaki ilk tarih yyyy-mm-dd biçimindedir. İstek tek bir gün belirtiyorsa, bu değer bu tarihtir. İstek daha uzun bir tarih aralığı belirtiyorsa, bu değer bu tarih aralığındaki ilk tarihtir. |
applicationId | dizgi | Hata verilerini almak istediğiniz uygulamanın Mağaza Kimliği. |
uygulamaAdı | dizgi | Uygulamanın görünen adı. |
hataAdı | dizgi | Dört bölümden oluşan hatanın adı: bir veya daha fazla sorun sınıfı, bir özel durum/hata denetimi kodu, hatanın oluştuğu görüntünün adı ve ilişkili işlev adı. |
failureHash | dizgi | Hatanın benzersiz tanımlayıcısı. |
sembol | dizgi | Bu hataya atanan simge. |
osVersion | dizgi | Hatanın oluştuğu işletim sistemi sürümünü belirten aşağıdaki dizelerden biri:
|
osRelease | dizgi | Hatanın oluştuğu işletim sistemi yayınını veya uçuş halkasını (işletim sistemi sürümünde alt doldurma olarak) belirten aşağıdaki dizelerden biri. Windows 11 için: Sürüm 2110 Windows 10 için:
Windows Server 1709 için:
Windows Server 2016 için:
Windows 8.1 için:
Windows 7 için:
İşletim sistemi sürümü veya uçuş halkası bilinmiyorsa, bu alan Bilinmeyen |
etkinlikTürü | karakter dizisi | Aşağıdaki dizelerden biri:
|
pazar | dizgi | Cihaz pazarının ISO 3166 ülke kodu. |
cihaz türü | dizgi | Hatanın oluştuğu cihaz türünü gösteren aşağıdaki dizelerden biri:
|
PaketAdı | dizgi | Bu hatayla ilişkili uygulama paketinin benzersiz adı. |
paketSürümü | dizgi | Bu hatayla ilişkili uygulama paketinin sürümü. |
cihazSayısı | sayı | Belirtilen toplama düzeyi için bu hataya karşılık gelen benzersiz cihazların sayısı. |
etkinlikSayısı | sayı | Belirtilen toplama düzeyi için bu hatayla ilişkilendirilen olayların sayısı. |
Not
Bu yöntem yalnızca son 30 gün içinde oluşan hataları alabilir.
İstek ve Yanıt örneği
Aşağıdaki kod parçacığı, bu istek için örnek bir isteği ve JSON yanıt gövdesini gösterir.
Örnek İstek
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>
Örnek Yanıt
{
"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
}
İlgili konular
- Sağlık raporu
- Uygulamanızdaki bir hatanın ayrıntılarını alın
- Uygulama bir hata için yığın izlemesini alma
- Uygulamadaki bir hatayı düzeltmek için CAB dosyasını indirin
- Microsoft Store hizmetlerini kullanarak analiz verilerine erişme
- Uygulama edinimleri
- Eklenti alımlarını alma
- Uygulama derecelendirmelerini alma
- Uygulama incelemeleri alma