Masaüstü uygulamanız için hata raporlama verilerini alma

Windows Masaüstü Uygulaması programıeklediğiniz bir masaüstü uygulamasının toplu hata raporlama verilerini 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 ayrıca İş Ortağı Merkezi'ndeki masaüstü uygulamaları için Sağlık raporu'de sağlanır.

Ö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ı 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 İstenilen URI
AL https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits

İstek başlığı

Başlık Türü Açıklama
İzin String Gerekli. Azure AD erişim belirteci Bearer<token> biçimindedir.

İstek parametreleri

Parametre Türü Açıklama Gerekli
applicationId (Uygulama Kimliği) String Hata raporlama verilerini almak istediğiniz masaüstü uygulamasının ürün kimliği. Masaüstü uygulamasının ürün kimliğini almak için İş Ortağı Merkezi'nde masaüstü uygulamanızın analiz raporlarını açın (Sistem Durumu raporugibi) ve ürün kimliğini URL'den alın. Evet
başlangıçTarihi tarih Alınacak hata raporlama verilerinin tarih aralığındaki başlangıç tarihi mm/dd/yyyybiçimindedir. Varsayılan değer geçerli tarihtir.

Not: Bu yöntem yalnızca son 30 gün içinde oluşan hataları alabilir.		 Hayı
Bitiş Tarihi tarih Alınacak hata raporlama verilerinin tarih aralığındaki bitiş tarihi mm/dd/yyyybiçimindedir. Varsayılan değer geçerli tarihtir. Hayı
Ü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ı
geçmek Int Sorguda atlanacak satırların 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ı
filtre String Bir veya daha fazla ifade, yanıtın satırlarını filtreler. Her ifade, yanıt gövdesindeki eq veya ne operatörleriyle ilişkili bir alan adı ve değer içerir ve ifadeler ve veya veya kullanılarak birleştirilebilir. Dize değerleri, filtresinin parametresinde tek tırnakla çevrelenmelidir. Yanıt gövdesinden aşağıdaki alanları belirtebilirsiniz:

  • Dosyaadı
  • uygulamaVersiyonu
  • hataAdi
  • hash hatası
  • simgesi
  • İşletim Sistemi Sürümü
  • işletim sistemi yapısı
  • işletim sistemi sürümü
  • etkinlikTürü
  • pazar
  • cihaz türü
  • ürünAdı
  • tarih
 Hayı
birleştirme seviyesi String Toplama verilerinin alındığı zaman aralığını belirtir. Şu dizelerden biri olabilir: gün, hafta veya ay. Belirtilmezse varsayılan gün olur. hafta veya aybelirtirseniz, failureName ve failureHash değerleri 1000 demetle sınırlıdır.

 Hayı
sıralama String Sonuç veri değerlerini sıralayan bir deyim. Sözdizimi orderby=field [order],field [order],... şeklindedir. field parametresi aşağıdaki dizelerden biri olabilir:
  • Dosyaadı
  • uygulamaVersiyonu
  • hataAdi
  • hash hatası
  • simgesi
  • İşletim Sistemi Sürümü
  • işletim sistemi yapısı
  • işletim sistemi sürümü
  • etkinlikTürü
  • pazar
  • cihaz türü
  • ürünAdı
  • tarih
Order parametresi isteğe bağlıdır ve her alan için artan veya azalan düzen belirtmek için asc veya desc olabilir. Varsayılan değer asc'dir.

Aşağıda örnek bir orderby dizesi verilmiştir: orderby=date,market

 Hayı
Gruplandırma ölçütü String Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim. Aşağıdaki alanları belirtebilirsiniz:
  • hataAdi
  • hash hatası
  • simgesi
  • İşletim Sistemi Sürümü
  • etkinlikTürü
  • pazar
  • cihaz türü

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

  • tarih
  • applicationId (Uygulama Kimliği)
  • applicationName (Uygulama Adı)
  • olay Sayısı

groupby parametresi aggregationLevel parametresiyle kullanılabilir. Örneğin: &gruplaya=girişAdı,pazar&toplamaDüzeyi=hafta

 Hayı

Örnek talep

Aşağıdaki örneklerde hata raporlama verilerini almaya yönelik çeşitli istekler gösterilmektedir. applicationId değerini masaüstü uygulamanızın ürün kimliğiyle değiştirin.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Yanıt

Yanıtın içeriği

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 String 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ı tamsayı Sorgunun veri sonucundaki toplam satır sayısı.

Hata değerleri

Değer dizisindeki öğeler aşağıdaki değerleri içerir.

Değer Türü Açıklama
tarih String 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 (Uygulama Kimliği) String Hata verilerini aldığınız masaüstü uygulamasının ürün kimliği.
ürünAdı String Masaüstü uygulamasının ilişkili yürütülebilir dosyalarının meta verilerinden türetilerek belirlenen görünen adı.
uygulamaAdı String TBD
Dosyaadı String Masaüstü uygulaması için yürütülebilir dosyanın adı.
hataAdı String 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ı.
başarısızlıkHash String Hatanın benzersiz tanımlayıcısı.
sembol String Bu hataya atanan simge.
işletim sistemi yapısı String Hatanın oluştuğu işletim sisteminin dört parçalı derleme numarası.
işletim sistemiSürümü String Masaüstü uygulamasının yüklü olduğu işletim sistemi sürümünü belirten aşağıdaki dizelerden biri:

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Sunucusu 1709
  • Bilinmiyor
işletim sistemi sürümü String Hatanın oluştuğu işletim sistemi sürümünü veya uçuş halkasını (işletim sistemi sürümündeki bir alt grup 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
  • İçeriden 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üncelleştirme 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ü String Hata olayının türünü gösteren aşağıdaki dizelerden biri:
  • çökme
  • asmak
  • bellek
  • JSE (İngilizce)
pazar String Cihaz pazarının ISO 3166 ülke kodu.
cihazTürü String Hatanın oluştuğu cihaz türünü belirten aşağıdaki dizelerden biri:

  • Kişisel bilgisayar
  • Sunucu
  • Tablet
  • Bilinmiyor
uygulamaVersiyonu String Hatanın oluştuğu uygulama yürütülebilir dosyasının sürümü.
etkinlikSayısı Numara Belirtilen toplama düzeyi için bu hatayla ilişkilendirilen olayların sayısı.

Yanıt örneği

Aşağıdaki örnekte bu istek için örnek bir JSON yanıt gövdesi gösterilmektedir.

{
  "Value": [
    {
      "date": "2018-02-01",
      "applicationId": "10238467886765136388",
      "productName": "Contoso Demo",
      "appName": "Contoso Demo",
      "fileName": "contosodemo.exe",
      "failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
      "failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
      "symbol": "hardware_disk!Unknown",
      "osBuild": "10.0.15063.850",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "eventType": "crash",
      "market": "US",
      "deviceType": "PC",
      "applicationVersion": "2.2.2.0",
      "eventCount": 0.0012422360248447205
    }
  ],
  "@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
  "TotalCount": 21
}
  • Last updated on