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

  • Статья

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

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

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

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

Примечание.

При использовании агента зависимостей 9.10.15 и выше установка не блокируется для неподдерживаемых версий ядра, но агент будет работать в режиме снижения уровня. В этом режиме данные подключения и порта, хранящиеся в виртуальных машинах Подключение ion и V МБ oundport, не собираются. Таблица VMProcess может иметь некоторые данные, но она будет минимальной.

Распределение Версия ОС Версия ядра
Red Hat Linux 8 8,6 4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
8,5 4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
8.4 4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
8.3 4.18.0-240.*el8_3.x86_64
8.2 4.18.0-193.*el8_2.x86_64
8.1 4.18.0-147.*el8_1.x86_64
8.0 4.18.0-80.*el8.x86_64
4.18.0-80.*el8_0.x86_64
Red Hat Linux 7 7.9 3.10.0-1160
7.8 3.10.0-1136
7.7 3.10.0-1062
7.6 3.10.0-957
7.5 3.10.0-862
7,4 3.10.0-693
Red Hat Linux 6 6,10 2.6.32-754
6.9 2.6.32-696
CentOS Linux 8 8,6 4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
8,5 4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
8.4 4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
8.3 4.18.0-240.*el8_3.x86_64
8.2 4.18.0-193.*el8_2.x86_64
8.1 4.18.0-147.*el8_1.x86_64
8.0 4.18.0-80.*el8.x86_64
4.18.0-80.*el8_0.x86_64
CentOS Linux 7 7.9 3.10.0-1160
7.8 3.10.0-1136
7.7 3.10.0-1062
CentOS Linux 6 6,10 2.6.32-754.3.5
2.6.32-696.30.1
6.9 2.6.32-696.30.1
2.6.32-696.18.7
Сервер Ubuntu 20.04 5.8
5.4*
18,04 5.3.0-1020
5.0 (включает ядро, настроенное Azure)
4.18*
4.15*
16.04.3 4.15.*
16.04 4.13.*
4.11.*
4.10.*
4.8.*
4.4.*
14.04 3.13.*-generic
4.4.*-generic
SUSE Linux 12 Enterprise Server 12 с пакетом обновления (SP5) 4.12.14-122.*-default, 4.12.14-16.*-azure
12 SP4 4.12* (включает ядро, настроенное Azure)
12 с пакетом обновления 3 4.4.*
12 с пакетом обновления 2 4.4.*
SUSE Linux 15 Enterprise Server 15 с пакетом обновления 1 (SP1) 4.12.14-197.*-default, 4.12.14-8.*-azure
15 4.12.14-150 (по умолчанию)
Debian 9 4,9

Примечание.

Агент зависимостей не поддерживается для Виртуальных машин Microsoft Azure с процессорами Ampere Altra на основе ARM.

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

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

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

Имя. Значение или пример
версия_API 2015-01-01
издатель Microsoft.Azure.Monitoring.DependencyAgent
type DependencyAgentLinux
typeHandlerVersion 9,5
параметры "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": "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.

Внимание

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

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

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

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