Расширение виртуальной машины агента Log Analytics для Windows

Журналы Azure Monitor предоставляют возможности мониторинга облачных и локальных ресурсов. Корпорация Майкрософт публикует и поддерживает расширение виртуальной машины агента Log Analytics для Windows. Расширение устанавливает агент Log Analytics на виртуальных машинах Azure и регистрирует виртуальные машины в существующей рабочей области Log Analytics. В этой статье описываются поддерживаемые платформы, конфигурации и параметры развертывания для расширения виртуальной машины агента Log Analytics для Windows.

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

Ознакомьтесь со следующими предварительными условиями для использования расширения виртуальной машины агента Log Analytics для Windows.

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

Дополнительные сведения о поддерживаемых операционных системах Windows см. в статье " Обзор агентов Azure Monitor".

Версия расширения агента и виртуальной машины

Приведенная ниже таблица содержит сопоставление версий расширения виртуальной машины Windows для Log Analytics и агента Log Analytics для каждого выпуска.

Microsoft Defender для облака

Microsoft Defender для облака автоматически подготавливает агент Log Analytics и подключает его к рабочей области Log Analytics по умолчанию в подписке Azure.

Azure Arc

Серверы с поддержкой Azure Arc можно использовать для развертывания, удаления и обновления расширения виртуальной машины агента Log Analytics на компьютерах, отличных от Windows и Linux. Этот подход упрощает управление гибридным компьютером через жизненный цикл. Дополнительные сведения см. в документе Управление расширениями виртуальных машин с помощью серверов с поддержкой Azure Arc.

Подключение к Интернету

Расширение виртуальной машины агента Log Analytics для Windows требует подключения целевой виртуальной машины к Интернету.

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

В следующем формате JSON показана схема расширения виртуальной машины агента Log Analytics для Windows. Для расширения требуется идентификатор и ключ из целевой рабочей области Log Analytics. Эти элементы можно найти в параметрах рабочей области в портал Azure.

Так как ключ рабочей области должен рассматриваться в качестве конфиденциальных данных, его следует хранить в защищенной конфигурации параметров. Данные, защищенные расширением виртуальной машины Azure, шифруются и расшифровываются только на целевой виртуальной машине.

{
    "type": "extensions",
    "name": "OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

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

Схема JSON содержит следующие свойства.

* Свойство workspaceId схемы указывается в качестве consumerId свойства в API Log Analytics.

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

Расширения виртуальных машин Azure можно развернуть с помощью шаблонов Azure Resource Manager (ARM). Схему JSON, описанную в предыдущем разделе, можно использовать в шаблоне ARM для запуска расширения виртуальной машины агента Log Analytics во время развертывания шаблона ARM. Пример шаблона, включающего в себя расширение виртуальной машины агента Log Analytics, можно найти в коллекции быстрого запуска Azure.

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

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

{
    "type": "extensions",
    "name": "OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

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

{
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "name": "<parentVmResource>/OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

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

Команду Set-AzVMExtension можно использовать для развертывания расширения виртуальной машины агента Log Analytics на существующей виртуальной машине. Перед выполнением команды сохраните общедоступные и частные конфигурации в хэш-файле PowerShell.

$PublicSettings = @{"workspaceId" = "myWorkspaceId"}
$ProtectedSettings = @{"workspaceKey" = "myWorkspaceKey"}

Set-AzVMExtension -ExtensionName "MicrosoftMonitoringAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.EnterpriseCloud.Monitoring" `
    -ExtensionType "MicrosoftMonitoringAgent" `
    -TypeHandlerVersion 1.0 `
    -Settings $PublicSettings `
    -ProtectedSettings $ProtectedSettings `
    -Location WestUS 

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

Ниже приведены некоторые рекомендации по устранению неполадок с развертыванием.

Просмотр состояния расширения

Проверьте состояние развертывания расширения в портал Azure или с помощью PowerShell или Azure CLI.

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

• Azure PowerShell:

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

• Azure CLI:

  az vm get-instance-view --resource-group <myResourceGroup> --name <myVM> --query "instanceView.extensions"
  

Просмотр журналов выходных данных

Просмотрите выходные журналы для расширения виртуальной машины агента Log Analytics для Windows в C:\WindowsAzure\Logs\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\разделе .

Поддержка

Ниже приведены некоторые другие варианты, которые помогут устранить проблемы с развертыванием.

• Чтобы получить помощь, обратитесь к экспертам Azure на форумах Q&A и Stack Overflow.

• Вы также можете связаться с служба поддержки Майкрософт. Дополнительные сведения об использовании службы поддержки Azure см. в статье Часто задаваемые вопросы о поддержке Azure.