Este artigo descreve diferentes métodos que pode utilizar para instalar, desinstalar, atualizar e configurar o Agente do Azure Monitor em máquinas virtuais do Azure, conjuntos de escalamento de máquinas virtuais e servidores habilitados para o Azure Arc.
Pré-requisitos
Para obter pré-requisitos e outros requisitos para usar o Azure Monitor Agent, consulte estes artigos:
Importante
Instalar, atualizar ou desinstalar o Azure Monitor Agent não requer uma reinicialização da máquina.
Opções de instalação
A tabela a seguir lista as opções para instalar o Azure Monitor Agent em VMs do Azure e servidores habilitados para Azure Arc.
Para qualquer máquina que não esteja no Azure, o agente do Azure Arc deve ser instalado na máquina antes que o Azure Monitor Agent possa ser instalado.
| Método de instalação |
Descrição |
| Extensão de máquina virtual (VM) |
Use qualquer um dos métodos descritos neste artigo para instalar o agente por meio da estrutura de extensão do Azure. Esse método não cria um DCR, portanto, você deve criar pelo menos um DCR e associá-lo ao agente antes que a coleta de dados comece. |
|
Criar uma DCR |
Quando você cria um DCR no portal do Azure, o Azure Monitor Agent é instalado em qualquer máquina adicionada como um recurso para o DCR. O agente começa imediatamente a coletar dados conforme definido no DCR. |
|
Informações sobre VM |
Quando você habilita insights de VM em uma máquina, o Azure Monitor Agent é instalado e um DCR é criado para coletar um conjunto predefinido de dados. Você não deve modificar esse DCR, mas pode criar mais DCRs para coletar mais dados. |
|
Informações sobre contêineres |
Quando você habilita a coleta de métricas Prometheus ou logs de contêiner em um cluster Kubernetes, uma versão conteinerizada do Agente do Azure Monitor é instalada no cluster e um DCR é criado para começar imediatamente a coletar dados. Você pode modificar o DCR usando as orientações em Configurar a recolha de dados e otimização de custos em Insights de Contentores usando DCRs. |
|
Instalador do cliente |
Instale o agente usando um instalador MSI do Windows para clientes Windows 11 e Windows 10. |
|
Política do Azure |
Use a Política do Azure para instalar automaticamente o agente em máquinas virtuais do Azure e servidores habilitados para Azure Arc e associá-los automaticamente aos DCRs necessários. |
Nota
Para enviar dados entre locatários, você deve primeiro habilitar o Azure Lighthouse.
Não há suporte para clonagem de uma máquina que tenha o Azure Monitor Agent instalado. A prática recomendada para esse cenário é usar a Política do Azure ou uma infraestrutura como uma ferramenta de código (IaaC) para implantar o Agente do Azure Monitor em escala.
Instalar a extensão do agente
Você pode instalar o Azure Monitor Agent em uma máquina virtual do Azure ou em um servidor habilitado para Azure Arc usando o comando PowerShell para adicionar uma extensão de máquina virtual.
Máquinas virtuais do Azure
Use os seguintes comandos do PowerShell para instalar o Azure Monitor Agent em uma máquina virtual do Azure. Escolha o comando apropriado com base no método de autenticação usado.
Windows
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <___location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"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>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <___location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Linux
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <___location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"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>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <___location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Conjunto de dimensionamento de máquina virtual do Azure
Use o cmdlet Add-AzVmssExtension PowerShell para instalar o Azure Monitor Agent em um conjunto de escala de máquina virtual do Azure.
Servidores compatíveis com o Azure Arc
Use os seguintes comandos do PowerShell para instalar o Azure Monitor Agent em um servidor habilitado para Azure Arc:
Windows
New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-___location> -EnableAutomaticUpgrade
Linux
New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-___location> -EnableAutomaticUpgrade
Você pode instalar o Agente do Azure Monitor em uma máquina virtual do Azure ou em um servidor habilitado para Azure Arc usando o comando CLI do Azure para adicionar uma extensão de máquina virtual.
Máquinas virtuais do Azure
Use os seguintes comandos da CLI do Azure para instalar o Azure Monitor Agent em uma máquina virtual do Azure. Escolha o comando apropriado com base no método de autenticação usado.
Identidade gerida atribuída pelo utilizador
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 escalonamento de máquinas virtuais do Azure
Use o cmdlet Azure CLI az vmss extension set para instalar o Azure Monitor Agent num conjunto de escalonamento de máquinas virtuais do Azure.
Servidores compatíveis com o Azure Arc
Use os seguintes comandos da CLI do Azure para instalar o Azure Monitor Agent em um servidor habilitado para Azure Arc:
Windows
az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --___location <arc-server-___location> --enable-auto-upgrade true
Linux
az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --___location <arc-server-___location> --enable-auto-upgrade true
Você pode usar um modelo do Azure Resource Manager para instalar o Azure Monitor Agent em uma máquina virtual do Azure ou em um servidor habilitado para Azure Arc e para criar uma associação com DCRs. Você deve criar qualquer DCR antes de criar a associação para o DCR.
Obtenha modelos de exemplo para instalar o agente e criar a associação a partir dos seguintes recursos:
Instale os modelos usando qualquer método de implantação para modelos do Gerenciador de Recursos, incluindo os comandos a seguir.
PowerShell
New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
CLI do Azure
az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
Desinstalar
Para desinstalar o Azure Monitor Agent usando o portal do Azure, vá para sua máquina virtual, conjunto de escala ou servidor habilitado para Azure Arc. Selecione a guia Extensões e, em seguida, selecione AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Na caixa de diálogo que se abre, selecione Desinstalar.
Desinstalar em uma máquina virtual do Azure
Use os seguintes comandos do PowerShell para desinstalar o Agente do Azure Monitor em uma máquina virtual do Azure:
Windows
Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Linux
Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Desinstalar num conjunto de dimensionamento de máquinas virtuais do Azure
Use o cmdlet Remove-AzVmssExtension PowerShell para desinstalar o Agente do Azure Monitor em um conjunto de escala de máquina virtual do Azure.
Desinstalar em um servidor habilitado para Azure Arc
Use os seguintes comandos do PowerShell para desinstalar o Azure Monitor Agent em um servidor habilitado para Azure Arc:
Windows
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
Linux
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
Desinstalar em uma máquina virtual do Azure
Use os seguintes comandos da CLI do Azure para desinstalar o Azure Monitor Agent em uma máquina virtual 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 em um conjunto de máquinas virtuais do Azure com escalonamento automático
Use a extensão az vmss delete Azure CLI cmdlet para desinstalar o Azure Monitor Agent em um conjunto de escala de máquina virtual do Azure.
Desinstalar em um servidor habilitado para Azure Arc
Use os seguintes comandos da CLI do Azure para desinstalar o Azure Monitor Agent em um servidor habilitado 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>
Atualizar
Nota
É altamente recomendável que você sempre atualize para a versão mais recente do agente ou opte pela atualização automática da extensão.
A distribuição automática de extensões segue as práticas padrão de implantação do Azure para implantar com segurança a versão mais recente do agente. Você deve esperar que as atualizações automáticas levem semanas para lançar a versão mais recente.
As atualizações são emitidas em lotes, portanto, algumas de suas máquinas virtuais, conjuntos de escala ou servidores habilitados para Azure Arc podem ser atualizados antes de outros.
Se você precisar atualizar uma extensão imediatamente, você pode usar as instruções manuais descritas neste artigo. Apenas agentes lançados no ano passado são suportados.
Para fazer uma atualização única do agente, você deve primeiro desinstalar a versão existente do agente. Em seguida, instale a nova versão conforme descrito.
Recomendamos que você habilite a atualização automática do agente habilitando a atualização automática de extensão. Vá para sua máquina virtual ou conjunto de escala, selecione a guia Extensões e, em seguida, selecione AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Na caixa de diálogo que se abre, selecione Ativar atualização automática.
Atualização em máquinas virtuais do Azure
Para fazer uma atualização única do agente, instale a nova versão conforme descrito.
Recomendamos que você habilite a atualização automática do agente optando pela atualização automática da extensão.
Use os seguintes comandos do PowerShell:
Windows
Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <___location> -EnableAutomaticUpgrade $true
Linux
Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <___location> -EnableAutomaticUpgrade $true
Atualização em servidores habilitados para Azure Arc
Para fazer uma atualização única do agente, use os seguintes comandos do PowerShell:
Windows
$target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Linux
$target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Recomendamos que você habilite a atualização automática do agente aceitando a atualização automática da extensão.
Use os seguintes comandos do PowerShell:
Windows
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
Linux
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
Atualização em máquinas virtuais do Azure
Para fazer uma atualização única do agente, você deve primeiro desinstalar a versão existente do agente. Em seguida, instale a nova versão conforme descrito neste artigo.
Recomendamos que você habilite a atualização automática do agente aceitando o recurso de atualização automática de extensão usando os seguintes comandos da CLI do Azure:
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
Atualização em servidores habilitados para Azure Arc
Para fazer uma atualização única do agente, use os seguintes comandos da CLI do Azure:
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>
Recomendamos que você habilite a atualização automática do agente optando pela atualização automática da extensão.
Use os seguintes comandos da CLI do Azure:
Windows
az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
As regras de coleta de dados (DCRs) servem como uma ferramenta de gerenciamento para o Agente do Azure Monitor em sua máquina. O DCR AgentSettings pode ser usado para configurar determinados parâmetros do Azure Monitor Agent para configurar o agente de acordo com suas necessidades específicas de monitoramento.
Nota
Considerações importantes quando você trabalha com o DCR AgentSettings:
- Atualmente, o DCR AgentSettings só pode ser configurado usando um modelo do Azure Resource Manager.
- AgentSettings deve ser um único DCR sem outras configurações.
- A máquina virtual e o DCR AgentSettings devem estar na mesma região.
Parâmetros suportados
Atualmente, o DCR AgentSettings oferece suporte à configuração dos seguintes parâmetros:
| Parâmetro |
Descrição |
Valores válidos |
MaxDiskQuotaInMB |
Para fornecer resiliência, o agente coleta dados em um cache local quando não pode enviar dados. O agente envia os dados no cache depois que a conexão é restaurada. Este parâmetro é a quantidade de espaço em disco usada (em MB) pelos arquivos de log e cache do Agente do Azure Monitor. |
Linux: 4,000 para 1,000,000 default: 10,000
Windows: 4,000 até 1,000,000 |
UseTimeReceivedForForwardedEvents |
Altera a coluna WEF na tabela Microsoft Sentinel Windows Event Forwarding (WEF) para usar TimeReceived em vez de TimeGenerated dados |
0 ou 1 |
Configurar as Definições do Agente DCR
Não é atualmente suportado.
Não é atualmente suportado.
Não é atualmente suportado.
Prepare o ambiente instalando o Azure Monitor Agent em sua VM.
Crie um DCR.
Este exemplo define a quantidade máxima de espaço em disco usada pelo cache do Azure Monitor Agent como 5.000 MB.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRules",
"name": "dcr-contoso-01",
"apiVersion": "2023-03-11",
"properties":
{
"description": "A simple agent settings",
"agentSettings":
{
"logs": [
{
"name": "MaxDiskQuotaInMB",
"value": "5000"
}
]
}
},
"kind": "AgentSettings",
"___location": "eastus"
}
]
}
Associe o DCR à sua máquina. Use os seguintes arquivos do Gerenciador de Recursos.
Arquivo de modelo:
{
"$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')]"
}
}
]
}
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"
},
"dataCollectionRuleId": {
"value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
}
}
}
Para aplicar as alterações, reinicie o Azure Monitor Agent.
Conteúdos relacionados
Crie uma regra de coleta de dados para coletar dados do agente e enviá-los para o Azure Monitor.