Compartilhar via


Extensão de máquina virtual de dependência do Azure Monitor para Windows

O recurso Mapa do Azure Monitor para VMs obtém seus dados do Microsoft Dependency Agent. A extensão de máquina virtual do Dependency Agent de VM do Azure para Windows instala o Dependency Agent em máquinas virtuais do Azure. Este documento especifica as opções de plataformas, de configurações e de implantação com suporte para a extensão da máquina virtual do agente de dependência da VM do Azure para Windows.

Sistema operacional

A extensão do agente da Dependência de VM do Azure para Windows pode ser executada nos sistemas operacionais compatíveis listados na tabela a seguir. Todos os sistemas operacionais da tabela a seguir são considerados x64. O x86 não é compatível com nenhum sistema operacional.

Sistema operacional Agente da Dependência de VM do Azure
Windows Server 2022
Windows Server 2022 Core
Windows Server 2019
Windows Server 2019 Core
Windows Server 2016
Windows Server 2016 Core
Windows Server 2012 R2
Windows Server 2012
Windows 11 Cliente e Pro 1, 2
Windows 11 Enterprise
(incluindo multissessão)
Windows 10 1803 (RS4) e superior 1
Windows 10 Enterprise
(incluindo multissessão) e Pro
(Somente cenários de servidor)
Windows 8 Enterprise e Pro
(Somente cenários de servidor)
Windows 7 SP1
(Somente cenários de servidor)
Azure Stack HCI
Windows IoT Enterprise

1 Usando o instalador de cliente do agente do Azure Monitor.
2 Também compatível em computadores baseados no Arm64.

Esquema de extensão

O JSON a seguir mostra o esquema para a extensão do agente de dependência de VM do Azure em uma VM do Windows do 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 Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "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": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

Valores de propriedade

Nome Valor/exemplo
apiVersion 01-01-2015
publicador Microsoft.Azure.Monitoring.DependencyAgent
type DependencyAgentWindows
typeHandlerVersion 9.10
autoUpgradeMinorVersion true
settings "enableAMA": "true"

Importante

Adicione enableAMA ao modelo se você estiver usando o Agente do Azure Monitor; caso contrário, o Dependency Agent tentará enviar dados para o agente herdado do Log Analytics.

Implantação de modelo

É possível implantar as extensões de VM do Azure com modelos de Azure Resource Manager. Você pode usar o esquema JSON detalhado na seção anterior em um modelo do Azure Resource Manager para executar a extensão do agente de dependência de VM do Azure durante uma implantação de modelo do Azure Resource Manager.

O JSON de uma extensão de máquina virtual pode ser aninhado no recurso de máquina virtual. Como alternativa, você pode colocá-lo no nível raiz ou superior de um modelo JSON do Resource Manager. O posicionamento do JSON afeta o valor do tipo e nome do recurso. Para obter mais informações, consulte Definir o nome e o tipo de recursos filho.

O exemplo a seguir pressupõe que a extensão do agente de dependência está aninhada no recurso de máquina virtual. Quando você aninha o recurso de extensão, o JSON é colocado no objeto "resources": [] da máquina virtual.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

Ao colocar a extensão JSON na raiz do modelo, o nome do recurso inclui uma referência à máquina virtual pai. O tipo reflete a configuração aninhada.

{
	"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": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

Implantação do PowerShell

Use o comando Set-AzVMExtension para implantar a extensão de máquina virtual do Agente de Dependência em uma máquina virtual existente. Antes de executar o comando, as configurações públicas e privadas precisam ser armazenadas em uma tabela de hash do PowerShell.


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

Upgrade de extensão automática

Agora, está disponível um novo recurso para atualizar automaticamente as versões secundárias da extensão de Dependência.

Para habilitar a atualização da extensão automática para uma extensão, você deve garantir que a propriedade enableAutomaticUpgrade esteja definida como true e adicionada ao modelo de extensão. Essa propriedade deve ser habilitada individualmente em cada VM ou conjunto de dimensionamento de VM. Use um dos métodos descritos na seção habilitação para habilitar o recurso para sua VM ou conjunto de dimensionamento de VM.

Quando a atualização automática de extensão está habilitada em uma VM ou conjunto de dimensionamento de VM, ela é atualizada automaticamente sempre que o editor libera uma nova versão para a extensão. A atualização é aplicada com segurança de acordo com os princípios de disponibilidade, conforme descrito aqui.

A funcionalidade do atributo enableAutomaticUpgrade é diferente da do autoUpgradeMinorVersion. O atributo autoUpgradeMinorVersion não dispara automaticamente uma atualização de versão secundária quando o editor de extensão lança uma nova versão. O atributo autoUpgradeMinorVersion indica se a extensão deve usar uma versão secundária mais nova se houver uma disponível no momento da implantação. Após implantada, no entanto, a extensão não atualizará as versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como verdadeira.

Para manter a versão de extensão atualizada, recomendamos usar enableAutomaticUpgrade com sua implantação de extensão.

Importante

Se você adicionar enableAutomaticUpgrade ao modelo, use a versão 2019-12-01 da API ou superior.

Solução de problemas e suporte

Solucionar problemas

Os dados sobre o estado das implantações de extensão podem ser recuperados no portal do Microsoft Azure usando o módulo do Azure PowerShell. Para ver o estado de implantação das extensões de uma determinada VM, execute o seguinte comando usando o módulo Azure PowerShell:

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

A saída de execução da extensão é registrada nos arquivos localizados no seguinte diretório:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

Suporte

Se precisar de mais ajuda em qualquer ponto deste artigo, contate os especialistas do Azure nas perguntas e respostas da Microsoft e nos fóruns do Stack Overflow. Como alternativa, você pode registrar um incidente de suporte do Azure. Vá para o site de suporte do Azure e selecione Obter suporte. Para saber mais sobre como usar o suporte do Azure, leia as Perguntas frequentes sobre o suporte do Microsoft Azure.