Habilitar insights da VM

Este artigo fornece detalhes sobre como habilitar os Insights da VM no Azure Monitor usando métodos diferentes, incluindo o portal do Azure, os modelos do ARM e o script do PowerShell.

Aviso

Se sua máquina virtual já tiver insights de VM habilitados usando o agente do Log Analytics preterido, confira Migrar do agente do Log Analytics para o Agente do Azure Monitor no VM Insights para obter diretrizes sobre como migrar para o agente do Azure Monitor. Certifique-se de remover o agente do Log Analytics para impedir uma coleta de dados duplicada com ambos os agentes instalados.

Pré-requisitos

• Você deve ter um workspace do Log Analytics para armazenar dados coletados por insights de VM. Você poderá criar um novo workspace se habilitar o uso do portal do Azure.
• Você precisa de permissões para criar uma regra de coleta de dados (DCR) e associá-la ao agente do Azure Monitor. Confira as permissões da Regra de Coleta de Dados para obter detalhes.
• Veja Sistemas operacionais e ambientes com suporte do agente do Azure Monitor para verificar se seu sistema operacional é compatível com o agente do Azure Monitor.
• Consulte Gerenciar o agente do Azure Monitor para pré-requisitos relacionados ao agente do Azure Monitor.
• Confira a configuração de rede do agente do Azure Monitor para ver requisitos de rede do agente do Azure Monitor.
• Confira os requisitos do Dependency Agent para verificar se o sistema operacional tem suporte do Agente de Dependência e para ver os requisitos de rede do Dependency Agent.

Agentes

Quando você habilita o VM Insights para um computador, os agentes a seguir são instalados.

• Agente do Azure Monitor: coleta dados do computador e os entrega em um workspace do Log Analytics.
• Dependency Agent: coleta dados descobertos sobre processos que estão em execução na máquina virtual e de dependências de processos externos para dar suporte ao recurso de mapeamento nos VM Insights. Este agente não é necessário para outras funcionalidades dos Insights da VM, portanto, você não precisa instalar o agente de dependência se não for usar o recurso Mapa.

VM insights DCR

DCRs (Regras de coleta de dados) são usadas pelo agente do Azure Monitor para especificar quais dados coletar e como devem ser processados. Ao habilitar os Insights da VM, você cria uma DCR especificamente para os Insights de VM e a associa ao agente do Azure Monitor em todos os computadores a serem monitorados.

A única configuração em uma DCR dos Insights da VM é o workspace do Log Analytics e se os dados de dependências e processos devem ou não ser coletados. Em vez de criar uma DCR separada para cada computador, você deve usar uma única DCR para cada workspace do Log Analytics usado para os Insights da VM e associar essa DCR a vários computadores. Talvez você queira criar DCRs separadas se quiser coletar processos e dependências de alguns computadores, mas não de outros.

Observação

Você não deve modificar a DCR do VM Insights. Se você precisar coletar dados adicionais dos computadores monitorados, como logs de eventos e logs de segurança, crie DCRs adicionais e associe-as aos mesmos computadores. Você pode obter diretrizes para criar essas DCRs a partir de Coletar dados com o Agente do Azure Monitor.

Criar uma DCR dos Insights da VM

Há dois métodos para criar uma DCR dos Insights da VM. Independentemente do método escolhido, a DCR é idêntica e pode ser usada com qualquer processo para habilitar os Insights da VM em outros computadores. Embora não seja necessário, você deve nomear a DCR MSVMI-{WorkspaceName} para corresponder à convenção de nomenclatura usada pelo portal do Azure.

• Crie um DCR do VM Insights como parte do processo de integração usando o portal do Azure com o processo detalhado abaixo.

• Baixe e instale os modelos de regra de coleta de dados dos Insights da VM. A tabela a seguir descreve os modelos disponíveis. Confira Implantar modelos se você não estiver familiarizado com métodos para implantar modelos do ARM.

  Pasta	Arquivo	Descrição
  DeployDcr\ PerfAndMapDcr	DeployDcrTemplate DeployDcrParameters	Habilite a experiência de Desempenho e Mapa dos Insights de VM.
  DeployDcr\ PerfOnlyDcr	DeployDcrTemplate DeployDcrParameters	Habilitar apenas a experiência de Desempenho do VM Insights.

Habilitar isolamento de rede

Há dois métodos para isolamento de rede que os insights da VM dão suporte, conforme descrito na tabela a seguir.

Método	Descrição
Link privado	Por padrão, o Agente do Azure Monitor se conecta a um ponto de extremidade público para se conectar ao ambiente do Azure Monitor. Para que ele se conecte à ligação privada, associe o DCR do VM Insights a um ponto de extremidade de coleta de dados (DCE) que esteja vinculado a um Escopo de Link Privado do Azure Monitor, conforme descrito em Habilitar isolamento de rede para o Agente do Azure Monitor usando o Link Privado.
Perímetro de segurança da rede	Se o workspace do Log Analytics estiver associado a um perímetro de segurança de rede, utilize as orientações em Configurar o Azure Monitor com um Perímetro de Segurança de Rede.

Habilitar insights da VM

Portal

Habilitar VM Insights usando o portal do Azure

Use o procedimento a seguir para habilitar VM Insights em uma máquina virtual não monitorada ou no Conjunto de Dimensionamento de Máquinas Virtuais. Este processo não exige que você implante agentes ou crie uma DCR dos Insights da VM primeiro, já que essas tarefas são executadas pelo portal.

Observação

Como parte do processo de instalação do agente do Azure Monitor, o Azure atribui uma identidade gerenciada atribuída pelo sistema ao computador se essa identidade ainda não existir.

1. No menu Monitoramento no portal do Azure, selecione Não Monitorado>Máquinas Virtuais. Esta guia inclui todos os computadores que não têm os Insights da VM habilitados. Todos os computadores têm o agente do Azure Monitor instalado. Se uma máquina virtual tiver o agente Log Analytics instalado, mas não o agente de dependência, ela será listada como não monitorada.

2. Selecione Habilitar próximo da máquina que você desejar habilitar. Se um computador não estiver em execução no momento, você precisa iniciá-lo para poder habilitá-lo.

   

3. Na página Integração do Insights, selecione Habilitar.

4. Na página Configuração de monitoramento, selecione Agente do Azure Monitor e selecione uma DCR na lista suspensa Regra de coleta de dados. Somente DCRs configuradas para os Insights da VM são listadas.

   

5. Se uma DCR ainda não tiver sido criada para os Insights da VM, o Azure Monitor oferecerá criar uma com um workspace do Log Analytics padrão e as seguintes configurações. Você pode aceitar esses padrões ou clicar em Criar nova para criar uma nova DCR com configurações diferentes. Isso permite que você selecione um espaço de trabalho e especifique se deseja coletar processos e dependências usando o Mapa de Insights de VM.

   • Modo de convidado habilitado.
   • Processos e dependências desabilitados.

   

   Observação

   Se você selecionar uma DCR com o Mapa habilitado e sua máquina virtual não for compatível com o Dependency Agent, o Dependency Agent será instalado e será executado no modo degradado.

6. Selecione Configurar para iniciar o processo de configuração. Instalar o agente e começar a coletar dados leva alguns minutos. Você receberá as mensagens de status à medida que a configuração for executada.

7. Se você usar um modelo de atualização manual para o Conjunto de dimensionamento de máquinas virtuais, atualize as instâncias para concluir a configuração. Você pode iniciar as atualizações na página Instâncias, na seção Configurações.

Modelo do ARM

Habilitar VM Insights usando modelos do ARM

Há três etapas para habilitar os Insights da VM usando modelos do ARM. Cada uma dessas etapas é descrita mais detalhadamente nas seções a seguir.

Implantar agentes

Instale os agentes necessários em seus computadores usando diretrizes nos artigos a seguir. O agente de dependência só será necessário se você quiser habilitar o recurso Mapa.

• Agente do Azure Monitor para Linux ou Windows.
• Agente de dependência para Linux ou Agente de dependência para Windows se você quiser habilitar o recurso Mapa.

Observação

Se os conjuntos de dimensionamento de máquinas virtuais tiverem uma política de atualização definida como manual, os insights de VM não serão habilitados para instâncias por padrão após a instalação do modelo. Você deve atualizar as instâncias manualmente.

Crie uma DCR (regra de coleta de dados)

Se você ainda não tiver uma DCR para insights de VM, crie uma usando os detalhes acima em DCR para insights de VM.

Associe a DCR com os agentes

A etapa final na habilitação de VM Insights é associar a DCR ao agente do Azure Monitor. Use o modelo abaixo, que vem de Gerenciar associações de regra de coleta de dados no Azure Monitor. Para habilitar em vários computadores, você precisa criar uma associação usando esse modelo para cada um deles. Confira Implantar modelos se você não estiver familiarizado com métodos para implantar modelos do ARM.

Observação

Se você associar uma DCR ao recurso Mapa habilitado para um computador no qual o Dependency Agent não está instalado, o modo de exibição de mapa não estará disponível. Para habilitar o modo de exibição de Mapa, defina enableAMA property = true na extensão do Dependency Agent ao instalar o Dependency Agent.

Modelo de ARM

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "Name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "Name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "Resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

Arquivo de parâmetros

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-azure-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

Implantar modelos ARM

Os modelos do ARM descritos nesta seção podem ser implantados usando qualquer método para instalar um modelo do ARM. Confira o Início Rápido: criar e implantar modelos do ARM usando o portal do Azure para obter detalhes sobre como implantar um modelo do portal do Azure.

Os exemplos a seguir mostram como implantar os modelos da linha de comando usando métodos comuns.

New-AzResourceGroupDeployment -Name EnableVMinsights -ResourceGroupName <ResourceGroupName> -TemplateFile <Template.json> -TemplateParameterFile <Parameters.json>

az deployment group create --resource-group <ResourceGroupName> --template-file <Template.json> --parameters <Parameters.json>

Script de PowerShell

Habilitar Insights da VM para várias VMs usando o script do PowerShell

Esta seção descreve como habilitar os Insights da VM usando um script do PowerShell que é capaz de habilitar várias VMs. Este processo usa um script que instala extensões de VM para o agente do Azure Monitor (AMA) e, se necessário, o Dependency Agent para habilitar os Insights da VM.

Antes de usar este script, você deve criar uma DCR dos Insights da VM usando os detalhes acima em DCR dos Insights da VM.

Script do PowerShell

Use o script do PowerShell Install-VMInsights.ps1 para habilitar o VM Insights para várias VMs ou conjuntos de dimensionamento de máquinas virtuais. Este script itera por meio dos computadores de acordo com os parâmetros especificados. O script pode ser usado para habilitar os Insights da VM para o seguinte. Cada um desses parâmetros aceita curingas.

• Cada máquina virtual e conjunto de dimensionamento de máquinas virtuais em sua assinatura.
• Os grupos de recursos com escopo especificados por -ResourceGroup.
• Uma VM ou um conjunto de dimensionamento de máquinas virtuais especificado por -Name.

Verifique se você está usando o módulo do Az PowerShell versão 1.0.0 ou posterior com os aliases de compatibilidade Enable-AzureRM habilitados. Execute Get-Module -ListAvailable Az para encontrar a versão. Para atualizar, confira Instalar o módulo do Azure PowerShell. Se estiver executando o PowerShell localmente, execute Connect-AzAccount para criar uma conexão com o Azure.

Para ver uma lista de detalhes de argumento do script e um exemplo de uso, execute Get-Help.

Get-Help Install-VMInsights.ps1 -Detailed

Quando você habilita os Insights da VM usando o agente do Azure Monitor, o script associa uma DCR (regra de coleta de dados) e uma UAMI (identidade gerenciada atribuída pelo usuário) à VM/ao conjunto de dimensionamento de máquinas virtuais. As configurações da UAMI são transmitidas para a extensão do agente do Azure Monitor.

Install-VMInsights.ps1 -SubscriptionId <SubscriptionId> `
[-ResourceGroup <ResourceGroup>] `
[-ProcessAndDependencies ] `
[-Name <VM or Virtual Machine Scale Set name>] `
-DcrResourceId <DataCollectionRuleResourceId> `
-UserAssignedManagedIdentityName <UserAssignedIdentityName> `
-UserAssignedManagedIdentityResourceGroup <UserAssignedIdentityResourceGroup> 

Argumentos necessários:

• -SubscriptionId <String> ID da assinatura do Azure.
• -DcrResourceId <String> Identificador da ID do recurso do Azure da DCR (regra de coleta de dados). Você pode especificar DCRs de assinaturas diferentes para as VMs ou os conjuntos de dimensionamento de máquinas virtuais que estão sendo habilitados com os Insights da VM.
• -UserAssignedManagedIdentityResourceGroup <String> Nome do grupo de recursos da UAMI (identidade gerenciada atribuída pelo usuário).
• -UserAssignedManagedIdentityName <String> Nome da UAMI (identidade gerenciada atribuída pelo usuário).

Argumentos opcionais:

• -ProcessAndDependencies Defina esse sinalizador para integrar o Dependency Agent com as configurações do AMA (agente do Azure Monitor). Se isso não for especificado, somente o AMA (agente do Azure Monitor) será integrado.
• -Name <String> Nome da VM ou do conjunto de dimensionamento de máquinas virtuais a ser integrado. Se isso não for especificado, todas as VMs e o conjunto de dimensionamento de máquinas virtuais da assinatura ou do grupo de recursos serão integrados. Use curingas para especificar várias VMs ou Conjuntos de Dimensionamento de Máquinas Virtuais.
• -ResourceGroup <String> Nome do grupo de recursos que contém a VM ou o conjunto de dimensionamento de máquinas virtuais a ser integrado. Se isso não for especificado, todas as VMs e o conjunto de dimensionamento de máquinas virtuais da assinatura serão integrados. Use curingas para especificar vários grupos de recursos.
• -PolicyAssignmentName <String> Inclua somente as VMs associadas a essa política. Quando o parâmetro PolicyAssignmentName é especificado, as VMs que fazem parte do parâmetro SubscriptionId são consideradas.
• -TriggerVmssManualVMUpdate [<SwitchParameter>] Acione a atualização de instâncias de VM em um conjunto de escalonamento cuja política de atualização está definida como Manual.
• -WhatIf [<SwitchParameter>] Obtenha informações sobre o efeito esperado dos comandos no script.
• -Confirm [<SwitchParameter>] Confirme cada ação no script.
• -Approve [<SwitchParameter>] Forneça a aprovação para que a instalação seja iniciada sem nenhum prompt de confirmação para as VMs/os Conjuntos de Dimensionamento de Máquinas Virtuais listados.

O script dá suporte a caracteres curinga em -Name e -ResourceGroup. Por exemplo, -Name vm* habilita as informações de VM para todas as VMs e conjuntos de escala de máquinas virtuais que começam com “vm”. Para obter mais informações, confira Curingas do Windows PowerShell.

Exemplo:

Install-VMInsights.ps1 -SubscriptionId 12345678-abcd-abcd-1234-12345678 `
-ResourceGroup rg-AMAPowershell  `
-ProcessAndDependencies  `
-Name vmAMAPowershellWindows `
-DcrResourceId /subscriptions/12345678-abcd-abcd-1234-12345678/resourceGroups/rg-AMAPowershell/providers/Microsoft.Insights/dataCollectionRules/MSVMI-ama-vmi-default-dcr `
-UserAssignedManagedIdentityName miamatest1  `
-UserAssignedManagedIdentityResourceGroup amapowershell

Verifique os seus computadores no portal do Azure para ver se as extensões estão instaladas, ou use o seguinte comando:

az vm extension list --resource-group <resource group> --vm-name <VM name>  -o table 

Editar a configuração dos insights da VM

Para editar a configuração de insights da VM para uma máquina virtual depois de ser integrada, clique em Habilitado ao lado da VM na página Visão geral do insights da VM. Isso exibirá a configuração atual. Clique em Editar para abrir a página de configuração, conforme descrito na seção anterior. Você pode selecionar outro DCR para a VM ou criar um novo. Você não pode modificar o DCR existente a partir desta página.

Próximas etapas

Para saber como usar o recurso monitoramento de desempenho, consulte Exibir desempenho do VM Insights. Para ver as dependências de aplicativos descobertas, confira Exibir o Mapa do VM Insights.