A Log Analytics-ügynök kezelése és karbantartása Windowshoz és Linuxhoz

Cikk
10/15/2024

A Log Analytics Windows- vagy Linux-ügynök Azure Monitorban való kezdeti üzembe helyezése után előfordulhat, hogy újra kell konfigurálnia, frissítenie vagy el kell távolítania a számítógépről, ha elérte a kivonási szakaszt az életciklusában. Ezeket a rutin karbantartási feladatokat egyszerűen kezelheti manuálisan vagy automatizálással, ami csökkenti a működési hibákat és a költségeket is.

Fontos

Az örökölt Log Analytics-ügynök 2024. augusztus 31-étől elavult. A Microsoft a továbbiakban nem nyújt támogatást a Log Analytics-ügynökhöz. Ha a Log Analytics-ügynököt használja az adatok Azure Monitorba való betöltéséhez, migráljon most az Azure Monitor-ügynökbe.

Az ügynök frissítése

Frissítsen a Windowshoz és Linuxhoz készült Log Analytics-ügynök legújabb kiadására manuálisan vagy automatikusan az üzembe helyezési forgatókönyv és a virtuális gép által használt környezet alapján.

Környezet	Telepítési módszer	Frissítési módszer
Azure VM	Log Analytics-ügynök virtuálisgép-bővítmény Windows/Linux rendszerhez	Az ügynök automatikusan frissül a virtuálisgép-modell módosítása után, kivéve, ha az Azure Resource Manager-sablont úgy konfigurálta, hogy a tulajdonságot `autoUpgradeMinorVersion` hamisra állítsa. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva. Csak a Linux-ügynök támogatja az automatikus frissítés utáni telepítést tulajdonsággal `enableAutomaticUpgrade` (lásd: Automatikus frissítés engedélyezése a Linux-ügynökhöz). A főverzió frissítése mindig manuális (lásd: VirtualMachineExtensionInner.AutoUpgradeMinorVersion tulajdonság).
Egyéni Azure-beli virtuálisgép-rendszerképek	A Log Analytics-ügynök manuális telepítése Windows/Linux rendszeren	A virtuális gépeket az ügynök legújabb verziójára kell frissíteni a Windows telepítőcsomagot vagy a Linux önkitermelő és telepíthető rendszerhéjszkriptcsomagot futtató parancssorból.
Nem Azure-beli virtuális gépek	A Log Analytics-ügynök manuális telepítése Windows/Linux rendszeren	A virtuális gépeket az ügynök legújabb verziójára kell frissíteni a Windows telepítőcsomagot vagy a Linux önkitermelő és telepíthető rendszerhéjszkriptcsomagot futtató parancssorból.

A Windows-ügynök frissítése

Ha windowsos virtuális gépen szeretné frissíteni az ügynököt a Log Analytics virtuálisgép-bővítmény használatával nem telepített legújabb verzióra, futtassa a parancssorból, szkriptből vagy más automatizálási megoldásból, vagy használja az MMASetup platformot<>.msi telepítővarázslót.

A Windows-ügynök legújabb verziójának letöltése a Log Analytics-munkaterületről:

Jelentkezzen be az Azure Portalra.
Az Azure Portalon válassza a Minden szolgáltatás elemet. Az erőforrások listájába írja be a Log Analytics kifejezést. Ahogy elkezd gépelni, a lista a beírtak alapján szűri a lehetőségeket. Válassza a Log Analytics-munkaterületek lehetőséget.
A Log Analytics-munkaterületek listájában válassza ki a munkaterületet.
A Log Analytics-munkaterületen válassza az Ügynökök csempét, majd a Windows Servert.
A Windows Server képernyőn válassza ki a windowsos operációs rendszer processzorarchitektúrájától függően letöltendő Windows-ügynök megfelelő verzióját.

Feljegyzés

A Windows Log Analytics-ügynök frissítése során nem támogatja a munkaterület konfigurálását vagy újrakonfigurálását a jelentéskészítéshez. Az ügynök konfigurálásához kövesse a munkaterület hozzáadása vagy eltávolítása területen felsorolt támogatott módszerek egyikét.

Frissítés a Telepítővarázslóval

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
Futtassa az MMASetup-platformot><.exe a telepítővarázsló elindításához.
A Telepítővarázsló első lapján válassza a Tovább gombot.
A Microsoft Monitorozási ügynök beállítása párbeszédpanelen válassza a Licencszerződés elfogadásával elfogadom lehetőséget.
A Microsoft Monitorozási ügynök beállítása párbeszédpanelen válassza a Frissítés lehetőséget. Az állapotlap a frissítés előrehaladását jeleníti meg.
Amikor a Microsoft Monitoring Agent konfigurációja sikeresen befejeződött, megjelenik a Befejezés gomb.

Frissítés a parancssorból

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
Az ügynök telepítési fájljainak kinyeréséhez futtasson MMASetup-<platform>.exe /c egy rendszergazda jogú parancssorból, és rákérdez a fájlok kinyerési útvonalára. Az elérési utat az argumentumok MMASetup-<platform>.exe /c /t:<Full Path>átengedésével is megadhatja.
Futtassa a következő parancsot, ahol a D:\ a frissítési naplófájl helye:
```
setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
```

A Linux-ügynök frissítése

A korábbi verziók (>1.0.0-47) frissítése támogatott. Ha a telepítést a --upgrade paranccsal hajtja végre, az ügynök összes összetevőjét a legújabb verzióra frissíti.

Futtassa a következő parancsot az ügynök frissítéséhez:

sudo sh ./omsagent-*.universal.x64.sh --upgrade

A Linux-ügynök automatikus frissítésének engedélyezése

Javasoljuk, hogy engedélyezze az automatikus bővítményfrissítést ezekkel a parancsokkal az ügynök automatikus frissítéséhez.

PowerShell
Azure CLI

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  -EnableAutomaticUpgrade $true

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
  --settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  --version latestVersion \
  --enable-auto-upgrade true

Munkaterület hozzáadása vagy eltávolítása

Munkaterület hozzáadása vagy eltávolítása a Windows-ügynök vagy a Linux-ügynök használatával.

Windows-ügynök

Az ebben a szakaszban ismertetett lépésekre nem csak akkor van szükség, ha újra szeretné konfigurálni a Windows-ügynököt, hogy egy másik munkaterületen jelentsen, vagy eltávolítson egy munkaterületet a konfigurációjából, hanem akkor is, ha azt szeretné, hogy az ügynök több munkaterületre is jelentsen. (Ezt a gyakorlatot gyakran többhomingnak is nevezik.) A Windows-ügynök konfigurálása több munkaterületre való jelentésre csak az ügynök kezdeti beállítása után és az ebben a szakaszban ismertetett módszerekkel végezhető el.

A Vezérlőpult beállításainak frissítése

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
Nyissa meg a Vezérlőpultot.
Válassza a Microsoft Monitoring Agent lehetőséget , majd az Azure Log Analytics lapot.
Ha eltávolít egy munkaterületet, jelölje ki, majd válassza az Eltávolítás lehetőséget. Ismételje meg ezt a lépést minden olyan munkaterület esetében, ahová az ügynök le szeretné állítani a jelentéskészítést.
Ha munkaterületet ad hozzá, válassza a Hozzáadás lehetőséget. A Log Analytics-munkaterület hozzáadása párbeszédpanelen illessze be a munkaterület azonosítóját és munkaterületkulcsát (elsődleges kulcs). Ha a számítógépnek jelentenie kell egy Log Analytics-munkaterületnek az Azure Government-felhőben, válassza az Azure US Government lehetőséget az Azure Cloud legördülő listából.
A módosítások mentéséhez kattintson az OK gombra .

Munkaterület eltávolítása a PowerShell használatával

$workspaceId = "<Your workspace Id>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.RemoveCloudWorkspace($workspaceId)
$mma.ReloadConfiguration()

Munkaterület hozzáadása azure-beli kereskedelmi környezetben a PowerShell használatával

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

Munkaterület hozzáadása az Azure for US Governmentben a PowerShell használatával

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Feljegyzés

Ha korábban a parancssort vagy a szkriptet használta az ügynök telepítéséhez vagy konfigurálásához, EnableAzureOperationalInsights a program lecserélte a következőt AddCloudWorkspace : és RemoveCloudWorkspace.

Linux-ügynök

Az alábbi lépések bemutatják, hogyan konfigurálhatja újra a Linux-ügynököt, ha úgy dönt, hogy egy másik munkaterületen regisztrálja, vagy eltávolít egy munkaterületet a konfigurációjából.

Annak ellenőrzéséhez, hogy az ügynök regisztrálva van-e egy munkaterületen, futtassa a következő parancsot:

/opt/microsoft/omsagent/bin/omsadmin.sh -l

A következő példához hasonló állapotot kell visszaadnia:

Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

Fontos, hogy az állapot azt is jelezse, hogy az ügynök fut. Ellenkező esetben az ügynök újrakonfigurálásához szükséges alábbi lépések nem fejeződnek be sikeresen.
Ha az ügynök már regisztrálva van egy munkaterületen, távolítsa el a regisztrált munkaterületet az alábbi parancs futtatásával. Ellenkező esetben, ha nincs regisztrálva, folytassa a következő lépésekkel.

/opt/microsoft/omsagent/bin/omsadmin.sh -X
Ha másik munkaterületen szeretne regisztrálni, futtassa a következő parancsot:

/opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]
A módosítások érvénybe lépésének ellenőrzéséhez futtassa a következő parancsot:

/opt/microsoft/omsagent/bin/omsadmin.sh -l

A következő példához hasonló állapotot kell visszaadnia:

Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

Az ügynökszolgáltatást nem kell újraindítani a módosítások érvénybe lépéséhez.

Proxybeállítások frissítése

A Log Analytics Agent (MMA) nem használja a rendszerproxy beállításait. Ennek eredményeképpen az MMA telepítése során proxybeállításokat kell megadnia. Ezek a beállítások a virtuális gépen lévő MMA-konfiguráció (beállításjegyzék) alatt lesznek tárolva. Ha úgy szeretné konfigurálni az ügynököt, hogy proxykiszolgálón vagy Log Analytics-átjárón keresztül kommunikáljon a szolgáltatással az üzembe helyezés után, a feladat elvégzéséhez használja az alábbi módszerek egyikét.

Windows-ügynök

Használjon Windows-ügynököt.

Beállítások frissítése Vezérlőpult használatával

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
Nyissa meg a Vezérlőpultot.
Válassza a Microsoft Monitorozási ügynök lehetőséget , majd a Proxybeállítások lapot.
Válassza a Proxykiszolgáló használata elemet, és adja meg a proxykiszolgáló vagy átjáró URL-címét és portszámát. Ha a proxykiszolgáló vagy a Log Analytics-átjáró hitelesítést igényel, adja meg a felhasználónevet és a jelszót a hitelesítéshez, majd válassza az OK gombot.

Beállítások frissítése a PowerShell használatával

Másolja ki a következő PowerShell-mintakódot, frissítse a környezetére vonatkozó információkkal, és mentse egy PS1 fájlnévkiterjesztéssel. Futtassa a szkriptet minden olyan számítógépen, amely közvetlenül az Azure Monitor Log Analytics-munkaterületéhez csatlakozik.

param($ProxyDomainName="https://proxy.contoso.com:30443", $cred=(Get-Credential))

# First we get the Health Service configuration object. We need to determine if we
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
    Write-Output 'Health Service proxy API not present, will not update settings.'
    return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Linux-ügynök

Hajtsa végre a következő lépéseket, ha a Linux rendszerű számítógépeknek proxykiszolgálón vagy Log Analytics-átjárón keresztül kell kommunikálniuk. A proxykonfiguráció értéke a következő szintaxist tartalmazza: [protocol://][user:password@]proxyhost[:port]. A proxyhost tulajdonság elfogadja a proxykiszolgáló teljes tartománynevét vagy IP-címét.

Szerkessze a fájlt /etc/opt/microsoft/omsagent/proxy.conf az alábbi parancsok futtatásával, és módosítsa az értékeket a megadott beállításokra:

proxyconf="https://proxyuser:proxypassword@proxyserver01:30443"
sudo echo $proxyconf >>/etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf

Indítsa újra az ügynököt a következő parancs futtatásával:

sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

Ha megjelenik cURL failed to perform on this base url a naplóban, megpróbálhatja eltávolítani '\n' az EOF-t proxy.conf a hiba megoldásához:

od -c /etc/opt/microsoft/omsagent/proxy.conf
cat /etc/opt/microsoft/omsagent/proxy.conf | tr -d '\n' > /etc/opt/microsoft/omsagent/proxy2.conf
rm /etc/opt/microsoft/omsagent/proxy.conf
mv /etc/opt/microsoft/omsagent/proxy2.conf /etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

Ügynök eltávolítása

A Következő eljárások egyikével távolítsa el a Windows- vagy Linux-ügynököt a parancssor vagy a telepítővarázsló használatával.

Windows-ügynök

Használja a Windows-ügynököt.

Eltávolítás a Vezérlőpult

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
A Vezérlőpult válassza a Programok és szolgáltatások lehetőséget.
A Programok és szolgáltatások területen válassza a Microsoft Monitorozási ügynök>eltávolítása>igen lehetőséget.

Feljegyzés

Az Ügynökbeállítás varázsló dupla kattintással MMASetup-\<platform\>.exeis futtatható, amely az Azure Portal egyik munkaterületéről tölthető le.

Eltávolítás a parancssorból

Az ügynök letöltött fájlja egy, az IExpress használatával létrehozott önálló telepítési csomag. Az ügynök és a támogató fájlok telepítőprogramja a csomagban található, és az alábbi példában látható parancssor használatával ki kell nyerni a megfelelő eltávolításhoz.

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
Az ügynök telepítési fájljainak kinyeréséhez futtassa extract MMASetup-<platform>.exe a rendszergazda jogú parancssort, és rákérdez a fájlok kinyerési útvonalára. Az elérési utat az argumentumok extract MMASetup-<platform>.exe /c:<Path> /t:<Path>átengedésével is megadhatja. Az IExpress által támogatott parancssori kapcsolókkal kapcsolatos további információkért tekintse meg az IExpress parancssori kapcsolóinak témakörét, majd frissítse a példát az igényeinek megfelelően.
A parancssorba írja be a következőt %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb:

Linux-ügynök

Az ügynök eltávolításához futtassa az alábbi parancsot a Linux rendszerű számítógépen. Az --purge argumentum teljesen eltávolítja az ügynököt és annak konfigurációját.

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh --purge

Ügynök konfigurálása az Operations Manager felügyeleti csoportnak való jelentéshez

Használja a Windows-ügynököt.

Windows-ügynök

Az alábbi lépések végrehajtásával konfigurálhatja a Windows Log Analytics-ügynökét, hogy jelentést tegyen egy System Center Operations Manager felügyeleti csoportnak.

Feljegyzés

A Microsoft Operations Management Suite-ról Azure Monitorra való, folyamatban lévő váltás részeként a Windows és a Linux rendszerhez készült Operations Management Suite-ügynökre a Windowshoz készült Log Analytics-ügynök, illetve Linuxhoz készült Log Analytics-ügynök néven fogunk hivatkozni.

Jelentkezzen be a számítógépre rendszergazdai jogosultságokkal rendelkező fiókkal.
Nyissa meg a Vezérlőpultot.
Válassza a Microsoft Monitoring Agent lehetőséget , majd az Operations Manager lapot.
Ha az Operations Manager-kiszolgálók integráltak az Active Directoryval, válassza az Active Directory felügyeleti csoport hozzárendeléseinek automatikus frissítését az AD DS-ből.
Válassza a Hozzáadás lehetőséget a Felügyeleti csoport hozzáadása párbeszédpanel megnyitásához.
A Felügyeleti csoport neve mezőben adja meg a felügyeleti csoport nevét.
Az Elsődleges felügyeleti kiszolgáló mezőben adja meg az elsődleges felügyeleti kiszolgáló számítógépnevét.
A Felügyeleti kiszolgáló port mezőjében adja meg a TCP-port számát.
Az Ügynökműveleti fiók területen válassza ki a helyi rendszerfiókot vagy egy helyi tartományi fiókot.
Kattintson az OK gombra a Felügyeleti csoport hozzáadása párbeszédpanel bezárásához. Ezután az OK gombra kattintva zárja be a Microsoft Monitorozási ügynök tulajdonságai párbeszédpanelt.

Linux-ügynök

Az alábbi lépések végrehajtásával konfigurálhatja a Linux Log Analytics-ügynökét, hogy jelentést tegyen egy System Center Operations Manager felügyeleti csoportnak.

Feljegyzés

Szerkessze a következő fájlt: /etc/opt/omi/conf/omiserver.conf.
Győződjön meg arról, hogy az első sor httpsport= az 1270-es portot határozza meg, például: httpsport=1270.
Indítsa újra az OMI-kiszolgálót a következő paranccsal:

sudo /opt/omi/bin/service_control restart

Gyakori kérdések

Ez a szakasz választ ad a gyakori kérdésekre.

Hogyan állítsa le a Log Analytics-ügynök és az Azure Monitor közötti kommunikációt?

A Log Analyticshez közvetlenül csatlakozó ügynökök esetén nyissa meg a Vezérlőpult, és válassza a Microsoft Monitoring Agent lehetőséget. Az Azure Log Analytics (OMS) lapon távolítsa el az összes felsorolt munkaterületet. A System Center Operations Managerben távolítsa el a számítógépet a Log Analytics által felügyelt számítógépek listájából. Az Operations Manager úgy frissíti az ügynök konfigurációját, hogy többé ne jelentsen a Log Analyticsnek.

Következő lépések

Tekintse át a Linux-ügynök hibaelhárítását, ha problémákat tapasztal a Linux-ügynök telepítése vagy kezelése során.
Tekintse át a Windows-ügynök hibaelhárítását, ha problémákat tapasztal a Windows-ügynök telepítése vagy kezelése során.

Megosztás a következőn keresztül:

A Log Analytics-ügynök kezelése és karbantartása Windowshoz és Linuxhoz

Az ügynök frissítése

A Windows-ügynök frissítése

Frissítés a Telepítővarázslóval

Frissítés a parancssorból

A Linux-ügynök frissítése

A Linux-ügynök automatikus frissítésének engedélyezése

Munkaterület hozzáadása vagy eltávolítása

Windows-ügynök

A Vezérlőpult beállításainak frissítése

Munkaterület eltávolítása a PowerShell használatával

Munkaterület hozzáadása azure-beli kereskedelmi környezetben a PowerShell használatával

Munkaterület hozzáadása az Azure for US Governmentben a PowerShell használatával

Linux-ügynök

Proxybeállítások frissítése

Windows-ügynök

Beállítások frissítése Vezérlőpult használatával

Beállítások frissítése a PowerShell használatával

Linux-ügynök

Ügynök eltávolítása

Windows-ügynök

Eltávolítás a Vezérlőpult

Eltávolítás a parancssorból

Linux-ügynök

Ügynök konfigurálása az Operations Manager felügyeleti csoportnak való jelentéshez

Windows-ügynök

Linux-ügynök

Gyakori kérdések

Hogyan állítsa le a Log Analytics-ügynök és az Azure Monitor közötti kommunikációt?

Következő lépések

Visszajelzés

További források