Správa a údržba agenta Log Analytics pro Windows a Linux

  • Článek

Po počátečním nasazení agenta Log Analytics pro Windows nebo Linux ve službě Azure Monitor možná budete muset agenta překonfigurovat, upgradovat ho nebo ho z počítače odebrat, pokud v jeho životním cyklu dosáhl fáze vyřazení. Tyto úlohy rutinní údržby můžete snadno spravovat ručně nebo prostřednictvím automatizace, což snižuje provozní chyby i výdaje.

Důležité

Starší verze agentaLog Analytics bude do srpna 2024 zastaralá. Po tomto datu už Microsoft nebude poskytovat žádnou podporu pro agenta Log Analytics. Migrace na agenta Azure Monitoru před srpnem 2024 a pokračujte v ingestování dat.

Upgrade agenta

Upgradujte na nejnovější verzi agenta Log Analytics pro Windows a Linux ručně nebo automaticky na základě vašeho scénáře nasazení a prostředí, ve kterém je virtuální počítač spuštěný.

Prostředí Metoda instalace Metoda upgradu
Virtuální počítač Azure Rozšíření agenta Log Analytics pro Windows/Linux Agent se po změně modelu virtuálního počítače automaticky upgraduje, pokud jste nenakonfigurovali šablonu Azure Resource Manageru tak, aby se odhlásila nastavením vlastnosti autoUpgradeMinorVersion na false. Po nasazení ale rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true. Pouze linuxový agent podporuje automatické aktualizace po nasazení s enableAutomaticUpgrade vlastností (viz Povolení automatické aktualizace pro agenta Linuxu). Upgrade hlavní verze je vždy ruční (viz Vlastnost VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Vlastní image virtuálních počítačů Azure Ruční instalace agenta Log Analytics pro Windows/Linux Aktualizace virtuálních počítačů na nejnovější verzi agenta se musí provést z příkazového řádku, na kterém je spuštěn balíček instalační služby systému Windows nebo sada skriptů prostředí s automatickým extrahováním a instalací.
Virtuální počítače mimo Azure Ruční instalace agenta Log Analytics pro Windows/Linux Aktualizace virtuálních počítačů na nejnovější verzi agenta se musí provést z příkazového řádku, na kterém je spuštěn balíček instalační služby systému Windows nebo sada skriptů prostředí s automatickým extrahováním a instalací.

Upgrade agenta pro Windows

Pokud chcete aktualizovat agenta na virtuálním počítači s Windows na nejnovější verzi, která není nainstalovaná pomocí rozšíření virtuálního počítače Log Analytics, spustíte buď z příkazového řádku, skriptu nebo jiného řešení automatizace, nebo použijete Průvodce instalací MMASetup-platform.msi<>.

Stažení nejnovější verze agenta Windows z pracovního prostoru služby Log Analytics:

  1. Přihlaste se k portálu Azure.

  2. Na webu Azure Portal vyberte Všechny služby. V seznamu prostředků zadejte Log Analytics. Seznam se průběžně filtruje podle zadávaného textu. Vyberte možnost Pracovní prostory služby Log Analytics.

  3. V seznamu pracovních prostorů služby Log Analytics vyberte pracovní prostor.

  4. V pracovním prostoru služby Log Analytics vyberte dlaždici Agenti a pak vyberte Windows Servery.

  5. Na obrazovce Windows Servers vyberte v závislosti na architektuře procesoru operačního systému Windows odpovídající stažení verze agenta systému Windows.

Poznámka:

Během upgradu agenta Log Analytics pro Windows nepodporuje konfiguraci ani konfiguraci pracovního prostoru pro sestavu. Pokud chcete nakonfigurovat agenta, postupujte podle některé z podporovaných metod uvedených v části Přidat nebo odebrat pracovní prostor.

Upgrade pomocí Průvodce instalací

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. Spusťte NÁSTROJ MMASetup-platform.exe<> a spusťte Průvodce instalací.

  3. Na první stránce Průvodce instalací vyberte Další.

  4. V dialogovém okně Instalace agenta Microsoft Monitoring Agent vyberte Souhlasím s přijetím licenční smlouvy.

  5. V dialogovém okně Instalace agenta Microsoft Monitoring Agent vyberte Upgradovat. Na stránce stavu se zobrazí průběh upgradu.

  6. Po úspěšném dokončení konfigurace nástroje Microsoft Monitoring Agent vyberte Dokončit.

Upgrade z příkazového řádku

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. Chcete-li extrahovat instalační soubory agenta, spusťte MMASetup-<platform>.exe /c z příkazového řádku se zvýšenými oprávněními a zobrazí se výzva k zadání cesty k extrahování souborů. Alternativně můžete zadat cestu předáním argumentů MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Spusťte následující příkaz, kde D:\ je umístění pro soubor protokolu upgradu:

    setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1

Upgrade agenta pro Linux

Podporuje se upgrade z předchozích verzí (>1.0.0-47). Provedení instalace pomocí --upgrade příkazu upgraduje všechny součásti agenta na nejnovější verzi.

Spuštěním následujícího příkazu upgradujte agenta:

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

Povolení automatické aktualizace pro agenta Linuxu

Doporučujeme povolit automatický upgrade rozšíření pomocí těchto příkazů, abyste agenta aktualizovali automaticky.

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

Přidání nebo odebrání pracovního prostoru

Přidejte nebo odeberte pracovní prostor pomocí agenta pro Windows nebo agenta Linuxu.

Agent Windows

Kroky v této části jsou nezbytné nejen v případě, že chcete překonfigurovat agenta Windows tak, aby sestavil jiný pracovní prostor, nebo odebrat pracovní prostor z jeho konfigurace, ale také v případě, že chcete agenta nakonfigurovat tak, aby sestavil více než jeden pracovní prostor. (Tento postup se běžně označuje jako multihoming.) Konfiguraci agenta Windows pro hlášení do více pracovních prostorů je možné provést pouze po počátečním nastavení agenta a pomocí metod popsaných v této části.

Aktualizace nastavení z Ovládací panely

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. Otevřete okno Ovládací panely.

  3. Vyberte Microsoft Monitoring Agent a pak vyberte kartu Azure Log Analytics .

  4. Pokud pracovní prostor odebíráte, vyberte ho a pak vyberte Odebrat. Tento krok opakujte pro jakýkoli jiný pracovní prostor, do kterého má agent ukončit vytváření sestav.

  5. Pokud přidáváte pracovní prostor, vyberte Přidat. V dialogovém okně Přidat pracovní prostor služby Log Analytics vložte ID pracovního prostoru a klíč pracovního prostoru (primární klíč). Pokud se má počítač hlásit do pracovního prostoru služby Log Analytics v cloudu Azure Government, v rozevíracím seznamu Azure Cloud vyberte Azure US Government.

  6. Kliknutím na TLAČÍTKO OK uložte provedené změny.

Odebrání pracovního prostoru pomocí PowerShellu

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

Přidání pracovního prostoru v komerčním prostředí Azure pomocí PowerShellu

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

Přidání pracovního prostoru v Azure pro státní správu USA pomocí PowerShellu

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

Poznámka:

Pokud jste dříve k instalaci nebo konfiguraci agenta použili příkazový řádek nebo skript, EnableAzureOperationalInsights nahradili ho AddCloudWorkspace a RemoveCloudWorkspace.

Agent pro Linux

Následující kroky ukazují, jak překonfigurovat agenta Pro Linux, pokud se rozhodnete ho zaregistrovat v jiném pracovním prostoru nebo odebrat pracovní prostor z jeho konfigurace.

  1. Pokud chcete ověřit, že je agent zaregistrovaný v pracovním prostoru, spusťte následující příkaz:

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

    Měl by vrátit stav podobný následujícímu příkladu:

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

    Je důležité, aby se ve stavu zobrazoval také spuštěný agent. V opačném případě se následující kroky pro překonfigurování agenta nedokončí úspěšně.

  2. Pokud už je agent zaregistrovaný v pracovním prostoru, odeberte registrovaný pracovní prostor spuštěním následujícího příkazu. Jinak pokud není zaregistrovaný, přejděte k dalšímu kroku.

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

  3. Pokud se chcete zaregistrovat v jiném pracovním prostoru, spusťte následující příkaz:

    /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. Pokud chcete ověřit, že se změny projevily, spusťte následující příkaz:

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

    Měl by vrátit stav podobný následujícímu příkladu:

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

Aby se změny projevily, není potřeba restartovat službu agenta.

Aktualizace nastavení proxy serveru

Agent Log Analytics (MMA) nepoužívá nastavení systémového proxy serveru. V důsledku toho musíte při instalaci MMA předat nastavení proxy serveru. Tato nastavení se uloží v rámci konfigurace MMA (registru) na virtuálním počítači. Pokud chcete nakonfigurovat agenta tak, aby po nasazení komunikovali se službou prostřednictvím proxy serveru nebo brány Log Analytics, pomocí jedné z následujících metod dokončete tuto úlohu.

Agent Windows

Použijte agenta systému Windows.

Aktualizace nastavení pomocí Ovládací panely

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. Otevřete okno Ovládací panely.

  3. Vyberte Microsoft Monitoring Agent a pak vyberte kartu Proxy Nastavení.

  4. Vyberte Použít proxy server a zadejte adresu URL a číslo portu proxy serveru nebo brány. Pokud váš proxy server nebo brána Log Analytics vyžaduje ověření, zadejte uživatelské jméno a heslo pro ověření a pak vyberte OK.

Aktualizace nastavení pomocí PowerShellu

Zkopírujte následující ukázkový kód PowerShellu, aktualizujte ho informacemi specifickými pro vaše prostředí a uložte ho s příponou názvu souboru PS1. Spusťte skript na každém počítači, který se připojuje přímo k pracovnímu prostoru služby Log Analytics ve službě Azure Monitor.

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)

Agent pro Linux

Pokud počítače s Linuxem potřebují komunikovat přes proxy server nebo bránu Log Analytics, proveďte následující kroky. Hodnota konfigurace proxy serveru má následující syntaxi: [protocol://][user:password@]proxyhost[:port]. Vlastnost proxyhost přijímá plně kvalifikovaný název domény nebo IP adresu proxy serveru.

  1. Upravte soubor /etc/opt/microsoft/omsagent/proxy.conf spuštěním následujících příkazů a změňte hodnoty na vaše konkrétní nastavení:

    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

  2. Restartujte agenta spuštěním následujícího příkazu:

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

    Pokud se v protokolu zobrazí cURL failed to perform on this base url , můžete zkusit odstranit '\n' chybu v proxy.conf EOF:

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

Odinstalace agenta

Pomocí jednoho z následujících postupů odinstalujte agenta systému Windows nebo Linux pomocí příkazového řádku nebo Průvodce instalací.

Agent Windows

Použijte agenta systému Windows.

Odinstalace z Ovládací panely

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. V Ovládací panely vyberte Programy a funkce.

  3. V části Programy a funkce vyberte Microsoft Monitoring Agent>Odinstalovat>Ano.

Poznámka:

Průvodce instalací agenta lze spustit také poklikánímMMASetup-\<platform\>.exe, který je k dispozici ke stažení z pracovního prostoru na webu Azure Portal.

Odinstalace z příkazového řádku

Stažený soubor pro agenta je samostatný instalační balíček vytvořený pomocí IExpress. Instalační program pro agenta a podpůrné soubory jsou obsaženy v balíčku a musí být extrahovány k správné odinstalaci pomocí příkazového řádku zobrazeného v následujícím příkladu.

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. Chcete-li extrahovat instalační soubory agenta, spusťte z příkazového řádku extract MMASetup-<platform>.exe se zvýšenými oprávněními a zobrazí se výzva k zadání cesty k extrahování souborů. Alternativně můžete zadat cestu předáním argumentů extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Další informace o přepínačích příkazového řádku podporovaných aplikací IExpress naleznete v tématu Přepínače příkazového řádku pro IExpress a pak aktualizujte příklad tak, aby vyhovoval vašim potřebám.

  3. Na příkazovém řádku zadejte %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Agent pro Linux

Pokud chcete agenta odebrat, spusťte v počítači s Linuxem následující příkaz. Argument --purge zcela odebere agenta a jeho konfiguraci.

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

Konfigurace agenta pro hlášení skupině pro správu Operations Manageru

Použijte agenta systému Windows.

Agent Windows

Pomocí následujících kroků nakonfigurujte agenta Log Analytics pro Windows tak, aby se hlásil skupině pro správu nástroje System Center Operations Manager.

Poznámka:

V rámci průběžného přechodu ze sady Microsoft Operations Management Suite na Azure Monitor se Agent sady Operations Management Suite pro Windows nebo Linux bude označovat jako agent Log Analytics pro Windows, resp. agent Log Analytics pro Linux.

  1. Přihlaste se k počítači pomocí účtu, který má práva správce.

  2. Otevřete okno Ovládací panely.

  3. Vyberte Microsoft Monitoring Agent a pak vyberte kartu Operations Manageru .

  4. Pokud vaše servery Operations Manageru mají integraci se službou Active Directory, vyberte ze služby AD DS automaticky aktualizovat přiřazení skupin pro správu.

  5. Výběrem možnosti Přidat otevřete dialogové okno Přidat skupinu pro správu.

  6. Do pole Název skupiny pro správu zadejte název vaší skupiny pro správu.

  7. Do pole Primární server pro správu zadejte název počítače primárního serveru pro správu.

  8. Do pole Port serveru pro správu zadejte číslo portu TCP.

  9. V části Účet akce agenta zvolte účet místního systému nebo účet místní domény.

  10. Kliknutím na tlačítko OK zavřete dialogové okno Přidat skupinu pro správu. Potom kliknutím na tlačítko OK zavřete dialogové okno Vlastnosti agenta Microsoft Monitoring Agent.

Agent pro Linux

Provedením následujících kroků nakonfigurujte agenta Log Analytics pro Linux tak, aby se hlásil skupině pro správu nástroje System Center Operations Manager.

Poznámka:

V rámci průběžného přechodu ze sady Microsoft Operations Management Suite na Azure Monitor se Agent sady Operations Management Suite pro Windows nebo Linux bude označovat jako agent Log Analytics pro Windows, resp. agent Log Analytics pro Linux.

  1. Upravte soubor /etc/opt/omi/conf/omiserver.conf.

  2. Ujistěte se, že řádek začínající httpsport= definuje port 1270, například httpsport=1270.

  3. Restartujte server OMI pomocí následujícího příkazu:

    sudo /opt/omi/bin/service_control restart

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Návody zastavit komunikaci agenta Log Analytics se službou Azure Monitor?

U agentů připojených k Log Analytics přímo otevřete Ovládací panely a vyberte Microsoft Monitoring Agent. Na kartě Azure Log Analytics (OMS) odeberte všechny uvedené pracovní prostory. V nástroji System Center Operations Manager odeberte počítač ze seznamu spravovaných počítačů služby Log Analytics. Operations Manager aktualizuje konfiguraci agenta tak, aby se přestal hlásit do Log Analytics.

Další kroky