Snapshot Debugger kullanarak Azure ASP.NET canlı uygulama hata ayıklaması Snapshot Debugger

Makale
09/14/2021
Okumak için 2 dakika

Bu Snapshot Debugger, ilgilendiğiniz kod yürütülürken üretim uygulamalarınıza bir anlık görüntü alır. Hata ayıklayıcıya anlık görüntü alma talimatı için kodunda anlık görüntü noktaları ve günlük noktaları ayarlayın. Hata ayıklayıcısı, üretim uygulama trafiğinizi etkilemeden tam olarak neyin yanlış gittiğini görmenizi sağlar. Bu Snapshot Debugger, üretim ortamlarında oluşan sorunları çözmek için gereken zamanı önemli ölçüde azaltmanıza yardımcı olabilir.

Anlık ek nokta ve günlük noktaları kesme noktalarına benzer, ancak kesme noktanın aksine, anlık ek nokta isabetli olduğunda uygulamayı durdurmaz. Genellikle anlık görüntüyü bir anlık görüntüde yakalama 10-20 milisaniye sürer.

Bu öğreticide şunları yapacaksınız:

Start the Snapshot Debugger
Anlık görüntü ayarlama ve anlık görüntüyü görüntüleme
Günlük noktası ayarlama

Önkoşullar

Snapshot Debugger, Azure geliştirme iş yükü Visual Studio 2017 Enterprise 15.5 veya daha yüksek bir sürümden itibaren kullanılabilir. (Bağımsız bileşenler sekmesinde Hata ayıklama ve test altında bulabilirsiniz > Snapshot debugger.)

Henüz yüklü değilse, 2019'Visual Studio yükleyin. Önceki bir Visual Studio yüklemesini güncelleştiriyorsanız, Visual Studio Yükleyicisi'i çalıştırın ve Snapshot Debugger ve web geliştirme iş yükünde ASP.NET bileşenini kontrol edin.

Henüz yüklenmemişse, 2017 Visual Studio 15.5 veya Enterprise sürümünü yükleyin. Önceki bir Visual Studio 2017 yüklemesini güncelleştiriyorsanız, Visual Studio Yükleyicisi'i çalıştırın ve Snapshot Debugger ve web geliştirme iş yükünde ASP.NET bileşenini kontrol edin.
Temel veya daha Azure App Service plan.
Anlık görüntü koleksiyonu, aşağıdaki web uygulamaları için kullanılabilir ve Azure App Service:
- ASP.NET 4.6.1 veya .NET Framework üzerinde çalışan uygulamalar.
- ASP.NET Core .NET Core 2.0 veya sonraki bir üzerinde çalışan uygulamaları Windows.

Projenizi açın ve Snapshot Debugger

Hata ayıklamanın anlık görüntüsünü açmak için projeyi açın.

Önemli

Hata ayıklamanın anlık görüntüsünü ayıklamak için, kaynak kodun kendi kaynak kodunuzla aynı sürümünü Azure App Service.

Bulut Gezgini'nde (> Cloud Explorer'ı görüntüle) projenizin dağıtılacağı Azure App Service sağ tıklayın ve Uygulama ekle'yi Snapshot Debugger.

Hata Ayıkla ve > Ekle... Snapshot Debugger seçin. Projenizin Azure App Service azure depolama hesabını seçin ve ardından Ekle'ye tıklayın. Snapshot Debugger, Sanal Azure Kubernetes Service Kümeleri ile Azure Sanal Makineleri (VM) & sanal makineleri de destekler.

Önemli

İlk olarak Ekle'yi Snapshot Debugger, sitenize Snapshot Debugger site uzantısını yüklemeniz Azure App Service. Bu yükleme, çalışma alanlarınızı yeniden Azure App Service.

Not

Application Analizler site uzantısı, Anlık Görüntü Hata Ayıklamayı da destekler. "Site uzantısı güncel değil" hata iletisiyle karşılaştıysanız, ayrıntıları yükseltmek için bkz. Anlık görüntü hata ayıklama ile ilgili sorun giderme ipuçları ve bilinen sorunlar.

Not

(Visual Studio 2019 sürüm 16.2 ve üzeri) Snapshot Debugger Azure bulut desteğini etkinleştirdi. Hem Azure kaynağının hem de Azure Depolama hesabının aynı bulutta olduğundan emin olun. Kuruma ilişkin Azure uyumluluk yapılandırmaları hakkında sorularınız varsa lütfen Azure yöneticinize başvurun.

Visual Studio artık anlık görüntü hata ayıklama modunda.

Modüller penceresi, modüller için tüm modüller yüklendiğinde (bu pencereyi açmak Azure App Service modüllerde hata ayıkla'> Windows >'ı seçin) gösterir.

Modüller penceresini denetleme

Ek bileşen ayarlama

Kod düzenleyicisinde, bir ek bileşen ayarlamak için ilgilendiğimiz bir kod satırın yanındaki sol olukluna tıklayın. Yürütülecek kodun bu olduğundan emin olun.
Ek bileşeni açmak için Koleksiyonu Başlat'a tıklayın.

İpucu

Bir anlık görüntüyü görüntülerken adım adım atabilirsiniz, ancak farklı kod satırlarında yürütmeyi takip etmek için kodunuza birden çok ek bileşen yer almaktadır. Kodunda birden çok ek bileşen varsa, Snapshot Debugger anlık görüntülerin aynı son kullanıcı oturumundan olduğundan emin olun. Uygulama Snapshot Debugger çok sayıda kullanıcı olsa bile bunu yapar.

Anlık görüntü alma

Bir ek bileşen ayarlandıktan sonra, web sitenizin tarayıcı görünümüne gidip işaretlenmiş kod satırı çalıştırarak el ile anlık görüntü oluşturabilir veya kullanıcılarının site kullanımlarından bir anlık görüntü oluşturmasını bekleyebilirsiniz.

Anlık görüntü verilerini inceleme

Anlık görüntü, anlık görüntüye isabet Tanılama Araçları görüntülenir. Bu pencereyi açmak için Hata ayıkla'> Windows > Show Tanılama Araçları.
Anlık görüntüyü kod düzenleyicisinde açmak için anlık görüntüye çift tıklayın.

Bu görünümden değişkenlerin üzerine gelerek DataTips'i görüntüleyebilirsiniz, Yerel ayarlar, İzlemeler ve Çağrı Yığını pencerelerini kullanabilir ve ifadeleri değerlendirebilirsiniz.

Web sitesinin kendisi hala canlı ve son kullanıcılar bundan etkilenmez. Varsayılan olarak her anlık görüntüde yalnızca bir anlık görüntü yakalanır: Bir anlık görüntü yakalandikten sonra anlık görüntü kapattır. Ek bileşende başka bir anlık görüntü yakalamak için, Koleksiyonu Güncelleştir'e tıklayarak anlık görüntüyü yeniden açabilirsiniz.

Ayrıca, uygulamanıza daha fazla ek bileşen ekleyebilir ve Koleksiyonu Güncelleştir düğmesiyle bunları açabilirsiniz.

Yardıma mı ihtiyacınız var? Anlık görüntü hata ayıklama sayfaları için Sorun giderme ve bilinen sorunlar ve SSS bölümüne bakın.

Koşullu ek bileşen ayarlama

Uygulamanıza belirli bir durumu yeniden oluşturmak zorsa koşullu ek bileşen kullanmayı göz önünde bulundurabilirsiniz. Koşullu ek bileşen, bir değişkenin incelemek istediğiniz belirli bir değeri içerdiği durumlarda anlık görüntü alma zamanlarını denetlemeye yardımcı olur. İfadeleri, filtreleri veya isabet sayılarını kullanarak koşulları ayarlayabilirsiniz.

Koşullu ek bileşen oluşturmak için

Bir anlık görüntü simgesine (boş top) sağ tıklayın ve Ayarlar.
Ek bileşen ayarları penceresinde bir ifade yazın.

Yukarıdaki çizimde anlık görüntü yalnızca anlık görüntü için olduğunda visitor.FirstName == "Dan" alınır.

Günlük noktası ayarlama

Bir anlık görüntüye isabet olduğunda anlık görüntü almaya ek olarak, bir ileti günlüğe (yani, bir günlük noktası oluşturmak) için bir anlık görüntü de yapılandırabilirsiniz. Oturum açma noktaları, uygulamanın yeniden bir şekilde yenidend bayılamanıza gerek kalmadan ayarlandırabilirsiniz. Günlük noktaları sanal olarak yürütülür ve çalışan uygulamanıza hiçbir etkisi veya yan etkisi olmaz.

Bir günlük noktası oluşturmak için

Bir ek bileşen simgesine (mavi altıgen) sağ tıklayın ve öğesini seçin Ayarlar.
Ek bileşen ayarları penceresinde Eylemler'i seçin.
İleti alanına, günlüğe almak istediğiniz yeni günlük iletiyi girebilirsiniz. Ayrıca günlük iletinizin değişkenlerini küme ayraçlarına yerleştirerek de değerlendirebilirsiniz.

Çıkış Penceresi'a gönder'i seçerseniz, günlüğe kaydedilirse, ileti Tanılama Araçları görüntülenir.

Uygulama günlüğüne gönder'i seçerseniz, günlüğe kaydedilirse, ileti App Analizler gibi üzerinden System.Diagnostics.Trace (veya ILogger .NET Core'da) iletileri gördüğünüz her yerde görüntülenir.