Tanılama Özellikleri

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

Bu bölümde App Center'ın Tanılama hizmeti için kullanılabilen özellik kümesi hakkında bilgi edineceksiniz.

Kilitlenme ve Hata Analizi

App Center Tanılama'da, uygulamanızda bir kilitlenme veya hata oluştuğunu anlamak için App Center tarafından otomatik olarak oluşturulan analiz verilerini görüntüleyebilirsiniz.

App Center varsayılan olarak bir uygulamanın günlük kilitlenmelerini ve hatalarını yan yana bir görünümde görüntüler.

Sol üst köşedeki sekmeleri kullanarak Kilitlenmeler ve Hatalar'da derine inin. Bunu yaptığınızda, sol grafik günlük kilitlenme/hata sayısını gösterir ve sağ grafik etkilenen kullanıcıların sayısını gösterir. Daha odaklanmış bir görünüm için grafikleri uygulama sürümüne, zaman çerçevesine ve duruma göre filtreleyin.

Önemli

Etkilenen kullanıcılar grafiği, App Center Analytics modülündeki oturum verilerini gerektirir. Etkilenen kullanıcı yüzdelerini doğru hesaplamak için hem Kilitlenmeler hem de Analitik modüllerini etkinleştirin. Analytics olmadan, çökmeler ve hatalar kullanıcıların %100’ünü etkiliyormuş gibi görünebilir.

Uyarı

App Center, hassas olabilecek bilgileri filtreler. App Center'ın filtrelediği hassas bilgilere URL'ler, JSON dizeleri ve istek kimlikleri örnek olarak verilebilir.

Gruplama

App Center Tanılama, kilitlenmeleri ve hataları sorunun nedeni ve sorunun uygulamada nerede oluştuğu gibi benzerliklere göre gruplandırmaktadır. App Center, her kilitlenme ve hata grubu için başarısız olan kod satırını, sınıf veya yöntem adını, dosya adını, satır numarasını, kilitlenmeyi veya hata türünü ve bu grupları bir bakışta daha iyi anlamanız için iletiyi görüntüler. Daha fazla bilgi görüntülemek için bir grup seçin ve ayrıntılı sorun raporları ve günlükleri listesine erişin. Bu, uygulamanızın kilitlenme veya hata sırasındaki davranışını daha iyi anlamak için daha ayrıntılı incelemenize ve özellik kümemizi kullanmanıza olanak tanır.

Bir kilitlenme, bir URL'ye yapılan başarısız bir çağrıdan kaynaklanıyorsa ("azure.com veya google.com çağrılırken hata" gibi), App Center kilitlenmeleri bu URL'ye göre gruplayabilir. Örneğin, azure.com tüm başarısız çağrılar birlikte gruplandırılır ve google.com başarısız olan tüm çağrılar birlikte gruplandırılır. Ancak, App Center çökme günlüğünden başına HTTP veya HTTPS eklenmiş URL'leri kaldırdığından, bu gruplandırma yalnızca bu sözdizimini kullanmaktan kaçındığınız sürece çalışır. Örneğin, " http://azure.com" çağrılırken hata" ifadesi diğer azure.com çağrılarıyla gruplanmaz; ancak "azure.com çağrılırken hata" ifadesi benzer hata raporlarıyla gruplanır.

Kullanıcı Kimliği

App Center Tanılama, kilitlenmelerinize ve hatalarınıza bir kullanıcı kimliği eklemenize olanak tanır. Bunu yapmak için hedeflenen platformunuzda App Center SDK'sını kullanın Android, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms ve MAUI/Xamarin. Bir grubun içindeki bir soruna tıkladığınızda, kilitlenme veya hata ile ilişkili olan kullanıcı kimliğini bulacaksınız.

Kullanıcı kimliği ekledikten sonra App Center'ın arama özelliğini kullanarak belirtilen kimlikle çökme raporlarını arayabilirsiniz. App Center'ın arama belgelerini izleyerek bunun nasıl yapılacağını öğrenin.

Ekleri

App Center Tanılama kullanıcı arabiriminde, kilitlenme ve hata raporlarınızın ikili ve metin eklerini görüntüleyebilir ve indirebilirsiniz.

Android, iOS, macOS, React Native, UWP, WPF/WinForms ve MAUI/Xamarin uygulamalarınız için SDK Kilitlenmeleri belgelerini okuyarak kilitlenme raporlarınıza ek eklemeyi öğrenebilirsiniz.

İşlenmiş hatalar için ekler yalnızca Android, Unity, UWP, WPF, WinForms ve Xamarin platformlarında desteklenir. Android, Unity, UWP, WPF/WinForms ve MAUI/Xamarin uygulamalarınız için SDK belgelerinde hata raporlarınıza ek eklemeyi öğrenin.

Ekleri görüntülemek ve indirmek için bir kilitlenme veya hata grubu, belirli bir cihaz raporu seçin ve ekler sekmesine tıklayın.

Çökmeden önceki olaylar

Uygulamanızın durumu hakkında yararlı bilgiler yakalamak için kilitlenmeye neden olan olayları izleyin.

Bu özellik App Center Analytics modülünü gerektirir. Özel bir olay tanımlamak için Android, iOS, macOS, React Native, Windows ve MAUI/Xamarin için SDK Belgeleri'ne göz atın.

Kilitlenmeden önceki olayları görüntülemek için bir kilitlenme grubu, belirli bir cihaz raporu seçin ve ardından olaylar sekmesine tıklayın.

Anahtar Değer Çiftleri

Yönteme dize değerleri sözlüğü (anahtar/değer çiftleri olarak) geçirerek App Center'a gönderilen hata raporlarına, hata için ek bağlam içerecek şekilde uyarlama yapabilirsiniz. Bu özellikler isteğe bağlıdır. Anahtar değer çiftlerini ayarlamak için Android, MAUI/Xamarin, Unity, UWP ve WPF/WinForms belgelerimize göz atın.

Uyarı

Bu özellik bugün yalnızca Android, iOS, Xamarin, React Native, Unity, UWP, WinForms ve WPF Hataları için desteklenir.

Tanılama Verilerini Dışarı Aktarma

App Center, tanılama verileri (çökme ve hatalar) ham verilerini Azure'a aktarabilir. Verilerin özelleştirilmesi için tanılama verilerini Blob Depolama'ya aktarın.

Kilitlenmeleri, ekleri ve hataları dışarı aktarmak için Yapılandırmaları Dışarı Aktar API'sini çağırmanız gerekir:

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

exportEntities API özelliğinin alanında, dışarı aktarmak istediğiniz veri türünü belirtmeniz gerekir: kilitlenmeler, hatalar, ekler. Bunu yaparken, tamamen simgelenmiş çökmeler ve ilgili yığın izlemeleri ihraç edilecektir.

Dışarı aktarma belgelerinde verilerinizin avantajları ve verilerinizi dışarı aktarma hakkında daha fazla bilgi edinin.

Konular

Kilitlenme raporunda, uygulama kilitlendiğinde etkin olan iş parçacıklarının geçerli durumunu görebilirsiniz. Kilitlenen iş parçacığı, uygulamanın durumunu daha iyi anlamanız için kırmızıyla vurgulanır.

Uyarı

Windows'da rapor yalnızca çöken iş parçacığının yığın izini gösterir. Çökme anındaki diğer iş parçacıklarının durumunun gösterilmesi Windows'ta desteklenmez.

Uyarı yapılandırma

App Center uygulama tanımı ayarlarınızı e-posta bildirimi alacak şekilde yapılandırarak uygulama kilitlenmelerinizden anında haberdar olun. Bu ayarı uygulama başına yapılandırarak yeni bir kilitlenme grubu oluşturulduğunda hemen bir e-posta gönderebilir veya uygulamanızın en önemli kilitlenmelerini içeren günlük bir özet e-posta gönderebilirsiniz. Bu uyarıları yapılandırmak için:

1. App Center'da oturum açın ve uygulamanızı seçin
2. Soldaki menüde Ayarlar'a gidin
3. E-posta Bildirimleri'ne tıklayın
4. Hemen, Günlük veya Hiçbir Zaman'ı seçin. Varsayılan yapılandırma Hiçbir zaman olarak ayarlanır.

Bildirim hakkında daha fazla bilgiyi App Center pano belgelerimizden öğrenebilirsiniz.

Hata İzleyicisi Oluşturma

Bilgi sahibi olmak ve kilitlenmelerinizi daha iyi yönetmek için üçüncü taraf hata izleyici araçlarını App Center ile tümleştirebilirsiniz. Nasıl başlatacağınızı öğrenmek için hata izleyicisi belgelerini okuyun.

App Center'a rapor yükleme

API aracılığıyla kilitlenmeleri karşıya yüklemeyle ilgili belgeler taşındı.