在 Azure 虛擬機上啟用 Web 應用程式的 .NET Profiler

注意

建議您使用 Azure Az PowerShell 模組來與 Azure 互動。 若要開始使用，請參閱安裝 Azure PowerShell (部分機器翻譯)。 若要了解如何移轉至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。

在本文中，您將瞭解如何透過三種不同的方法，在 Azure 虛擬機 （VM） 或 Azure 虛擬機擴展集上執行適用於 .NET 的 Application Insights Profiler：

• Visual Stuido 與 Azure Resource Manager
• PowerShell
• Azure 資源總管

選取您慣用的方法索引標籤以：

在本指南中，您將了解如何：

• 設定 Azure 診斷 延伸模組以執行 .NET Profiler。
• 在 VM 上安裝 Application Insights SDK。
• 部署您的應用程式。
• 透過 Azure 入口網站中的 Application Insights 執行個體檢視 Profiler 追蹤。

必要條件

• 正常運作的 ASP.NET Core 應用程式。
• Application Insights 資源。
• 若要檢閱適用於 Azure 診斷延伸模組的 Azure Resource Manager 範本 (ARM 範本)：
  • VM
  • 虛擬機器擴展集

將 Application Insights SDK 新增至您的應用程式

1. 在 Visual Studio 中開啟您的 ASP.NET Core 專案。

2. 選取 [專案]>[新增 Application Insights 遙測]。

3. 選取 [Azure Application Insights]>[下一步]。

4. 選取 Application Insights 資源所在的訂用帳戶，然後選取 [下一步]。

5. 選取要儲存連接字串的位置，然後選取 [下一步]。

6. 選取 [完成]。

注意

如需完整指示 (包括如何不使用 Visual Studio 而直接在 ASP.NET Core 應用程式上啟用 Application Insights)，請參閱適用於 ASP.NET Core 應用程式的 Application Insights。

確認最新的 Application Insights SDK 穩定版本

1. 移至 [專案]>[管理 NuGet 套件]。

2. 選取 [Microsoft.ApplicationInsights.AspNetCore]。

3. 在側邊窗格上，從下拉式清單選取最新版本的 SDK。

4. 選取更新。

   

啟用 .NET Profiler

您可以透過三種方式之一來啟用 Profiler：

• 在 ASP.NET Core 應用程式中，使用 Azure Resource Manager 範本和 Visual Studio。 建議。
• 藉由 Azure CLI 使用 PowerShell 命令。
• 藉由使用 Azure 資源總管。

Visual Studio 和 ARM 範本

安裝 Azure 診斷擴充功能

1. 選擇要使用哪一個 ARM 範本：

   • VM
   • 虛擬機器擴展集

2. 在範本中，找出屬於類型 extension 的資源。

3. 在 Visual Studio 中，前往您在安裝 Application Insights SDK 時新增的 ASP.NET Core 應用程式中的 arm.json 檔案。

4. 將資源類型 extension 從範本新增至 arm.json 檔案，以使用 Azure 診斷來設定 VM 或虛擬機器擴展集。

5. 在 WadCfg 標籤內，將您的 Application Insights 檢測金鑰新增至 MyApplicationInsightsProfilerSink。

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

6. 部署您的應用程式。

PowerShell

下列 PowerShell 命令是只會觸及 Azure 診斷延伸模組的現有 VM 適用的方法。

注意

若您再次部署 VM，接收器將會遺失。 您將需要更新部署 VM 時所使用的設定，以保留此設定。

透過 Azure 診斷設定來安裝 Application Insights

1. 將目前已部署的 Azure 診斷設定匯出至檔案：

   $ConfigFilePath = [IO.Path]::GetTempFileName()
   

2. 將 Application Insights Profiler 接收器新增至下列命令傳回的設定：

   (Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath
   

   Application Insights Profiler WadCfg：

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

3. 執行下列命令，將更新的設定傳至 Set-AzVMDiagnosticsExtension 命令。

   Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
   

   注意

   Set-AzVMDiagnosticsExtension 可能需要 -StorageAccountName 引數。 如果您的原始診斷設定在 protectedSettings 區段中有 storageAccountName 屬性 (無法下載)，請務必傳入您在此 Cmdlet 呼叫中使用的相同原始值。

IIS HTTP 追蹤功能

如果預期的應用程式是透過 IIS 執行，則啟用 IIS Http Tracing Windows 功能：

1. 建立對環境的遠端存取。

2. 使用新增 Windows 功能視窗，或在 PowerShell 中執行下列命令 (以系統管理員身分)：

   Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
   

   如果建立遠端存取發生問題，您可以使用 Azure CLI 來執行下列命令：

   az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
   

3. 部署您的應用程式。

Azure 資源總管

藉由使用 Azure 資源總管設定 Profiler 接收器

由於 Azure 入口網站 不提供設定 .NET 接收 Application Insights Profiler 的方法，因此您可以使用 Azure 資源總管來設定接收。

注意

若您再次部署 VM，接收器將會遺失。 您將需要更新部署 VM 時所使用的設定，以保留此設定。

1. 檢視為虛擬機器安裝的延伸模組，以驗證是否已安裝 Microsoft Azure 診斷延伸模組。

   

2. 尋找 VM 的 VM 診斷延伸模組：

   1. 移至 Azure 資源總管。

   2. 展開 [訂用帳戶]，並尋找包含 VM 所屬資源群組的訂用帳戶。

   3. 選取您的資源群組，向下切入至您的 VM 擴充功能。 然後選取 [Microsoft.Compute]>[virtualMachines]>[您的虛擬機器]>[擴充功能]。

      

3. 將適用於 .NET 接收的 Application Insights Profiler 新增至 SinksConfig 下的 WadCfg節點。 若您還沒有 SinksConfig 區段，或許需要新增一個。 若要新增接收器：

   • 在設定中指定適當的 Application Insights iKey。

   • 在右上角將總管模式切換為 [讀取/寫入]。

   • 選取編輯。

     

     "WadCfg": {
       "SinksConfig": {
         "Sink": [
           {
             "name": "MyApplicationInsightsProfilerSink",
             "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
           }
         ]
       }
     }        
     

4. 當設定編輯完成後，請選取 [PUT]。

5. 若 put 成功，畫面中間會出現綠色勾號標記。

   

.NET Profiler 可以在內部部署伺服器上執行嗎？

目前，內部部署伺服器不支援適用於 .NET 的 Application Insights Profiler。

下一步

產生載入並檢視 .NET Profiler 追蹤