Instalar o monitoramento de VM (visualização)

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

O código neste artigo detalha as etapas para instalar a extensão de VM de integridade do aplicativo e habilitar a observação de VM. Observe que os segmentos de código exigem a entrada do usuário. Todas as etiquetas entre colchetes angulares (<>) no código precisam ser substituídas por valores específicos da sua instalação. Aqui está uma lista de parâmetros com instruções sobre o que substituí-los.

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

Pré-requisitos

1. Registre o recurso

Registre-se para adotar a observação 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 de recursos

Valide se você se registrou com êxito para o recurso de observação de VM executando o seguinte comando:

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

---

2. Verifique se uma VM está instalada

Para obter informações sobre como criar uma VM e/ou um conjunto de dimensionamento de máquina virtual, consulte 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 Windows e Linux, exceto para o valor do parâmetro <application health extension type> passado para o tipo de extensão. Substitua <application health extension type> por "ApplicationHealthLinux" para instalações Linux e "ApplicationHealthWindows" para instalações 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 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
                 } 
             } 
         }  

Valide se a extensão da VM de integridade do aplicativo está instalada na VM do Azure

Vá para o portal do Azure e confirme se a extensão de VM de 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 a observação de VM foi habilitada nessa VM, volte para a página de visão geral e selecione a exibição JSON para a VM. Verifique se a configuração existe no JSON.

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

---

Instalar o monitoramento de VM em um conjunto de dimensionamento de máquina virtual do Azure

Importante

O segmento de código é idêntico para Windows e Linux, exceto para o valor do parâmetro <application health extension type> passado para o tipo de extensão. Substitua <application health extension type> por "ApplicationHealthLinux" para instalações Linux e "ApplicationHealthWindows" para instalações 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 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  
                                }  
                            }  
                        } 
                    }  
                ]  
            }  
        }  
    }     

Valide se a extensão da VM de integridade do aplicativo está instalada no conjunto de dimensionamento da máquina virtual

Vá para o portal do Azure e confirme se a extensão de VM de 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 a observação de VM foi habilitada nesse conjunto de escalas, volte para a página de visão geral e selecione a visualização JSON para o conjunto de escalas. Verifique se a configuração existe no JSON.

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

Conteúdos relacionados

• Extensão de integridade do aplicativo
• CLI do Azure
• Portal do Azure