Azure Monitor Dependency-VM-Erweiterung für Linux

Das Zuordnungsfeature in Azure Monitor für VMs erhält seine Daten vom Microsoft Dependency-Agent. Die Azure-VM-Dependency-Agent-Erweiterung für Linux installiert den Dependency-Agent auf virtuellen Azure-Computern. Dieses Dokument enthält ausführliche Informationen zu den unterstützten Plattformen, Konfigurationen und Bereitstellungsoptionen für die Azure Dependency-Agent-VM-Erweiterung für Linux.

Voraussetzungen

Betriebssystem

Da der Azure-VM Dependency-Agent auf der Kernelebene arbeitet, ist die Unterstützung des Betriebssystems auch von der Kernelversion abhängig. Ab Version 9.10.* unterstützt der Dependency-Agent * Kernels. In der folgenden Tabelle sind die Haupt- und Nebenversionen des Linux-Betriebssystems sowie die unterstützten Kernelversionen für den Dependency-Agent aufgeführt:

Hinweis

Mit Dependency Agent 9.10.15 und höher wird die Installation nicht für nicht unterstützte Kernelversionen blockiert, aber der Agent wird im heruntergestuften Modus ausgeführt. In diesem Modus werden die in VMConnection- und VMBoundport-Tabellen gespeicherten Verbindungs- und Portdaten nicht erfasst. Die VMProcess-Tabelle enthält möglicherweise einige Daten, jedoch nur in minimalem Umfang.

Distribution	Betriebssystemversion	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 (enthält optimierten Azure-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.* (enthält optimierten Azure-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

Hinweis

Der Dependency-Agent wird für Azure Virtual Machines mit Ampere Altra ARM-basierten Prozessoren nicht unterstützt.

Erweiterungsschema

Das folgende JSON zeigt das Schema für die Azure VM Dependency-Agent-Erweiterung auf einem virtuellen Azure Linux-Computer.

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

Eigenschaftswerte

Name	Beispiel/Wert
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
Type	DependencyAgentLinux
typeHandlerVersion	9.5
Einstellungen	"enableAMA": "true"

Wichtig

Fügen Sie Ihrer Vorlage unbedingt enableAMA hinzu, wenn Sie den Azure Monitor-Agent verwenden. Andernfalls versucht der Dependency-Agent, Daten an den veralteten Log Analytics-Agent zu senden.

Bereitstellung von Vorlagen

Sie können Azure-VM-Erweiterungen mithilfe von Azure Resource Manager-Vorlagen bereitstellen. Sie können das im vorherigen Abschnitt erläuterte JSON-Schema in einer Azure Resource Manager-Vorlage verwenden, um die Azure VM Dependency-Agent-Erweiterung im Rahmen einer Azure Resource Manager-Bereitstellung auszuführen.

Der JSON-Code für eine VM-Erweiterung kann innerhalb der VM-Ressource geschachtelt werden. Alternativ können Sie den Code auf der Stamm- bzw. obersten Ebene einer Resource Manager-JSON-Vorlage platzieren. Die Platzierung des JSON-Codes wirkt sich auf den Wert von Name und Typ der Ressource aus. Weitere Informationen finden Sie unter Set name and type for child resources (Festlegen von Name und Typ für untergeordnete Ressourcen).

Im folgenden Beispiel wird davon ausgegangen, dass die Dependency-Agent-Erweiterung in der VM-Ressource geschachtelt ist. Wenn Sie die Erweiterungsressource schachteln, wird der JSON-Code im "resources": []-Objekt des virtuellen Computers platziert.

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

Wenn Sie den JSON-Code für die Erweiterung auf der Stammebene der Vorlage platzieren, enthält der Ressourcenname einen Verweis auf den übergeordneten virtuellen Computer. Der Typ spiegelt die geschachtelte Konfiguration wider.

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

Bereitstellung mithilfe der Azure-Befehlszeilenschnittstelle

Sie können die Dependency-Agent-VM-Erweiterung mithilfe der Azure CLI auf einem vorhandenen virtuellen Computer bereitstellen.

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

Automatisches Erweiterungsupgrade

Ein neues Feature für automatische Upgrades für Nebenversionen der Dependency-Erweiterung ist jetzt verfügbar.

Sie müssen sicherstellen, dass die Eigenschaft enableAutomaticUpgrade auf true festgelegt ist und der Erweiterungsvorlage hinzugefügt wird, um automatische Erweiterungsupgrades für eine Erweiterung zu aktivieren. Diese Eigenschaft muss für jede VM oder VM-Skalierungsgruppe einzeln aktiviert werden. Verwenden Sie eine der im Abschnitt Aktivieren des automatischen Erweiterungsupgrades beschriebenen Methoden, um das Feature für Ihre VM oder VM-Skalierungsgruppe zu aktivieren.

Wenn das automatische Erweiterungsupgrade für eine VM oder VM-Skalierungsgruppe aktiviert ist, wird für die Erweiterung automatisch ein Upgrade ausgeführt, sobald der Erweiterungsherausgeber eine neue Version für diese Erweiterung freigibt. Das Upgrade wird wie hier beschrieben gemäß den verfügbarkeitsbasierten Prinzipien sicher angewendet.

Die Funktionalität des enableAutomaticUpgrade-Attributs unterscheidet sich von jener des autoUpgradeMinorVersion-Attributs. Das autoUpgradeMinorVersion-Attribut löst nicht automatisch eine Aktualisierung der Nebenversion aus, wenn der Herausgeber der Erweiterung eine neue Version veröffentlicht. Das autoUpgradeMinorVersion-Attribut gibt an, ob die Erweiterung eine neuere Nebenversion verwenden sollte, falls zum Bereitstellungszeitpunkt eine verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf true festgelegt ist.

Es wird empfohlen, enableAutomaticUpgrade für Ihre Erweiterungsbereitstellung zu verwenden, damit Ihre Erweiterungsversion aktualisiert wird.

Wichtig

Wenn Sie Ihrer Vorlage enableAutomaticUpgrade hinzufügen, stellen Sie sicher, dass Sie die API-Version 2019-12-01 oder höher verwenden.

Problembehandlung und Support

Problembehandlung

Daten zum Status von Erweiterungsbereitstellungen können über das Azure-Portal und mithilfe der Azure-Befehlszeilenschnittstelle abgerufen werden. Führen Sie über die Azure-Befehlszeilenschnittstelle den folgenden Befehl aus, um den Bereitstellungsstatus von Erweiterungen für einen bestimmten virtuellen Computer anzuzeigen:

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

Die Ausgabe der Erweiterungsausführung wird in der folgenden Datei protokolliert:

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

Unterstützung

Sollten Sie beim Lesen dieses Artikels feststellen, dass Sie weitere Hilfe benötigen, setzen Sie sich über das Microsoft Q&A-Forum oder das Stack Overflow-Forum mit Azure-Expert*innen in Verbindung. Sie können auch einen Azure-Supportfall erstellen. Rufen Sie die Azure-Support-Website auf, und wählen Sie Support erhaltenaus. Informationen darüber, wie Azure-Support genutzt werden kann, finden Sie unter Häufig gestellte Fragen zum Azure-Support.