Extensão de máquina virtual do agente do Log Analytics para Windows

Os Logs do Azure Monitor fornecem recursos de monitoramento em ativos locais e na nuvem. A Microsoft publica e dá suporte à extensão de máquina virtual (VM) do agente do Log Analytics para Windows. A extensão instala o agente do Log Analytics em VMs do Azure e registra VMs em um espaço de trabalho existente do Log Analytics. Este artigo descreve as plataformas, configurações e opções de implantação suportadas para a extensão VM do agente do Log Analytics para Windows.

Pré-requisitos

Analise os pré-requisitos a seguir para usar a extensão de VM do agente do Log Analytics para Windows.

Sistema operativo

Para obter detalhes sobre os sistemas operacionais Windows suportados, consulte o artigo Visão geral dos agentes do Azure Monitor .

Versão da extensão do agente e da VM

A tabela a seguir fornece um mapeamento da versão da extensão de VM do Windows Log Analytics e do agente do Log Analytics para cada versão.

Microsoft Defender para a Cloud

O Microsoft Defender for Cloud provisiona automaticamente o agente do Log Analytics e o conecta ao espaço de trabalho padrão do Log Analytics da assinatura do Azure.

Azure Arc

Você pode usar servidores habilitados para Azure Arc para implantar, remover e atualizar a extensão de VM do agente do Log Analytics para máquinas Windows e Linux que não sejam do Azure. Esta abordagem simplifica a gestão da sua máquina híbrida ao longo do seu ciclo de vida. Para obter mais informações, consulte Gerenciamento de extensão de VM com servidores habilitados para Azure Arc.

Ligação à Internet

A extensão de VM do agente do Log Analytics para Windows requer que a VM de destino esteja conectada à Internet.

Esquema de extensão

O JSON a seguir mostra o esquema para a extensão de VM do agente do Log Analytics para Windows. A extensão requer o ID e a chave do espaço de trabalho do espaço de trabalho de destino do Log Analytics. Esses itens podem ser encontrados nas configurações do espaço de trabalho no portal do Azure.

Como a chave do espaço de trabalho deve ser tratada como dados confidenciais, ela deve ser armazenada em uma configuração de configuração protegida. Os dados de configuração protegida da extensão de VM do Azure são criptografados e só são descriptografados na VM de destino.

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

Valores de propriedade

O esquema JSON inclui as seguintes propriedades.

* A workspaceId propriedade schema é especificada como a consumerId propriedade na API do Log Analytics.

Implementação de modelos

As extensões de VM do Azure podem ser implantadas com modelos do Azure Resource Manager (ARM). O esquema JSON detalhado na seção anterior pode ser usado em um modelo ARM para executar a extensão VM do agente do Log Analytics durante uma implantação de modelo ARM. Um modelo de exemplo que inclui a extensão de VM do agente do Log Analytics pode ser encontrado na Galeria de Início Rápido do Azure.

O JSON para uma extensão de VM pode ser aninhado dentro do recurso de VM ou colocado na raiz ou no nível superior de um modelo JSON ARM. O posicionamento do JSON afeta o valor do nome e do tipo de recurso. Para obter mais informações, consulte Definir nome e tipo para recursos filho.

O exemplo a seguir pressupõe que a extensão de VM do agente do Log Analytics esteja aninhada dentro do recurso VM. Quando você aninha o recurso de extensão, o JSON é colocado no "resources": [] objeto da VM.

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

Quando você coloca a extensão JSON na raiz do modelo ARM, o recurso name inclui uma referência à VM pai e reflete a type configuração aninhada.

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

Implementação do PowerShell

O Set-AzVMExtension comando pode ser usado para implantar a extensão de VM do agente do Log Analytics em uma VM existente. Antes de executar o comando, armazene as configurações pública e privada em uma hashtable do 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 

Resolver problemas

Aqui estão algumas sugestões de como solucionar problemas de implantação.

Ver estado da extensão

Verifique o status da sua implantação de extensão no portal do Azure ou usando o PowerShell ou a CLI do Azure.

Para ver o estado de implantação das extensões de uma determinada VM, execute os seguintes comandos.

• Azure PowerShell:

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

• A CLI do Azure:

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

Revisar logs de saída

Exiba os logs de saída da extensão de VM do agente do Log Analytics para Windows em C:\WindowsAzure\Logs\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\.

Obter suporte

Aqui estão algumas outras opções para ajudá-lo a resolver problemas de implantação:

• Para obter assistência, contacte os especialistas do Azure nos fóruns de Perguntas e Respostas e Estouro de Pilha.

• Também pode contactar o Suporte da Microsoft. Para obter informações sobre como usar o suporte do Azure, leia as Perguntas frequentes de suporte do Azure.