Rozšíření virtuálního počítače agenta závislostí Azure Monitoru pro Linux

Článek
08/25/2024

Funkce Azure Monitor pro virtuální počítače Map získá data z agenta Microsoft Dependency Agent. Rozšíření virtuálního počítače závislého agenta virtuálního počítače virtuálního počítače azure pro Linux nainstaluje agenta závislostí na virtuální počítače Azure. Tento dokument podrobně popisuje podporované platformy, konfigurace a možnosti nasazení pro rozšíření virtuálního počítače azure VM Dependency Agent pro Linux.

Požadavky

Operační systém

Vzhledem k tomu, že agent závislostí virtuálního počítače Azure funguje na úrovni jádra, podpora operačního systému závisí také na verzi jádra. Od verze 9.10.* agent podporuje * jádra. Následující tabulka uvádí hlavní a vedlejší verzi operačního systému Linux a podporované verze jádra pro agenta závislostí.

Poznámka:

U agenta Dependency Agent 9.10.15 a novějšího není instalace blokována pro nepodporované verze jádra, ale agent se spustí v degradovaném režimu. V tomto režimu se neshromažďují data připojení a portu uložená v tabulkách VMConnection a VMBoundport. Tabulka VMProcess může obsahovat nějaká data, ale bude minimální.

Distribuce	Verze operačního systému	Verze jádra
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 (zahrnuje jádro vyladěné v Azure) 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.* (zahrnuje jádro vyladěné v Azure)
	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

Poznámka:

Agent závislostí se nepodporuje pro virtuální počítače Azure s procesory založenými na Arm Ampere Altra.

Schéma rozšíření

Následující json ukazuje schéma rozšíření agenta závislostí virtuálního počítače Azure na virtuálním počítači Azure s Linuxem.

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

Hodnoty vlastností

Název	Hodnota/příklad
apiVersion	2015-01-01
vydavatel	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentLinux
typeHandlerVersion	9.5
settings	"enableAMA": "true"

Důležité

Pokud používáte agenta služby Azure Monitor, nezapomeňte do šablony přidat enableAMA . Jinak se agent závislostí pokusí odesílat data do starší verze agenta Log Analytics.

Nasazení šablon

Rozšíření virtuálních počítačů Azure můžete nasadit pomocí šablon Azure Resource Manageru. Schéma JSON podrobně popsané v předchozí části šablony Azure Resource Manageru můžete použít ke spuštění rozšíření agenta závislostí virtuálního počítače Azure během nasazení šablony Azure Resource Manageru.

Json pro rozšíření virtuálního počítače je možné vnořit do prostředku virtuálního počítače. Nebo ho můžete umístit na kořenovou nebo nejvyšší úroveň šablony JSON Resource Manageru. Umístění JSON má vliv na hodnotu názvu a typu prostředku. Další informace naleznete v tématu Nastavení názvu a typu pro podřízené prostředky.

Následující příklad předpokládá, že rozšíření agenta závislostí je vnořené uvnitř prostředku virtuálního počítače. Při vnoření prostředku rozšíření se JSON umístí do "resources": [] objektu virtuálního počítače.

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

Když umístíte json rozšíření do kořenového adresáře šablony, název prostředku obsahuje odkaz na nadřazený virtuální počítač. Typ odráží vnořenou konfiguraci.

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

Nasazení v Azure CLI

Pomocí Azure CLI můžete nasadit rozšíření virtuálního počítače závislého agenta do existujícího virtuálního počítače.


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

Automatický upgrade rozšíření

Nyní je k dispozici nová funkce pro automatický upgrade podverzí rozšíření Dependency.

Chcete-li povolit automatický upgrade rozšíření pro rozšíření, je nutné zajistit, aby byla vlastnost enableAutomaticUpgrade nastavena true a přidána do šablony rozšíření. Tato vlastnost musí být povolená na každém virtuálním počítači nebo škálovací sadě virtuálních počítačů jednotlivě. Použijte jednu z metod popsaných v části povolení , která umožňuje funkci pro virtuální počítač nebo škálovací sadu virtuálních počítačů.

Pokud je na virtuálním počítači nebo škálovací sadě virtuálních počítačů povolen automatický upgrade rozšíření, upgraduje se toto rozšíření automaticky pokaždé, když vydavatel rozšíření vydá novou verzi pro toto rozšíření. Upgrade se používá bezpečně podle zásad první dostupnosti, jak je popsáno zde.

Funkce enableAutomaticUpgrade atributu se liší od funkce atributu autoUpgradeMinorVersion. Atribut autoUpgradeMinorVersion automaticky neaktivuje aktualizaci podverze, když vydavatel rozšíření vydá novou verzi. Atribut autoUpgradeMinorVersion označuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení ale rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.

Pokud chcete, aby se vaše verze rozšíření aktualizovala, doporučujeme použít enableAutomaticUpgrade s nasazením rozšíření.

Důležité

Pokud šablonu přidáte enableAutomaticUpgrade , ujistěte se, že používáte rozhraní API verze 2019-12-01 nebo vyšší.

Řešení potíží a podpora

Odstraňování potíží

Data o stavu nasazení rozšíření je možné načíst z webu Azure Portal a pomocí Azure CLI. Pokud chcete zobrazit stav nasazení rozšíření pro daný virtuální počítač, spusťte pomocí Azure CLI následující příkaz:

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

Výstup spuštění rozšíření se zaznamená do následujícího souboru:

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

Technická podpora

Pokud potřebujete další pomoc v libovolném bodě tohoto článku, obraťte se na odborníky na Azure na fórech Microsoft Q &a Stack Overflow. Nebo můžete podat podpora Azure incident. Přejděte na web podpora Azure a vyberte Získat podporu. Informace o tom, jak používat podporu Azure, najdete v nejčastějších dotazech k Microsoftu podpora Azure.

Sdílet prostřednictvím