為 Azure 虛擬機器上的 Web 應用程式啟用 Profiler

發行項
04/26/2024

注意

建議您使用 Azure Az PowerShell 模組來與 Azure 互動。請參閱安裝 Azure PowerShell 以開始使用。若要了解如何移轉至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。

在本文中，您將了解如何透過三種不同的方法，在 Azure 虛擬機器 (VM) 或 Azure 虛擬機器擴展集上執行 Application Insights Profiler：

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

您可以透過上述任何方法來：

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

必要條件

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

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

在 Visual Studio 中開啟您的 ASP.NET Core 專案。
選取 [專案]>[新增 Application Insights 遙測]。
選取 [Azure Application Insights]>[下一步]。
選取 Application Insights 資源所在的訂用帳戶，然後選取 [下一步]。
選取要儲存連接字串的位置，然後選取 [下一步]。
選取 [完成]。

注意

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

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

移至 [專案]>[管理 NuGet 套件]。
選取 [Microsoft.ApplicationInsights.AspNetCore]。
在側邊窗格上，從下拉式清單選取最新版本的 SDK。
選取更新。

啟用分析工具

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

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

安裝 Azure 診斷擴充功能

選擇要使用哪一個 ARM 範本：
- VM
- 虛擬機器擴展集
在範本中，找出屬於類型 extension 的資源。
在 Visual Studio 中，前往您在安裝 Application Insights SDK 時新增的 ASP.NET Core 應用程式中的 arm.json 檔案。
將資源類型 extension 從範本新增至 arm.json 檔案，以使用 Azure 診斷來設定 VM 或虛擬機器擴展集。

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

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

部署您的應用程式。

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

注意

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

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

將目前已部署的 Azure 診斷設定匯出至檔案：
```
$ConfigFilePath = [IO.Path]::GetTempFileName()
```

將 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"
      }
    ]
  }
}

執行下列命令，將更新的設定傳至 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 功能：

建立對環境的遠端存取。

使用新增 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"

部署您的應用程式。

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

因為 Azure 入口網站未提供設定 Application Insights Profiler 接收器的機制，您可以使用 Azure 資源總管來設定接收器。

注意

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

檢視為虛擬機器安裝的延伸模組，以驗證是否已安裝 Microsoft Azure 診斷延伸模組。
尋找 VM 的 VM 診斷延伸模組：
1. 移至 Azure 資源總管。
2. 展開 [訂用帳戶]，並尋找包含 VM 所屬資源群組的訂用帳戶。
3. 選取您的資源群組，向下切入至您的 VM 擴充功能。然後選取 [Microsoft.Compute]>[virtualMachines]>[您的虛擬機器]>[擴充功能]。
將 Application Insights Profiler 接收器新增至 WadCfg 底下的 SinksConfig 節點。若您還沒有 SinksConfig 區段，或許需要新增一個。若要新增接收器：
- 在設定中指定適當的 Application Insights iKey。
- 在右上角將總管模式切換為 [讀取/寫入]。
- 選取編輯。
```
"WadCfg": {
  "SinksConfig": {
    "Sink": [
      {
        "name": "MyApplicationInsightsProfilerSink",
        "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
      }
    ]
  }
}        
```
當設定編輯完成後，請選取 [PUT]。
若 put 成功，畫面中間會出現綠色勾號標記。