Questo articolo descrive i diversi metodi che è possibile usare per installare, disinstallare, aggiornare e configurare l'agente di Monitoraggio di Azure in macchine virtuali di Azure, set di scalabilità di macchine virtuali e server abilitati per Azure Arc.
Prerequisiti
Per i prerequisiti e altri requisiti per l'uso dell'agente di Monitoraggio di Azure, vedere questi articoli:
Importante
L'installazione, l'aggiornamento o la disinstallazione dell'agente di Monitoraggio di Azure non richiede un riavvio del computer.
Opzioni di installazione
La tabella seguente elenca le opzioni per l'installazione dell'agente di Monitoraggio di Azure in macchine virtuali di Azure e nei server abilitati per Azure Arc.
Per qualsiasi computer che non si trova in Azure, l'agente di Azure Arc deve essere installato nel computer prima di poter installare l'agente di Monitoraggio di Azure.
| Metodo di installazione |
Descrizione |
| Estensione macchina virtuale |
Usare uno dei metodi descritti in questo articolo per installare l'agente tramite il framework di estensione di Azure. Questo metodo non crea un DCR, quindi è necessario crearne almeno uno e associarlo all'agente prima dell'inizio della raccolta dati. |
| Creare una DCR |
Quando si crea un Data Collection Rule (DCR) nel portale di Azure, l'Azure Monitor Agent viene installato su qualsiasi macchina aggiunta come risorsa per il DCR. L'agente inizia immediatamente a raccogliere i dati come definito nella Regola di Raccolta Dati. |
| Informazioni dettagliate macchina virtuale |
Quando si abilitano le informazioni dettagliate sulle macchine virtuali in un computer, viene installato l'agente di Monitoraggio di Azure e viene creato un record di dominio per raccogliere un set predefinito di dati. Non è consigliabile modificare questo DCR, ma è possibile creare DCR addizionali per raccogliere altri dati. |
| Informazioni dettagliate sui container |
Quando si abilitaNo informazioni dettagliate sui contenitori in un cluster Kubernetes, viene installata una versione in contenitori dell'agente di Monitoraggio di Azure nel cluster e viene creato un DCR per iniziare immediatamente la raccolta dei dati. È possibile modificare la DCR utilizzando le linee guida contenute in Configurare la raccolta dati e l'ottimizzazione dei costi in Informazioni dettagliate contenitore utilizzando le DCR. |
| Programma di installazione client |
Installare l'agente usando un programma di installazione MSI di Windows per i client Windows 11 e Windows 10. |
| Criteri di Azure |
Usare Azure Policy per installare automaticamente l'agente nelle macchine virtuali di Azure e nei server abilitati per Azure Arc, e per associarli automaticamente alle regole di raccolta dati (DCR) richieste. |
Nota
Per inviare dati tra tenant, è necessario abilitare prima Azure Lighthouse.
La clonazione di un computer in cui è installato l'agente di Monitoraggio di Azure non è supportata. La procedura consigliata per questo scenario consiste nell'usare Criteri di Azure o uno strumento di infrastruttura come codice (IaaC) per distribuire l'agente di Monitoraggio di Azure su larga scala.
Installare l'estensione dell'agente
Per installare l'agente e creare un DCR per raccogliere i dati usando il portale di Azure, usare le indicazioni in Raccogliere dati usando l'agente di Monitoraggio di Azure.
È possibile installare l'agente di Monitoraggio di Azure in una macchina virtuale di Azure o in un server abilitato per Azure Arc usando il comando PowerShell per aggiungere un'estensione macchina virtuale.
Macchine virtuali di Azure
Usare i comandi di PowerShell seguenti per installare l'agente di Monitoraggio di Azure in una macchina virtuale di Azure. Scegliere il comando appropriato in base al metodo di autenticazione usato.
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
Set di scalabilità di macchine virtuali di Azure
Usare il cmdlet di PowerShell Add-AzVmssExtension per installare l'agente di Monitoraggio di Azure in un set di scalabilità di macchine virtuali di Azure.
Server con abilitazione di Azure Arc
Usare i comandi di PowerShell seguenti per installare l'agente di Monitoraggio di Azure in un server abilitato per 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
È possibile installare l'agente di Monitoraggio di Azure in una macchina virtuale di Azure o in un server abilitato per Azure Arc usando il comando dell'interfaccia della riga di comando di Azure per aggiungere un'estensione macchina virtuale.
Macchine virtuali di Azure
Usare i comandi seguenti dell'interfaccia della riga di comando di Azure per installare l'agente di Monitoraggio di Azure in una macchina virtuale di Azure. Scegliere il comando appropriato in base al metodo di autenticazione usato.
Identità gestita assegnata dall'utente
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>"}}}'
Identità gestita assegnata dal 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
Set di scalabilità di macchine virtuali di Azure
Usare il cmdlet dell'interfaccia della riga di comando di Azure az vmss extension set per installare l'agente di Monitoraggio di Azure in un set di scalabilità di macchine virtuali di Azure.
Server con abilitazione di Azure Arc
Usare i comandi seguenti dell'interfaccia della riga di comando di Azure per installare l'agente di Monitoraggio di Azure in un server abilitato per 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
È possibile usare un modello di Azure Resource Manager per installare l'agente di Monitoraggio di Azure in una macchina virtuale di Azure o in un server abilitato per Azure Arc e per creare un'associazione con controller di dominio. Prima di creare l'associazione per la DCR, è necessario creare una DCR.
Ottenere modelli di esempio per installare l'agente e creare l'associazione dalle risorse seguenti:
Installare i modelli usando qualsiasi metodo di distribuzione per i modelli di Resource Manager, inclusi i comandi seguenti.
PowerShell
New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
Interfaccia della riga di comando di Azure
az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
Disinstallare
Per disinstallare l'agente di Monitoraggio di Azure usando il portale di Azure, andare alla macchina virtuale, al set di scalabilità o al server abilitato per Azure Arc. Selezionare la scheda Estensioni e quindi selezionare AzureMonitorWindowsAgent o AzureMonitorLinuxAgent. Nella finestra di dialogo visualizzata selezionare Disinstalla.
Disinstallare su una macchina virtuale di Azure
Usare i comandi di PowerShell seguenti per disinstallare l'agente di Monitoraggio di Azure in una macchina virtuale di 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>
Disinstallare in un set di scalabilità di macchine virtuali di Azure
Usare il cmdlet di PowerShell Remove-AzVmssExtension per disinstallare l'agente di Monitoraggio di Azure in un set di scalabilità di macchine virtuali di Azure.
Disinstallare in un server abilitato per Azure Arc
Usare i comandi di PowerShell seguenti per disinstallare l'agente di Monitoraggio di Azure in un server abilitato per 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
Disinstallare su una macchina virtuale di Azure
Usare i comandi seguenti dell'interfaccia della riga di comando di Azure per disinstallare l'agente di Monitoraggio di Azure in una macchina virtuale di 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
Disinstallare in un set di scalabilità di macchine virtuali di Azure
Usare il cmdlet dell'interfaccia della riga di comando di Azure az vmss extension delete per disinstallare l'agente di Monitoraggio di Azure in un set di scalabilità di macchine virtuali di Azure.
Disinstallare in un server abilitato per Azure Arc
Usare i comandi seguenti dell'interfaccia della riga di comando di Azure per disinstallare l'agente di Monitoraggio di Azure in un server abilitato per 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>
Aggiornamento
Nota
È consigliabile eseguire sempre l'aggiornamento alla versione più recente dell'agente o acconsentire esplicitamente all'aggiornamento automatico dell'estensione.
L'implementazione automatica delle estensioni segue le procedure di distribuzione standard di Azure per distribuire in modo sicuro la versione più recente dell'agente. È consigliabile che gli aggiornamenti automatici debbano richiedere settimane per implementare la versione più recente.
Gli aggiornamenti vengono rilasciati in batch, quindi alcune macchine virtuali, set di scalabilità o server abilitati per Azure Arc potrebbero essere aggiornate prima di altre.
Se è necessario aggiornare immediatamente un'estensione, è possibile usare le istruzioni manuali descritte in questo articolo. Sono supportati solo gli agenti rilasciati nell'anno precedente.
Per eseguire un aggiornamento monouso dell'agente, è prima necessario disinstallare la versione dell'agente esistente. Installare quindi la nuova versione come descritto.
È consigliabile abilitare l'aggiornamento automatico dell'agente abilitando l'aggiornamento automatico dell'estensione. Passare alla macchina virtuale o al set di scalabilità, selezionare la scheda Estensioni e quindi selezionare AzureMonitorWindowsAgent o AzureMonitorLinuxAgent. Nella finestra di dialogo visualizzata selezionare Abilita aggiornamento automatico.
Aggiornamento delle macchine virtuali di Azure
Per eseguire un aggiornamento monouso dell'agente, installare la nuova versione come descritto.
È consigliabile abilitare l'aggiornamento automatico dell'agente abilitando la funzionalità Aggiornamento automatico dell'estensione.
Usare i comandi di PowerShell seguenti:
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
Aggiornare nei server abilitati per Azure Arc
Per eseguire un aggiornamento monouso dell'agente, usare i comandi di PowerShell seguenti:
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
È consigliabile abilitare l'aggiornamento automatico dell'agente acconsentendo esplicitamente all'aggiornamento automatico dell'estensione.
Usare i comandi di PowerShell seguenti:
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
Aggiornamento delle macchine virtuali di Azure
Per eseguire un aggiornamento monouso dell'agente, è prima necessario disinstallare la versione dell'agente esistente. Installare quindi la nuova versione come descritto in questo articolo.
È consigliabile abilitare l'aggiornamento automatico dell'agente selezionando la funzionalità di aggiornamento automatico dell'estensione usando i seguenti comandi dell'interfaccia della riga di comando di 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
Aggiornare nei server abilitati per Azure Arc
Per eseguire un aggiornamento monouso dell'agente, usare i comandi seguenti dell'interfaccia della riga di comando di 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>
È consigliabile abilitare l'aggiornamento automatico dell'agente abilitando la funzionalità Aggiornamento automatico dell'estensione.
Usare i comandi seguenti dell'interfaccia della riga di comando di 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
Le regole di raccolta dati (DCR) fungono da strumento di gestione per l'agente di Monitoraggio di Azure nel computer. AgentSettings DCR può essere usato per configurare determinati parametri dell'agente di Monitoraggio di Azure per configurare l'agente in base alle esigenze di monitoraggio specifiche.
Nota
Considerazioni importanti quando si lavora con la DCR AgentSettings:
- Attualmente, AgentSettings DCR può essere configurato solo usando un modello di Azure Resource Manager.
- AgentSettings deve essere un singolo DCR senza altre impostazioni.
- La macchina virtuale e il DCR di AgentSettings devono trovarsi nella stessa regione.
Parametri supportati
AgentSettings DCR supporta attualmente l'impostazione dei parametri seguenti:
| Parametro |
Descrizione |
Valori validi |
MaxDiskQuotaInMB |
Per garantire la resilienza, l'agente raccoglie i dati in una cache locale quando l'agente non può inviare dati. L'agente invia i dati nella cache dopo il ripristino della connessione. Questo parametro è la quantità di spazio su disco usata (in MB) dai file di log e dalla cache dell'agente di Monitoraggio di Azure. |
Linux: da 4,000 a 1,000,000
Windows: da 4000 a 1,000,000 |
UseTimeReceivedForForwardedEvents |
Modifica la colonna WEF nella tabella di Windows Event Forwarding (WEF) di Microsoft Sentinel per utilizzare TimeReceived invece dei dati di TimeGenerated. |
0 oppure 1 |
Configurare la DCR di AgentSettings
Attualmente non supportato.
Attualmente non supportato.
Attualmente non supportato.
Preparare l'ambiente installando l'agente di Monitoraggio di Azure nella macchina virtuale.
Crea un DCR.
Questo esempio imposta la quantità massima di spazio su disco usata dalla cache dell'agente di Monitoraggio di Azure su 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"
}
]
}
Associare il DCR alla macchina. Usare i file di Resource Manager seguenti.
File modello:
{
"$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')]"
}
}
]
}
File di parametri:
{
"$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"
}
}
}
Per applicare le modifiche, riavviare l'agente di Monitoraggio di Azure.
Contenuto correlato
Creare una regola di raccolta dati per raccogliere dati dall'agente e inviarli a Monitoraggio di Azure.