適用於 Windows 的 Azure 監視器相依性虛擬機器擴充功能

發行項
08/25/2024

適用於 VM 的 Azure 監視器對應功能會從 Microsoft Dependency Agent 取得其資料。適用於 Windows 的 Azure VM 相依性代理程式虛擬機器擴充功能會在 Azure 虛擬機器上安裝相依性代理程式。此文件詳細說明適用於 Windows 的 Azure VM 相依性代理程式虛擬機器延伸模組所支援的平台、組態和部署選項。

作業系統

適用於 Windows 的 Azure VM 相依性代理程式延伸模組可在下表所列的支援作業系統上執行。下表中的所有作業系統均假設為 x64。所有作業系統皆不支援 x86。

作業系統	Azure VM 相依性代理程式
Windows Server 2022	✓
Windows Server 2022 Core	✓
Windows Server 2019	✓
Windows Server 2019 Core	✓
Windows Server 2016	✓
Windows Server 2016 Core	✓
Windows Server 2012 R2	✓
Windows Server 2012	✓
Windows 11 用戶端和專業版	✓¹、²
Windows 11 企業版 (包括多重工作階段)	✓
Windows 10 1803 (RS4) 或更新版本	✓¹
Windows 10 Enterprise (包括多重工作階段) 和 Pro (伺服器案例僅限)	✓
Windows 8 企業版和專業版 (伺服器案例僅限)
Windows 7 SP1 (伺服器案例僅限)
Azure Stack HCI
Windows IoT 企業版	✓

¹ 使用 Azure 監視器代理程式用戶端安裝程式。
² 在 Arm64 型機器上也支援。

擴充功能結構描述

下列 JSON 顯示 Azure Windows VM 上 Azure VM 相依性代理程式延伸模組的結構描述。

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of existing Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "variables": {
    "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

屬性值

名稱	值/範例
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
設定	"enableAMA":"true"

重要

如果您使用 Azure 監視器代理程式，請務必將 enableAMA 新增至範本，否則相依性代理程式會嘗試將資料傳送至舊版 Log Analytics 代理程式。

範本部署

您可以使用 Azure Resource Manager 範本部署 Azure VM 延伸模組。在部署 Azure Resource Manager 範本時，您可以在 Azure Resource Manager 範本中使用上一節詳述的 JSON 結構描述來執行 Azure VM 相依性代理程式擴充功能。

虛擬機器擴充功能的 JSON 能以巢狀方式置於虛擬機器資源內部。或者，您可以將其放在 Resource Manager JSON 範本的根目錄層或最上層。 JSON 的放置會影響資源名稱和類型的值。如需詳細資訊，請參閱設定子資源的名稱和類型。

下列範例假設相依性代理程式擴充功能以巢狀方式置於虛擬機器資源內部。當您以巢狀方式安置擴充功能資源時，JSON 會放在虛擬機器的 "resources": [] 物件中。

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

當您將擴充功能 JSON 放在範本的根目錄時，資源名稱會包含對父代虛擬機器的參考。型別會反映以巢狀方式安置的設定。

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

PowerShell 部署

您可以使用 Set-AzVMExtension 命令將相依性代理程式虛擬機器延伸模組部署到現有的虛擬機器。執行命令之前，必須將公用和私人組態儲存在 PowerShell 雜湊表中。


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

自動升級擴充功能

現在已可使用相依性延伸模組的自動升級次要版本新功能。

若要啟用延伸模組的自動延伸模組更新，您必須確定 enableAutomaticUpgrade 屬性已設定為 true，並新增至延伸模組範本。此屬性必須個別在每部 VM 或 VM 擴展集上啟用。使用啟用一節中所述的其中一種方法，為您的 VM 或 VM 擴展集啟用此功能。

在 VM 或 VM 擴展集上啟用自動延伸模組更新時，每當延伸模組發行者發行該延伸模組的新版本時，就會自動升級延伸模組。升級會遵循可用性優先的原則安全地套用，如這裡所述。

enableAutomaticUpgrade 屬性的功能與 autoUpgradeMinorVersion 的功能不同。當延伸模組發行者發行新版本時，autoUpgradeMinorVersion 屬性不會自動觸發次要版本更新。 autoUpgradeMinorVersion 屬性會指出延伸模組是否應該在部署期間有較新的次要版本可用時，使用該版本。不過，部署之後，除非重新部署延伸模組，否則延伸模組將不會升級次要版本，即使此屬性設定為 true 亦然。

若要讓您的延伸模組版本保持更新，建議您搭配延伸模組部署使用 enableAutomaticUpgrade。

重要

如果您將 enableAutomaticUpgrade 新增至範本，請確定您是在 API 2019-12-01 版或更高版本中使用。

疑難排解與支援

疑難排解

使用 Azure PowerShell 模組，就可以從 Azure 入口網站擷取有關延伸模組部署狀態的資料。若要查看所指定 VM 的擴充功能部署狀態，請使用 Azure PowerShell 模組來執行下列命令：

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

擴充功能執行輸出會記錄至下列目錄中的檔案︰

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

支援

如果您在如果您在本文中有任何需要協助的地方，請連絡 Microsoft 問與答和 Stack Overflow 論壇上的 Azure 專家。或者，您也可以提出 Azure 支援事件。請移至 Azure 支援網站，然後選取 [取得支援]。如需如何使用 Azure 支援的相關資訊，請參閱 Microsoft Azure 支援常見問題集。

共用方式為