Aracılığıyla paylaş


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:

İ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. toplama düzeyigün, haftaveya ayise, bu parametre, biçiminde bir tarih belirtmelidir. toplama düzeyisaatise, bu parametre mm/dd/yyyy biçiminde bir tarih veya yyyy-mm-dd hh:mm:ssbiç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/yyyybiçiminde bir tarih belirtmelidir. toplama düzeyisaatise, bu parametre mm/dd/yyyy formatında bir tarih veya yyyy-mm-dd hh:mm:ssformatı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:

  • applicationName
  • failureName
  • hash hatası
  • simgesi
  • işletim sistemi versiyonu
  • osRelease
  • eventType
  • pazar
  • aygıtTürü
  • packageName
  • packageVersion
  • tarih
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:
  • applicationName
  • arızaAdı
  • hatasıHash
  • simgesi
  • osVersion
  • osRelease
  • eventType
  • pazar
  • cihazTürü
  • packageName
  • paketVersiyonu
  • tarih

order parametresi isteğe bağlıdır ve her alan için artan veya azalan düzen belirtmek üzere asc veya desc olabilir. Varsayılan asc'dir.

İşte bir örnek orderby dizesi: orderby=date

Not: Herhangi bir parametregroupby tarafından desteklenen listeden olmalıdır.

Hayır
groupby dizgi Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim. Aşağıdaki alanları belirtebilirsiniz:
  • hataAdı
  • hatasıHash
  • simgesi
  • işletim sistemi sürümü
  • eventType
  • pazar
  • cihazTürü
  • packageName
  • packageVersion

Döndürülen veri satırları, groupby parametresinde belirtilen alanları ve aşağıdakileri içerir:

  • tarih
  • applicationId
  • applicationName
  • cihazSayısı
  • eventCount

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-ddbiç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. saatlik bir toplama Düzeyi değeri belirten istekler için, bu değer biçiminde bir zaman değeri de içerir.
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:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • bilinmeyen
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:

  • Sürüm 1507
  • Sürüm 1511
  • Sürüm 1607
  • Sürüm 1703
  • Sürüm 1709
  • Sürüm 1803
  • Sürüm Önizleme
  • Insider Hızlı
  • Insider Yavaş

Windows Server 1709 için:

  • RTM

Windows Server 2016 için:

  • Sürüm 1607

Windows 8.1 için:

  • Güncelleme 1

Windows 7 için:

  • Hizmet Paketi 1

İşletim sistemi sürümü veya uçuş halkası bilinmiyorsa, bu alan Bilinmeyendeğerine sahiptir.

etkinlikTürü karakter dizisi Aşağıdaki dizelerden biri:
  • çökme
  • bellek
  • jse
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:
  • bilgisayar
  • Telefon
  • Console-Xbox Bir
  • Console-Xbox X Serisi
  • IoT
  • Holografik
  • bilinmeyen
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
}