Расширение виртуальной машины Azure Monitor Dependency для Windows

Статья
03/05/2024

Функция схемы в Azure Monitor для виртуальных машин получает данные от Microsoft Dependency Agent. Расширение виртуальной машины агента зависимостей виртуальной машины Azure для Windows устанавливает агент зависимостей на виртуальных машинах Azure. В этом документе подробно описаны поддерживаемые платформы, конфигурации и параметры развертывания для расширения виртуальной машины Azure VM Dependency Agent для Windows.

Операционная система

Расширение агента зависимостей виртуальной машины Azure для Windows можно запустить в поддерживаемых операционных системах, перечисленных в следующей таблице. Предполагается, что все операционные системы в следующей таблице имеют значение x64. Архитектура x86 не поддерживается для любой операционной системы.

Операционная система	Агент зависимостей виртуальной машины 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	✓
Клиент Windows 11 и Pro	✓¹, ²
Windows 11 Корпоративная (включая несколько сеансов)	✓
Windows 10 1803 (RS4) и более новые версии	✓¹
Windows 10 Корпоративная (в том числе с несколькими сеансами) и Профессиональная (только для сценариев с серверами)	✓
Windows 8 Корпоративная и Профессиональная (только для сценариев с серверами)
Windows 7 с пакетом обновления 1 (SP1) (только для сценариев с серверами)
Azure Stack HCI
Windows IoT Корпоративная	✓

¹ Использование клиентского установщика агента Azure Monitor.
² Также поддерживается на компьютерах на основе Arm64.

Схема расширения

В приведенном ниже коде в формате JSON показана схема для расширения Azure VM Dependency Agent на виртуальной машине Windows в 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": {
    }
}

Значения свойств

Имя.	Значение или пример
версия_API	2015-01-01
издатель	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	P-10
autoUpgradeMinorVersion	true
параметры	"enableAMA": "true"

Внимание

Не забудьте добавить enableAMA в шаблон, если вы используете агент Azure Monitor. В противном случае агент зависимостей пытается отправить данные в устаревший агент Log Analytics.

Развертывание шаблона

Вы можете развернуть расширения виртуальной машины Azure с помощью шаблонов Azure Resource Manager. Чтобы запустить расширение Azure VM Dependency Agent во время развертывания шаблона Azure Resource Manager, в нем можно использовать схему JSON, описанную в предыдущем разделе.

Код в формате JSON для расширения виртуальной машины можно вложить в ресурс виртуальной машины. Вы также можете поместить его на корневом или верхнем уровне шаблона JSON Resource Manager. Размещение JSON влияет на значения имени и типа ресурса. Дополнительные сведения см. в разделе Указание имени и типа дочернего ресурса в шаблоне Resource Manager.

В примере ниже предполагается, что расширение Dependency Agent вложено в ресурс виртуальной машины. При вложении ресурса расширения JSON помещается в объект "resources": [] виртуальной машины.

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

При размещении JSON расширения в корне шаблона имя ресурса содержит ссылку на родительскую виртуальную машину. Тип отражает вложенную конфигурацию.

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

Развертывание с помощью PowerShell

Чтобы развернуть расширение виртуальной машины Dependency Agent на существующей виртуальной машине, выполните команду Set-AzVMExtension. Перед выполнением команды необходимо сохранить открытые и закрытые конфигурации в хэш-таблице PowerShell.


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

Автоматическое обновление расширений

Доступна новая возможность автоматического обновления дополнительных версий расширения Dependency.

Чтобы разрешить автоматическое обновление расширений для расширения, необходимо задать для свойства enableAutomaticUpgrade значение true и добавить его в шаблон расширения. Это свойство включается по отдельности на каждой виртуальной машине или в масштабируемом наборе виртуальных машин. С помощью одного из способов, описанных в разделе Включение, включите эту функцию для своей виртуальной машины или масштабируемого набора виртуальных машин.

Если на виртуальной машине или в масштабируемом наборе виртуальных машин включено автоматическое обновление расширений, расширение обновляется автоматически каждый раз, когда издатель расширения выпускает новую версию такого расширения. Обновление безопасно применяется по мере доступности, как описано здесь.

Функциональные возможности атрибута enableAutomaticUpgrade отличаются от функциональных возможностей autoUpgradeMinorVersion. Атрибут autoUpgradeMinorVersion не запускает дополнительное обновление версии при выпуске новой версии издателем расширения автоматически. Атрибут autoUpgradeMinorVersion указывает, должно ли расширение использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не обновит дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true.

Для постоянного обновления версии расширения рекомендуем использовать в развертывании атрибут enableAutomaticUpgrade.

Внимание

Если вы добавили в шаблон параметр enableAutomaticUpgrade, убедитесь, что используется API версии не ниже 2019-12-01.

Устранение неполадок и поддержка

Устранение неполадок

Данные о состоянии развертывания расширения можно получить на портале Azure, а также с помощью модуля Azure PowerShell. Чтобы просмотреть состояние развертывания расширений для определенной виртуальной машины, выполните следующую команду в модуле Azure PowerShell:

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

Выходные данные выполнения расширения регистрируются в файле, расположенном в следующем каталоге:

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

Поддержка

Если вам нужна дополнительная помощь в любой момент этой статьи, вы можете обратиться к экспертам Azure на форумах Microsoft Q и A и Stack Overflow. Также можно зарегистрировать обращение в службу поддержки Azure. Перейдите на сайт поддержки Azure и щелкните Получить поддержку. Дополнительные сведения об использовании службы поддержки Azure см. в статье Часто задаваемые вопросы о поддержке Azure.