Instalar o monitoramento de VM (versão prévia)

Você pode habilitar o monitoramento de VM usando um modelo do ARM (modelo do Azure Resource Manager), o PowerShell ou a CLI do Azure em VMs (máquinas virtuais) do Azure e conjuntos de dimensionamento de máquinas virtuais do Azure. Você pode habilitar o monitoramento de VM em máquinas virtuais do Linux e do Windows. O monitoramento de VM é fornecido por meio da extensão de VM de integridade do aplicativo para facilitar a adoção.

O código deste artigo mostra detalhes das etapas necessárias para instalar a extensão de VM Integridade do Aplicativo e habilitar o monitoramento de VM. Observe que os segmentos de código exigem a entrada do usuário. Todos os rótulos dentro de colchetes angulares (<>) no código precisam ser substituídos por valores específicos da instalação. Confira uma lista de parâmetros com instruções sobre as substituições para eles.

Parâmetro	Descrição
<your subscription id>	A ID da assinatura do Azure em que você deseja instalar o monitoramento de VM.
<your vm name>	O nome da máquina virtual em que a extensão será instalada.
<your resource group name>	O nome do grupo de recursos na assinatura do Azure ao qual a VM será atribuída.
<your location>	A região do Azure em que a VM está instalada.
<your extension name	O nome que será atribuído à extensão de VM Integridade do Aplicativo que você está instalando.
<application health extension type>	Especifica a extensão Integridade do Aplicativo que deve ser instalada, a do Windows ou a do Linux.
<your vm scale set name>	O nome do conjunto de dimensionamento de máquinas virtuais no qual você deseja instalar o monitoramento de VM.

Pré-requisitos

1. Registrar o recurso

Registre-se para adotar o monitoramento de VM executando os seguintes comandos por meio da CLI do Azure:

az feature register --name VMWatchPreview --namespace Microsoft.Compute --subscription <your subscription id>
az provider register --namespace Microsoft.Compute --subscription <your subscription id>

---

Validar o registro do recurso

Valide se você se registrou com êxito no recurso de monitoramento de VM executando o seguinte comando:

az feature show --namespace Microsoft.Compute --name VMWatchPreview --subscription <your subscription id>

---

2. Verificar se uma VM está instalada

Para saber como criar um conjunto de dimensionamento de máquinas virtuais e/ou uma VM, confira o Guia de início rápido para Windows e o Guia de início rápido para Linux.

Importante

Se a extensão Integridade do Aplicativo já estiver instalada na VM, verifique se as configurações autoUpgradeMinorVersion e enableAutomaticUpgrade estão definidas como true.

Instalar o monitoramento de VM em uma máquina virtual do Azure

Importante

O segmento de código é idêntico para o Windows e o Linux, com exceção do valor do parâmetro <application health extension type> transmitido para o tipo de extensão. Substitua <application health extension type> por "ApplicationHealthLinux" para instalações do Linux e por "ApplicationHealthWindows" para instalações do Windows.

CLI

az vm extension set --resource-group <your resource group> --vm-name <your vm name> --name <application health extension type> --publisher Microsoft.ManagedServices --version 2.0 --settings '{"vmWatchSettings": {"enabled": true}}' --enable-auto-upgrade true 

PowerShell

Set-AzVMExtension -ResourceGroupName "<your resource group>" -Location "<your vm region>" -VMName "<your vm name>" -Name "<your extension name>" -Publisher "Microsoft.ManagedServices" -ExtensionType "<application health extension type>" -TypeHandlerVersion "2.0" -Settings @{"vmWatchSettings" = @{"enabled" = $True}} -EnableAutomaticUpgrade $True 

Modelo de ARM

        "type": "Microsoft.Compute/virtualMachines/extensions", 
        "apiVersion": "2019-07-01", 
        "name": "[concat('<your vm name>', '/', '<your extension name')]", 
        "location": "<your vm region>", 
        "dependsOn": [ 
            "[resourceId('Microsoft.Compute/virtualMachines', parameters('<your vm name>'))]" 
        ], 

        "properties": { 
            "enableAutomaticUpgrade": true, 
            "publisher": "Microsoft.ManagedServices", 
            "typeHandlerVersion": "2.0", 
            "type": "<application health extension type>", 
            "settings": { 
                "vmWatchSettings": { 
                    "enabled": true
                 } 
             } 
         }  

Validar se a extensão de VM Integridade do Aplicativo está instalada na VM do Azure

Acesse o portal do Azure e confirme se a extensão de VM Integridade do Aplicativo foi instalada com êxito.

A captura de tela a seguir mostra uma instalação do Windows.

A captura de tela a seguir mostra uma instalação do Linux.

Para confirmar se o monitoramento de VM foi habilitado na VM, volte à página de visão geral e clique a exibição JSON da VM. Verifique se a configuração existe no JSON.

  "settings": {  
      "vmWatchSettings": {  
          "enabled": true  
      }
  }

---

Instalar o monitoramento de VM em conjuntos de dimensionamento de máquinas virtuais do Azure

Importante

O segmento de código é idêntico para o Windows e o Linux, com exceção do valor do parâmetro <application health extension type> transmitido para o tipo de extensão. Substitua <application health extension type> por "ApplicationHealthLinux" para instalações do Linux e por "ApplicationHealthWindows" para instalações do Windows.

CLI

az vmss extension set --resource-group '<your resource group name>' --vmss-name '<your vm scale set name>' --name <application health extension type> --publisher Microsoft.ManagedServices --version 2.0 --settings '{"vmWatchSettings": {"enabled": true}}' --enable-auto-upgrade true

PowerShell

### Define the scale set variables 
$vmScaleSetName = "<your vm scale set name>" 
$vmScaleSetResourceGroup = "<your resource group name>" 

### Define the setting to enable VM watch 
$publicConfig = @{"vmWatchSettings" = @{"enabled" = $true}} 
$extensionName = "<your extension name>" 
$extensionType = "<application health extension type>" 
$publisher = "Microsoft.ManagedServices" 

### Get the scale set object 
$vmScaleSet = Get-AzVmss ` 
  -ResourceGroupName $vmScaleSetResourceGroup ` 
  -VMScaleSetName $vmScaleSetName

### Add the Application Health extension to the scale set model 
Add-AzVmssExtension -VirtualMachineScaleSet $vmScaleSet ` 
  -Name $extensionName ` 
  -Publisher $publisher ` 
  -Setting $publicConfig ` 
  -Type $extensionType ` 
  -TypeHandlerVersion "2.0" ` 
  -EnableAutomaticUpgrade $True

### Update the scale set 
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup ` 
  -Name $vmScaleSetName ` 
  -VirtualMachineScaleSet $vmScaleSet

### Upgrade instances to install the extension 
Update-AzVmssInstance -ResourceGroupName $vmScaleSetResourceGroup ` 
  -VMScaleSetName $vmScaleSetName ` 
  -InstanceId '*' 

Modelo de ARM

   "type": "Microsoft.Compute/virtualMachineScaleSets",
   "apiVersion": "2024-07-01",
   "name": "<your vm scale set name>",
   "location": "<your vm region>",  
   "properties": {  
        "virtualMachineProfile": {
            "extensionProfile": {
               "extensions": [
                    {
                        "name": "[concat(variables('<your vm scale set name>'), '/', '<your extension name>')]",  
                        "properties": {  
                            "publisher": "Microsoft.ManagedServices",  
                            "type": "<application health extension type>",  
                            "typeHandlerVersion": "2.0",  
                            "autoUpgradeMinorVersion": true,
                            "enableAutomaticUpgrade": true,
                            "settings": {  
                                "vmWatchSettings": {  
                                    "enabled": true  
                                }  
                            }  
                        } 
                    }  
                ]  
            }  
        }  
    }     

Validar se a extensão de VM Integridade do Aplicativo está instalada no conjunto de dimensionamento de máquinas virtuais

Acesse o portal do Azure e confirme se a extensão de VM Integridade do Aplicativo foi instalada com êxito.

A captura de tela a seguir mostra uma instalação do Windows.

A captura de tela a seguir mostra uma instalação do Linux.

---

Para confirmar se o monitoramento de VM estava habilitado neste conjunto de dimensionamento, volte à página de visão geral e selecione a exibição JSON para o conjunto de dimensionamento. Verifique se a configuração existe no JSON.

  "settings": {  
      "vmWatchSettings": {  
          "enabled": true  
      }
  }

Conteúdo relacionado

• Extensão Integridade do Aplicativo
• CLI do Azure
• Portal do Azure