Windows'da Azure App Service uygulamaları için .NET Profiler'ı etkinleştirme

.NET için Application Insights Profil Oluşturucu, Azure Uygulaması Hizmeti çalışma zamanının bir parçası olarak önceden yüklenmiştir. Temel hizmet katmanını veya üzerini kullanarak Profiler'ı ASP.NET ve App Service üzerinde çalışan ASP.NET Core uygulamalarında çalıştırabilirsiniz.

.NET için Application Insights Profiler'ın kodsuz yüklemesi .NET Core destek ilkesini izler. Azure bunu yalnızca Windows tabanlı web uygulamalarında destekler.

Linux'ta .NET Profiler'ı etkinleştirmek için bkz. Linux'ta Azure App Service uygulamaları için .NET Profiler'ı etkinleştirme.

Önkoşullar

"Her zaman açık" ayarının etkinleştirildiğini doğrulayın

  1. Azure portalında App Service örneğine gidin.

  2. Sol menüde Ayarlar

    Soldaki menüde Yapılandırma'nın seçilmesini gösteren ekran görüntüsü.

  3. Genel ayarlar'ı seçin.

  4. Her zaman açık seçeneğinin Açık olarak ayarlandığını doğrulayın.

    Not

    Her zaman açık devre dışıysa App Service web uygulamanızı Temel katmanda veya daha yüksek bir katmanda çalışacak şekilde yükseltin.

    Her Zaman Açık seçeneğinin etkin olduğunu gösteren Yapılandırma bölmesindeki Genel sekmesini gösteren ekran görüntüsü.

  5. Değişiklik yaptıysanız Kaydet'i seçin.

Application Insights'ı ve .NET Profiler'ı etkinleştirme

Profil Oluşturucu'yu şu durumlardan birinde etkinleştirebilirsiniz:

Aynı abonelikteki *Application Insights* ve *App Service* için

Application Insights kaynağınız App Service örneğiniz ile aynı abonelikteyse:

  1. App Service örneğinizin sol menüsündeApplication> seçin.

  2. Application Insights’ı Aç’ı seçin.

    Uygulamanız için Application Insights'ın açılmasını gösteren ekran görüntüsü.

  3. Application Insights ayarı sayfasındaki Application Insights'ın altında Etkinleştir'i seçin.

  4. Uygulamanıza bir Application Insights kaynağı bağladığınızdan emin olun.

    Uygulamanızda Application Insights'ın etkinleştirilmesini gösteren ekran görüntüsü.

  5. Aşağı kaydırın ve uygulamanıza bağlı olarak .NET veya .NET Core sekmesini seçin.

  6. Koleksiyon düzeyi içinÖnerilen'i seçin.

  7. Profil Oluşturucu ve Kod İyileştirmeleri'nin altında Açık'ı seçin. Daha önce Temel koleksiyon düzeyini seçtiyseniz, Profil Oluşturucu ayarı devre dışı bırakılır.

    Uygulamanızda Profiler'ı etkinleştirmeyi gösteren ekran görüntüsü.

  8. Uygula'yı ve onaylamak için Evet'i seçin.

Farklı aboneliklerdeki Application Insights ve App Service'in kullanımı için

Application Insights kaynağınız App Service örneğinizden farklı bir abonelikteyse, .NET için Profil Oluşturucu'nun el ile etkinleştirilmesi gerekir. App Service örneğiniz için uygulama ayarları oluşturarak etkinleştirin. Bir şablon veya başka yöntemler kullanarak bu ayarların oluşturulmasını otomatikleştirebilirsiniz. Profiler'ı etkinleştirmek için ihtiyacınız olan ayarlar aşağıdadır.

Uygulama ayarı Değer
APPLICATIONINSIGHTS_CONNECTION_STRING Bu değeri Application Insights kaynağınızın Genel Bakış sayfasından alın.
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
TanıHizmetleri_EKLENTİ_SÜRÜMÜ ~3

Şu değerleri şu şekilde ayarlayın:

Bölgesel bulutlar için .NET Profiler'ı etkinleştirme

Şu anda uç nokta değişiklikleri gerektiren tek bölgeler Azure Kamu ve 21Vianet tarafından sağlanan Microsoft Azure'dır.

Uygulama ayarı ABD Devlet Bulutu Çin Bulutu
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
Uygulama İçgörüleri Uç Noktası https://{region}.in.applicationinsights.azure.us https://{region}.in.applicationinsights.azure.cn

Yaygın Azure hizmetleri için Azure Genel ve Azure Kamu uç noktalarını karşılaştırın.

Profil alımı için Microsoft Entra kimlik doğrulamasını etkinleştirme

.NET için Application Insights Profiler, profil alımı için Microsoft Entra kimlik doğrulamasını destekler. Uygulamanızın tüm profillerinin alınması için uygulamanızın kimliğinin doğrulanması ve Profil Oluşturucu aracısına gerekli uygulama ayarlarını sağlaması gerekir.

Profil Oluşturucu yalnızca uygulamanızda Application Insights SDK'sını kullanarak Microsoft Entra Id'ye başvurup yapılandırdığınızda Microsoft Entra kimlik doğrulamasını destekler.

Profil alımı için Microsoft Entra Id'yi etkinleştirmek için:

  1. Application Insights kaynağınızda kimlik doğrulaması yapmak için yönetilen kimliği oluşturun ve App Service'inize ekleyin:

  2. Application Insights kaynağınızda Microsoft Entra Kimliğini yapılandırın ve etkinleştirin.

  3. Profil Oluşturucu aracısına hangi yönetilen kimliğin kullanılacağını bildirmek için aşağıdaki uygulama ayarını ekleyin.

    • Sistem tarafından atanan kimlik için:

      Uygulama ayarı Değer
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD
    • Kullanıcı atamalı kimlik için:

      Uygulama ayarı Değer
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

.NET Profiler'ı devre dışı bırakma

Tek bir uygulamanın örneğinde Profiler'ı durdurmak veya yeniden başlatmak için:

  1. Soldaki menüden Ayarlar'ın altında Web İşleri'ni seçin.

    Soldaki menüde web işlerini seçmeyi gösteren ekran görüntüsü.

  2. ApplicationInsightsProfiler3 adlı web işini seçin.

  3. Durdur simgesini seçin.

    Web işini durdurmak için durdurmayı seçmeyi gösteren ekran görüntüsü.

  4. Onaylamak için Durdur'u seçin.

Mümkün olan en erken performans sorunlarını keşfetmek için tüm uygulamalarınızda Profiler'ı etkinleştirmenizi öneririz.

Değişiklikleri web uygulamanıza dağıtmak için WebDeploy kullandığınızda Profil Oluşturucu'nun dosyalarını silebilirsiniz. App_Data klasörünün dağıtım sırasında silinmesini dışlayarak silme işlemini önleyebilirsiniz.