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

Funktionen Azure Monitor for VMs Map hämtar data från Microsoft Dependency Agent. Azure VM Dependency Agent-tillägget för virtuella datorer för Windows publiceras och stöds av Microsoft. Tillägget installerar beroendeagenten på virtuella Azure-datorer. Det här dokumentet innehåller information om plattformar, konfigurationer och distributionsalternativ som stöds för tillägget azure VM Dependency agent virtual machine for Windows.

Operativsystem

Azure VM Dependency Agent-tillägget för Windows kan köras mot de operativsystem som stöds i avsnittet Operativsystem som stöds i artikeln om Azure Monitor for VMs distribution.

Tilläggsschema

Följande JSON visar schemat för tillägget beroendeagent för virtuell Azure-dator 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.5",
        "autoUpgradeMinorVersion": true
      }
    }
  ],
    "outputs": {
    }
}

Egenskapsvärden

Namn Värde/exempel
apiVersion 2015-01-01
utgivare Microsoft.Azure.Monitoring.DependencyAgent
typ DependencyAgentWindows
typeHandlerVersion 9.5

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 tillägget beroendeagent för virtuell Azure-dator under en Azure Resource Manager-malldistribution.

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

I följande exempel förutsätts att dependency agent-tillägget är kapslat i den virtuella datorresursen. När du kapslas tilläggsresursen placeras JSON i "resources": [] objektet 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.5",
        "autoUpgradeMinorVersion": true
	}
}

När du placerar JSON-tillägget 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.5",
        "autoUpgradeMinorVersion": true
	}
}

PowerShell-distribution

Du kan använda kommandot Set-AzVMExtension 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.5 `
    -Location WestUS

Automatisk uppgradering av tillägg

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

Om du vill aktivera automatisk uppgradering av tillägg för ett tillägg måste du se till att egenskapen enableAutomaticUpgrade är inställd på och läggs till i true tilläggsmallen. Den här egenskapen måste vara aktiverad på varje virtuell dator eller VM-skalningsuppsättning individuellt. Använd någon av metoderna som beskrivs i avsnittet aktivera funktionen för din virtuella dator eller VM-skalningsuppsättning.

När automatisk uppgradering av tillägg är aktiverat på en virtuell dator eller VM-skalningsuppsättning, uppgraderas tillägget automatiskt när tilläggsutgivaren släpper en ny version för det 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 funktionen för autoUpgradeMinorVersion . Attributen autoUpgradeMinorVersion utlöser inte automatiskt en mindre versionsuppdatering när tilläggsutgivaren släpper en ny version. Attributet autoUpgradeMinorVersion anger om tillägget ska använda en nyare delversion om en sådan är tillgänglig vid distributionen. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte omdistribueras, även om den här egenskapen är inställd på true.

Om du vill hålla tilläggsversionen uppdaterad rekommenderar vi att du använder enableAutomaticUpgrade med tilläggdistributionen.

Viktigt

Om du lägger till i mallen kontrollerar du att du använder i enableAutomaticUpgrade 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 Portal 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-experter på MSDN Azureoch Stack Overflow forumen . Eller så kan du skapa en Azure-supportincident. Gå till Azure-supportwebbplatsen och välj Få support. Information om hur du använder Azure Support finns i vanliga Microsoft Azure vanliga frågor och svar om support.