使用 Application Insights 來分析即時 Azure 容器

您幾乎不需要程式碼，就可以為在容器中執行的 ASP.NET Core 應用程式啟用 Application Insights Profiler。 若要在容器執行個體上啟用 Application Insights Profiler，您必須：

• 將參考新增至 Microsoft.ApplicationInsights.Profiler.AspNetCore NuGet 套件。
• 設定環境變數來啟用它。

您將在本文中了解各種方法，讓您能：

• 在專案中安裝 NuGet 套件。
• 透過協調器 (例如 Kubernetes) 設定環境變數。
• 了解生產環境部署相關的安全性考量，例如保護您的 Application Insights 檢測金鑰。

必要條件

• Application Insights 資源。 記下檢測金鑰。
• Docker Desktop，用於組建 Docker 映像。
• 已安裝 .NET 6 SDK。

設定環境

1. 複製並使用下列專案範例：

   git clone https://github.com/microsoft/ApplicationInsights-Profiler-AspNetCore.git
   

2. 瀏覽至容器應用程式範例：

   cd examples/EnableServiceProfilerForContainerAppNet6
   

3. 此範例透過呼叫下列 CLI 命令所建立的基本專案：

   dotnet new mvc -n EnableServiceProfilerForContainerApp
   

   我們已在 Controllers/WeatherForecastController.cs 專案中新增延遲來模擬瓶頸。

   [HttpGet(Name = "GetWeatherForecast")]
   public IEnumerable<WeatherForecast> Get()
   {
       SimulateDelay();
       ...
       // Other existing code.
   }
   private void SimulateDelay()
   {
       // Delay for 500ms to 2s to simulate a bottleneck.
       Thread.Sleep((new Random()).Next(500, 2000));
   }
   

4. 新增 NuGet 套件來收集分析工具追蹤：

   dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore
   

5. 在 Startup.cs 中啟用 Application Insights 和 Profiler：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddApplicationInsightsTelemetry(); // Add this line of code to enable Application Insights.
       services.AddServiceProfiler(); // Add this line of code to Enable Profiler
       services.AddControllersWithViews();
   }
   

提取最新的 ASP.NET Core 組建/執行階段映像

1. 瀏覽至 .NET Core 6.0 範例目錄。

   cd examples/EnableServiceProfilerForContainerAppNet6
   

2. 提取最新的 ASP.NET Core 映像

   docker pull mcr.microsoft.com/dotnet/sdk:6.0
   docker pull mcr.microsoft.com/dotnet/aspnet:6.0
   

秘訣

尋找 Docker SDK 和執行階段的官方映像。

新增您的 Application Insights 金鑰

1. 透過 Azure 入口網站中的 Application Insights 資源，記下 Application Insights 檢測金鑰。

   

2. 開啟 appsettings.json 並新增 Application Insights 檢測金鑰至此程式碼區段：

   {
       "ApplicationInsights":
       {
           "InstrumentationKey": "Your instrumentation key"
       }
   }
   

組建和執行 Docker 映像

1. 檢閱 Dockerfile。

2. 組建範例映像：

   docker build -t profilerapp .
   

3. 執行容器：

   docker run -d -p 8080:80 --name testapp profilerapp
   

透過瀏覽器檢視容器

若要叫用端點，請執行下列其中一項：

• 前往瀏覽器中的 http://localhost:8080/weatherforecast，或是

• 使用 curl：

  curl http://localhost:8080/weatherforecast
  

檢查記錄

您可以選擇檢查本機記錄，以查看分析的工作階段是否已完成：

docker logs testapp

在本機記錄中，注意下列事件：

Starting application insights profiler with instrumentation key: your-instrumentation key # Double check the instrumentation key
Service Profiler session started.               # Profiler started.
Finished calling trace uploader. Exit code: 0   # Uploader is called with exit code 0.
Service Profiler session finished.              # A profiling session is completed.

檢視 Service Profiler 追蹤

1. 等待 2-5 分鐘，讓系統可將事件彙總至 Application Insights。

2. 在 Application Insights 中開啟 [效能] 刀鋒視窗。

3. 追蹤流程完成後，您會看到 [分析工具追蹤] 按鈕，如下所示：

   

清除資源

執行下列命令可停止範例專案：

docker rm -f testapp

後續步驟

了解如何...

產生負載並檢視 Profiler 追蹤