Azure Monitor-agent installeren en beheren

In dit artikel worden de verschillende methoden beschreven voor het installeren, verwijderen, bijwerken en configureren van Azure Monitor Agent op virtuele Azure-machines, schaalsets en servers met Azure Arc.

Belangrijk

Azure Monitor Agent vereist ten minste één regel voor het verzamelen van gegevens (DCR) om gegevens te verzamelen nadat deze op de clientcomputer is geïnstalleerd. Afhankelijk van de installatiemethode die u gebruikt, kan een DCR al dan niet automatisch worden gemaakt. Zo niet, dan moet u gegevensverzameling configureren volgens de richtlijnen bij Gegevens verzamelen met Azure Monitor Agent.

Vereisten

Zie de volgende artikelen voor vereisten en andere vereisten voor Azure Monitor Agent:

• Ondersteunde besturingssystemen en omgevingen van Azure Monitor Agent
• Vereisten voor Azure Monitor-agent
• Netwerkconfiguratie van Azure Monitor Agent

Belangrijk

Voor het installeren, upgraden of verwijderen van de Azure Monitor-agent is geen computer opnieuw opgestart.

Installatieopties

De volgende tabel bevat de verschillende opties voor het installeren van Azure Monitor Agent op Azure-VM's en servers met Azure Arc. De Azure Arc-agent moet worden geïnstalleerd op computers die zich niet in Azure bevinden voordat De Azure Monitor-agent kan worden geïnstalleerd.

Installatiemethode	Beschrijving
VM-extensie	Gebruik een van de onderstaande methoden om het Azure-extensieframework te gebruiken om de agent te installeren. Met deze methode wordt geen DCR gemaakt, dus u moet ten minste één dcr maken en deze koppelen aan de agent voordat het verzamelen van gegevens begint.
Een DCR maken	Wanneer u een DCR maakt in Azure Portal, wordt De Azure Monitor-agent geïnstalleerd op computers die als resources voor de DCR worden toegevoegd. De agent begint onmiddellijk met het verzamelen van gegevens die in de DCR zijn gedefinieerd.
VM-inzichten	Wanneer u VM-inzichten op een machine inschakelt, wordt Azure Monitor Agent geïnstalleerd en wordt er een DCR gemaakt waarmee een vooraf gedefinieerde set gegevens wordt verzameld. U moet deze DCR niet wijzigen, maar u kunt extra DCR's maken om andere gegevens te verzamelen.
Containerinzichten	Wanneer u Container Insights inschakelt voor een Kubernetes-cluster, wordt er een containerversie van Azure Monitor Agent geïnstalleerd in het cluster en wordt er een DCR gemaakt die direct begint met het verzamelen van gegevens. U kunt deze DCR wijzigen met behulp van richtlijnen voor het configureren van gegevensverzameling en kostenoptimalisatie in Container Insights met behulp van een regel voor gegevensverzameling.
Clientinstallatieprogramma	Installeert de agent met behulp van een Windows MSI-installatieprogramma voor Windows 10- en Windows 11-clients.
Azure Policy	Gebruik Azure Policy om de agent automatisch te installeren op virtuele Azure-machines en servers met Azure Arc en deze automatisch te koppelen aan de vereiste DCR's.

Notitie

Als u gegevens wilt verzenden tussen tenants, moet u eerst Azure Lighthouse inschakelen. Het klonen van een machine waarop Azure Monitor Agent is geïnstalleerd, wordt niet ondersteund. De aanbevolen procedure voor deze situaties is om Azure Policy of een infrastructuur als codehulpprogramma te gebruiken om AMA op schaal te implementeren.

Agentextensie installeren

In deze sectie vindt u informatie over het installeren van De Azure Monitor-agent met behulp van de VM-extensie.

Portal

Gebruik de richtlijnen bij Gegevens verzamelen met Azure Monitor Agent om de agent te installeren met behulp van Azure Portal en een DCR te maken om gegevens te verzamelen.

PowerShell

U kunt Azure Monitor Agent installeren op virtuele Azure-machines en op servers met Azure Arc met behulp van de PowerShell-opdracht voor het toevoegen van een extensie voor virtuele machines.

Azure-VM's

Gebruik de volgende PowerShell-opdrachten om Azure Monitor Agent te installeren op virtuele Azure-machines. Kies de juiste opdracht op basis van de gekozen verificatiemethode.

• 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
  

Schaalset voor virtuele Azure-machines

Gebruik de PowerShell-cmdlet Add-AzVmssExtension om Azure Monitor Agent te installeren op virtuele-machinesschaalsets van Azure.

Servers met Azure Arc

Gebruik de volgende PowerShell-opdrachten om Azure Monitor Agent te installeren op servers met 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
  

Azure-CLI

U kunt Azure Monitor Agent installeren op virtuele Azure-machines en op servers met Azure Arc met behulp van de Azure CLI-opdracht voor het toevoegen van een extensie voor virtuele machines.

Azure-VM's

Gebruik de volgende CLI-opdrachten om Azure Monitor Agent te installeren op virtuele Azure-machines. Kies de juiste opdracht op basis van de gekozen verificatiemethode.

Door de gebruiker toegewezen beheerde identiteit

• 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>"}}}'
  

Door het systeem toegewezen beheerde identiteit

• 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
  

Schaalset voor virtuele Azure-machines

Gebruik de CLI-cmdlet az vmss extension set om Azure Monitor Agent te installeren op virtuele-machinesschaalsets van Azure.

Servers met Azure Arc

Gebruik de volgende CLI-opdrachten om Azure Monitor Agent te installeren op servers met 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
  

Resource Manager-sjabloon

U kunt Resource Manager-sjablonen gebruiken om Azure Monitor Agent te installeren op virtuele Azure-machines en op servers met Azure Arc en om een koppeling te maken met regels voor gegevensverzameling. U moet een regel voor het verzamelen van gegevens maken voordat u de koppeling maakt.

Download voorbeeldsjablonen voor het installeren van de agent en het maken van de koppeling op basis van de volgende resources:

• Sjabloon voor het installeren van Azure Monitor-agent (Azure en Azure Arc)
• Sjabloon voor het maken van een koppeling met de regel voor gegevensverzameling

Installeer de sjablonen met behulp van een implementatiemethode voor Resource Manager-sjablonen, zoals de volgende opdrachten.

• PowerShell

  New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
  

• Azure-CLI

  az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
  

Verwijderen

Portal

Als u de Azure Monitor-agent wilt verwijderen met behulp van Azure Portal, gaat u naar uw virtuele machine, schaalset of server met Azure Arc. Selecteer het tabblad Extensies en selecteer AzureMonitorWindowsAgent of AzureMonitorLinuxAgent. Selecteer Verwijderen in het dialoogvenster dat wordt geopend.

PowerShell

Verwijderen op virtuele Azure-machines

Gebruik de volgende PowerShell-opdrachten om de Azure Monitor-agent op virtuele Azure-machines te verwijderen.

• 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> 
  

Verwijderen op virtuele Azure-machinesschaalset

Gebruik de PowerShell-cmdlet Remove-AzVmssExtension om Azure Monitor Agent te verwijderen op virtuele-machinesschaalsets van Azure.

Verwijderen op servers met Azure Arc

Gebruik de volgende PowerShell-opdrachten om Azure Monitor Agent te verwijderen op servers met 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
  

Azure-CLI

Verwijderen op virtuele Azure-machines

Gebruik de volgende CLI-opdrachten om Azure Monitor Agent op virtuele Azure-machines te verwijderen.

• 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
  

Verwijderen op virtuele Azure-machinesschaalset

Gebruik de az vmss-extensie om de CLI-cmdlet te verwijderen voor het verwijderen van Azure Monitor Agent op virtuele-machinesschaalsets van Azure.

Verwijderen op servers met Azure Arc

Gebruik de volgende CLI-opdrachten om Azure Monitor Agent te verwijderen op servers met 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>
  

Resource Manager-sjabloon

N.v.t.

Bijwerken

Notitie

Het wordt aanbevolen om automatische uitbreidingsupgrade in te schakelen die maximaal vijf weken na de release van een nieuwe extensieversie kan duren om geïnstalleerde extensies bij te werken naar de uitgebrachte (nieuwste) versie in alle regio's. Upgrades worden uitgegeven in batches, zodat sommige van uw virtuele machines, schaalsets of servers met Arc worden bijgewerkt voordat anderen worden bijgewerkt. Als u een extensie onmiddellijk moet upgraden, kunt u de onderstaande handmatige instructies gebruiken.

Portal

Als u een eenmalige update van de agent wilt uitvoeren, moet u eerst de bestaande agentversie verwijderen. Installeer vervolgens de nieuwe versie zoals beschreven.

U wordt aangeraden automatische updates van de agent in te schakelen door de functie Automatische extensie-upgrade in te schakelen. Ga naar uw virtuele machine of schaalset, selecteer het tabblad Extensies en selecteer AzureMonitorWindowsAgent of AzureMonitorLinuxAgent. Selecteer automatische upgrade inschakelen in het dialoogvenster dat wordt geopend.

PowerShell

Bijwerken op virtuele Azure-machines

Als u een eenmalige update van de agent wilt uitvoeren, moet u eerst de bestaande agentversie verwijderen en vervolgens de nieuwe versie installeren zoals beschreven.

U wordt aangeraden automatische updates van de agent in te schakelen door de functie Automatische extensie-upgrade in te schakelen met behulp van de volgende PowerShell-opdrachten.

• 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
  

Bijwerken op servers met Azure Arc

Als u een eenmalige upgrade van de agent wilt uitvoeren, gebruikt u de volgende PowerShell-opdrachten.

• 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
  

U wordt aangeraden automatische updates van de agent in te schakelen door de functie Automatische extensie-upgrade in te schakelen met behulp van de volgende PowerShell-opdrachten.

• 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
  

Azure-CLI

Bijwerken op virtuele Azure-machines

Als u een eenmalige update van de agent wilt uitvoeren, moet u eerst de bestaande agentversie verwijderen en vervolgens de nieuwe versie installeren zoals beschreven.

U wordt aangeraden automatische updates van de agent in te schakelen door de functie Automatische extensie-upgrade in te schakelen met behulp van de volgende CLI-opdrachten.

• 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
  

Bijwerken op servers met Azure Arc

Als u een eenmalige upgrade van de agent wilt uitvoeren, gebruikt u de volgende CLI-opdrachten.

• 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>
  

U wordt aangeraden automatische updates van de agent in te schakelen door de functie Automatische extensie-upgrade in te schakelen met behulp van de volgende PowerShell-opdrachten.

• 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
  

Resource Manager-sjabloon

N.v.t.

Configureren

Regels voor gegevensverzameling (DCR's) fungeren als een beheerprogramma voor Azure Monitor Agent (AMA) op uw computer. De AgentSettings DCR kan worden gebruikt voor het configureren van AMA-parameters zoals DisQuotaInMb, zodat uw agent is afgestemd op uw specifieke bewakingsbehoeften.

Notitie

Belangrijke overwegingen waarmee u rekening moet houden bij het werken met de AgentSettings DCR:

• De AgentSettings DCR kan alleen worden geconfigureerd via sjabloonimplementatie.
• AgentSettings is altijd een eigen DCR en kan geen bestaande dcr worden toegevoegd.
• Voor de juiste functionaliteit moeten zowel de machine als de AgentSettings DCR zich in dezelfde regio bevinden.

Ondersteunde parameters

De AgentSettings DCR ondersteunt momenteel het configureren van de volgende parameters:

Parameter	Description	Geldige waarden
DiscQuotaInMb	Hiermee definieert u de hoeveelheid schijfruimte die wordt gebruikt door de logboekbestanden en cache van de Azure Monitor-agent.	1000-5000 (in MB)
TimeReceivedForForwardedEvents	Wijzigt de WEF-kolom in de Sentinel WEF-tabel om TimeReceived te gebruiken in plaats van TimeGenerated-gegevens	0 of 1

AgentSettings DCR instellen

Portal

Momenteel niet ondersteund.

PowerShell

N.v.t.

Azure-CLI

N.v.t.

Resource Manager-sjabloon

1. De omgeving voorbereiden:

   Installeer AMA op uw virtuele machine.

2. Een DCR maken via sjabloonimplementatie:

   In het volgende voorbeeld wordt de maximale hoeveelheid schijfruimte die door AMA-cache wordt gebruikt, gewijzigd in 5 GB.

   {
   "$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"
       }
   ]
   }
   

   Notitie

   U kunt de Get DataCollectionRule-API gebruiken om de DCR-nettolading op te halen die u met deze sjabloon hebt gemaakt.

3. Koppel DCR aan uw computer:

   U kunt dit doen met een sjabloon of met behulp van de API maken met de volgende details:

   • AssociationName: agentSettings
   • ResourceUri: volledige ARM-id van de VM
   • api-versie: 2023-03-11 (oude API-versie is ook prima)
   • Hoofdtekst:

         {
         "properties": {
             "dataCollectionRuleId": “Full ARM ID for agent setting DCR”
             }
         }
     

4. Activeer de instellingen:

   Start AMA opnieuw om wijzigingen toe te passen.

Volgende stappen

Maak een regel voor gegevensverzameling om gegevens van de agent te verzamelen en naar Azure Monitor te verzenden.