VM-extensie voor Linux van Azure Monitor-afhankelijkheid

Artikel
08/25/2024

Met de toewijzingsfunctie van Azure Monitor voor VM's worden de gegevens opgehaald van de Microsoft Dependency Agent. Met de virtuele machine-extensie van de Azure VM-agent voor Linux wordt de afhankelijkheidsagent op virtuele Azure-machines geïnstalleerd. In dit document worden de ondersteunde platformen, configuraties en implementatieopties voor de virtuele machine-extensie van de Azure VM-agent voor Linux beschreven.

Vereisten

Besturingssysteem

Omdat de Azure VM Dependency Agent op kernelniveau werkt, is de ondersteuning van het besturingssysteem ook afhankelijk van de kernelversie. Vanaf afhankelijkheidsagent versie 9.10.* ondersteunt de agent * kernels. De volgende tabel bevat de primaire en secundaire versie van het Linux-besturingssysteem en ondersteunde kernelversies voor de Dependency Agent.

Notitie

Met Dependency Agent 9.10.15 en hoger wordt de installatie niet geblokkeerd voor niet-ondersteunde kernelversies, maar wordt de agent uitgevoerd in gedegradeerde modus. In deze modus worden geen verbindingsgegevens en poortgegevens verzameld die zijn opgeslagen in VMConnection- en VMBoundport-tabellen. De tabel VMProcess bevat mogelijk enkele gegevens, maar dit is minimaal.

Distributie	Besturingssysteemversie	Kernelversie
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 (bevat azure-afgestemde 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.* (bevat azure-afgestemde 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

Notitie

Afhankelijkheidsagent wordt niet ondersteund voor virtuele Azure-machines met Ampere Altra ARM-processors.

Extensieschema

In de volgende JSON ziet u het schema voor de Azure VM Dependency Agent-extensie op een Azure Linux-VM.

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

Eigenschapswaarden

Naam	Waarde/voorbeeld
apiVersion	2015-01-01
uitgever	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentLinux
typeHandlerVersion	9.5
instellingen	"enableAMA": "true"

Belangrijk

Zorg ervoor dat u aan uw sjabloon toevoegt enableAMA als u Azure Monitor Agent gebruikt. Anders probeert de afhankelijkheidsagent gegevens te verzenden naar de verouderde Log Analytics-agent.

Sjabloonimplementatie

U kunt Azure VM-extensies implementeren met Azure Resource Manager-sjablonen. U kunt het JSON-schema gebruiken dat in de vorige sectie in een Azure Resource Manager-sjabloon wordt beschreven om de Azure VM Dependency Agent-extensie uit te voeren tijdens een implementatie van een Azure Resource Manager-sjabloon.

De JSON voor een virtuele-machineextensie kan worden genest in de virtuele-machineresource. U kunt deze ook op het hoofd- of hoogste niveau van een Resource Manager JSON-sjabloon plaatsen. De plaatsing van de JSON is van invloed op de waarde van de resourcenaam en het type. Zie Naam en type instellen voor onderliggende resources voor meer informatie.

In het volgende voorbeeld wordt ervan uitgegaan dat de afhankelijkheidsagentextensie is genest in de resource van de virtuele machine. Wanneer u de extensieresource nest, wordt de JSON in het "resources": [] object van de virtuele machine geplaatst.

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

Wanneer u de extensie-JSON in de hoofdmap van de sjabloon plaatst, bevat de resourcenaam een verwijzing naar de bovenliggende virtuele machine. Het type weerspiegelt de geneste configuratie.

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

Implementatie van Azure CLI

U kunt de Azure CLI gebruiken om de VM-extensie van de afhankelijkheidsagent te implementeren op een bestaande virtuele machine.


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

Automatische extensie-upgrade

Er is nu een nieuwe functie beschikbaar om secundaire versies van de afhankelijkheidsextensie automatisch te upgraden.

Als u automatische extensie-upgrade wilt inschakelen voor een extensie, moet u ervoor zorgen dat de eigenschap enableAutomaticUpgrade is ingesteld true op en toegevoegd aan de extensiesjabloon. Deze eigenschap moet afzonderlijk worden ingeschakeld op elke VM of VM-schaalset. Gebruik een van de methoden die worden beschreven in de sectie Inschakelen van de functie voor uw VM of VM-schaalset.

Wanneer automatische extensie-upgrade is ingeschakeld op een VM of VM-schaalset, wordt de extensie automatisch bijgewerkt wanneer de uitgever van de extensie een nieuwe versie voor die extensie publiceert. De upgrade wordt veilig toegepast op basis van de principes voor beschikbaarheid en eerst, zoals hier wordt beschreven.

De enableAutomaticUpgrade functionaliteit van het kenmerk verschilt van die van de autoUpgradeMinorVersion. Het autoUpgradeMinorVersion kenmerk activeert niet automatisch een secundaire versie-update wanneer de uitgever van de extensie een nieuwe versie publiceert. Het autoUpgradeMinorVersion kenmerk geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.

Als u de extensieversie wilt bijwerken, raden we u aan bij uw extensie-implementatie te gebruiken enableAutomaticUpgrade .

Belangrijk

Als u de enableAutomaticUpgrade sjabloon toevoegt, moet u ervoor zorgen dat u bij API-versie 2019-12-01 of hoger gebruikt.

Problemen met en ondersteuning oplossen

Problemen oplossen

Gegevens over de status van extensie-implementaties kunnen worden opgehaald uit Azure Portal en met behulp van de Azure CLI. Als u de implementatiestatus van extensies voor een bepaalde VM wilt zien, voert u de volgende opdracht uit met behulp van de Azure CLI:

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

Uitvoer bij het uitvoeren van extensie wordt vastgelegd in het volgende bestand:

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

Ondersteuning

Als u op enig moment in dit artikel meer hulp nodig hebt, neemt u contact op met de Azure-experts op de Microsoft Q & A- en Stack Overflow-forums. U kunt ook een ondersteuning voor Azure incident indienen. Ga naar de ondersteuning voor Azure-site en selecteer Ondersteuning krijgen. Lees de veelgestelde vragen over Microsoft ondersteuning voor Azure voor informatie over het gebruik van Azure-ondersteuning.

Delen via