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

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

Необходимые компоненты

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

Так как агент зависимостей виртуальной машины Azure работает на уровне ядра, поддержка операционной системы также зависит от версии ядра. Начиная с версии Dependency Agent 9.10 * агент поддерживает ядра *. В следующей таблице перечислены основные и дополнительные версии ОС Linux и поддерживаемые версии ядра для агента зависимостей.

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

В приведенном ниже коде в формате JSON показана схема для расширения Azure VM Dependency Agent на виртуальной машине Linux в 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 Linux Azure VM."
      }
    }
  },
  "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": "DependencyAgentLinux",
          "typeHandlerVersion": "9.5",
          "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "enableAMA": "true"
        }
	}
}

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

Развернуть расширение виртуальной машины Dependency Agent на существующей виртуальной машине можно с помощью Azure CLI.

az vm extension set \
    --resource-group myResourceGroup \
    --vm-name myVM \
    --name DependencyAgentLinux \
    --publisher Microsoft.Azure.Monitoring.DependencyAgent \
    --version 9.5

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

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

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

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

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

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

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

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

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

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

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

/var/opt/microsoft/dependency-agent/log/install.log

Поддержка

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