Visual Studio'da Azure bulut hizmetinde hata ayıklama

Hata ayıklama yordamları, Cloud Services (genişletilmiş destek) mi yoksa klasik bulut hizmetleri modeli mi kullandığınıza bağlıdır. Cloud Services (genişletilmiş destek) için okumaya devam edin. Klasik model için bkz. Azure'da bulut hizmetinde hata ayıklama (klasik model).

Bulut hizmetinde uzaktan hata ayıklamayı etkinleştirmek için (genişletilmiş destek)

1. Varsayılan msvsmon bağlantı noktası için ServiceDefinition.csdef dosyasına bir Uç Nokta ekleyin. Visual Studio 2019 için 4024'tir.

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4024" localPort="4024" />
   </Endpoints>
   

   Not

   Visual Studio'nun diğer sürümlerinde farklı bağlantı noktaları Uzaktan Hata Ayıklayıcı Bağlantı Noktası Atamaları vardır.

2. Azure projesinin kısayol menüsünü açın ve yayımla'yı seçin.

3. Hazırlama ortamını ve Hata ayıklama yapılandırmasını seçin.

   Bu yalnızca bir kılavuzdur. Test ortamlarınızı üretim ortamında çalıştırmayı tercih edebilirsiniz. Ancak, Üretim ortamında uzaktan hata ayıklamayı etkinleştirirseniz kullanıcıları olumsuz etkileyebilirsiniz. Yayın yapılandırmasını seçebilirsiniz, ancak Hata Ayıklama yapılandırması hata ayıklamayı kolaylaştırır.

   

4. Cloud Services (genişletilmiş destek) sayfasında açıklanan normal adımları izleyin, ancak Tüm roller için Uzak Masaüstü'nü etkinleştir onay kutusunu seçin.

   Uzak masaüstü kullanıcısı için bir kullanıcı adı ve parola oluşturmanız istenir ve daha sonra bu sanal makinede oturum açmanız gerekir.

5. Sonraki ekrana ilerleyin, ayarlarınızı gözden geçirin ve hazır olduğunuzda Yayımla'ya tıklayın ve dağıtımın tamamlanmasını bekleyin.

6. Azure portalında oturum açın ve hata ayıklamak istediğiniz Bulut Hizmeti'ne (genişletilmiş destek) gidin.

7. Sol bölmede Roller ve Örnekler'i seçin ve ardından uzaktan hata ayıklamayla ilgilendiğiniz rolü seçin.

8. Sağ taraftaki Rol Örneği açılır menüsünden Bağlan'e tıklayın ve sanal makinede oturum açmanıza olanak sağlayacak bir uzak masaüstü dosyası indirmek için Bağlan düğmesini seçin. Önceki bir adımda uzak masaüstünü etkinleştirdiğinizde oluşturduğunuz kimlik bilgilerini kullanarak oturum açın.

   

9. Uzak Azure sanal makinesinde, Uzaktan hata ayıklama bölümünde açıklandığı gibi Visual Studio 2019 Uzak araçlarını yükleyin.

10. Sanal makinedeki masaüstünden D:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe komutunu yürütebilirsiniz. Yönetici istrator olarak çalıştırdığınızdan emin olun.

11. Güvenlik duvarı üzerinden erişime izin vermek için istemleri kabul edin. msvsmon.exe bağlantıları dinlemeye başladığını belirten bir ileti görmeniz gerekir.

12. Azure portalında kaynak grubunu açın ve Bulut Hizmeti için genel IP Adresini (genişletilmiş destek) alın.

    

Azure'da bir bulut hizmetine (genişletilmiş destek) hata ayıklayıcı eklemek için

1. İşleme Ekleme Hatalarını Ayıkla'yı>seçin (veya Ctrl+Alt+P tuşlarına basın).

2. Bağlantı türünü Varsayılan olarak tutun.

3. IP adresinizi ve bağlantı noktanızı kullanarak bağlantı hedefini girin: {ipaddress}:4024.

4. Ekle'yi Otomatik olarak ayarlayın.

5. Uzak masaüstü kullanıcıyla aynı kimlik bilgilerini kullanarak oturum açın.

6. Tüm kullanıcılar için işlemi göster'i seçin. Çalışan rolünde hata ayıklarken WaWorkerHost.exe ekleyin; bir web rolünde hata ayıklarsanız w3wp.exe işlemine ekleyin; Bir Web API rolü için bu WaIISHost.exe.

7. Kesme noktaları ayarlayın (satıra gidin ve F9 tuşuna basın), sitenin genel URL'sine erişin ve hata ayıklamak için senaryoyu yeniden oluşturun.

Bulut hizmetinde uzaktan hata ayıklamayı etkinleştirmek için (genişletilmiş destek)

1. Varsayılan msvsmon bağlantı noktası için ServiceDefinition.csdef dosyasına bir Uç Nokta ekleyin. Visual Studio 2022 için bu, 4026'dır; Visual Studio 2019 için 4024'tir.

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   Not

   Visual Studio'nun diğer sürümlerinde farklı bağlantı noktaları Uzaktan Hata Ayıklayıcı Bağlantı Noktası Atamaları vardır.

2. .NET 4.8'i hedef alıyorsanız, ServiceConfiguration.Cloud.cscfg dosyasını açtığınızdan emin olun ve Cloud Services(genişletilmiş destek) yayımlarken öğesindeki ServiceConfiguration özniteliğin osFamily değerini denetleyin. .NET 4.8 projesi için kullanın osFamily="7".

3. Azure projesinin kısayol menüsünü açın ve yayımla'yı seçin.

4. Hazırlama ortamını ve Hata ayıklama yapılandırmasını seçin.

   Bu yalnızca bir kılavuzdur. Test ortamlarınızı üretim ortamında çalıştırmayı tercih edebilirsiniz. Ancak, Üretim ortamında uzaktan hata ayıklamayı etkinleştirirseniz kullanıcıları olumsuz etkileyebilirsiniz. Yayın yapılandırmasını seçebilirsiniz, ancak Hata Ayıklama yapılandırması hata ayıklamayı kolaylaştırır.

   

5. Cloud Services (genişletilmiş destek) sayfasında açıklanan normal adımları izleyin, ancak Tüm roller için Uzak Masaüstü'nü etkinleştir onay kutusunu seçin.

   Uzak masaüstü kullanıcısı için bir kullanıcı adı ve parola oluşturmanız istenir ve daha sonra bu sanal makinede oturum açmanız gerekir.

6. Sonraki ekrana ilerleyin, ayarlarınızı gözden geçirin ve hazır olduğunuzda Yayımla'ya tıklayın ve dağıtımın tamamlanmasını bekleyin.

7. Azure portalında oturum açın ve hata ayıklamak istediğiniz Bulut Hizmeti'ne (genişletilmiş destek) gidin.

8. Sol bölmede Roller ve Örnekler'i seçin ve ardından uzaktan hata ayıklamayla ilgilendiğiniz rolü seçin.

9. Sağ taraftaki Rol Örneği açılır menüsünden Bağlan'e tıklayın ve sanal makinede oturum açmanıza olanak sağlayacak bir uzak masaüstü dosyası indirmek için Bağlan düğmesini seçin. Önceki bir adımda uzak masaüstünü etkinleştirdiğinizde oluşturduğunuz kimlik bilgilerini kullanarak oturum açın.

   

10. Uzak Azure sanal makinesinde, Uzaktan hata ayıklama bölümünde açıklandığı gibi Visual Studio 2022 Uzak araçlarını yükleyin.

11. Sanal makinedeki masaüstünden D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe komutunu yürütebilirsiniz. Yönetici istrator olarak çalıştırdığınızdan emin olun.

12. Güvenlik duvarı üzerinden erişime izin vermek için istemleri kabul edin. msvsmon.exe bağlantıları dinlemeye başladığını belirten bir ileti görmeniz gerekir.

    

13. Azure portalında kaynak grubunu açın ve Bulut Hizmeti için genel IP Adresini (genişletilmiş destek) alın.

    

Azure'da bir bulut hizmetine (genişletilmiş destek) hata ayıklayıcı eklemek için

1. İşleme Ekleme Hatalarını Ayıkla'yı>seçin (veya Ctrl+Alt+P tuşlarına basın).

2. Bağlantı türünü Varsayılan olarak tutun.

3. IP adresinizi ve bağlantı noktanızı kullanarak bağlantı hedefini girin: {ipaddress}:4026.

4. Ekle'yi Otomatik olarak ayarlayın.

5. Uzak masaüstü kullanıcıyla aynı kimlik bilgilerini kullanarak oturum açın.

6. Tüm kullanıcılar için işlemi göster'i seçin. Çalışan rolünde hata ayıklarken WaWorkerHost.exe ekleyin; bir web rolünde hata ayıklarsanız w3wp.exe işlemine ekleyin; Bir Web API rolü için bu WaIISHost.exe.

7. Kesme noktaları ayarlayın (satıra gidin ve F9 tuşuna basın), sitenin genel URL'sine erişin ve hata ayıklamak için senaryoyu yeniden oluşturun.

Azure'da bulut hizmetinde hata ayıklama (klasik model)

Uzak makineden bir bulut hizmetinde hata ayıklamak için, rol örneklerinizi çalıştıran sanal makinelere gerekli hizmetlerin (örneğin msvsmon.exe) yüklenmesi için bulut hizmetinizi dağıtırken bu işlevi açıkça etkinleştirmeniz gerekir. Hizmeti yayımladığınızda uzaktan hata ayıklamayı etkinleştirmediyseniz, uzaktan hata ayıklama etkinleştirildiğinde hizmeti yeniden yayımlamanız gerekir.

Bir bulut hizmeti için uzaktan hata ayıklamayı etkinleştirirseniz performansın düşmesi veya ek ücret yansıtılması gerekmez. Hizmeti kullanan istemciler olumsuz etkilenebileceği için üretim hizmetinde uzaktan hata ayıklama kullanmayın.

Bulut hizmeti için uzaktan hata ayıklamayı etkinleştirmek için (klasik model)

1. Azure projesinin kısayol menüsünü açın ve yayımla'yı seçin.

2. Hazırlama ortamını ve Hata ayıklama yapılandırmasını seçin.

   Bu yalnızca bir kılavuzdur. Test ortamlarınızı üretim ortamında çalıştırmayı tercih edebilirsiniz. Ancak, Üretim ortamında uzaktan hata ayıklamayı etkinleştirirseniz kullanıcıları olumsuz etkileyebilirsiniz. Yayın yapılandırmasını seçebilirsiniz, ancak Hata Ayıklama yapılandırması hata ayıklamayı kolaylaştırır.

   

3. Her zamanki adımları izleyin, ancak Gelişmiş Ayarlar sekmesindeki Tüm roller için Uzaktan Hata Ayıklayıcıyı Etkinleştir onay kutusunu seçin.

   

Azure'da bir bulut hizmetine hata ayıklayıcı eklemek için (klasik model)

1. Sunucu Gezgini'nde bulut hizmetinizin düğümünü genişletin.

2. Eklemek istediğiniz rol veya rol örneğinin kısayol menüsünü açın ve hata ayıklayıcı ekle'yi seçin.

   Bir rolün hatalarını ayıklarsanız, Visual Studio hata ayıklayıcısı bu rolün her örneğine eklenir. Hata ayıklayıcısı, bu kod satırını çalıştıran ve bu kesme noktasının koşullarını karşılayan ilk rol örneği için bir kesme noktası oluşturur. Bir örnekte hata ayıklarsanız, hata ayıklayıcısı yalnızca bu örneğe eklenir ve yalnızca belirli bir örnek bu kod satırını çalıştırdığında ve kesme noktasının koşullarını karşıladığında kesme noktasında kırılır.

   

3. Hata ayıklayıcı bir örneğe eklendikten sonra her zamanki gibi hata ayıkla. Hata ayıklayıcı, rolünüz için uygun konak işlemine otomatik olarak eklenir. Rolün ne olduğuna bağlı olarak, hata ayıklayıcısı w3wp.exe, WaWorkerHost.exe veya WaIISHost.exe ekler. Hata ayıklayıcının eklendiği işlemi doğrulamak için Sunucu Gezgini'nde örnek düğümünü genişletin. Azure işlemleri hakkında daha fazla bilgi için bkz . Azure Rol Mimarisi .

   

4. Hata ayıklayıcının eklendiği işlemleri tanımlamak için menü çubuğunda Windows>İşlemlerinde Hata Ayıkla'yı>seçin ve İşlemler iletişim kutusunu açın. (Klavye: Ctrl+Alt+Z) Belirli bir işlemi ayırmak için kısayol menüsünü açın ve ardından İşlemi Ayır'ı seçin. Veya Sunucu Gezgini'nde örnek düğümünü bulun, işlemi bulun, kısayol menüsünü açın ve ardından İşlemi Ayır'ı seçin.

   

Hata ayıklayıcıyı örneğinizdeki veya rolünüzdeki tüm işlemlerden ayırmak için, hata ayıkladığınız rol veya örneğin kısayol menüsünü açın ve Hata Ayıklayıcıyı Ayır'ı seçin.

Azure Uygulaması Hizmetinde Hata Ayıklama

Visual Studio'da İşleme Ekle iletişim kutusunu kullanarak Azure Uygulaması Hizmeti'nde çalışan programlarda hata ayıklayabilirsiniz.

Windows Azure Uygulaması Hizmetinde hata ayıklamak için

1. Hata Ayıkla'nın altında İşleme Ekle'yi seçin.

2. Bağlan ion türünü Microsoft Azure Uygulaması Services olarak değiştirip Bul... seçeneğini belirleyin.

3. Açılan iletişim kutusunda Abonelik adını seçin.

   

   Not

   Azure Uygulaması Hizmetinizi içeren aboneliğe erişimi olan bir Microsoft Hesabında oturum açmanız gerekir.

4. Görünümü Kaynak Grubuna veya Kaynak Türüne göre filtreleyin veya ada göre arayın.

5. Ardından, hata ayıklamak istediğiniz App Service'i ve ardından Tamam'ı seçin.

   Bu, App Service'inizde uzaktan hata ayıklamayı etkinleştirir ve eklenebilecek işlemlerin listesini gösterir.

   

6. Eklemek istediğiniz işlemi seçin ve ardından hata ayıklamayı başlatmak için Ekle'yi seçin.

Azure Sanal Makineler hatalarını ayıklama

Visual Studio'da Sunucu Gezgini'ne tıklayarak Azure Sanal Makineler üzerinde çalışan programlarda hata ayıklayabilirsiniz. Azure sanal makinesinde uzaktan hata ayıklamayı etkinleştirdiğinizde, Azure sanal makineye uzaktan hata ayıklama uzantısını yükler. Ardından, sanal makinedeki işlemlere ekleyebilir ve normalde yaptığınız gibi hata ayıklayabilirsiniz.

Azure sanal makinesinde hata ayıklamak için

1. Sunucu Gezgini'nde Sanal Makineler düğümünü genişletin ve hata ayıklamak istediğiniz sanal makinenin düğümünü seçin.

2. Bağlam menüsünü açın ve Hata Ayıklamayı Etkinleştir'i seçin. Sanal makinede hata ayıklamayı etkinleştirmek istediğinizden emin olup olmadığınız sorulduğunda Evet'i seçin.

   Azure, hata ayıklamayı etkinleştirmek için sanal makineye uzaktan hata ayıklama uzantısını yükler.

   

   

3. Uzaktan hata ayıklama uzantısının yüklenmesi tamamlandıktan sonra sanal makinenin bağlam menüsünü açın ve Hata Ayıklayıcı Ekle... öğesini seçin .

   Azure, sanal makinedeki işlemlerin listesini alır ve bunları İşleme Ekle iletişim kutusunda gösterir.

   

4. İşleme Ekle iletişim kutusunda, sonuç listesini yalnızca hata ayıklamak istediğiniz kod türlerini gösterecek şekilde sınırlandırmak için Seç'i seçin. 32 bit veya 64 bit yönetilen kodun, yerel kodun veya her ikisinin hatalarını ayıklayabilirsiniz.

   

5. Sanal makinede hata ayıklamak istediğiniz işlemleri seçin ve ardından Ekle'yi seçin. Örneğin, sanal makinede bir web uygulamasında hata ayıklamak istiyorsanız w3wp.exe işlemini seçebilirsiniz. Daha fazla bilgi için bkz . Visual Studio ve Azure Rol Mimarisinde Bir veya Daha Fazla İşlemde Hata Ayıklama.

Hata ayıklama için bir web projesi ve sanal makine oluşturma

Azure projenizi yayımlamadan önce, hata ayıklama ve test senaryolarını destekleyen ve test ve izleme programlarını yükleyebileceğiniz bağımsız bir ortamda test etmek yararlı olabilir. Bu tür testleri çalıştırmanın bir yolu, bir sanal makinede uygulamanızda uzaktan hata ayıklamaktır.

Visual Studio ASP.NET projeleri, uygulama testi için kullanabileceğiniz kullanışlı bir sanal makine oluşturma seçeneği sunar. Sanal makine PowerShell, Uzak Masaüstü ve WebDeploy gibi yaygın olarak gerekli uç noktaları içerir.

Hata ayıklama için bir web projesi ve sanal makine oluşturmak için

1. Visual Studio'da yeni bir ASP.NET Web Uygulaması oluşturun.

2. Yeni ASP.NET Projesi iletişim kutusunun Azure bölümünde açılan liste kutusunda Sanal Makine'yi seçin. Uzak kaynak oluştur onay kutusunu seçili bırakın. Devam etmek için Tamam'ı seçin.

   Azure'da sanal makine oluştur iletişim kutusu görüntülenir.

   

   Not

   Henüz oturum açmadıysanız Azure hesabınızda oturum açmanız istenir.

3. Sanal makine için çeşitli ayarları ve ardından Tamam'ı seçin. Daha fazla bilgi için bkz. Sanal Makineler.

   DNS adı için girdiğiniz ad, sanal makinenin adı olacaktır.

   

   Azure sanal makineyi oluşturur ve ardından Uzak Masaüstü ve Web Dağıtımı gibi uç noktaları sağlar ve yapılandırr.

4. Sanal makine tam olarak yapılandırıldıktan sonra Sunucu Gezgini'nde sanal makinenin düğümünü seçin.

5. Bağlam menüsünü açın ve Hata Ayıklamayı Etkinleştir'i seçin. Sanal makinede hata ayıklamayı etkinleştirmek istediğinizden emin olup olmadığınız sorulduğunda Evet'i seçin.

   Azure, hata ayıklamayı etkinleştirmek için uzaktan hata ayıklama uzantısını sanal makineye yükler.

   

   

6. Projenizi Nasıl yapılır: Visual Studio'da Tek Tıklamayla Yayımla'yı Kullanarak Web Projesi Dağıtma bölümünde açıklandığı gibi yayımlayın. Sanal makinede hata ayıklamak istediğiniz için Web'i Yayımla sihirbazının Ayarlar sayfasında Yapılandırma olarak Hata Ayıkla'yı seçin. Bu, hata ayıklama sırasında kod simgelerinin kullanılabilir olmasını sağlar.

   

7. Proje daha önce dağıtılmışsa, Dosya Yayımlama Seçenekleri'nde Hedefte ek dosyaları kaldır'ı seçin.

8. Proje yayımlandıktan sonra, sanal makinenin Sunucu Gezgini'ndeki bağlam menüsünde Hata Ayıklayıcı Ekle... öğesini seçin .

   Azure, sanal makinedeki işlemlerin listesini alır ve bunları İşleme Ekle iletişim kutusunda gösterir.

   

9. İşleme Ekle iletişim kutusunda, sonuç listesini yalnızca hata ayıklamak istediğiniz kod türlerini gösterecek şekilde sınırlandırmak için Seç'i seçin. 32 bit veya 64 bit yönetilen kodun, yerel kodun veya her ikisinin hatalarını ayıklayabilirsiniz.

   

10. Sanal makinede hata ayıklamak istediğiniz işlemleri seçin ve ardından Ekle'yi seçin. Örneğin, sanal makinede bir web uygulamasında hata ayıklamak istiyorsanız w3wp.exe işlemini seçebilirsiniz. Daha fazla bilgi için bkz . Visual Studio'da Bir veya Daha Fazla İşlemde Hata Ayıklama.