Installieren und Verwalten des Azure Monitor-Agents

In diesem Artikel werden die verschiedenen Methoden zum Installieren, Deinstallieren, Aktualisieren und Konfigurieren des Azure Monitor-Agents auf virtuellen Azure-Computern, Skalierungsgruppen und Azure Arc-fähigen Servern beschrieben.

Wichtig

Der Azure Monitor-Agent erfordert mindestens eine Datensammlungsregel (Data Collection Rule, DCR), um nach der Installation auf dem Clientcomputer mit dem Sammeln von Daten zu beginnen. Abhängig von der Installationsmethode kann eine DCR möglicherweise automatisch erstellt werden. Wenn nicht, müssen Sie die Datensammlung gemäß dem Leitfaden unter Sammeln von Daten mit dem Azure Monitor-Agent konfigurieren.

Voraussetzungen

Lesen Sie die folgenden Artikel über Voraussetzungen und anderen Anforderungen für den Azure Monitor-Agent:

• Vom Azure Monitor-Agent unterstützte Betriebssysteme und Umgebungen
• Anforderungen des Azure Monitor-Agents
• Konfiguration des Azure Monitor-Agent-Netzwerks

Wichtig

Zum Installieren, Aktualisieren oder Deinstallieren des Azure Monitor-Agents muss ein Computer nicht neu gestartet werden.

Installationsoptionen

In der folgenden Tabelle sind die verschiedenen Optionen zum Installieren und Verwalten des Azure Monitor-Agents auf Azure-VMs und Azure Arc-fähigen Servern aufgeführt. Der Azure Arc-Agent muss auf allen Computern installiert werden, die sich nicht in Azure befinden, bevor der Azure Monitor-Agent installiert werden kann.

Installationsmethode	Beschreibung
VM-Erweiterung	Verwenden Sie eine der folgenden Methoden, um das Azure-Erweiterungsframework zum Installieren des Agents zu verwenden. Diese Methode erstellt keine DCR, daher müssen Sie mindestens eine erstellen und dem Agent zuordnen, bevor die Datensammlung beginnt.
Erstellen einer Datensammlungsregel	Wenn Sie eine DCR im Azure-Portal erstellen, wird der Azure Monitor-Agent auf allen Computern installiert, die der Datensammlungsregel als Ressourcen hinzugefügt werden. Der Agent beginnt sofort mit der Erfassung von Daten, die in der DCR definiert sind.
VM Insights	Wenn Sie VM Insights auf einer VM aktivieren, wird der Azure Monitor-Agent installiert. Außerdem wird eine DCR erstellt, die eine vordefinierte Gruppe von Daten erfasst. Sie sollten diesen DCR nicht verändern, können jedoch zusätzliche erstellen, um andere Daten zu sammeln.
Container Insights	Wenn Sie für einen Kubernetes-Cluster Container Insights aktivieren, wird eine containerisierte Version des Azure Monitor-Agents installiert. Zudem wird eine DCR erstellt, die umgehend mit dem Sammeln von Daten beginnt. Sie können diese DCR mithilfe des Leitfadens unter Konfigurieren von Datenerfassung und Kostenoptimierung in Container Insights mithilfe von Datenerfassungsregeln anpassen.
Clientinstallationsprogramm	Installiert den Agent mithilfe eines Windows MSI-Installationsprogramms für Windows 10- und Windows 11-Clients.
Azure Policy	Verwenden Sie Azure Policy, um den Agent automatisch auf virtuellen Azure-Computern und Azure Arc-fähigen Servern zu installieren und ihn automatisch mit erforderlichen DCRs zu verknüpfen.

Hinweis

Zum mandantenübergreifenden Senden von Daten müssen Sie zuerst Azure Lighthouse aktivieren. Das Klonen eines Computers mit installiertem Azure Monitor Agent wird nicht unterstützt. Die bewährte Methode für diese Situationen ist die Verwendung von Azure Policy oder einem Infrastructure-as-a-Code-Tool, um AMA im großen Maßstab bereitzustellen.

Installieren der Agent-Erweiterung

Dieser Abschnitt enthält Details zum Installieren des Azure Monitor-Agents mithilfe der VM-Erweiterung.

Portal

Verwenden Sie den Leitfaden unter Sammeln von Daten mit Azure Monitor Agent, um den Agent über das Azure-Portal zu installieren und eine DCR zum Sammeln von Daten zu erstellen.

PowerShell

Sie können den Azure Monitor-Agenten auf Azure-VMs und auf Azure Arc-fähigen Servern mithilfe des PowerShell-Befehls zum Hinzufügen einer Erweiterung für VMs installieren.

Virtuelle Azure-Computer

Verwenden Sie die folgenden PowerShell-Befehle, um den Azure Monitor-Agent auf Azure-VMs zu installieren. Wählen Sie basierend auf der von Ihnen ausgewählten Authentifizierungsmethode den geeigneten Befehl aus.

• 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
  

Azure-VM-Skalierungsgruppen

Verwenden Sie das PowerShell-Cmdlet Add-AzVmssExtension, um den Azure Monitor-Agent auf Azure-VM-Skalierungsgruppen zu installieren.

Server mit Azure Arc-Unterstützung

Verwenden Sie die folgenden PowerShell-Befehle, um den Azure Monitor-Agent auf Azure Arc-fähigen Servern zu installieren.

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

Sie können den Azure Monitor-Agent auf Azure-VMs und auf Azure Arc-aktivierten Servern installieren, indem Sie den Azure CLI-Befehl zum Hinzufügen einer Erweiterung für VMs verwenden.

Virtuelle Azure-Computer

Verwenden Sie die folgenden CLI-Befehle, um den Azure Monitor-Agent auf Azure-VMs zu installieren. Wählen Sie basierend auf der von Ihnen ausgewählten Authentifizierungsmethode den geeigneten Befehl aus.

Benutzerseitig zugewiesene verwaltete Identität

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

Systemseitig zugewiesene verwaltete Identität

• 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
  

Azure-VM-Skalierungsgruppen

Verwenden Sie das CLI-Cmdlet az vmss extension set, um den Azure Monitor-Agent auf Azure-VM-Skalierungsgruppen zu installieren.

Server mit Azure Arc-Unterstützung

Verwenden Sie die folgenden CLI-Befehle, um den Azure Monitor-Agent auf Servern mit Azure Arc-Unterstützung zu installieren.

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

Sie können Resource Manager-Vorlagen verwenden, um den Azure Monitor-Agenten auf virtuellen Azure-Maschinen und auf Azure Arc-fähigen Servern zu installieren und eine Zuordnung zu Datensammlungsregeln zu erstellen. Die entsprechenden Datensammlungsregeln müssen Sie vor dem Erstellen der Zuordnung erstellen.

Rufen Sie Beispielvorlagen für die Installation des Agents und das Erstellen der Zuordnung aus den folgenden Ressourcen ab:

• Vorlage zum Installieren des Azure Monitor-Agents (Azure und Azure Arc)
• Vorlage zum Erstellen einer Zuordnung zu einer Datensammlungsregel

Installieren Sie die Vorlagen mit einer beliebigen Bereitstellungsmethode für Resource Manager-Vorlagen, z. B. mit den folgenden Befehlen.

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

Deinstallieren

Portal

Um den Azure Monitor-Agent mithilfe des Azure-Portals zu deinstallieren, navigieren Sie zu Ihrer VM, Ihrer Skalierungsgruppe oder Ihrem Azure Arc-fähigen Server. Wählen Sie die Registerkarte Erweiterungen und dann AzureMonitorWindowsAgent oder AzureMonitorLinuxAgent aus. Wählen Sie im daraufhin geöffneten Dialogfeld Deinstallieren aus.

PowerShell

Deinstallieren auf Azure-VMs

Verwenden Sie die folgenden PowerShell-Befehle, um den Azure Monitor-Agent auf Azure-VMs zu deinstallieren.

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

Deinstallieren auf einer Azure-VMs-Skalierungsgruppe

Verwenden Sie das PowerShell-Cmdlet Remove-AzVmssExtension, um den Azure Monitor-Agent auf Azure-VM-Skalierungsgruppen zu deinstallieren.

Deinstallieren auf Azure Arc-fähigen Servern

Verwenden Sie die folgenden PowerShell-Befehle, um den Azure Monitor-Agent auf Azure Arc-fähigen Servern zu deinstallieren.

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

Deinstallieren auf Azure-VMs

Verwenden Sie die folgenden CLI-Befehle, um den Azure Monitor-Agent auf Azure-VMs zu deinstallieren.

• 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
  

Deinstallieren auf einer Azure-VMs-Skalierungsgruppe

Verwenden Sie das CLI-Cmdlet az vmss extension delete, um den Azure Monitor-Agent auf Azure-VM-Skalierungsgruppen zu deinstallieren.

Deinstallieren auf Azure Arc-fähigen Servern

Verwenden Sie die folgenden CLI-Befehle, um den Azure Monitor-Agent auf Servern mit Azure Arc-Unterstützung zu deinstallieren.

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

–

Update

Hinweis

Die Empfehlung besteht darin, das automatische Erweiterungsupgrade zu aktivieren, das bis zu 5 Wochen nach der Veröffentlichung einer neuen Erweiterungsversion dauern kann, um installierte Erweiterungen auf die veröffentlichte (neueste) Version in allen Regionen zu aktualisieren. Upgrades werden in Batches ausgegeben, sodass möglicherweise einige Ihrer virtuellen Computer, Skalierungsgruppen oder Arc-fähigen Server vor anderen ein Upgrade erhalten werden. Wenn Sie sofort ein Upgrade für eine Erweiterung durchführen müssen, können Sie die unten aufgeführten manuellen Anweisungen verwenden.

Portal

Um ein einmaliges Update des Agents durchzuführen, müssen Sie zuerst die vorhandene Agent-Version deinstallieren. Installieren Sie dann die neue Version wie beschrieben.

Es wird empfohlen, automatische Updates des Agents zu aktivieren, indem Sie das Feature Automatisches Erweiterungsupgrade aktivieren. Navigieren Sie zu Ihrer VM oder Skalierungsgruppe, wählen Sie die Registerkarte Erweiterungen aus, und wählen Sie dann AzureMonitorWindowsAgent oder AzureMonitorLinuxAgent aus. Wählen Sie im daraufhin angezeigten Dialogfeld Automatisches Upgrade aktivieren aus.

PowerShell

Aktualisieren auf Azure-VMs

Um ein einmaliges Update des Agents durchzuführen, müssen Sie zuerst die vorhandene Agent-Version deinstallieren und dann die neue Version wie beschrieben installieren.

Es wird empfohlen, automatische Updates des Agents zu aktivieren, indem Sie das Feature Automatisches Erweiterungsupgrade mithilfe der folgenden PowerShell-Befehle aktivieren.

• 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
  

Aktualisieren auf Servern mit Azure Arc-Unterstützung

Verwenden Sie die folgenden PowerShell-Befehle, um ein einmaliges Upgrade des Agents durchzuführen.

• 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
  

Es wird empfohlen, automatische Updates des Agents zu aktivieren, indem Sie das Feature Automatisches Erweiterungsupgrade mithilfe der folgenden PowerShell-Befehle aktivieren.

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

Aktualisieren auf Azure-VMs

Um ein einmaliges Update des Agents durchzuführen, müssen Sie zuerst die vorhandene Agent-Version deinstallieren und dann die neue Version wie beschrieben installieren.

Es wird empfohlen, automatische Updates des Agents zu aktivieren, indem Sie das Feature Automatisches Erweiterungsupgrade mithilfe der folgenden CLI-Befehle aktivieren.

• 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
  

Aktualisieren auf Servern mit Azure Arc-Unterstützung

Verwenden Sie die folgenden CLI-Befehle, um ein einmaliges Upgrade des Agents durchzuführen.

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

Es wird empfohlen, automatische Updates des Agents zu aktivieren, indem Sie das Feature Automatisches Erweiterungsupgrade mithilfe der folgenden PowerShell-Befehle aktivieren.

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

–

Konfigurieren

Datensammlungsregeln (Data Collection Rules, DCRs) dienen als Verwaltungstool für Azure Monitor Agent (AMA) auf Ihrem Computer. Die AgentSettings-DCR kann zum Konfigurieren von AMA-Parametern wie DisQuotaInMb verwendet werden, um sicherzustellen, dass Ihr Agent auf Ihre spezifischen Überwachungsanforderungen zugeschnitten ist.

Hinweis

Folgende wichtige Überlegungen sollten Sie beim Arbeiten mit der AgentSettings-DCR berücksichtigen:

• Die AgentSettings-DCR kann nur über die Vorlagenbereitstellung konfiguriert werden.
• Die AgentSettings-DCR ist immer ihre eigene DCR, und es kann keine vorhandene hinzugefügt werden.
• Für die ordnungsgemäße Funktionalität muss sich sowohl der Computer als auch die AgentSettings-DCR in derselben Region befinden.

Unterstützte Parameter

Die AgentSettings-DCR unterstützt derzeit die Konfiguration folgender Parameter:

Parameter	BESCHREIBUNG	Gültige Werte
DiscQuotaInMb	Definiert den Speicherplatz, der von den Azure Monitor-Agent-Protokolldateien und -Cache verwendet wird.	1.000–5.000 (in MB)
TimeReceivedForForwardedEvents	Ändert die WEF-Spalte in der Sentinel WEF-Tabelle so, dass TimeReceived- anstelle von TimeGenerated-Daten verwendet werden.	0 oder 1

Einrichten der AgentSettings-DCR

Portal

Wird derzeit nicht unterstützt.

PowerShell

–

Azure-Befehlszeilenschnittstelle

–

Resource Manager: Vorlage

1. Bereiten Sie die Umgebung vor:

   Installieren Sie AMA auf Ihrer VM.

2. Erstellen Sie eine DCR mithilfe der Vorlagenbereitstellung:

   Im folgenden Beispiel wird der maximale Speicherplatz, der vom AMA-Cache verwendet wird, auf 5 GB geändert.

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

   Hinweis

   Sie können die „Get DataCollectionRule“-API verwenden, um die DCR-Nutzlast abzurufen, die Sie mit dieser Vorlage erstellt haben.

3. Zuordnen einer DCR zu Ihrem Computer:

   Dies kann mithilfe einer Vorlage oder der Create-API mit den folgenden Details erfolgen:

   • AssociationName: agentSettings
   • ResourceUri: vollständige ARM-ID der VM
   • API-Version: 2023-03-11 (eine alte API-Version ist ebenfalls möglich)
   • Text:

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

4. Aktivieren Sie die Einstellungen:

   Starten Sie AMA neu, um die Änderungen anzuwenden.

Nächste Schritte

Erstellen Sie eine Datensammlungsregel, um Daten des Agents zu sammeln und an Azure Monitor zu senden.