Rozszerzenie maszyny wirtualnej zależności usługi Azure Monitor dla systemu Windows

Artykuł
03/05/2024

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

System operacyjny

Rozszerzenie agenta zależności maszyny wirtualnej platformy Azure dla systemu Windows można uruchomić względem obsługiwanych systemów 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 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	✓
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	✓

¹ Za pomocą instalatora klienta agenta usługi Azure Monitor.
² Obsługiwane również na maszynach opartych na architekturze Arm64.

Schemat rozszerzenia

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

{
  "$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
autoUpgradeMinorVersion	prawda
ustawienia	"enableAMA": "true"

Ważne

Pamiętaj, aby dodać enableAMA go do szablonu, jeśli używasz agenta usługi Azure Monitor. W przeciwnym razie agent zależności pró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 rozszerzenia maszyny wirtualnej można zagnieżdżać 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, zobacz Ustawianie nazwy i typu dla 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 konfigurację zagnieżdżonych.

{
	"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ć Set-AzVMExtension polecenia , aby wdrożyć rozszerzenie maszyny wirtualnej 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 `
    -Location WestUS

Automatyczne uaktualnianie rozszerzenia

Dostępna jest nowa funkcja umożliwiająca automatyczne uaktualnianie wersji pomocniczych rozszerzenia Zależności.

Aby włączyć automatyczne uaktualnianie rozszerzenia dla rozszerzenia, należy upewnić się, że właściwość enableAutomaticUpgrade jest ustawiona true na 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 dotyczącymi pierwszej dostępności, zgodnie z opisem w tym miejscu.

Funkcjonalność enableAutomaticUpgrade atrybutu różni się od autoUpgradeMinorVersionfunkcji . Atrybut autoUpgradeMinorVersion nie wyzwala automatycznie aktualizacji wersji pomocniczej, gdy wydawca rozszerzenia wyda nową wersję. 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 element do szablonu, upewnij się, że używasz go w interfejsie API w wersji 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\

Pomoc techniczna

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ć zdarzenie pomoc techniczna platformy 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, zapoznaj się z często zadawanymi pytaniami dotyczącymi platformy Microsoft pomoc techniczna platformy Azure.

Share via