Azure Monitor-beroendetillägg för virtuell dator för Linux

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 Linux 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 azure VM Dependency Agent-tillägget för virtuella datorer för Linux.

Förutsättningar

Operativsystem

Azure VM Dependency Agent-tillägget för Linux 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 Linux-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 Linux Azure VM."
      }
    }
  },
  "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true
      }
    }
  ],
    "outputs": {
    }
}

Egenskapsvärden

Namn Värde/exempel
apiVersion 2015-01-01
utgivare Microsoft.Azure.Monitoring.DependencyAgent
typ DependencyAgentLinux
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": "DependencyAgentLinux",
        "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true
	}
}

Azure CLI-distribution

Du kan använda Azure CLI för att distribuera VM-tillägget för beroendeagenten till en befintlig virtuell dator.


az vm extension set \
    --resource-group myResourceGroup \
    --vm-name myVM \
    --name DependencyAgentLinux \
    --publisher Microsoft.Azure.Monitoring.DependencyAgent \
    --version 9.5

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 statusen för tilläggsdistributioner kan hämtas från Azure Portal och med hjälp av Azure CLI. 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 CLI:

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Utdata för tilläggskörning loggas i följande fil:

/opt/microsoft/dependency-agent/log/install.log

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.