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

.NET için Application Insights Profiler'ı kullanarak canlı ASP.NET Core web uygulamalarınızın her yönteminde ne kadar zaman harcandığı izleyebilirsiniz. Bu makale, Linux'ta barındırılan web uygulamalarına odaklanır. Windows ve Mac geliştirme ortamlarını kullanarak da denemeler yapabilirsiniz.

Bu makalede şunları yapacaksınız:

• Yerel bilgisayarınızda Linux üzerinde barındırılan bir ASP.NET Core web uygulaması ayarlayın.
• Azure portalını kullanarak bir App Service oluşturun.
• Yerel Git kullanarak yerel ASP.NET Core projenizi Azure'a dağıtın.
• Profiler'ı ASP.NET Core web uygulamasına ekleyin.

Uyarı

SDK destek ilkesi için Application Insights SDK destek kılavuzunu gözden geçirin. Geçiş rehberliği için, Application Insights SDK'larından Azure İzleyici OpenTelemetry'e Geçiş bölümüne bakın.

Dikkat

Yeni uygulamalar için Azure İzleyici OpenTelemetry Distro'yu kullanın. Application Insights SDK'sına benzer bir deneyim ve benzer işlevler sağlar. OpenTelemetry tabanlı bir teklife geçiş yapmak için geçiş kılavuzunu gözden geçirin.

Önkoşullar

OpenTelemetry Profiler

• En son .NET Core SDK'sını yükleyin.
• Başlarken: Git'i Yükleme başlığı altındaki yönergeleri izleyerek Git'i yükleyin.
• Bağlamı anlamak için ASP.NET Core Web API için Azure İzleyici Profiler'ı Etkinleştirme örneğini gözden geçirin.

Application Insights SDK'sı (eski)

• En son .NET Core SDK'sını yükleyin.
• Başlarken: Git'i Yükleme başlığı altındaki yönergeleri izleyerek Git'i yükleyin.
• Bağlam için aşağıdaki örnekleri gözden geçirin:
  • Kapsayıcılı ASP.NET Çekirdek Uygulaması (.NET 6) için Hizmet Profili Oluşturucu'yı etkinleştirme
  • Çalışan Hizmeti için Application Insights Profil Oluşturucu örneği

Projeyi yerel olarak ayarlama

1. Bilgisayarınızda bir komut istemi penceresi açın.

2. ASP.NET Core MVC web uygulaması oluşturma:

   dotnet new mvc -n LinuxProfilerTest
   

3. Çalışma dizinini projenin kök klasörü olarak değiştirin.

4. Profil Oluşturucu izlemelerini toplamak için NuGet paketlerini ekleyin:

   OpenTelemetry Profiler

   dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --prerelease
   dotnet add package Azure.Monitor.OpenTelemetry.Profiler --prerelease
   

   Application Insights SDK'sı (eski)

   dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore
   

.NET Profiler'ı etkinleştirme

OpenTelemetry Profiler

1. Tercih ettiğiniz kod düzenleyicisinde, .NET için Azure İzleyici OpenTelemetry Profiler'a ait iki paketi Program.cs'e eklediğinizi doğrulayın. Varsa özel Profil Oluşturucu ayarları ekleyin.

   Projenizin .csproj dosyasında aşağıdaki satırları eklediğinizi doğrulayın:

   <ItemGroup>
       <PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" Version="[1.*-*, 2.0.0)" />
       <PackageReference Include="Azure.Monitor.OpenTelemetry.Profiler" Version="[1.*-*, 2.0.0)" />
   </ItemGroup>
   

   Dosyanızda Program.cs aşağıdaki satırları eklediğinizi doğrulayın:

   using Azure.Monitor.OpenTelemetry.AspNetCore;
   using Azure.Monitor.OpenTelemetry.Profiler;
   
   ///
   
   builder.Services.AddOpenTelemetry()
       .UseAzureMonitor()          // Enable Azure Monitor OpenTelemetry distro for ASP.NET Core
       .AddAzureMonitorProfiler(); // Add Azure Monitor Profiler    
   

2. Değişikliklerinizi kaydedin ve yerel depoya işleyin:

   git init
   git add .
   git commit -m "first commit"
   

Application Insights SDK'sı (eski)

1. Tercih ettiğiniz kod düzenleyicisinde, içindeki SDK'yı kullanarak Application Insights'ı ve .NET Profiler'ı Program.cseklediğinizi doğrulayın. Varsa özel Profil Oluşturucu ayarları ekleyin.

   WebAPI için

   // Add services to the container.
   builder.Services.AddApplicationInsightsTelemetry();
   builder.Services.AddServiceProfiler();
   

   Çalışan için

   IHost host = Host.CreateDefaultBuilder(args)
       .ConfigureServices(services =>
       {
           services.AddApplicationInsightsTelemetryWorkerService();
           services.AddServiceProfiler();
   
           // Assuming Worker is your background service class.
           services.AddHostedService<Worker>();
       })
       .Build();
   
   await host.RunAsync();
   

2. Değişikliklerinizi kaydedin ve yerel depoya işleyin:

   git init
   git add .
   git commit -m "first commit"
   

Projenizi barındırmak için Linux web uygulaması oluşturma

1. Azure portalındaUygulama Hizmetleri'ni arayıp seçin ve ardındanWeb Uygulaması> seçin.

2. Linux üzerinde App Service kullanarak bir web uygulaması ortamı oluşturun.

   

3. Yeni web uygulaması kaynağınıza gidin. Sol menüde Dağıtım>Dağıtım Merkezi'ni ve ardından FTPS Kimlik Bilgileri'ni seçerek dağıtım kimlik bilgilerini oluşturun. Daha sonra kullanmak üzere kimlik bilgilerinizi not edin.

   

4. Kaydet'i seçin.

5. Ayarlar sekmesini seçin.

6. Web uygulamasında yerel bir Git deposu ayarlamak için Kaynak'ı ve ardından Yerel Git'i seçin.

   

7. Git kopyası URI'sine sahip bir Git deposu oluşturmak için Kaydet'i seçin.

   

   Daha fazla dağıtım seçeneği için App Service belgelerine bakın.

Projenizi dağıtın

Kodu Azure App Service'e çeşitli yollarla dağıtabilirsiniz. En basit yol, yerel Git kullanarak dağıtmaktır. Daha fazla bilgi için bkz. Yerel Git kullanarak Azure App Service'e dağıtma.

1. Komut istemi pencerenizde projenizin kök klasörüne göz atın. App Service'te depoya işaret eden bir Git uzak deposu ekleyin:

   git remote add azure https://<username>@<app_name>.scm.azurewebsites.net:443/<app_name>.git
   

   Bu değer için web uygulamanızın Genel Bakış sayfasına gidin. Git kopya URL'sini kopyalayın.

2. Değişiklikleri Azure'a göndererek projeyi dağıtın:

   git push azure main
   

Web uygulamanızı izlemek için Application Insights ekleme

Bağlantı dizesini otomatik olarak ayarlayan bir App Service oluştururken Application Insights'ı etkinleştirebilirsiniz.

OpenTelemetry Profiler

Web uygulamanızı izlemek için Application Insights kaynağınızdan bağlantı dizenizi kopyalayıp yapıştırın.

1. Bağlantı dizesini kopyalayın.
2. Bağlantı dizesini ortamınıza yapıştırın.

Application Insights SDK'sı (eski)

Web uygulamanıza Application Insights eklemek için üç seçeneğiniz vardır. Kullanmak istediğiniz seçeneği genişletin.

Application Insights bölmesi

1. Web uygulamanızı Azure portalında açın. Soldaki menüden İzleme>Application Insights seçeneğini seçin.

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

   

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

   

4. Application Insights kaynağına bağlan'ın altında yeni bir kaynak oluşturun veya var olan bir kaynağı seçin. Bu örnek için yeni bir kaynak oluşturun.

   

5. Uygula'yı ve ardından uygulamak ve onaylamak için Evet'i seçin.

Ortam değişkenleri bölmesi

1. App Service örneğiniz ile aynı Azure aboneliğinde bir Application Insights kaynağı oluşturun.

2. Application Insights kaynağına gidin.

3. Bağlantı Dizesini kopyalayın.

4. Web uygulamanızı Azure portalında açın.

5. Sol menüde Ayarlar>Ortam değişkenleri'ni seçin. Ardından Ekle'yi seçin.

   

6. Add/Edit uygulama ayarları bölmesinde bağlantı dizesini yeni bir ayar olarak ekleyin:

   İsim	Değer
   APPLICATIONINSIGHTS_CONNECTION_STRING	[YOUR_CONNECTION_STRING]

   

7. Tamam'ı seçin.

   

8. Kaydet'i seçin.

Web uygulaması ayarları (appsettings.json)

1. App Service örneğiniz ile aynı Azure aboneliğinde bir Application Insights kaynağı oluşturun.

2. Application Insights kaynağına gidin.

3. Bağlantı Dizesini kopyalayın.

4. Tercih ettiğiniz kod düzenleyicisinde ASP.NET Core projenizin appsettings.json dosyasına gidin.

5. Aşağıdaki kodu ekleyin ve bağlantı dizesi yapıştırın:

   "ApplicationInsights":
   {
     "ConnectionString": "<your-connection-string>"
   }
   

6. Ayar değişikliğini uygulamak için appsettings.json Kaydet.

Sorun giderme

OpenTelemetry Profiler

Uygulamanızdan izleme bulamıyorsanız bu sorun giderme kılavuzundaki adımları deneyin.

Uygulamanızdan izleme bulamıyorsanız bu sorun giderme kılavuzundaki adımları izlemeyi göz önünde bulundurun.

Application Insights SDK'sı (eski)

Uygulamanızdan izleme bulamıyorsanız bu sorun giderme kılavuzundaki adımları deneyin.

Sonraki adım

Yük oluştur ve .NET Profiler izlerini görüntüle