Este artigo descreve os diferentes métodos que você pode usar para instalar, desinstalar, atualizar e configurar o Agente do Azure Monitor em máquinas virtuais do Azure, conjuntos de dimensionamento de máquinas virtuais e servidores habilitados para Azure Arc.
Pré-requisitos
Para obter informações sobre os pré-requisitos e outros requisitos para usar o Agente do Azure Monitor, confira estes artigos:
Importante
A instalação, atualização ou desinstalação do Agente do Azure Monitor não exige a reinicialização do computador.
Opções de instalação
A tabela a seguir lista as opções para instalar o Agente do Azure Monitor em VMs do Azure e servidores habilitados para Azure Arc.
Para qualquer computador que não esteja no Azure, o Agente do Azure Arc deve ser instalado no computador antes que o Agente do Azure Monitor 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 uma DCR, portanto, você deve criar pelo menos uma DCR e associá-la ao agente antes que a coleta de dados comece. |
|
Criar um DCR |
Quando você cria uma DCR no portal do Azure, o Agente do Azure Monitor é instalado em qualquer computador adicionado como recurso da DCR. O agente começa imediatamente a coletar dados conforme definido na DCR. |
|
Insights da VM |
Quando você habilita os insights da VM em um computador, o Agente do Azure Monitor é instalado e uma DCR é criada para coletar um conjunto predefinido de dados. Você não deve modificar essa DCR, mas pode criar mais DCRs para coletar mais dados. |
|
Insights do contêiner |
Quando você habilita a coleta de métricas do Prometheus ou logs de contêiner em um cluster do Kubernetes, uma versão em contêineres do Agente do Azure Monitor é instalada no cluster e um DCR é criado para começar imediatamente a coletar dados. Você pode modificar a DCR usando as diretrizes em Configurar a coleta de dados e a otimização de custos nos insights de contêiner usando DCRs. |
|
Instalador do cliente |
Instale o agente usando um Instalador MSI do Windows para clientes do Windows 11 e Windows 10. |
|
Azure Policy |
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 obrigatórias. |
Observação
Para enviar dados entre locatários, primeiro você deve habilitar o Azure Lighthouse.
A clonagem de um computador com o Agente do Azure Monitor instalado não tem suporte. A melhor prática para esse cenário é usar o Azure Policy ou uma ferramenta de infraestrutura como código (IaaC) para implantar o Agente do Azure Monitor em escala.
Instalar a extensão do agente
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 do PowerShell para adicionar uma extensão de máquina virtual.
Máquinas virtuais do Azure
Use os seguintes comandos do PowerShell para instalar o Agente do Azure Monitor em uma máquina virtual do Azure. Escolha o comando apropriado com base no método de autenticação que você usa.
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áquinas virtuais do Azure
Use o cmdlet do PowerShell Add-AzVmssExtension para instalar o Agente do Azure Monitor em um conjunto de dimensionamento de máquinas virtuais do Azure.
Servidores habilitados para Azure Arc
Use os seguintes comandos do PowerShell para instalar o Agente do Azure Monitor 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 da 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 Agente do Azure Monitor em uma máquina virtual do Azure. Escolha o comando apropriado com base no método de autenticação que você usa.
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 do Azure az vmss extension set para instalar o Agente do Azure Monitor em um conjunto de dimensionamento de máquinas virtuais do Azure.
Servidores habilitados para Azure Arc
Use os seguintes comandos da CLI do Azure para instalar o Agente do Azure Monitor 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 Agente do Azure Monitor em uma máquina virtual do Azure ou em um servidor habilitado para Azure Arc e 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 nos seguintes recursos:
Instale os modelos usando qualquer método de implantação para modelos do Resource Manager, incluindo os seguintes comandos.
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 Agente do Azure Monitor usando o portal do Azure, acesse sua máquina virtual, conjunto de dimensionamento ou servidor habilitado para Azure Arc. Selecione a guia Extensões e, em seguida, selecione AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Na caixa de diálogo que é aberta, 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 em um conjunto de dimensionamento de máquinas virtuais do Azure
Use o cmdlet do PowerShell Remove-AzVmssExtension para desinstalar o Agente do Azure Monitor em um conjunto de dimensionamento de máquinas virtuais do Azure.
Desinstalar em um servidor habilitado para Azure Arc
Use os seguintes comandos do PowerShell para desinstalar o Agente do Azure Monitor 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 Agente do Azure Monitor 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 dimensionamento de máquinas virtuais do Azure
Use o cmdlet da CLI do Azure az vmss extension delete para desinstalar o Agente do Azure Monitor em um conjunto de dimensionamento de máquinas virtuais do Azure.
Desinstalar em um servidor habilitado para Azure Arc
Use os seguintes comandos da CLI do Azure para desinstalar o Agente do Azure Monitor 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
Observação
Recomendamos enfaticamente que você sempre atualize para a versão mais recente do agente ou aceite a atualização automática da extensão.
A implementação automática de extensão segue as práticas de implantação padrão do Azure para implantar com segurança a versão mais recente do agente. Espere que as atualizações automáticas levem semanas para implantar a versão mais recente.
As atualizações são emitidas em lotes, portanto, algumas de suas máquinas virtuais, conjuntos de dimensionamento ou servidores habilitados para Azure Arc podem ser atualizados antes dos outros.
Se precisar atualizar uma extensão imediatamente, você poderá usar as instruções manuais descritas nesse artigo. Somente agentes lançados no último ano têm suporte.
Para fazer uma atualização única do agente, você deve primeiro desinstalar a versão existente do agente. Depois, instale a nova versão, conforme a descrição.
Recomendamos que você habilite a atualização automática do agente habilitando a atualização automática da extensão. Acesse sua máquina virtual ou conjunto de dimensionamento, selecione a guia Extensões e, em seguida, selecione AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Na caixa de diálogo exibida, clique em Habilitar atualização automática.
Atualizar 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 aceitando a 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
Atualizar em servidores habilitados para o 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
Atualizar 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 nesse artigo.
Recomendamos que você habilite a atualização automática do agente aceitando o recurso atualização automática da 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
Atualizar em servidores habilitados para o 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 aceitando a 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 no seu computador. A DCR AgentSettings pode ser usada para configurar determinados parâmetros do Agente do Azure Monitor para configurar o agente de acordo com suas necessidades específicas de monitoramento.
Observação
Considerações importantes ao trabalhar com a DCR AgentSettings:
- Atualmente, a DCR AgentSettings pode ser configurada somente por meio de um modelo do Azure Resource Manager.
- AgentSettings deve ser uma única DCR sem outras configurações.
- A máquina virtual e a DCR AgentSettings devem estar na mesma região.
Parâmetros com suporte
Atualmente, a DCR AgentSettings dá suporte à definiçã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 é possível enviar dados. O agente envia os dados armazenados em cache após a restauração da conexão. Esse 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 a 1,000,000 default: 10,000 Windows: 4,000 a 1,000,000 |
UseTimeReceivedForForwardedEvents |
Altera a coluna WEF na tabela de Encaminhamento de Eventos do Windows (WEF) do Microsoft Sentinel para usar TimeReceived em vez de TimeGenerated dados |
0 ou 1 |
Configurar a DCR AgentSettings
Prepare o ambiente instalando o Agente do Azure Monitor na sua VM.
Criar uma DCR.
Esse exemplo define a quantidade máxima de espaço em disco usada pelo cache do Agente do Azure Monitor 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 a DCR ao seu computador. Use os seguintes arquivos do Resource Manager.
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âmetro:
{
"$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 Agente do Azure Monitor.
Conteúdo relacionado
Crie uma regra de coleta de dados para coletar dados do agente e enviá-los ao Azure Monitor.