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

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

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

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

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

В приведенном ниже коде в формате 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": {
    }
}

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

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

Вы можете развернуть расширения виртуальной машины 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 `
    -Settings @{"enableAMA" = "true"}

Развертывание PowerShell для агента Azure Monitor

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

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

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

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

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

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

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

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

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

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

Данные о состоянии развертывания расширения можно получить на портале 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.