Rozszerzenie agentowe Azure Monitor dla zależności na maszynach wirtualnych w systemie Windows

2025-04-08

Funkcja mapy Azure Monitor dla maszyn wirtualnych pobiera dane z agenta Microsoft Dependency Agent. Rozszerzenie maszyny wirtualnej agenta zależności dla systemu Windows instaluje agenta zależności na maszynach wirtualnych Azure. Ten dokument zawiera szczegółowe informacje o obsługiwanych platformach, konfiguracjach i opcjach wdrażania rozszerzenia agenta zależności maszyny wirtualnej dla systemu Windows na platformie Azure.

System operacyjny

Rozszerzenie agenta zależności maszyny wirtualnej Azure dla systemu Windows można uruchomić na obsługiwanych systemach operacyjnych wymienionych w poniższej tabeli. Przyjmuje się, że wszystkie systemy operacyjne w poniższej tabeli mają wartość x64. Wersja x86 nie jest obsługiwana w żadnym systemie operacyjnym.

System operacyjny	Agent zależności maszyny wirtualnej platformy Azure
Windows Server 2025
Windows Server 2022	✓
Windows Server 2019	✓
Windows Server 2019 Core
Windows Server 2016	✓
Windows Server 2016 Core
Windows Server 2012 R2	✓
Windows Server 2012	✓
Klient i pro systemu Windows 11	✓
Windows 11 Enterprise (w tym wiele sesji)	✓
Windows 10 1803 (RS4) i nowsze	✓
Windows 10 Enterprise (w tym wiele sesji) i Pro (Tylko scenariusze serwera)	✓
Windows 8 Enterprise i Pro (Tylko scenariusze serwera)
Windows 7 z dodatkiem SP1 (Tylko scenariusze serwera)
Azure Stack HCI
Windows IoT Enterprise

Schemat rozszerzenia

Poniższy kod JSON przedstawia schemat rozszerzenia agenta zależności na maszynie wirtualnej Azure z systemem Windows.

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

Wartości właściwości

Nazwisko	Wartość/przykład
apiVersion	2015-01-01
wydawca	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
automatycznaAktualizacjaMniejszejWersji	prawda
ustawienia	"enableAMA": "true"

Ważne

Pamiętaj, aby dodać enableAMA do szablonu, jeśli używasz agenta usługi Azure Monitor. W przeciwnym razie agent zależności spróbuje wysłać dane do starszego agenta usługi Log Analytics.

Wdrażanie na podstawie szablonu

Rozszerzenia maszyn wirtualnych platformy Azure można wdrożyć przy użyciu szablonów usługi Azure Resource Manager. Możesz użyć schematu JSON opisanego w poprzedniej sekcji w szablonie usługi Azure Resource Manager, aby uruchomić rozszerzenie agenta zależności maszyny wirtualnej platformy Azure podczas wdrażania szablonu usługi Azure Resource Manager.

Kod JSON dla rozszerzenia maszyny wirtualnej można umieścić wewnątrz zasobu maszyny wirtualnej. Możesz też umieścić go na poziomie głównym lub najwyższym szablonu JSON usługi Resource Manager. Umieszczanie pliku JSON wpływa na wartość nazwy i typu zasobu. Aby uzyskać więcej informacji, przejdź do Ustaw nazwę i typ zasobów podrzędnych.

W poniższym przykładzie przyjęto założenie, że rozszerzenie agenta zależności jest zagnieżdżone wewnątrz zasobu maszyny wirtualnej. W przypadku zagnieżdżania zasobu rozszerzenia kod JSON jest umieszczany w "resources": [] obiekcie maszyny wirtualnej.

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

W przypadku umieszczenia rozszerzenia JSON w katalogu głównym szablonu nazwa zasobu zawiera odwołanie do nadrzędnej maszyny wirtualnej. Typ odzwierciedla zagnieżdżoną konfigurację.

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

Wdrażanie przy użyciu programu PowerShell

Możesz użyć polecenia Set-AzVMExtension, aby wdrożyć rozszerzenie agenta zależności na istniejącej maszynie wirtualnej. Przed uruchomieniem polecenia konfiguracje publiczne i prywatne muszą być przechowywane w tabeli skrótów programu PowerShell.

Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Settings @{"enableAMA" = "true"}

Wdrażanie programu PowerShell dla agenta usługi Azure Monitor

Jeśli używasz agenta usługi Azure Monitor, musisz użyć enableAMA ustawienia . W przeciwnym razie agent zależności próbuje wysłać dane do starszego agenta usługi Log Analytics. Na przykład:


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS `
    -Settings @{"enableAMA" = "true"}

Automatyczne uaktualnianie rozszerzenia

Dostępna jest nowa funkcja do automatycznego uaktualniania drobnych wersji rozszerzenia dotyczącego zależności.

Aby włączyć automatyczne uaktualnianie dla rozszerzenia, należy upewnić się, że właściwość enableAutomaticUpgrade jest ustawiona na true i dodana do szablonu rozszerzenia. Ta właściwość musi być włączona osobno dla każdej maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. Użyj jednej z metod opisanych w sekcji włączania , aby włączyć funkcję dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.

Gdy automatyczne uaktualnianie rozszerzenia jest włączone na maszynie wirtualnej lub zestawie skalowania maszyn wirtualnych, rozszerzenie jest uaktualniane automatycznie za każdym razem, gdy wydawca rozszerzeń wyda nową wersję dla tego rozszerzenia. Uaktualnienie jest stosowane bezpiecznie zgodnie z zasadami 'availability-first', zgodnie z opisem w tym miejscu.

Funkcjonalność atrybutu enableAutomaticUpgrade różni się od tej atrybutu autoUpgradeMinorVersion. Atrybut autoUpgradeMinorVersion nie wyzwala automatycznie aktualizacji wersji pomniejszej przy wydaniu nowej wersji przez wydawcę rozszerzenia. Atrybut autoUpgradeMinorVersion wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualnia wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

Aby zachować aktualizację wersji rozszerzenia, zalecamy użycie polecenia enableAutomaticUpgrade z wdrożeniem rozszerzenia.

Ważne

Jeśli dodasz enableAutomaticUpgrade do swojego szablonu, upewnij się, że używasz wersji API 2019-12-01 lub nowszej.

Rozwiązywanie problemów i pomoc techniczna

Rozwiązywanie problemów

Dane dotyczące stanu wdrożeń rozszerzeń można pobrać z witryny Azure Portal i przy użyciu modułu Azure PowerShell. Aby wyświetlić stan wdrażania rozszerzeń dla danej maszyny wirtualnej, uruchom następujące polecenie, używając modułu Azure PowerShell:

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

Dane wyjściowe wykonywania rozszerzenia są rejestrowane w plikach znajdujących się w następującym katalogu:

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

Wsparcie

Jeśli potrzebujesz więcej pomocy w dowolnym momencie tego artykułu, możesz skontaktować się z ekspertami platformy Azure na forach microsoft Q & A i Stack Overflow. Możesz też zgłosić zgłoszenie do pomocy technicznej Azure. Przejdź do witryny pomoc techniczna platformy Azure i wybierz pozycję Uzyskaj pomoc techniczną. Aby uzyskać informacje na temat korzystania z pomocy technicznej platformy Azure, przeczytaj FAQ dotyczące pomocy technicznej Microsoft Azure.

Udostępnij za pośrednictwem