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

Kartfunktionen Azure Monitor for VMs hämtar sina data från Microsoft Dependency-agenten. Azure VM Dependency agent virtual machine extension for Linux 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 Linux.

Förutsättningar

Operativsystem

Eftersom Beroendeagenten för den virtuella Azure-datorn fungerar på kernelnivå är även operativsystemsstöd beroende av kernelversionen. Från och med dependency agent version 9.10.* har agenten stöd för * kernels. I följande tabell visas den större och mindre Versionen av Linux-operativsystemet och kernelversioner som stöds för Dependency-agenten.

Kommentar

Med dependency agent 9.10.15 och senare blockeras inte installationen för kernelversioner som inte stöds, men agenten körs i degraderat läge. I det här läget samlas inte anslutnings- och portdata som lagras i tabellerna VM Anslut ion och VMBoundport in. VMProcess-tabellen kan ha vissa data, men den är minimal.

Distribution	OS-version	Kernelversion
Red Hat Linux 8	8,6	4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
	8.5	4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
	8,4	4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.*el8.x86_64 4.18.0-80.*el8_0.x86_64
Red Hat Linux 7	7,9	3.10.0-1160
	7,8	3.10.0-1136
	7.7	3.10.0-1062
	7.6	3.10.0-957
	7.5	3.10.0-862
	7,4	3.10.0-693
Red Hat Linux 6	6.10	2.6.32-754
	6.9	2.6.32-696
CentOS Linux 8	8,6	4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
	8.5	4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
	8,4	4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.*el8.x86_64 4.18.0-80.*el8_0.x86_64
CentOS Linux 7	7,9	3.10.0-1160
	7,8	3.10.0-1136
	7.7	3.10.0-1062
CentOS Linux 6	6.10	2.6.32-754.3.5 2.6.32-696.30.1
	6.9	2.6.32-696.30.1 2.6.32-696.18.7
Ubuntu Server	20.04	5.8 5.4*
	18.04	5.3.0-1020 5.0 (innehåller Azure-finjusterad kernel) 4.18* 4.15*
	16.04.3	4.15.*
	16.04	4.13.* 4.11.* 4.10.* 4.8.* 4.4.*
	14.04	3.13.*-generic 4.4.*-generic
SUSE Linux 12 Enterprise Server	12 SP5	4.12.14-122.*-default, 4.12.14-16.*-azure
	12 SP4	4.12.* (innehåller Azure-finjusterad kernel)
	12 SP3	4.4.*
	12 SP2	4.4.*
SUSE Linux 15 Enterprise Server	15 SP1	4.12.14-197.*-default, 4.12.14-8.*-azure
	15	4.12.14-150.*-default
Debian	9	4,9

Kommentar

Beroendeagenten stöds inte för virtuella Azure-datorer med Ampere Altra ARM-baserade processorer.

Tilläggsschema

Följande JSON visar schemat för Azure VM Dependency Agent-tillägget 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,
          "settings": {
              "enableAMA": "true"
        }
      }
    }
  ],
    "outputs": {
    }
}

Egenskapsvärden

Name	Värde/exempel
apiVersion	2015-01-01
Publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentLinux
typeHandlerVersion	9.5
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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "enableAMA": "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 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 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:

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

Support

Om du behöver mer hjälp när som helst i den här artikeln kontaktar du 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.