Azure Monitor Dependency-VM-Erweiterung für Windows

Artikel
09/27/2024

Das Zuordnungsfeature in Azure Monitor für VMs erhält seine Daten vom Microsoft Dependency-Agent. Die Azure-VM-Dependency-Agent-Erweiterung für Windows installiert den Dependency-Agent auf virtuellen Azure-Computern. Dieses Dokument enthält ausführliche Informationen zu den unterstützten Plattformen, Konfigurationen und Bereitstellungsoptionen für die Azure Dependency-Agent-VM-Erweiterung für Windows.

Betriebssystem

Die Erweiterung für den Azure VM Dependency-Agent für Windows kann auf den in der folgenden Tabelle aufgeführten unterstützten Betriebssysteme ausgeführt werden. Bei allen Betriebssystemen in der folgenden Tabelle wird davon ausgegangen, dass sie x64 sind. x86 wird für kein Betriebssystem unterstützt.

Betriebssystem	Azure VM-Abhängigkeits-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 und Pro	✓¹, ²
Windows 11 Enterprise (einschließlich Multisession)	✓
Windows 10 1803 (RS4) und neuer	✓¹
Windows 10 Enterprise (einschließlich Multisession) und Pro (nur Serverszenarien)	✓
Windows 8 Enterprise und Pro (nur Serverszenarien)
Windows 7 SP1 (nur Serverszenarien)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Verwenden des Clientinstallationsprogramms des Azure Monitor-Agents.
² Wird auch auf Arm64-basierten Computern unterstützt.

Erweiterungsschema

Das folgende JSON zeigt das Schema für die Azure VM Dependency-Agent-Erweiterung auf einem virtuellen Azure Windows-Computer.

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

Eigenschaftswerte

Name	Beispiel/Wert
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
Type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
Einstellungen	"enableAMA": "true"

Wichtig

Fügen Sie Ihrer Vorlage unbedingt enableAMA hinzu, wenn Sie den Azure Monitor-Agent verwenden. Andernfalls versucht der Dependency-Agent, Daten an den veralteten Log Analytics-Agent zu senden.

Bereitstellung von Vorlagen

Sie können die Azure-VM-Erweiterungen mithilfe von Azure Resource Manager-Vorlagen bereitstellen. Sie können das im vorherigen Abschnitt erläuterte JSON-Schema in einer Azure Resource Manager-Vorlage verwenden, um die Azure VM Dependency-Agent-Erweiterung im Rahmen einer Azure Resource Manager-Bereitstellung auszuführen.

Der JSON-Code für eine VM-Erweiterung kann innerhalb der VM-Ressource geschachtelt werden. Alternativ können Sie den Code auf der Stamm- bzw. obersten Ebene einer Resource Manager-JSON-Vorlage platzieren. Die Platzierung des JSON-Codes wirkt sich auf den Wert von Name und Typ der Ressource aus. Weitere Informationen finden Sie unter Set name and type for child resources (Festlegen von Name und Typ für untergeordnete Ressourcen).

Im folgenden Beispiel wird davon ausgegangen, dass die Dependency-Agent-Erweiterung in der VM-Ressource geschachtelt ist. Wenn Sie die Erweiterungsressource schachteln, wird der JSON-Code im "resources": []-Objekt des virtuellen Computers platziert.

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

Wenn Sie den JSON-Code für die Erweiterung auf der Stammebene der Vorlage platzieren, enthält der Ressourcenname einen Verweis auf den übergeordneten virtuellen Computer. Der Typ spiegelt die geschachtelte Konfiguration wider.

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

Sie können den Befehl Set-AzVMExtension verwenden, um die Dependency-Agent-VM-Erweiterung auf einem vorhandenen virtuellen Computer bereitzustellen. Bevor Sie den Befehl ausführen, müssen die öffentliche und die private Konfiguration in einer PowerShell-Hashtabelle gespeichert werden.


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

Automatisches Erweiterungsupgrade

Ein neues Feature für automatische Upgrades für Nebenversionen der Dependency-Erweiterung ist jetzt verfügbar.

Sie müssen sicherstellen, dass die Eigenschaft enableAutomaticUpgrade auf true festgelegt ist und der Erweiterungsvorlage hinzugefügt wird, um automatische Erweiterungsupgrades für eine Erweiterung zu aktivieren. Diese Eigenschaft muss für jede VM oder VM-Skalierungsgruppe einzeln aktiviert werden. Verwenden Sie eine der im Abschnitt Aktivieren des automatischen Erweiterungsupgrades beschriebenen Methoden, um das Feature für Ihre VM oder VM-Skalierungsgruppe zu aktivieren.

Wenn das automatische Erweiterungsupgrade für eine VM oder VM-Skalierungsgruppe aktiviert ist, wird für die Erweiterung automatisch ein Upgrade ausgeführt, sobald der Erweiterungsherausgeber eine neue Version für diese Erweiterung freigibt. Das Upgrade wird wie hier beschrieben gemäß den verfügbarkeitsbasierten Prinzipien sicher angewendet.

Die Funktionalität des enableAutomaticUpgrade-Attributs unterscheidet sich von jener des autoUpgradeMinorVersion-Attributs. Das autoUpgradeMinorVersion-Attribut löst nicht automatisch eine Aktualisierung der Nebenversion aus, wenn der Herausgeber der Erweiterung eine neue Version veröffentlicht. Das autoUpgradeMinorVersion-Attribut gibt an, ob die Erweiterung eine neuere Nebenversion verwenden sollte, falls zum Bereitstellungszeitpunkt eine verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf true festgelegt ist.

Es wird empfohlen, enableAutomaticUpgrade für Ihre Erweiterungsbereitstellung zu verwenden, damit Ihre Erweiterungsversion aktualisiert wird.

Wichtig

Wenn Sie Ihrer Vorlage enableAutomaticUpgrade hinzufügen, stellen Sie sicher, dass Sie die API-Version 2019-12-01 oder höher verwenden.

Problembehandlung und Support

Problembehandlung

Daten zum Status von Erweiterungsbereitstellungen können aus dem Azure-Portal und über das Azure PowerShell-Modul abgerufen werden. Führen Sie im Azure PowerShell-Modul den folgenden Befehl aus, um den Bereitstellungsstatus von Erweiterungen für einen bestimmten virtuellen Computer anzuzeigen:

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

Die Ausgabe der Erweiterungsausführung wird in Dateien im folgenden Verzeichnis protokolliert:

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

Support

Sollten Sie beim Lesen dieses Artikels feststellen, dass Sie weitere Hilfe benötigen, können Sie sich über das Microsoft Q&A-Forum oder das Stack Overflow-Forum mit Azure-Expert*innen in Verbindung setzen. Sie können auch einen Azure-Supportfall erstellen. Rufen Sie die Azure-Support-Website auf, und wählen Sie Support erhaltenaus. Informationen darüber, wie Azure-Support genutzt werden kann, finden Sie unter Häufig gestellte Fragen zum Azure-Support.

Teilen über