VM-extensie Azure Monitor Dependency voor Windows

Artikel
03/05/2024

Met de toewijzingsfunctie van Azure Monitor voor VM's worden de gegevens opgehaald van de Microsoft Dependency Agent. Met de virtuele machine-extensie van de Azure VM-agent voor Windows wordt de afhankelijkheidsagent op virtuele Azure-machines geïnstalleerd. In dit document worden de ondersteunde platforms, configuraties en implementatieopties voor de virtuele machine-extensie van de Azure VM-agent voor Windows beschreven.

Besturingssysteem

De Azure VM Dependency Agent-extensie voor Windows kan worden uitgevoerd op de ondersteunde besturingssystemen die worden vermeld in de volgende tabel. Alle besturingssystemen in de volgende tabel worden verondersteld x64 te zijn. x86 wordt niet ondersteund voor een besturingssysteem.

Besturingssysteem	Azure VM Dependency Agent
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 Client en Pro	✓¹, ²
Windows 11 Enterprise (inclusief meerdere sessies)	✓
Windows 10 1803 (RS4) en hoger	✓¹
Windows 10 Enterprise (inclusief meerdere sessies) en Pro (Alleen serverscenario's)	✓
Windows 8 Enterprise en Pro (Alleen serverscenario's)
Windows 7 SP1 (Alleen serverscenario's)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Het clientinstallatieprogramma van de Azure Monitor-agent gebruiken.
² Ook ondersteund op arm64-computers.

Extensieschema

In de volgende JSON ziet u het schema voor de Azure VM Dependency Agent-extensie op een Azure Windows-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": {
    }
}

Eigenschapswaarden

Naam	Waarde/voorbeeld
apiVersion	2015-01-01
Publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
instellingen	"enableAMA": "true"

Belangrijk

Zorg ervoor dat u aan uw sjabloon toevoegt enableAMA als u Azure Monitor Agent gebruikt. Anders probeert de afhankelijkheidsagent gegevens te verzenden naar de verouderde Log Analytics-agent.

Sjabloonimplementatie

U kunt de Azure VM-extensies implementeren met Azure Resource Manager-sjablonen. U kunt het JSON-schema gebruiken dat in de vorige sectie in een Azure Resource Manager-sjabloon wordt beschreven om de Azure VM Dependency Agent-extensie uit te voeren tijdens een implementatie van een Azure Resource Manager-sjabloon.

De JSON voor een virtuele-machineextensie kan worden genest in de virtuele-machineresource. U kunt deze ook op het hoofd- of hoogste niveau van een Resource Manager JSON-sjabloon plaatsen. De plaatsing van de JSON is van invloed op de waarde van de resourcenaam en het type. Zie Naam en type instellen voor onderliggende resources voor meer informatie.

In het volgende voorbeeld wordt ervan uitgegaan dat de afhankelijkheidsagentextensie is genest in de resource van de virtuele machine. Wanneer u de extensieresource nest, wordt de JSON in het "resources": [] object van de virtuele machine geplaatst.

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

Wanneer u de extensie-JSON in de hoofdmap van de sjabloon plaatst, bevat de resourcenaam een verwijzing naar de bovenliggende virtuele machine. Het type weerspiegelt de geneste configuratie.

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

U kunt de Set-AzVMExtension opdracht gebruiken om de extensie voor de virtuele machine van de afhankelijkheidsagent te implementeren op een bestaande virtuele machine. Voordat u de opdracht uitvoert, moeten de openbare en persoonlijke configuraties worden opgeslagen in een PowerShell-hashtabel.


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

Automatische extensie-upgrade

Er is nu een nieuwe functie beschikbaar om secundaire versies van de afhankelijkheidsextensie automatisch te upgraden.

Als u automatische extensie-upgrade wilt inschakelen voor een extensie, moet u ervoor zorgen dat de eigenschap enableAutomaticUpgrade is ingesteld true op en toegevoegd aan de extensiesjabloon. Deze eigenschap moet afzonderlijk worden ingeschakeld op elke VM of VM-schaalset. Gebruik een van de methoden die worden beschreven in de sectie Inschakelen van de functie voor uw VM of VM-schaalset.

Wanneer automatische extensie-upgrade is ingeschakeld op een VM of VM-schaalset, wordt de extensie automatisch bijgewerkt wanneer de uitgever van de extensie een nieuwe versie voor die extensie publiceert. De upgrade wordt veilig toegepast op basis van de principes voor beschikbaarheid en eerst, zoals hier wordt beschreven.

De enableAutomaticUpgrade functionaliteit van het kenmerk verschilt van die van de autoUpgradeMinorVersion. Het autoUpgradeMinorVersion kenmerk activeert niet automatisch een secundaire versie-update wanneer de uitgever van de extensie een nieuwe versie publiceert. Het autoUpgradeMinorVersion kenmerk geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.

Als u de extensieversie wilt bijwerken, raden we u aan bij uw extensie-implementatie te gebruiken enableAutomaticUpgrade .

Belangrijk

Als u de enableAutomaticUpgrade sjabloon toevoegt, moet u ervoor zorgen dat u bij API-versie 2019-12-01 of hoger gebruikt.

Problemen met en ondersteuning oplossen

Problemen oplossen

Gegevens over de status van extensie-implementaties kunnen worden opgehaald uit Azure Portal en met behulp van de Azure PowerShell-module. Voer de volgende opdracht uit met behulp van de Azure PowerShell-module om de implementatiestatus van extensies voor een bepaalde VM te bekijken:

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

Uitvoer van extensie-uitvoering wordt vastgelegd in bestanden in de volgende map:

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

Ondersteuning

Als u op elk gewenst moment in dit artikel meer hulp nodig hebt, kunt u contact opnemen met de Azure-experts op de Microsoft Q & A- en Stack Overflow-forums. U kunt ook een ondersteuning voor Azure incident indienen. Ga naar de ondersteuning voor Azure-site en selecteer Ondersteuning krijgen. Lees de veelgestelde vragen over Microsoft ondersteuning voor Azure voor informatie over het gebruik van Azure-ondersteuning.