Este artigo detalha os diferentes métodos para instalar, desinstalar, atualizar e configurar o Agente do Azure Monitor em máquinas virtuais do Azure, conjuntos de dimensionamento e servidores habilitados para Azure Arc.
Importante
Depois de ter sido instalado no computador cliente, o Agente do Azure Monitor requer pelo menos uma DCR (regra de coleta de dados) para começar a coletar dados. Dependendo do método de instalação usado, uma DCR pode ou não ser criada automaticamente. Caso contrário, você precisará configurar a coleta de dados seguindo as diretrizes em Coletar dados com o Agente do Azure Monitor.
Pré-requisitos
Consulte os seguintes artigos para descobrir os pré-requisitos e outros requisitos do Agente do Azure Monitor:
Não será preciso reiniciar o computador após a instalação, atualização ou desinstalação do Agente do Azure Monitor.
Opções de instalação
A tabela a seguir lista as diferentes opções para instalar o Agente do Azure Monitor em VMs do Azure e em servidores habilitados para Azure Arc. O agente do Azure Arc deve ser instalado em qualquer computador que não esteja no Azure antes que o Agente do Azure Monitor possa ser instalado.
Método de instalação
Descrição
Extensão de VM
Use qualquer um dos métodos abaixo para usar a estrutura de extensão do Azure para instalar o agente. Esse método não cria uma DCR, portanto, você deve criar pelo menos uma e associá-la ao agente antes que a coleta de dados comece.
Ao criar uma DCR no portal do Azure, o Agente do Azure Monitor é instalado em todos os computadores adicionados como recursos para a DCR. O agente começará a coletar dados definidos na DCR imediatamente.
Ao habilitar os insights da VM em um computador, o Agente do Azure Monitor será instalado, e será criada uma DCR que coleta um conjunto predefinido de dados. Você não deve modificar essa DCR, mas pode criar DCRs adicionais para coletar outros dados.
Use o Azure Policy para instalar automaticamente o agente em máquinas virtuais do Azure e servidores habilitados para Azure Arc e associá-los automaticamente às DCRs necessárias.
Observação
Para enviar dados entre locatários, primeiro você deve habilitar o Azure Lighthouse.
Não há suporte para a clonagem de um computador com o agente do Azure Monitor (AMA) instalado. A melhor prática para essas situações é usar o Azure Policy ou uma Infraestrutura como uma ferramenta de código para implantar o AMA em escala.
Instalar a extensão do agente
Esta seção fornece detalhes sobre como instalar o Agente do Azure Monitor usando a extensão da VM.
Você pode instalar o Agente do Azure Monitor em máquinas virtuais do Azure e em servidores habilitados para Azure Arc usando o comando do PowerShell para adicionar uma extensão de máquina virtual.
Máquinas virtuais do Azure
Use os comandos do PowerShell a seguir para instalar o Agente do Azure Monitor em máquinas virtuais do Azure. Escolha o comando apropriado com base no método de autenticação escolhido.
Você pode instalar o Agente do Azure Monitor em máquinas virtuais do Azure e em servidores habilitados para Azure Arc usando o comando da CLI do Azure para adicionar uma extensão de máquina virtual.
Máquinas virtuais do Azure
Use os comandos da CLI a seguir para instalar o Agente do Azure Monitor em máquinas virtuais do Azure. Escolha o comando apropriado com base no método de autenticação escolhido.
Identidade gerenciada atribuída pelo usuário
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Identidade gerenciada atribuída pelo sistema
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Conjunto de dimensionamento de máquinas virtuais do Azure
Use o cmdlet da CLI az vmss extension set para instalar o Agente do Azure Monitor nos conjuntos de dimensionamento de máquinas virtuais do Azure.
Servidores habilitados para Azure Arc
Use os comandos da CLI a seguir para instalar o Agente do Azure Monitor em servidores habilitados para Azure Arc.
Você pode usar modelos do Resource Manager para instalar o Agente do Azure Monitor em máquinas virtuais do Azure e em servidores habilitados para o Azure Arc e para criar uma associação com regras de coleta de dados. Você precisa criar qualquer regra de coleta de dados antes de criar a associação.
Obtenha modelos de exemplo para instalar o agente e criar a associação com os seguintes recursos:
Para desinstalar o Agente do Azure Monitor usando o portal do Azure, acesse a máquina virtual, o conjunto de dimensionamento ou o servidor habilitado para Azure Arc. Selecione a guia Extensões e escolha AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Na caixa de diálogo que é aberta, selecione Desinstalar.
Desinstalar em máquinas virtuais do Azure
Use os comandos do PowerShell a seguir para desinstalar o Agente do Azure Monitor em máquinas virtuais do Azure.
Desinstalar no conjunto de dimensionamento de máquinas virtuais do Azure
Use o cmdlet do PowerShell Remove-AzVmssExtension para desinstalar o Agente do Azure Monitor em conjuntos de dimensionamento de máquinas virtuais do Azure.
Desinstalar em servidores habilitados para o Azure Arc
Use os comandos do PowerShell a seguir para desinstalar o Agente do Azure Monitor em servidores habilitados para Azure Arc.
Use os comandos da CLI a seguir para desinstalar o Agente do Azure Monitor em máquinas virtuais do Azure.
Windows
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
Linux
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
Desinstalar no conjunto de dimensionamento de máquinas virtuais do Azure
Use o cmdlet da CLI az vmss extension delete para desinstalar o Agente do Azure Monitor nos conjuntos de dimensionamento de máquinas virtuais do Azure.
Desinstalar em servidores habilitados para o Azure Arc
Use os comandos da CLI a seguir para desinstalar o Agente do Azure Monitor em servidores habilitados para Azure Arc.
Windows
az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
N/D
Atualizar
Observação
A recomendação é habilitar a Atualização automática de extensão para atualizar as extensões instaladas para a versão estável em todas as regiões. Uma versão não é distribuída automaticamente até atender a um padrão de alta qualidade que pode levar até 5 semanas após a versão inicial. As atualizações são emitidas em lotes, portanto, você pode ver algumas de suas máquinas virtuais, conjuntos de dimensionamento ou servidores habilitados para Arc serem atualizados antes de outros. Se você precisar atualizar uma extensão imediatamente, poderá usar as instruções manuais abaixo.
Para executar uma atualização avulsa do agente, primeiro você precisa desinstalar a versão do agente existente. Depois, instale a nova versão, conforme a descrição.
A recomendação é habilitar a atualização automática do agente habilitando o recurso Atualização automática de extensão. Navegue até a máquina virtual ou o conjunto de dimensionamento, selecione a guia Extensões e clique em AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Na caixa de diálogo exibida, clique em Habilitar atualização automática.
Atualizar em máquinas virtuais do Azure
Para executar uma atualização única do agente, primeiro você deve desinstalar a versão do agente existente e instalar a nova versão, conforme descrito.
A recomendação é habilitar a atualização automática do agente habilitando o recurso Atualização automática de extensão usando os comandos do PowerShell a seguir.
A recomendação é habilitar a atualização automática do agente habilitando o recurso Atualização automática de extensão usando os comandos do PowerShell a seguir.
Para executar uma atualização única do agente, primeiro você deve desinstalar a versão do agente existente e instalar a nova versão, conforme descrito.
A recomendação é habilitar a atualização automática do agente habilitando o recurso Atualização automática de extensão usando os comandos da CLI a seguir.
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Atualizar em servidores habilitados para o Azure Arc
Para executar uma atualização avulsa do agente, use os comandos da CLI a seguir.
Windows
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
A recomendação é habilitar a atualização automática do agente habilitando o recurso Atualização automática de extensão usando os comandos do PowerShell a seguir.
As DCRs (Regras de coleta de dados) atuam como uma ferramenta de gerenciamento para o AMA (Agente do Azure Monitor) no seu computador. O AgentSettingsDCR pode ser usado para configurar determinados parâmetros do AMA para ajustar o agente às suas necessidades específicas de monitoramento.
Observação
Considerações importantes a serem lembradas ao trabalhar com o AgentSettings DCR:
Atualmente, o AgentSettings DCR só pode ser configurado usando modelos do ARM.
AgentSettings deve ser um único DCR sem outras configurações.
A máquina virtual e o AgentSettings DCR devem estar localizados na mesma região.
Parâmetros com suporte
Atualmente, a DCR do AgentSettings dá suporte à configuração dos seguintes parâmetros:
Parâmetro
Descrição
Valores válidos
MaxDiskQuotaInMB
Define a quantidade de espaço em disco usada (em MB) pelos arquivos de log e cache do Agente do Azure Monitor.
Linux: 1025-51199 Windows: 4000-51199
UseTimeReceivedForForwardedEvents
Altera a coluna WEF na tabela WEF do Sentinel para usar dados TimeReceived em vez de TimeGenerated
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string",
"metadata": {
"description": "The name of the virtual machine."
}
},
"dataCollectionRuleId": {
"type": "string",
"metadata": {
"description": "The 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": "agentSettings",
"properties": {
"description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
"dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
}
}
]
}