Instalace a správa agenta služby Azure Monitor

Tento článek podrobně popisuje různé metody instalace, odinstalace, aktualizace a konfigurace agenta Služby Azure Monitor na virtuálních počítačích Azure, škálovacích sadách a serverech s podporou Služby Azure Arc.

Důležité

Agent Služby Azure Monitor vyžaduje, aby po instalaci na klientském počítači začal shromažďovat data alespoň jedno pravidlo shromažďování dat (DCR). V závislosti na použité metodě instalace může nebo nemusí být řadič domény vytvořen automaticky. Pokud ne, je potřeba nakonfigurovat shromažďování dat podle pokynů v tématu Shromažďování dat pomocí agenta služby Azure Monitor.

Požadavky

Požadavky a další požadavky pro agenta služby Azure Monitor najdete v následujících článcích:

• Agent Azure Monitor podporuje operační systémy a prostředí
• Požadavky na agenta služby Azure Monitor
• Konfigurace sítě agenta služby Azure Monitor

Důležité

Instalace, upgrade nebo odinstalace agenta služby Azure Monitor nevyžaduje restartování počítače.

Možnosti instalace

Následující tabulka uvádí různé možnosti instalace agenta Azure Monitoru na virtuální počítače Azure a servery s podporou Azure Arc. Agent Azure Arc musí být nainstalovaný na všech počítačích, které nejsou v Azure, aby bylo možné nainstalovat agenta služby Azure Monitor.

Metoda instalace	Popis
Rozšíření virtuálního počítače	K instalaci agenta použijte některou z níže uvedených metod. Tato metoda nevytvoří řadič domény, takže musíte vytvořit aspoň jeden a přidružit ho k agentu před zahájením shromažďování dat.
Vytvoření pravidla shromažďování dat (DCR)	Při vytváření DCR na webu Azure Portal se agent Azure Monitor nainstaluje na všechny počítače, které se přidají jako prostředky pro DCR. Agent začne okamžitě shromažďovat data definovaná v řadiči domény.
Přehledy virtuálních počítačů	Když povolíte přehledy virtuálních počítačů na počítači, nainstaluje se agent Služby Azure Monitor a vytvoří se DCR, který shromažďuje předdefinovanou sadu dat. Tento řadič domény byste neměli upravovat, ale můžete vytvořit další řadiče domény pro shromažďování dalších dat.
Přehledy kontejnerů	Když v clusteru Kubernetes povolíte službu Container Insights, v clusteru se nainstaluje kontejnerizovaná verze agenta Služby Azure Monitor a vytvoří se dcR, která okamžitě začne shromažďovat data. Tento řadič domény můžete upravit pomocí pokynů v tématu Konfigurace shromažďování dat a optimalizace nákladů v Přehledech kontejnerů pomocí pravidla shromažďování dat.
Instalační program klienta	Nainstaluje agenta pomocí instalačního programu MSI systému Windows pro klienty Windows 10 a Windows 11.
Azure Policy	Pomocí Služby Azure Policy můžete automaticky nainstalovat agenta na virtuální počítače Azure a servery s podporou Služby Azure Arc a automaticky je přidružit k požadovaným řadičům domény.

Poznámka:

Pokud chcete odesílat data mezi tenanty, musíte nejprve povolit Azure Lighthouse. Klonování počítače s nainstalovaným agentem Služby Azure Monitor se nepodporuje. Osvědčeným postupem pro tyto situace je použít Azure Policy nebo infrastrukturu jako nástroj pro kód k nasazení AMA ve velkém měřítku.

Instalace rozšíření agenta

Tato část obsahuje podrobnosti o instalaci agenta Azure Monitoru pomocí rozšíření virtuálního počítače.

Azure Portal

Pokyny ke shromažďování dat pomocí agenta Azure Monitoru použijte k instalaci agenta pomocí webu Azure Portal a vytvoření DCR ke shromažďování dat.

PowerShell

Agenta Azure Monitoru můžete nainstalovat na virtuální počítače Azure a na servery s podporou Azure Arc pomocí příkazu PowerShellu pro přidání rozšíření virtuálního počítače.

Virtuální počítače Azure

Pomocí následujících příkazů PowerShellu nainstalujte agenta Azure Monitoru na virtuální počítače Azure. Na základě zvolené metody ověřování zvolte příslušný příkaz.

• 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
  

Škálovací sada virtuálních počítačů Azure

Pomocí rutiny Add-AzVmssExtension PowerShellu nainstalujte agenta Azure Monitoru na škálovací sady virtuálních počítačů Azure.

Servery s podporou služby Azure Arc

Pomocí následujících příkazů PowerShellu nainstalujte agenta Azure Monitoru na servery s podporou 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

Agenta Azure Monitoru můžete nainstalovat na virtuální počítače Azure a na servery s podporou Azure Arc pomocí příkazu Azure CLI pro přidání rozšíření virtuálního počítače.

Virtuální počítače Azure

K instalaci agenta Azure Monitoru na virtuální počítače Azure použijte následující příkazy rozhraní příkazového řádku. Na základě zvolené metody ověřování zvolte příslušný příkaz.

Spravovaná identita přiřazená uživatelem

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

Spravovaná identita přiřazená systémem

• 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
  

Škálovací sada virtuálních počítačů Azure

Pomocí rutiny rozhraní příkazového řádku sady rozšíření az vmss nainstalujte agenta Azure Monitoru do škálovacích sad virtuálních počítačů Azure.

Servery s podporou služby Azure Arc

Pomocí následujících příkazů rozhraní příkazového řádku nainstalujte agenta Azure Monitoru na servery s podporou 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
  

Šablona Resource Manageru

Pomocí šablon Resource Manageru můžete nainstalovat agenta Služby Azure Monitor na virtuální počítače Azure a na servery s podporou Služby Azure Arc a vytvořit přidružení k pravidlům shromažďování dat. Před vytvořením přidružení musíte vytvořit jakékoli pravidlo shromažďování dat.

Získejte ukázkové šablony pro instalaci agenta a vytvoření přidružení z následujících zdrojů:

• Šablona pro instalaci agenta Azure Monitoru (Azure a Azure Arc)
• Šablona pro vytvoření přidružení k pravidlu shromažďování dat

Nainstalujte šablony pomocí libovolné metody nasazení pro šablony Resource Manageru, jako jsou například následující příkazy.

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

Odinstalace produktu

Azure Portal

Pokud chcete odinstalovat agenta Azure Monitoru pomocí webu Azure Portal, přejděte na virtuální počítač, škálovací sadu nebo server s podporou Služby Azure Arc. Vyberte kartu Rozšíření a vyberte AzureMonitorWindowsAgent nebo AzureMonitorLinuxAgent. V dialogovém okně, které se otevře, vyberte Odinstalovat.

PowerShell

Odinstalace na virtuálních počítačích Azure

Pomocí následujících příkazů PowerShellu odinstalujte agenta Azure Monitoru na virtuálních počítačích 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> 
  

Odinstalace ve škálovací sadě virtuálních počítačů Azure

Pomocí rutiny Remove-AzVmssExtension PowerShellu odinstalujte agenta Azure Monitoru ve škálovacích sadách virtuálních počítačů Azure.

Odinstalace na serverech s podporou Služby Azure Arc

Pomocí následujících příkazů PowerShellu odinstalujte agenta Azure Monitoru na serverech s podporou 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

Odinstalace na virtuálních počítačích Azure

K odinstalaci agenta Služby Azure Monitor na virtuálních počítačích Azure použijte následující příkazy rozhraní příkazového řádku.

• 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
  

Odinstalace ve škálovací sadě virtuálních počítačů Azure

Pomocí rutiny azure vmss extension delete CLI odinstalujte agenta Azure Monitoru ve škálovacích sadách virtuálních počítačů Azure.

Odinstalace na serverech s podporou Služby Azure Arc

K odinstalaci agenta Azure Monitor na serverech s podporou Azure Arc použijte následující příkazy rozhraní příkazového řádku.

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

Šablona Resource Manageru

–

Aktualizovat

Poznámka:

Doporučujeme povolit automatický upgrade rozšíření, které může trvat až 5 týdnů po vydání nové verze rozšíření, aby aktualizovala nainstalovaná rozšíření na vydané (nejnovější) verze ve všech oblastech. Upgrady se vydávají v dávkách, takže se některé virtuální počítače, škálovací sady nebo servery s podporou arc upgradují dřív než ostatní. Pokud potřebujete rozšíření upgradovat okamžitě, můžete použít následující ruční pokyny.

Azure Portal

Pokud chcete provést jednorázovou aktualizaci agenta, musíte nejprve odinstalovat stávající verzi agenta. Pak nainstalujte novou verzi, jak je popsáno.

Doporučujeme povolit automatickou aktualizaci agenta povolením funkce automatického upgradu rozšíření. Přejděte na virtuální počítač nebo škálovací sadu, vyberte kartu Rozšíření a vyberte AzureMonitorWindowsAgent nebo AzureMonitorLinuxAgent. V dialogovém okně, které se otevře, vyberte Povolit automatický upgrade.

PowerShell

Aktualizace na virtuálních počítačích Azure

Pokud chcete provést jednorázovou aktualizaci agenta, musíte nejprve odinstalovat stávající verzi agenta a pak nainstalovat novou verzi, jak je popsáno.

Doporučujeme povolit automatickou aktualizaci agenta povolením funkce automatického upgradu rozšíření pomocí následujících příkazů PowerShellu.

• 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
  

Aktualizace na serverech s podporou Azure Arc

Pokud chcete provést jednorázový upgrade agenta, použijte následující příkazy PowerShellu.

• 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
  

Doporučujeme povolit automatickou aktualizaci agenta povolením funkce automatického upgradu rozšíření pomocí následujících příkazů PowerShellu.

• 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

Aktualizace na virtuálních počítačích Azure

Pokud chcete provést jednorázovou aktualizaci agenta, musíte nejprve odinstalovat stávající verzi agenta a pak nainstalovat novou verzi, jak je popsáno.

Doporučujeme povolit automatickou aktualizaci agenta povolením funkce automatického upgradu rozšíření pomocí následujících příkazů rozhraní příkazového řádku.

• 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
  

Aktualizace na serverech s podporou Azure Arc

Pokud chcete provést jednorázový upgrade agenta, použijte následující příkazy rozhraní příkazového řádku.

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

Doporučujeme povolit automatickou aktualizaci agenta povolením funkce automatického upgradu rozšíření pomocí následujících příkazů PowerShellu.

• 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
  

Šablona Resource Manageru

–

Konfigurovat

Pravidla shromažďování dat (DCR) slouží jako nástroj pro správu agenta služby Azure Monitor (AMA) na vašem počítači. AgentSettings DCR se dá použít ke konfiguraci parametrů AMA, jako je DisQuotaInMb, a zajistit tak, aby byl váš agent přizpůsobený vašim konkrétním potřebám monitorování.

Poznámka:

Důležité aspekty, které je potřeba vzít v úvahu při práci s DCR AgentSettings:

• AgentSettings DCR je možné nakonfigurovat pouze prostřednictvím nasazení šablony.
• AgentSettings je vždy vlastníkem dcR a nedá se přidat existující.
• Pro správnou funkčnost musí být počítač i agentSettings DCR umístěné ve stejné oblasti.

Podporované parametry

Řadič domény AgentSettings aktuálně podporuje konfiguraci následujících parametrů:

Parametr	Popis	Platné hodnoty
DiscQuotaInMb	Definuje velikost místa na disku používaného soubory protokolů agenta služby Azure Monitor a mezipamětí.	1000–5000 (v MB)
TimeReceivedForForwardedEvents	Změní sloupec WEF v tabulce WEF služby Sentinel tak, aby místo dat TimeGenerated používal TimeReceived.	0 nebo 1

Nastavení AGENTSettings DCR

Azure Portal

V současné době se nepodporuje.

PowerShell

–

Azure CLI

N/A

Šablona Resource Manageru

1. Příprava prostředí:

   Nainstalujte na virtuální počítač AMA .

2. Vytvoření DCR prostřednictvím nasazení šablony:

   Následující příklad změní maximální množství místa na disku používané mezipaměti AMA na 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"
       }
   ]
   }
   

   Poznámka:

   K získání datové části DCR, kterou jste vytvořili pomocí této šablony, můžete použít rozhraní API Get DataCollectionRule.

3. Přidružit DCR k počítači:

   Můžete to provést pomocí šablony nebo pomocí rozhraní CREATE API s následujícími podrobnostmi:

   • AssociationName: agentSettings
   • ResourceUri: Úplné ID ARM virtuálního počítače
   • api-version: 2023-03-11 (Stará verze rozhraní API je také v pořádku)
   • Text:

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

4. Aktivujte nastavení:

   Restartujte AMA, aby se použily změny.

Další kroky

Vytvořte pravidlo shromažďování dat, které bude shromažďovat data z agenta a odesílat je do služby Azure Monitor.