Rozšíření virtuálního počítače agenta závislostí Azure Monitoru pro Windows

Článek
08/25/2024

Funkce Azure Monitor pro virtuální počítače Map získá data z agenta Microsoft Dependency Agent. Rozšíření virtuálního počítače závislého agenta virtuálního počítače virtuálního počítače Azure pro Windows nainstaluje agenta závislostí na virtuální počítače Azure. Tento dokument podrobně popisuje podporované platformy, konfigurace a možnosti nasazení pro rozšíření virtuálního počítače azure VM Dependency Agent pro Windows.

Operační systém

Rozšíření agenta závislostí virtuálního počítače Azure pro Windows se dá spustit s podporovanými operačními systémy uvedenými v následující tabulce. Předpokládá se, že všechny operační systémy v následující tabulce jsou x64. X86 není podporován pro žádný operační systém.

Operační systém	Agent závislostí virtuálních počítačů Azure
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	✓
Klient Windows 11 a Pro	{¹, ²
Windows 11 Enterprise (včetně více relací)	✓
Windows 10 1803 (RS4) a novější	{¹
Windows 10 Enterprise (včetně více relací) a Pro (Pouze scénáře serveru)	✓
Windows 8 Enterprise a Pro (Pouze scénáře serveru)
Windows 7 SP1 (Pouze scénáře serveru)
Azure Stack HCI
Windows IoT Enterprise	✓

¹. Použití instalačního programu agenta služby Azure Monitor
² Podporuje se také na počítačích založených na Arm64.

Schéma rozšíření

Následující kód JSON ukazuje schéma rozšíření agenta závislostí virtuálního počítače Azure na virtuálním počítači Azure s Windows.

{
  "$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": {
    }
}

Hodnoty vlastností

Název	Hodnota/příklad
apiVersion	2015-01-01
vydavatel	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
settings	"enableAMA": "true"

Důležité

Pokud používáte agenta služby Azure Monitor, nezapomeňte do šablony přidat enableAMA . Jinak se agent závislostí pokusí odesílat data do starší verze agenta Log Analytics.

Nasazení šablon

Rozšíření virtuálních počítačů Azure můžete nasadit pomocí šablon Azure Resource Manageru. Schéma JSON podrobně popsané v předchozí části šablony Azure Resource Manageru můžete použít ke spuštění rozšíření agenta závislostí virtuálního počítače Azure během nasazení šablony Azure Resource Manageru.

Json pro rozšíření virtuálního počítače je možné vnořit do prostředku virtuálního počítače. Nebo ho můžete umístit na kořenovou nebo nejvyšší úroveň šablony JSON Resource Manageru. Umístění JSON má vliv na hodnotu názvu a typu prostředku. Další informace naleznete v tématu Nastavení názvu a typu pro podřízené prostředky.

Následující příklad předpokládá, že rozšíření agenta závislostí je vnořené uvnitř prostředku virtuálního počítače. Při vnoření prostředku rozšíření se JSON umístí do "resources": [] objektu virtuálního počítače.

{
	"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"
    		    }
    }
}

Když umístíte json rozšíření do kořenového adresáře šablony, název prostředku obsahuje odkaz na nadřazený virtuální počítač. Typ odráží vnořenou konfiguraci.

{
	"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"
    		    }
	}
}

Nasazení PowerShellu

Pomocí příkazu můžete Set-AzVMExtension nasadit rozšíření virtuálního počítače agenta závislostí na existující virtuální počítač. Před spuštěním příkazu musí být veřejné a privátní konfigurace uložené v tabulce hodnot hash PowerShellu.


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

Automatický upgrade rozšíření

Nyní je k dispozici nová funkce pro automatický upgrade podverzí rozšíření Dependency.

Chcete-li povolit automatický upgrade rozšíření pro rozšíření, je nutné zajistit, aby byla vlastnost enableAutomaticUpgrade nastavena true a přidána do šablony rozšíření. Tato vlastnost musí být povolená na každém virtuálním počítači nebo škálovací sadě virtuálních počítačů jednotlivě. Použijte jednu z metod popsaných v části povolení , která umožňuje funkci pro virtuální počítač nebo škálovací sadu virtuálních počítačů.

Pokud je na virtuálním počítači nebo škálovací sadě virtuálních počítačů povolen automatický upgrade rozšíření, upgraduje se toto rozšíření automaticky pokaždé, když vydavatel rozšíření vydá novou verzi pro toto rozšíření. Upgrade se používá bezpečně podle zásad první dostupnosti, jak je popsáno zde.

Funkce enableAutomaticUpgrade atributu se liší od funkce atributu autoUpgradeMinorVersion. Atribut autoUpgradeMinorVersion automaticky neaktivuje aktualizaci podverze, když vydavatel rozšíření vydá novou verzi. Atribut autoUpgradeMinorVersion označuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení ale rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.

Pokud chcete, aby se vaše verze rozšíření aktualizovala, doporučujeme použít enableAutomaticUpgrade s nasazením rozšíření.

Důležité

Pokud šablonu přidáte enableAutomaticUpgrade , ujistěte se, že používáte rozhraní API verze 2019-12-01 nebo vyšší.

Řešení potíží a podpora

Odstraňování potíží

Data o stavu nasazení rozšíření je možné načíst z webu Azure Portal a pomocí modulu Azure PowerShellu. Pokud chcete zobrazit stav nasazení rozšíření na daném virtuálním počítači, s využitím modulu Azure PowerShellu spusťte následující příkaz:

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

Výstup spouštění rozšíření se zaznamenává do souborů v následujícím adresáři:

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

Technická podpora

Pokud potřebujete další pomoc v libovolném bodě tohoto článku, můžete se obrátit na odborníky na Azure na fórech Microsoft Q &a A a Stack Overflow. Nebo můžete podat podpora Azure incident. Přejděte na web podpora Azure a vyberte Získat podporu. Informace o tom, jak používat podporu Azure, najdete v nejčastějších dotazech k Microsoftu podpora Azure.

Sdílet prostřednictvím