Installera och hantera Azure Monitor-agenten

Den här artikeln beskriver de olika metoderna för att installera, avinstallera, uppdatera och konfigurera Azure Monitor Agent på virtuella Azure-datorer, skalningsuppsättningar och Azure Arc-aktiverade servrar.

Viktigt!

Azure Monitor Agent kräver att minst en datainsamlingsregel (DCR) börjar samla in data när den har installerats på klientdatorn. Beroende på vilken installationsmetod du använder kanske en DCR skapas automatiskt eller inte. Annars måste du konfigurera datainsamling enligt vägledningen i Samla in data med Azure Monitor Agent.

Förutsättningar

I följande artiklar finns krav och andra krav för Azure Monitor Agent:

• Operativsystem och miljöer som stöds av Azure Monitor Agent
• Krav för Azure Monitor-agent
• Nätverkskonfiguration för Azure Monitor Agent

Viktigt!

Om du installerar, uppgraderar eller avinstallerar Azure Monitor-agenten krävs ingen omstart av datorn.

Installationsalternativ

I följande tabell visas de olika alternativen för att installera Azure Monitor Agent på virtuella Azure-datorer och Azure Arc-aktiverade servrar. Azure Arc-agenten måste vara installerad på datorer som inte finns i Azure innan Azure Monitor-agenten kan installeras.

Installationsmetod	beskrivning
VM-tillägg	Använd någon av metoderna nedan för att använda Azure-tilläggsramverket för att installera agenten. Den här metoden skapar ingen DCR, så du måste skapa minst en och associera den med agenten innan datainsamlingen börjar.
Skapa en datainsamlingsregel (DCR)	När du skapar en DCR i Azure-portalen installeras Azure Monitor Agent på alla datorer som läggs till som resurser för DCR. Agenten börjar samla in data som definierats i DCR omedelbart.
VM-insikter	När du aktiverar VM-insikter på en dator installeras Azure Monitor Agent och en DCR skapas som samlar in en fördefinierad uppsättning data. Du bör inte ändra den här domänkontrollanten, men du kan skapa ytterligare domänkontrollanter för att samla in andra data.
Containerinsikter	När du aktiverar Container Insights i ett Kubernetes-kluster installeras en containerbaserad version av Azure Monitor Agent i klustret och en DCR skapas som omedelbart börjar samla in data. Du kan ändra den här domänkontrollanten med hjälp av vägledningen i Konfigurera datainsamling och kostnadsoptimering i Container insights med hjälp av datainsamlingsregeln.
Klientinstallationsprogram	Installerar agenten med hjälp av ett Windows MSI-installationsprogram för Windows 10- och Windows 11-klienter.
Azure Policy	Använd Azure Policy för att automatiskt installera agenten på virtuella Azure-datorer och Azure Arc-aktiverade servrar och associera dem automatiskt med nödvändiga domänkontrollanter.

Kommentar

Om du vill skicka data mellan klienter måste du först aktivera Azure Lighthouse. Kloning av en dator med Azure Monitor Agent installerat stöds inte. Det bästa sättet för dessa situationer är att använda Azure Policy eller en infrastruktur som ett kodverktyg för att distribuera AMA i stor skala.

Installera agenttillägg

Det här avsnittet innehåller information om hur du installerar Azure Monitor Agent med hjälp av VM-tillägget.

Portal

Använd vägledningen i Samla in data med Azure Monitor Agent för att installera agenten med hjälp av Azure-portalen och skapa en DCR för att samla in data.

PowerShell

Du kan installera Azure Monitor Agent på virtuella Azure-datorer och på Azure Arc-aktiverade servrar med hjälp av PowerShell-kommandot för att lägga till ett tillägg för virtuella datorer.

Virtuella Azure-datorer

Använd följande PowerShell-kommandon för att installera Azure Monitor Agent på virtuella Azure-datorer. Välj lämpligt kommando baserat på din valda autentiseringsmetod.

• 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
  

Skalningsuppsättning för virtuella Azure-datorer

Använd PowerShell-cmdleten Add-AzVmssExtension för att installera Azure Monitor Agent på skalningsuppsättningar för virtuella Azure-datorer.

Azure Arc-aktiverade servrar

Använd följande PowerShell-kommandon för att installera Azure Monitor Agent på Azure Arc-aktiverade servrar.

• 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

Du kan installera Azure Monitor Agent på virtuella Azure-datorer och på Azure Arc-aktiverade servrar med hjälp av Azure CLI-kommandot för att lägga till ett tillägg för virtuella datorer.

Virtuella Azure-datorer

Använd följande CLI-kommandon för att installera Azure Monitor Agent på virtuella Azure-datorer. Välj lämpligt kommando baserat på din valda autentiseringsmetod.

Användartilldelad hanterad identitet

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

Systemtilldelad hanterad identitet

• 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
  

Skalningsuppsättning för virtuella Azure-datorer

Använd cli-cmdleten az vmss extension set för att installera Azure Monitor Agent på skalningsuppsättningar för virtuella Azure-datorer.

Azure Arc-aktiverade servrar

Använd följande CLI-kommandon för att installera Azure Monitor Agent på Azure Arc-aktiverade servrar.

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

Du kan använda Resource Manager-mallar för att installera Azure Monitor Agent på virtuella Azure-datorer och på Azure Arc-aktiverade servrar och för att skapa en association med regler för datainsamling. Du måste skapa en regel för datainsamling innan du skapar associationen.

Hämta exempelmallar för att installera agenten och skapa associationen från följande resurser:

• Mall för att installera Azure Monitor Agent (Azure och Azure Arc)
• Mall för att skapa association med datainsamlingsregel

Installera mallarna med valfri distributionsmetod för Resource Manager-mallar, till exempel följande kommandon.

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

Avinstallera

Portal

Om du vill avinstallera Azure Monitor-agenten med hjälp av Azure-portalen går du till din virtuella dator, skalningsuppsättning eller Azure Arc-aktiverade server. Välj fliken Tillägg och välj AzureMonitorWindowsAgent eller AzureMonitorLinuxAgent. I dialogrutan som öppnas väljer du Avinstallera.

PowerShell

Avinstallera på virtuella Azure-datorer

Använd följande PowerShell-kommandon för att avinstallera Azure Monitor Agent på virtuella Azure-datorer.

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

Avinstallera på skalningsuppsättningen för virtuella Azure-datorer

Använd PowerShell-cmdleten Remove-AzVmssExtension för att avinstallera Azure Monitor Agent på skalningsuppsättningar för virtuella Azure-datorer.

Avinstallera på Azure Arc-aktiverade servrar

Använd följande PowerShell-kommandon för att avinstallera Azure Monitor Agent på Azure Arc-aktiverade servrar.

• 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

Avinstallera på virtuella Azure-datorer

Använd följande CLI-kommandon för att avinstallera Azure Monitor Agent på virtuella Azure-datorer.

• 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
  

Avinstallera på skalningsuppsättningen för virtuella Azure-datorer

Använd cmdleten az vmss extension delete CLI för att avinstallera Azure Monitor Agent på skalningsuppsättningar för virtuella Azure-datorer.

Avinstallera på Azure Arc-aktiverade servrar

Använd följande CLI-kommandon för att avinstallera Azure Monitor Agent på Azure Arc-aktiverade servrar.

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

Ej tillämpligt

Uppdatera

Kommentar

Rekommendationen är att aktivera automatisk tilläggsuppgradering som kan ta upp till 5 veckor efter att en ny tilläggsversion har släppts för att uppdatera installerade tillägg till den utgivna (senaste) versionen i alla regioner. Uppgraderingar utfärdas i batchar, så du kan se att vissa av dina virtuella datorer, skalningsuppsättningar eller Arc-aktiverade servrar uppgraderas före andra. Om du behöver uppgradera ett tillägg omedelbart kan du använda de manuella anvisningarna nedan.

Portal

Om du vill utföra en engångsuppdatering av agenten måste du först avinstallera den befintliga agentversionen. Installera sedan den nya versionen enligt beskrivningen.

Vi rekommenderar att du aktiverar automatisk uppdatering av agenten genom att aktivera funktionen Automatisk tilläggsuppgradering . Gå till den virtuella datorn eller skalningsuppsättningen, välj fliken Tillägg och välj AzureMonitorWindowsAgent eller AzureMonitorLinuxAgent. I dialogrutan som öppnas väljer du Aktivera automatisk uppgradering.

PowerShell

Uppdatera på virtuella Azure-datorer

Om du vill utföra en engångsuppdatering av agenten måste du först avinstallera den befintliga agentversionen och sedan installera den nya versionen enligt beskrivningen.

Vi rekommenderar att du aktiverar automatisk uppdatering av agenten genom att aktivera funktionen Automatisk tilläggsuppgradering med hjälp av följande PowerShell-kommandon.

• 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
  

Uppdatera på Azure Arc-aktiverade servrar

Om du vill utföra en engångsuppgradering av agenten använder du följande PowerShell-kommandon.

• 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
  

Vi rekommenderar att du aktiverar automatisk uppdatering av agenten genom att aktivera funktionen Automatisk tilläggsuppgradering med hjälp av följande PowerShell-kommandon.

• 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

Uppdatera på virtuella Azure-datorer

Om du vill utföra en engångsuppdatering av agenten måste du först avinstallera den befintliga agentversionen och sedan installera den nya versionen enligt beskrivningen.

Vi rekommenderar att du aktiverar automatisk uppdatering av agenten genom att aktivera funktionen Automatisk tilläggsuppgradering med hjälp av följande CLI-kommandon.

• 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
  

Uppdatera på Azure Arc-aktiverade servrar

Om du vill utföra en engångsuppgradering av agenten använder du följande CLI-kommandon.

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

Vi rekommenderar att du aktiverar automatisk uppdatering av agenten genom att aktivera funktionen Automatisk tilläggsuppgradering med hjälp av följande PowerShell-kommandon.

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

Ej tillämpligt

Konfigurera

Datainsamlingsregler (DCR) fungerar som ett hanteringsverktyg för Azure Monitor Agent (AMA) på datorn. AgentSettings DCR kan användas för att konfigurera AMA-parametrar som DisQuotaInMb, vilket säkerställer att din agent är skräddarsydd för dina specifika övervakningsbehov.

Kommentar

Viktiga saker att tänka på när du arbetar med AgentSettings DCR:

• AgentSettings DCR kan bara konfigureras via malldistribution.
• AgentSettings är alltid en egen DCR och kan inte läggas till en befintlig.
• För korrekt funktionalitet måste både datorn och AgentSettings DCR finnas i samma region.

Parametrar som stöds

AgentSettings DCR stöder för närvarande konfiguration av följande parametrar:

Parameter	Description	Giltiga värden
DiscQuotaInMb	Definierar mängden diskutrymme som används av Azure Monitor Agent-loggfilerna och cacheminnet.	1 000–5 000 (i MB)
TimeReceivedForForwardedEvents	Ändrar WEF-kolumnen i Sentinel WEF-tabellen för att använda TimeReceived i stället för TimeGenerated-data	0 eller 1

Konfigurera AgentInställningar DCR

Portal

Stöds inte för närvarande.

PowerShell

Saknas

Azure CLI

Saknas

Resource Manager-mall

1. Förbered miljön:

   Installera AMA på den virtuella datorn.

2. Skapa en DCR via malldistribution:

   I följande exempel ändras den maximala mängden diskutrymme som används av AMA-cachen till 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"
       }
   ]
   }
   

   Kommentar

   Du kan använda API:et Get DataCollectionRule för att hämta DCR-nyttolasten som du skapade med den här mallen.

3. Associera DCR med datorn:

   Detta kan göras med en mall eller med hjälp av Skapa API med följande information:

   • AssociationName: agentInställningar
   • ResourceUri: Fullständigt ARM-ID för den virtuella datorn
   • api-version: 2023-03-11 (gammal API-version är också bra)
   • Brödtext:

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

4. Aktivera inställningarna:

   Starta om AMA för att tillämpa ändringar.

Nästa steg

Skapa en datainsamlingsregel för att samla in data från agenten och skicka dem till Azure Monitor.