Azure Monitor függőségi virtuális gépi bővítmény Windowshoz

Cikk
03/05/2024

Az Azure Monitor for VMs Map szolgáltatás a Microsoft Függőségi ügynöktől szerzi be az adatait. A Windows azure-beli virtuálisgép-függőségi ügynök virtuálisgép-bővítménye telepíti a függőségi ügynököt az Azure-beli virtuális gépekre. Ez a dokumentum a Windows Azure VM Dependency Agent virtuálisgép-bővítményének támogatott platformjait, konfigurációit és üzembehelyezési lehetőségeit ismerteti.

Operációs rendszer

A Windows azure-beli virtuálisgép-függőségi ügynök bővítménye az alábbi táblázatban felsorolt támogatott operációs rendszereken futtatható. Az alábbi táblázatban szereplő összes operációs rendszer x64-nek minősül. Az x86 nem támogatott semmilyen operációs rendszer esetén.

Operációs rendszer	Azure-beli virtuálisgép-függőségi ügynök
Windows Server 2022	✓
Windows Server 2022 Core	✓
Windows Server 2019	✓
Windows Server 2019 Core	✓
Windows Server 2016	✓
Windows Server 2016 Core	✓
Windows Server 2012 R2	✓
Windows Server 2012	✓
Windows 11-ügyfél és Pro	^✓1, ²
Windows 11 Enterprise (beleértve a több munkamenetet is)	✓
Windows 10 1803 (RS4) és újabb	^✓1
Windows 10 Enterprise (beleértve a több munkamenetet) és a Pro-t (Csak kiszolgálói forgatókönyvek)	✓
Windows 8 Enterprise és Pro (Csak kiszolgálói forgatókönyvek)
Windows 7 SP1 (Csak kiszolgálói forgatókönyvek)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Az Azure Monitor-ügynök ügyfél-telepítőjének használata.
² Arm64-alapú gépeken is támogatott.

Bővítményséma

Az alábbi JSON az Azure-beli virtuális gép függőségi ügynök bővítményének sémáját mutatja be egy Azure Windows rendszerű virtuális gépen.

{
  "$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 Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "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": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

Tulajdonságértékek

Név	Érték/Példa
apiVersion	2015-01-01
Publisher	Microsoft.Azure.Monitoring.DependencyAgent
típus	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
beállítások	"enableAMA": "true"

Fontos

Az Azure Monitor-ügynök használata esetén mindenképpen vegye fel enableAMA a sablont; ellenkező esetben a függőségi ügynök adatokat próbál küldeni az örökölt Log Analytics-ügynöknek.

Sablonalapú telepítés

Az Azure-beli virtuálisgép-bővítményeket Azure Resource Manager-sablonokkal helyezheti üzembe. Az Azure Resource Manager-sablon előző szakaszában részletezett JSON-sémával futtathatja az Azure-beli virtuálisgép-függőségi ügynök bővítményt egy Azure Resource Manager-sablon üzembe helyezése során.

A virtuálisgép-bővítmény JSON-fájlja beágyazható a virtuálisgép-erőforrásba. A Resource Manager JSON-sablon legfelső vagy legfelső szintjén is elhelyezheti. A JSON elhelyezése hatással van az erőforrás nevének és típusának értékére. További információ: A gyermekerőforrások nevének és típusának beállítása.

Az alábbi példa feltételezi, hogy a Függőségi ügynök bővítmény beágyazva van a virtuálisgép-erőforrásba. A bővítményerőforrás beágyazásakor a JSON a "resources": [] virtuális gép objektumába kerül.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

Amikor a JSON bővítményt a sablon gyökerénél helyezi el, az erőforrás neve hivatkozik a szülő virtuális gépre. A típus a beágyazott konfigurációt tükrözi.

{
	"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": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

A PowerShell telepítése

A parancs használatával Set-AzVMExtension üzembe helyezheti a Függőségi ügynök virtuálisgép-bővítményt egy meglévő virtuális gépen. A parancs futtatása előtt a nyilvános és a privát konfigurációkat PowerShell-kivonattáblában kell tárolni.


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

Automatikus bővítményfrissítés

A Függőség bővítmény alverzióinak automatikus frissítését lehetővé tévő új funkció már elérhető.

Ha engedélyezni szeretné egy bővítmény automatikus bővítményfrissítését, győződjön meg arról, hogy true a tulajdonság enableAutomaticUpgrade be van állítva, és hozzá kell adni a bővítménysablonhoz. Ezt a tulajdonságot minden egyes virtuálisgép- vagy virtuálisgép-méretezési csoportban engedélyezni kell. Az engedélyezés szakaszban ismertetett módszerek egyikével engedélyezheti a funkciót a virtuális gép vagy a virtuálisgép-méretezési csoport számára.

Ha egy virtuális gép vagy virtuálisgép-méretezési csoport automatikus bővítményfrissítése engedélyezve van, a bővítmény automatikusan frissül, amikor a bővítmény közzétevője új verziót ad ki a bővítményhez. A frissítés biztonságosan, az itt ismertetett rendelkezésre állási alapelveket követve lesz alkalmazva.

Az enableAutomaticUpgrade attribútum működése eltér a autoUpgradeMinorVersion. Az autoUpgradeMinorVersion attribútum nem aktiválja automatikusan az alverzió frissítését, amikor a bővítmény közzétevője új verziót ad ki. Az autoUpgradeMinorVersion attribútum azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.

A bővítményverzió frissítésének fenntartása érdekében javasoljuk, hogy használja enableAutomaticUpgrade a bővítmény üzembe helyezését.

Fontos

Ha hozzáadja a enableAutomaticUpgrade sablont, győződjön meg arról, hogy az API 2019-12-01-es vagy újabb verziójában használja.

Hibaelhárítás és támogatás

Hibaelhárítás

A bővítménytelepítések állapotával kapcsolatos adatok az Azure Portalról és az Azure PowerShell-modul használatával kérhetők le. Egy adott virtuális gép bővítményei üzembehelyezési állapotának megtekintéséhez futtassa a következő parancsot az Azure PowerShell-modullal:

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

A bővítmény végrehajtásának kimenetét az alábbi könyvtárban található fájlokba naplózza a rendszer:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

Támogatás

Ha a cikk bármely pontján további segítségre van szüksége, forduljon az Azure szakértőihez a Microsoft Q &A és a Stack Overflow fórumain. Vagy Azure-támogatás incidenst is beszedhet. Lépjen a Azure-támogatás webhelyre, és válassza a Támogatás kérése lehetőséget. Az Azure-támogatás használatáról további információt a Microsoft Azure-támogatás gyakori kérdésekben talál.