Az Azure Monitor-ügynök telepítése és kezelése

Ez a cikk az Azure Monitor Agent Azure-beli virtuális gépeken, méretezési csoportokon és Azure Arc-kompatibilis kiszolgálókon való telepítésének, eltávolításának, frissítésének és konfigurálására szolgáló különböző módszereket ismerteti.

Fontos

Az Azure Monitor-ügynöknek legalább egy adatgyűjtési szabályra (DCR) van szüksége ahhoz, hogy megkezdje az adatgyűjtést az ügyfélszámítógépen való telepítés után. A használt telepítési módszertől függően előfordulhat, hogy a rendszer automatikusan létrehoz egy DCR-t. Ha nem, akkor konfigurálnia kell az adatgyűjtést az Adatok gyűjtése az Azure Monitor-ügynökkel című útmutatót követve.

Előfeltételek

Az Azure Monitor Agent előfeltételeiről és egyéb követelményeiről az alábbi cikkekben olvashat:

• Az Azure Monitor Agent által támogatott operációs rendszerek és környezetek
• Az Azure Monitor Agent követelményei
• Az Azure Monitor Agent hálózati konfigurációja

Fontos

Az Azure Monitor-ügynök telepítéséhez, frissítéséhez vagy eltávolításához nem szükséges a gép újraindítása.

Telepítési lehetőségek

Az alábbi táblázat az Azure Monitor Agent Azure-beli virtuális gépekre és Azure Arc-kompatibilis kiszolgálókra való telepítésének különböző lehetőségeit sorolja fel. Az Azure Arc-ügynököt minden olyan gépre telepíteni kell, amely nem az Azure-ban található, mielőtt az Azure Monitor Agent telepíthető lenne.

Telepítési módszer	Leírás
Virtuálisgép-bővítmény	Az alábbi módszerek bármelyikével telepítheti az ügynököt az Azure-bővítmény keretrendszerével. Ez a metódus nem hoz létre DCR-t, ezért legalább egyet létre kell hoznia, és társítania kell az ügynökkel az adatgyűjtés megkezdése előtt.
DCR létrehozása	Amikor létrehoz egy DCR-t az Azure Portalon, az Azure Monitor Agent minden olyan gépen telepítve lesz, amely a DCR erőforrásaiként van hozzáadva. Az ügynök azonnal megkezdi a DCR-ben definiált adatok gyűjtését.
Virtuálisgép-elemzések	Ha engedélyezi a virtuálisgép-elemzéseket egy gépen, az Azure Monitor Agent telepítve lesz, és létrejön egy DCR, amely előre meghatározott adathalmazt gyűjt. Ezt a DCR-t nem érdemes módosítania, de további DCR-eket hozhat létre más adatok gyűjtéséhez.
Tárolóelemzések	Ha engedélyezi a Container Insightst egy Kubernetes-fürtön, az Azure Monitor Agent egy tárolóalapú verziója lesz telepítve a fürtben, és létrejön egy DCR, amely azonnal megkezdi az adatok gyűjtését. Ezt a DCR-t az adatgyűjtés és a költségoptimalizálás konfigurálása a Container Insightsban adatgyűjtési szabály használatával című témakör útmutatásával módosíthatja.
Ügyféltelepítő	Telepíti az ügynököt windowsos MSI-telepítővel Windows 10 és Windows 11 rendszerű ügyfelekhez.
Azure Policy	Az Azure Policy használatával automatikusan telepítheti az ügynököt azure-beli virtuális gépekre és Azure Arc-kompatibilis kiszolgálókra, és automatikusan társíthatja őket a szükséges DCR-ekkel.

Feljegyzés

Ahhoz, hogy adatokat küldjön a bérlők között, először engedélyeznie kell az Azure Lighthouse-t. Az Azure Monitor-ügynököt tartalmazó gépek klónozása nem támogatott. Ezekben a helyzetekben az ajánlott eljárás az, ha az Azure Policyt vagy az infrastruktúrát kódeszközként használja az AMA nagy léptékű üzembe helyezéséhez.

Ügynökbővítmény telepítése

Ez a szakasz az Azure Monitor Agent virtuálisgép-bővítmény használatával történő telepítésének részleteit ismerteti.

Portál

Az Adatok összegyűjtése az Azure Monitor-ügynökkel című útmutató segítségével telepítse az ügynököt az Azure Portalon, és hozzon létre egy DCR-t az adatok gyűjtéséhez.

PowerShell

Az Azure Monitor-ügynököt azure-beli virtuális gépeken és Azure Arc-kompatibilis kiszolgálókon a PowerShell-paranccsal telepítheti egy virtuálisgép-bővítmény hozzáadásához.

Azure-beli virtuális gépek

Az Alábbi PowerShell-parancsokkal telepítheti az Azure Monitor Agentet azure-beli virtuális gépekre. Válassza ki a megfelelő parancsot a választott hitelesítési módszer alapján.

• 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-beli virtuális gépek méretezési készlete

Az Add-AzVmssExtension PowerShell-parancsmaggal telepítse az Azure Monitor Agentet azure-beli virtuálisgép-méretezési csoportokra.

Azure Arc-kompatibilis kiszolgálók

Az Alábbi PowerShell-parancsokkal telepítheti az Azure Monitor Agentet az Azure Arc-kompatibilis kiszolgálókra.

• 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

Az Azure Monitor-ügynököt azure-beli virtuális gépekre és Azure Arc-kompatibilis kiszolgálókra az Azure CLI-paranccsal telepítheti egy virtuálisgép-bővítmény hozzáadásához.

Azure-beli virtuális gépek

Az Azure Monitor Agent azure-beli virtuális gépeken való telepítéséhez használja az alábbi CLI-parancsokat. Válassza ki a megfelelő parancsot a választott hitelesítési módszer alapján.

Felhasználó által hozzárendelt felügyelt identitás

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

Rendszer által hozzárendelt felügyelt identitás

• 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-beli virtuális gépek méretezési készlete

Az az vmss extension set CLI parancsmaggal telepítse az Azure Monitor Agentet az Azure-beli virtuális gépek méretezési csoportjaira.

Azure Arc-kompatibilis kiszolgálók

Az Alábbi CLI-parancsokkal telepítheti az Azure Monitor Agentet az Azure Arc-kompatibilis kiszolgálókra.

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

Resource Manager-sablonokkal telepítheti az Azure Monitor-ügynököt Azure-beli virtuális gépekre és Azure Arc-kompatibilis kiszolgálókra, és létrehozhat egy társításokat az adatgyűjtési szabályokkal. A társítás létrehozása előtt minden adatgyűjtési szabályt létre kell hoznia.

Mintasablonok lekérése az ügynök telepítéséhez és a társítás létrehozásához a következő erőforrásokból:

• Az Azure Monitor Agent (Azure és Az Azure Arc) telepítéséhez szükséges sablon
• Sablon az adatgyűjtési szabályhoz való társítás létrehozásához

Telepítse a sablonokat a Resource Manager-sablonok bármely üzembehelyezési módszerével, például az alábbi parancsokkal.

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

Eltávolítás

Portál

Az Azure Monitor Agent Azure Portalon való eltávolításához lépjen a virtuális gépre, a méretezési csoportra vagy az Azure Arc-kompatibilis kiszolgálóra. Válassza a Bővítmények lapot, és válassza az AzureMonitorWindowsAgent vagy az AzureMonitorLinuxAgent lehetőséget. A megnyíló párbeszédpanelen válassza az Eltávolítás lehetőséget.

PowerShell

Eltávolítás Azure-beli virtuális gépeken

Az Azure Monitor Agent azure-beli virtuális gépeken való eltávolításához használja az alábbi PowerShell-parancsokat.

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

Eltávolítás azure-beli virtuális gépek méretezési csoportján

A Remove-AzVmssExtension PowerShell-parancsmaggal távolítsa el az Azure Monitor Agentet azure-beli virtuálisgép-méretezési csoportokon.

Eltávolítás Azure Arc-kompatibilis kiszolgálókon

Az Alábbi PowerShell-parancsokkal távolíthatja el az Azure Monitor Agentet az Azure Arc-kompatibilis kiszolgálókon.

• 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

Eltávolítás Azure-beli virtuális gépeken

Az Azure Monitor Agent azure-beli virtuális gépeken való eltávolításához használja az alábbi CLI-parancsokat.

• 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
  

Eltávolítás azure-beli virtuális gépek méretezési csoportján

Az az vmss extension delete CLI parancsmaggal távolítsa el az Azure Monitor Agentet az Azure-beli virtuális gépek méretezési csoportjain.

Eltávolítás Azure Arc-kompatibilis kiszolgálókon

Az Alábbi CLI-parancsokkal távolítsa el az Azure Monitor Agentet az Azure Arc-kompatibilis kiszolgálókon.

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

n/a

Frissítés

Feljegyzés

A javaslat az automatikus bővítményfrissítés engedélyezése, amely egy új bővítményverzió kiadása után akár 5 hetet is igénybe vehet ahhoz, hogy a telepített bővítményeket az összes régióban a kiadott (legújabb) verzióra frissítse. A frissítéseket kötegekben bocsátjuk ki, így előfordulhat, hogy egyes virtuális gépek, méretezési csoportok vagy Arc-kompatibilis kiszolgálók frissítése mások előtt is meg fog jelenni. Ha azonnal frissítenie kell egy bővítményt, használhatja az alábbi manuális utasításokat.

Portál

Az ügynök egyszeri frissítéséhez először el kell távolítania a meglévő ügynökverziót. Ezután telepítse az új verziót a leírtak szerint.

Javasoljuk, hogy engedélyezze az ügynök automatikus frissítését az Automatikus bővítményfrissítés funkció engedélyezésével. Nyissa meg a virtuális gépet vagy a méretezési csoportot, válassza a Bővítmények lapot, és válassza az AzureMonitorWindowsAgent vagy az AzureMonitorLinuxAgent lehetőséget. A megnyíló párbeszédpanelen válassza az Automatikus frissítés engedélyezése lehetőséget.

PowerShell

Frissítés Azure-beli virtuális gépeken

Az ügynök egyszeri frissítéséhez először el kell távolítania a meglévő ügynökverziót, majd telepítenie kell az új verziót a leírtak szerint.

Javasoljuk, hogy engedélyezze az ügynök automatikus frissítését az automatikus bővítményfrissítési funkció engedélyezésével az alábbi PowerShell-parancsokkal.

• 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
  

Frissítés az Azure Arc-kompatibilis kiszolgálókon

Az ügynök egyszeri frissítéséhez használja az alábbi PowerShell-parancsokat.

• 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
  

Javasoljuk, hogy engedélyezze az ügynök automatikus frissítését az automatikus bővítményfrissítési funkció engedélyezésével az alábbi PowerShell-parancsokkal.

• 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

Frissítés Azure-beli virtuális gépeken

Az ügynök egyszeri frissítéséhez először el kell távolítania a meglévő ügynökverziót, majd telepítenie kell az új verziót a leírtak szerint.

Javasoljuk, hogy engedélyezze az ügynök automatikus frissítését az Automatikus bővítményfrissítés funkció engedélyezésével az alábbi CLI-parancsokkal.

• 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
  

Frissítés az Azure Arc-kompatibilis kiszolgálókon

Az ügynök egyszeri frissítéséhez használja az alábbi CLI-parancsokat.

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

Javasoljuk, hogy engedélyezze az ügynök automatikus frissítését az automatikus bővítményfrissítési funkció engedélyezésével az alábbi PowerShell-parancsokkal.

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

n/a

Konfigurálás

Az adatgyűjtési szabályok (DCRs) az Azure Monitor Agent (AMA) felügyeleti eszközeként szolgálnak a számítógépen. Az AgentSettings DCR-sel olyan AMA-paramétereket konfigurálhat, mint például DisQuotaInMb, hogy az ügynök az adott figyelési igényeknek megfelelően legyen testre szabva.

Feljegyzés

Fontos szempontok az AgentSettings DCR használata során:

• Az AgentSettings DCR csak sablontelepítéssel konfigurálható.
• Az AgentSettings mindig saját DCR, és nem lehet meglévőt hozzáadni.
• A megfelelő működéshez a gépnek és az AgentSettings DCR-nek is ugyanabban a régióban kell lennie.

Támogatott paraméterek

Az AgentSettings DCR jelenleg a következő paraméterek konfigurálását támogatja:

Paraméter	Leírás	Érvényes értékek
DiscQuotaInMb	Meghatározza az Azure Monitor Agent naplófájljai és gyorsítótára által használt lemezterületet.	1000-5000 (MB-ban)
TimeReceivedForForwardedEvents	A Sentinel WEF tábla WEF oszlopának módosítása a TimeReceived helyett a TimeGenerated adatok használatára	0 vagy 1

Az AgentSettings DCR beállítása

Portál

Ez jelenleg nem támogatott.

PowerShell

N.A.

Azure CLI

N.A.

Resource Manager-sablon

1. A környezet előkészítése:

   Telepítse az AMA-t a virtuális gépre.

2. DCR létrehozása sablontelepítéssel:

   Az alábbi példa az AMA-gyorsítótár által használt maximális lemezterületet 5 GB-ra módosítja.

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

   Feljegyzés

   A DataCollectionRule API lekérésével lekérheti a sablonnal létrehozott DCR hasznos adatokat.

3. A DCR társítása a géppel:

   Ezt sablonnal vagy a Create API használatával teheti meg a következő részletekkel:

   • AssociationName: agentSettings
   • ResourceUri: A virtuális gép teljes ARM-azonosítója
   • API-verzió: 2023-03-11 (A régi API-verzió is rendben van)
   • Törzs:

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

4. A beállítások aktiválása:

   A módosítások alkalmazásához indítsa újra az AMA-t.

Következő lépések

Hozzon létre egy adatgyűjtési szabályt , amellyel adatokat gyűjthet az ügynöktől, és elküldheti azokat az Azure Monitornak.