Azure Monitor Dependency-tillägg för virtuell dator för Windows

Artikel
03/05/2024

Kartfunktionen Azure Monitor for VMs hämtar sina data från Microsoft Dependency-agenten. Azure VM Dependency agent virtual machine extension for Windows installerar beroendeagenten på virtuella Azure-datorer. Det här dokumentet beskriver de plattformar, konfigurationer och distributionsalternativ som stöds för azure VM Dependency agent virtual machine extension för Windows.

Operativsystem

Azure VM Dependency Agent-tillägget för Windows kan köras mot de operativsystem som stöds i följande tabell. Alla operativsystem i följande tabell antas vara x64. x86 stöds inte för något operativsystem.

Operativsystem	Beroendeagent för virtuella Azure-datorer
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-klient och Pro	✔¹, ²
Windows 11 Enterprise (inklusive flera sessioner)	✓
Windows 10 1803 (RS4) och senare	✔¹
Windows 10 Enterprise (inklusive flera sessioner) och Pro (Endast serverscenarier)	✓
Windows 8 Enterprise och Pro (Endast serverscenarier)
Windows 7 SP1 (Endast serverscenarier)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Använda klientinstallationsprogrammet för Azure Monitor-agenten.
² Stöds också på Arm64-baserade datorer.

Tilläggsschema

Följande JSON visar schemat för Azure VM Dependency Agent-tillägget på en virtuell Azure Windows-dator.

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

Egenskapsvärden

Name	Värde/exempel
apiVersion	2015-01-01
Publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9,10
autoUpgradeMinorVersion	true
settings	"enableAMA": "true"

Viktigt!

Se till att lägga enableAMA till i mallen om du använder Azure Monitor Agent. Annars försöker beroendeagenten skicka data till den äldre Log Analytics-agenten.

Malldistribution

Du kan distribuera Azure VM-tillägg med Azure Resource Manager-mallar. Du kan använda JSON-schemat som beskrivs i föregående avsnitt i en Azure Resource Manager-mall för att köra Azure VM Dependency Agent-tillägget under en Azure Resource Manager-malldistribution.

JSON för ett tillägg för virtuella datorer kan kapslas i den virtuella datorresursen. Eller så kan du placera den på rot- eller toppnivå i en Resource Manager JSON-mall. Placeringen av JSON påverkar värdet för resursnamnet och typen. Mer information finns i Ange namn och typ för underordnade resurser.

I följande exempel förutsätts att beroendeagenttillägget är kapslat i den virtuella datorresursen. När du kapslade tilläggsresursen placeras JSON i objektet "resources": [] för den virtuella datorn.

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

När du placerar tilläggets JSON i mallens rot innehåller resursnamnet en referens till den överordnade virtuella datorn. Typen återspeglar den kapslade konfigurationen.

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

Du kan använda Set-AzVMExtension kommandot för att distribuera tillägget för den virtuella beroendeagenten till en befintlig virtuell dator. Innan du kör kommandot måste de offentliga och privata konfigurationerna lagras i en PowerShell-hashtabell.


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

Automatisk tilläggsuppgradering

En ny funktion för att automatiskt uppgradera mindre versioner av beroendetillägget är nu tillgänglig.

Om du vill aktivera automatisk tilläggsuppgradering för ett tillägg måste du se till att egenskapen enableAutomaticUpgrade har angetts till true och lagts till i tilläggsmallen. Den här egenskapen måste aktiveras på varje VM- eller VM-skalningsuppsättning individuellt. Använd någon av metoderna som beskrivs i aktiveringsavsnittet för att aktivera funktionen för vm- eller VM-skalningsuppsättningen.

När automatisk tilläggsuppgradering är aktiverad på en VM- eller VM-skalningsuppsättning uppgraderas tillägget automatiskt när tilläggsutgivaren släpper en ny version för tillägget. Uppgraderingen tillämpas på ett säkert sätt enligt principerna för tillgänglighet först enligt beskrivningen här.

Attributets enableAutomaticUpgrade funktioner skiljer sig från autoUpgradeMinorVersion. Attributet autoUpgradeMinorVersion utlöser inte automatiskt en delversionsuppdatering när tilläggsutgivaren släpper en ny version. Attributet autoUpgradeMinorVersion anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte mindre versioner om inte omdistribueras, även med den här egenskapen inställd på true.

För att hålla tilläggsversionen uppdaterad rekommenderar vi att du använder enableAutomaticUpgrade med tilläggsdistributionen.

Viktigt!

Om du lägger till i mallen enableAutomaticUpgrade kontrollerar du att du använder i API-version 2019-12-01 eller senare.

Felsökning och support

Felsöka

Data om tillståndet för tilläggsdistributioner kan hämtas från Azure-portalen och med hjälp av Azure PowerShell-modulen. Om du vill se distributionstillståndet för tillägg för en viss virtuell dator kör du följande kommando med hjälp av Azure PowerShell-modulen:

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

Utdata för körning av tillägg loggas i filer som finns i följande katalog:

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

Support

Om du behöver mer hjälp när som helst i den här artikeln kan du kontakta Azure-experterna på Microsoft Q &A- och Stack Overflow-forumen. Eller så kan du skapa en Azure-supportincident. Gå till Azure-supportwebbplatsen och välj Hämta support. Information om hur du använder Azure Support finns i Vanliga frågor och svar om Microsoft Azure-support.