Расширение виртуальной машины Log Analytics для Linux
Обзор
Журналы Azure Monitor предоставляют возможности мониторинга, оповещений и внесения исправлений в соответствии с оповещениями для облачных и локальных ресурсов. Расширение виртуальной машины Log Analytics для Linux предоставляет и поддерживает корпорация Майкрософт. Это расширение устанавливает агент Log Analytics на виртуальных машинах Azure и регистрирует виртуальные машины в существующей рабочей области Log Analytics. В этом документе подробно описаны поддерживаемые платформы, конфигурации и параметры развертывания для расширения виртуальной машины Log Analytics для Linux.
Примечание.
Серверы с поддержкой Azure Arc позволяют развертывать, удалять и обновлять расширения виртуальной машины агента Log Analytics на виртуальных машинах Windows и Linux, не относящихся к Azure, что упрощает управление гибридным компьютером на протяжении всего его жизненного цикла. Дополнительные сведения см. в документе Управление расширениями виртуальных машин с помощью серверов с поддержкой Azure Arc.
Необходимые компоненты
Операционная система
Дополнительные сведения о поддерживаемых дистрибутивах Linux см. в статье Обзор агентов Azure Monitor.
Версия агента и расширения виртуальной машины
Приведенная ниже таблица содержит сопоставление версий расширения виртуальной машины Log Analytics и пакетов агента Log Analytics для каждого выпуска. В ней также указана ссылка на заметки о выпуске для версии пакета агента Log Analytics. Заметки о выпуске содержат сведения об исправлениях ошибок и новых функциях, доступных в данном выпуске агента.
| Версия расширения виртуальной машины Log Analytics для Linux | Версия пакета агента Log Analytics |
|---|---|
| 1.19.0 | 1.19.0 |
| 1.18.1 | 1.18.1 |
| 1.17.1 | 1.17.1 |
| 1.16.0 | 1.16.0 |
| 1.14.19 | 1.14.19 |
| 1.14.16 | 1.14.16 |
| 1.14.13 | 1.14.13 |
| 1.14.11 | 1.14.11 |
| 1.14.9 | 1.14.9 |
| 1.13.40 | 1.13.40 |
| 1.13.35 | 1.13.35 |
| 1.13.33 | 1.13.33 |
| 1.13.27 | 1.13.27 |
| 1.13.15 | 1.13.9-0 |
| 1.12.25 | 1.12.15-0 |
| 1.11.15 | 1.11.0-9 |
| 1.10.0 | 1.10.0-1 |
| 1.9.1 | 1.9.0-0 |
| 1.8.11 | 1.8.1-256 |
| 1.8.0 | 1.8.0-256 |
| 1.7.9 | 1.6.1–3 |
| 1.6.42.0 | 1.6.0–42 |
| 1.4.60.2 | 1.4.4-210 |
| 1.4.59.1 | 1.4.3–174 |
| 1.4.58.7 | 14.2–125 |
| 1.4.56.5 | 1.4.2–124 |
| 1.4.55.4 | 1.4.1–123 |
| 1.4.45.3 | 1.4.1–45 |
| 1.4.45.2 | 1.4.0-45 |
| 1.3.127.5 | 1.3.5-127 |
| 1.3.127.7 | 1.3.5-127 |
| 1.3.18.7 | 1.3.4-15 |
Microsoft Defender для облака
Microsoft Defender для облака автоматически подготавливает агент Log Analytics и подключает его к рабочей области Log Analytics по умолчанию, созданной Defender для облака в подписке Azure. Если вы используете Microsoft Defender для облака, не выполняйте действия, описанные в этом документе. Это приведет к перезаписи настроенной рабочей области и разрыву подключения с Microsoft Defender для облака.
Подключение к Интернету
Для расширения агента Log Analytics для Linux требуется, чтобы целевая виртуальная машина была подключена к Интернету.
Схема расширения
В следующем объекте JSON показана схема для расширения агента Log Analytics. Расширение требует идентификатор и ключ целевой рабочей области Log Analytics, которые можно найти в рабочей области Log Analytics на портале Azure. Так как ключ рабочей области должен рассматриваться в качестве конфиденциальных данных, его следует хранить в защищенной конфигурации параметров. Данные защищенных параметров расширения виртуальной машины Azure зашифрованы. Они расшифровываются только на целевой виртуальной машине. Обратите внимание, что в workspaceId и workspaceKey учитывается регистр знаков.
Примечание.
Так как поддержка решения для мониторинга контейнеров прекращается, в следующей документации используется необязательный параметр skipDockerProviderInstall: true.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"name": "OMSExtension",
"apiVersion": "2018-06-01",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
],
"properties": {
"publisher": "Microsoft.EnterpriseCloud.Monitoring",
"type": "OmsAgentForLinux",
"typeHandlerVersion": "1.16",
"autoUpgradeMinorVersion": true,
"settings": {
"workspaceId": "myWorkspaceId",
"skipDockerProviderInstall": true
},
"protectedSettings": {
"workspaceKey": "myWorkSpaceKey"
}
}
}
Примечание.
В приведенной выше схеме предполагается, что он будет размещен на корневом уровне шаблона. Если поместить его в ресурс виртуальной машины в шаблоне, свойства type и name следует изменить, как это описано далее.
Значения свойств
| Имя. | Значение и пример |
|---|---|
| версия_API | 2018-06-01 |
| издатель | Microsoft.EnterpriseCloud.Monitoring |
| type | OmsAgentForLinux |
| typeHandlerVersion | 1,16 |
| workspaceID (пример) | 6f680a37-00c6-41c7-a93f-1437e3462574 |
| workspaceKey (пример) | z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ== |
Развертывание шаблона
Примечание.
Некоторые компоненты расширения для виртуальной машины Log Analytics также поставляются в расширении виртуальной машины для диагностики. Из-за этой архитектуры могут возникать конфликты, если экземпляры обоих расширений создаются в одном и том же шаблоне ARM. Чтобы избежать таких конфликтов во время установки, с помощью директивы dependsOn обеспечьте последовательную установку расширений. Расширения можно устанавливать в любом порядке.
Расширения виртуальной машины Azure можно развернуть с помощью шаблонов Azure Resource Manager. Шаблоны идеально подходят для развертывания одной или нескольких виртуальных машин, требующих настройки после развертывания, например подключения к журналам Azure Monitor. Пример шаблона Resource Manager, включающего расширение виртуальной машины агента Log Analytics, можно найти в коллекции быстрого запуска Azure.
Конфигурацию JSON для расширения виртуальной машины можно вложить в ресурс виртуальной машины или поместить в корень или на верхний уровень JSON-файла шаблона Resource Manager. Размещение конфигурации JSON влияет на значения имени и типа ресурса. Дополнительные сведения см. в разделе Указание имени и типа дочернего ресурса в шаблоне Resource Manager.
В следующем примере предполагается, что расширение виртуальной машины вложено в ресурс виртуальной машины. При вложении ресурса расширения JSON помещается в объект "resources": [] виртуальной машины.
{
"type": "extensions",
"name": "OMSExtension",
"apiVersion": "2018-06-01",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
],
"properties": {
"publisher": "Microsoft.EnterpriseCloud.Monitoring",
"type": "OmsAgentForLinux",
"typeHandlerVersion": "1.16",
"settings": {
"workspaceId": "myWorkspaceId",
"skipDockerProviderInstall": true
},
"protectedSettings": {
"workspaceKey": "myWorkSpaceKey"
}
}
}
При размещении JSON расширения в корне шаблона имя ресурса содержит ссылку на родительскую виртуальную машину, а тип отражает вложенную конфигурацию.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"name": "<parentVmResource>/OMSExtension",
"apiVersion": "2018-06-01",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
],
"properties": {
"publisher": "Microsoft.EnterpriseCloud.Monitoring",
"type": "OmsAgentForLinux",
"typeHandlerVersion": "1.16",
"settings": {
"workspaceId": "myWorkspaceId",
"skipDockerProviderInstall": true
},
"protectedSettings": {
"workspaceKey": "myWorkSpaceKey"
}
}
}
Развертывание с помощью Azure CLI
Azure CLI можно использовать для развертывания расширения виртуальной машины агента Log Analytics на существующей виртуальной машине. Замените myWorkspaceKey ниже значением ключа вашей рабочей области, а значение myWorkspaceId — идентификатором вашей рабочей области. Эти значения можно найти в рабочей области Log Analytics на портал Azure в разделе Дополнительные параметры. Замените значение latestVersion версией расширения виртуальной машины Log Analytics для Linux.
az vm extension set \
--resource-group myResourceGroup \
--vm-name myVM \
--name OmsAgentForLinux \
--publisher Microsoft.EnterpriseCloud.Monitoring \
--protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
--settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
--version latestVersion
Развертывание с помощью Azure PowerShell
Командлеты Azure Powershell можно использовать для развертывания расширения виртуальной машины агента Log Analytics на имеющейся виртуальной машине. Замените myWorkspaceKey ниже значением ключа вашей рабочей области, а значение myWorkspaceId — идентификатором вашей рабочей области. Эти значения можно найти в рабочей области Log Analytics на портал Azure в разделе Дополнительные параметры. Замените значение latestVersion версией расширения виртуальной машины Log Analytics для Linux.
Set-AzVMExtension \
-ResourceGroupName myResourceGroup \
-VMName myVM \
-ExtensionName OmsAgentForLinux \
-ExtensionType OmsAgentForLinux \
-Publisher Microsoft.EnterpriseCloud.Monitoring \
-TypeHandlerVersion latestVersion \
-ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
-SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}'
Устранение неполадок и поддержка
Устранение неполадок
Данные о состоянии развертывания расширения можно получить на портале Azure, а также с помощью Azure CLI или Azure PowerShell. Чтобы просмотреть состояние развертывания расширений для определенной виртуальной машины, выполните приведенную ниже команду, если вы используете Azure CLI.
az vm extension list --resource-group myResourceGroup --vm-name myVM -o table
Выходные данные выполнения расширения регистрируются в следующем файле:
/var/log/azure/Microsoft.EnterpriseCloud.Monitoring.OmsAgentForLinux/extension.log
Чтобы получить версию расширения OMS, установленную на виртуальной машине, выполните приведенную ниже команду, если вы используете Azure CLI.
az vm extension show --resource-group myResourceGroup --vm-name myVM --instance-view
Чтобы получить версию расширения OMS, установленную на виртуальной машине, выполните приведенную ниже команду, если вы используете Azure PowerShell.
Get-AzVMExtension -ResourceGroupName my_resource_group -VMName my_vm_name -Name OmsAgentForLinux -Status
Коды ошибок и их описание
| Код ошибки | Значение | Возможное действие |
|---|---|---|
| 9 | Преждевременный вызов операции включения | Обновите агент Azure Linux до новейшей версии. |
| 10 | Виртуальная машина уже подключена к рабочей области Log Analytics | Для подключения виртуальной машины к рабочей области, указанной в схеме расширения, задайте для stopOnMultipleConnections значение false в общих параметрах или удалите это свойство. Счет для этой виртуальной машины выставляется за каждую рабочую область, к которой она подключена. |
| 11 | Для расширения предоставлена недопустимая конфигурация | Изучите приведенные выше примеры, чтобы задать все значения свойств, необходимые для развертывания. |
| 17 | Сбой установки пакета Log Analytics | |
| 18 | Не удалось установить пакет OMSConfig. | Просмотрите выходные данные команды, чтобы определить причину сбоя. |
| 19 | Сбой установки пакета OMI | |
| 20 | Сбой установки пакета SCX | |
| 33 | Ошибка при создании метаконфигурации для omsconfig. | Сообщите об ошибке на сайте Github, предоставив подробные сведения из выходных данных. |
| 51 | Это расширение не поддерживается в операционной системе виртуальной машины | |
| 52 | Сбой расширения из-за отсутствия зависимости или разрешения | Проверьте выходные данные и журналы, чтобы получить дополнительные сведения об отсутствующей зависимости или разрешении. |
| 53 | Сбой расширения из-за отсутствующих или неправильных параметров конфигурации | Проверьте выходные данные и журналы, чтобы получить дополнительные сведения о проблеме. Кроме того, проверьте правильность идентификатора рабочей области и убедитесь, что компьютер подключен к Интернету. |
| 55 | Не удается подключиться к службе Azure Monitor, отсутствуют необходимые пакеты или заблокирован менеджер пакетов dpkg | Убедитесь, что система имеет доступ к Интернету и что предоставлен допустимый прокси-сервер HTTP. Кроме того, проверьте правильность идентификатора рабочей области и убедитесь, что установлены служебные программы curl и tar. |
Дополнительные сведения об устранении неполадок см. в руководстве по устранению неполадок агента Log Analytics для Linux.
Поддержка
Если в любой момент при изучении этой статьи вам потребуется дополнительная помощь, вы можете обратиться к экспертам по Azure на форумах MSDN Azure и Stack Overflow. Кроме того, можно зарегистрировать обращение в службу поддержки Azure. Перейдите на сайт поддержки Azure и щелкните "Получить поддержку". Дополнительные сведения об использовании службы поддержки Azure см. в статье Часто задаваемые вопросы о поддержке Microsoft Azure.