Hantera och underhålla Log Analytics-agenten för Windows och Linux

  • Artikel

Efter den första distributionen av Log Analytics Windows- eller Linux-agenten i Azure Monitor kan du behöva konfigurera om agenten, uppgradera den eller ta bort den från datorn om den har nått tillbakadragningsfasen i livscykeln. Du kan enkelt hantera dessa rutinunderhållsuppgifter manuellt eller via automatisering, vilket minskar både driftfel och utgifter.

Viktigt!

Den äldre Log Analytics-agentenkommer att vara inaktuell i augusti 2024. Efter det här datumet kommer Microsoft inte längre att tillhandahålla någon support för Log Analytics-agenten. Migrera till Azure Monitor-agenten före augusti 2024 för att fortsätta mata in data.

Uppgradera agenten

Uppgradera till den senaste versionen av Log Analytics-agenten för Windows och Linux manuellt eller automatiskt baserat på ditt distributionsscenario och miljön som den virtuella datorn körs i.

Miljö Installationsmetod Uppgraderingsmetod
Azure VM Log Analytics-agentens VM-tillägg för Windows/Linux Agenten uppgraderas automatiskt efter att VM-modellen har ändrats, såvida du inte har konfigurerat Azure Resource Manager-mallen så att den avregistrerar sig genom att ställa in egenskapen autoUpgradeMinorVersion på false. När tillägget har distribuerats uppgraderas dock inte mindre versioner om inte omdistribueras, även med den här egenskapen inställd på true. Endast Linux-agenten stöder automatisk uppdatering efter distribution med enableAutomaticUpgrade egenskapen (se Aktivera automatisk uppdatering för Linux-agenten). Huvudversionsuppgradering är alltid manuell (se VirtualMachineExtensionInner.AutoUpgradeMinorVersion Property).
Anpassade avbildningar av virtuella Azure-datorer Manuell installation av Log Analytics-agenten för Windows/Linux Uppdatering av virtuella datorer till den senaste versionen av agenten måste utföras från kommandoraden som kör Windows installer-paketet eller Linux-skriptpaketet för självextrahering och installation.
Virtuella datorer som inte är Azure-datorer Manuell installation av Log Analytics-agenten för Windows/Linux Uppdatering av virtuella datorer till den senaste versionen av agenten måste utföras från kommandoraden som kör Windows installer-paketet eller Linux-skriptpaketet för självextrahering och installation.

Uppgradera Windows-agenten

Om du vill uppdatera agenten på en virtuell Windows-dator till den senaste versionen som inte har installerats med log analytics VM-tillägget kör du antingen från kommandotolken, skriptet eller någon annan automatiseringslösning eller använder installationsguiden MMASetup-platform.msi<>.

Så här laddar du ned den senaste versionen av Windows-agenten från Log Analytics-arbetsytan:

  1. Logga in på Azure-portalen.

  2. Välj Alla tjänster i Azure-portalen. I listan över resurser anger du Log Analytics. När du börjar skriva filtreras listan baserat på det du skriver. Välj Log Analytics-arbetsytor.

  3. I din lista över Log Analytics-arbetsytor väljer du arbetsytan.

  4. På Log Analytics-arbetsytan väljer du panelen Agenter och sedan Windows-servrar.

  5. På skärmen Windows-servrar väljer du lämplig Version av Ladda ned Windows Agent som ska laddas ned beroende på processorarkitekturen i Windows-operativsystemet.

Kommentar

Under uppgraderingen av Log Analytics-agenten för Windows stöder den inte konfiguration eller omkonfiguration av en arbetsyta att rapportera till. Om du vill konfigurera agenten följer du någon av de metoder som stöds under Lägg till eller ta bort en arbetsyta.

Uppgradera med installationsguiden

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. Kör MMASetup-platform.exe<> för att starta installationsguiden.

  3. På den första sidan i installationsguiden väljer du Nästa.

  4. I dialogrutan Installation av Microsoft Monitoring Agent väljer du Jag godkänner licensavtalet.

  5. I dialogrutan Installation av Microsoft Monitoring Agent väljer du Uppgradera. Statussidan visar uppgraderingens förlopp.

  6. När microsoft Monitoring Agent-konfigurationen har slutförts visas väljer du Slutför.

Uppgradera från kommandoraden

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. Om du vill extrahera agentinstallationsfilerna kör MMASetup-<platform>.exe /c du från en upphöjd kommandotolk och uppmanar dig att ange sökvägen för att extrahera filer till. Du kan också ange sökvägen genom att skicka argumenten MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Kör följande kommando, där D:\ är platsen för uppgraderingsloggfilen:

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

Uppgradera Linux-agenten

Uppgradering från tidigare versioner (>1.0.0-47) stöds. Om du utför installationen med --upgrade kommandot uppgraderas alla komponenter i agenten till den senaste versionen.

Kör följande kommando för att uppgradera agenten:

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

Aktivera automatisk uppdatering för Linux-agenten

Vi rekommenderar att du aktiverar automatisk uppgradering av tillägg med hjälp av dessa kommandon för att uppdatera agenten automatiskt.

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

Lägga till eller ta bort en arbetsyta

Lägg till eller ta bort en arbetsyta med hjälp av Windows-agenten eller Linux-agenten.

Windows-agent

Stegen i det här avsnittet är nödvändiga inte bara när du vill konfigurera om Windows-agenten för att rapportera till en annan arbetsyta eller ta bort en arbetsyta från konfigurationen, utan även när du vill konfigurera agenten att rapportera till mer än en arbetsyta. (Den här metoden kallas ofta multihoming.) Det går bara att konfigurera Windows-agenten för att rapportera till flera arbetsytor efter den första installationen av agenten och med hjälp av de metoder som beskrivs i det här avsnittet.

Uppdatera inställningar från Kontrollpanelen

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. Öppna Kontrollpanelen.

  3. Välj Microsoft Monitoring Agent och välj sedan fliken Azure Log Analytics .

  4. Om du tar bort en arbetsyta väljer du den och väljer sedan Ta bort. Upprepa det här steget för alla andra arbetsytor som du vill att agenten ska sluta rapportera till.

  5. Om du lägger till en arbetsyta väljer du Lägg till. I dialogrutan Lägg till en Log Analytics-arbetsyta klistrar du in arbetsytans ID och arbetsytenyckel (primär nyckel). Om datorn ska rapportera till en Log Analytics-arbetsyta i Azure Government-molnet väljer du Azure US Government i listrutan Azure Cloud .

  6. Spara ändringarna genom att välja OK.

Ta bort en arbetsyta med PowerShell

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

Lägga till en arbetsyta i Azure Commercial med Hjälp av PowerShell

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

Lägga till en arbetsyta i Azure för amerikanska myndigheter med PowerShell

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

Kommentar

Om du tidigare har använt kommandoraden eller skriptet för att installera eller konfigurera agenten EnableAzureOperationalInsights ersattes du av AddCloudWorkspace och RemoveCloudWorkspace.

Linux-agent

Följande steg visar hur du konfigurerar om Linux-agenten om du bestämmer dig för att registrera den med en annan arbetsyta eller om du vill ta bort en arbetsyta från dess konfiguration.

  1. Kontrollera att agenten är registrerad på en arbetsyta genom att köra följande kommando:

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

    Den bör returnera en status som liknar följande exempel:

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

    Det är viktigt att statusen också visar att agenten körs. Annars slutförs inte följande steg för att konfigurera om agenten.

  2. Om agenten redan är registrerad med en arbetsyta tar du bort den registrerade arbetsytan genom att köra följande kommando. Annars går du vidare till nästa steg om den inte är registrerad.

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

  3. Om du vill registrera dig med en annan arbetsyta kör du följande kommando:

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

  4. Kontrollera att ändringarna trädde i kraft genom att köra följande kommando:

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

    Den bör returnera en status som liknar följande exempel:

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

Agenttjänsten behöver inte startas om för att ändringarna ska börja gälla.

Uppdatera proxyinställningar

Log Analytics Agent (MMA) använder inte systemproxyinställningarna. Därför måste du skicka proxyinställningar medan du installerar MMA. De här inställningarna lagras under MMA-konfiguration (register) på den virtuella datorn. Om du vill konfigurera agenten att kommunicera med tjänsten via en proxyserver eller Log Analytics-gateway efter distributionen använder du någon av följande metoder för att slutföra den här uppgiften.

Windows-agent

Använd en Windows-agent.

Uppdatera inställningar med hjälp av Kontrollpanelen

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. Öppna Kontrollpanelen.

  3. Välj Microsoft Monitoring Agent och välj sedan fliken Proxy Inställningar.

  4. Välj Använd en proxyserver och ange URL och portnummer för proxyservern eller gatewayen. Om proxyservern eller Log Analytics-gatewayen kräver autentisering anger du användarnamnet och lösenordet för att autentisera och väljer sedan OK.

Uppdatera inställningar med PowerShell

Kopiera följande PowerShell-exempelkod, uppdatera den med information som är specifik för din miljö och spara den med ett PS1-filnamnstillägg. Kör skriptet på varje dator som ansluter direkt till Log Analytics-arbetsytan i 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)

Linux-agent

Utför följande steg om dina Linux-datorer behöver kommunicera via en proxyserver eller Log Analytics-gateway. Proxykonfigurationsvärdet har följande syntax: [protocol://][user:password@]proxyhost[:port]. Egenskapen proxyhost accepterar ett fullständigt kvalificerat domännamn eller EN IP-adress för proxyservern.

  1. Redigera filen /etc/opt/microsoft/omsagent/proxy.conf genom att köra följande kommandon och ändra värdena till dina specifika inställningar:

    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. Starta om agenten genom att köra följande kommando:

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

    Om du ser cURL failed to perform on this base url i loggen kan du försöka ta bort '\n' i proxy.conf EOF för att lösa felet:

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

Avinstallera agent

Använd någon av följande procedurer för att avinstallera Windows- eller Linux-agenten med hjälp av kommandoraden eller installationsguiden.

Windows-agent

Använd Windows-agenten.

Avinstallera från Kontrollpanelen

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. I Kontrollpanelen väljer du Program och funktioner.

  3. I Program och funktioner väljer du Avinstallera>Microsoft Monitoring Agent>Ja.

Kommentar

Installationsguiden för agenten kan också köras genom att MMASetup-\<platform\>.exedubbelklicka på , som är tillgänglig för nedladdning från en arbetsyta i Azure-portalen.

Avinstallera från kommandoraden

Den nedladdade filen för agenten är ett fristående installationspaket som skapats med IExpress. Installationsprogrammet för agenten och stödfilerna finns i paketet och måste extraheras för att avinstalleras korrekt med hjälp av kommandoraden som visas i följande exempel.

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. Om du vill extrahera agentinstallationsfilerna från en upphöjd kommandotolk körs extract MMASetup-<platform>.exe och du uppmanas att ange sökvägen för att extrahera filer till. Du kan också ange sökvägen genom att skicka argumenten extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Mer information om kommandoradsväxlar som stöds av IExpress finns i Kommandoradsväxlar för IExpress och uppdaterar sedan exemplet efter dina behov.

  3. I kommandotolken anger du %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Linux-agent

Kör följande kommando för att ta bort agenten på Linux-datorn. Argumentet --purge tar helt bort agenten och dess konfiguration.

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

Konfigurera agenten att rapportera till en Operations Manager-hanteringsgrupp

Använd Windows-agenten.

Windows-agent

Utför följande steg för att konfigurera Log Analytics-agenten för Windows att rapportera till en System Center Operations Manager-hanteringsgrupp.

Kommentar

Som en del av den pågående övergången från Microsoft Operations Management Suite till Azure Monitor kan Operations Management Suite-agenten för Windows eller Linux kallas för Log Analytics-agenten för Windows och Log Analytics-agenten för Linux.

  1. Logga in på datorn med ett konto som har administrativa rättigheter.

  2. Öppna Kontrollpanelen.

  3. Välj Microsoft Monitoring Agent och välj sedan fliken Operations Manager .

  4. Om Operations Manager-servrarna har integrering med Active Directory väljer du Uppdatera hanteringsgrupptilldelningar automatiskt från AD DS.

  5. Välj Lägg till för att öppna dialogrutan Lägg till en hanteringsgrupp .

  6. I fältet Hanteringsgruppsnamn anger du namnet på hanteringsgruppen.

  7. I fältet Primär hanteringsserver anger du datornamnet för den primära hanteringsservern.

  8. I fältet Hanteringsserverport anger du TCP-portnumret.

  9. Under Agentåtgärdskonto väljer du antingen det lokala systemkontot eller ett lokalt domänkonto.

  10. Välj OK för att stänga dialogrutan Lägg till en hanteringsgrupp . Välj sedan OK för att stänga dialogrutan Egenskaper för Microsoft Monitoring Agent.

Linux-agent

Utför följande steg för att konfigurera Log Analytics-agenten för Linux att rapportera till en System Center Operations Manager-hanteringsgrupp.

Kommentar

Som en del av den pågående övergången från Microsoft Operations Management Suite till Azure Monitor kan Operations Management Suite-agenten för Windows eller Linux kallas för Log Analytics-agenten för Windows och Log Analytics-agenten för Linux.

  1. Redigera filen /etc/opt/omi/conf/omiserver.conf.

  2. Se till att raden som börjar med httpsport= definierar port 1270, till exempel httpsport=1270.

  3. Starta om OMI-servern med följande kommando:

    sudo /opt/omi/bin/service_control restart

Vanliga frågor och svar

Det här avsnittet innehåller svar på vanliga frågor.

Hur gör jag för att stoppa Log Analytics-agenten från att kommunicera med Azure Monitor?

Öppna Kontrollpanelen och välj Microsoft Monitoring Agent för agenter som är anslutna till Log Analytics direkt. Under fliken Azure Log Analytics (OMS) tar du bort alla arbetsytor som visas. I System Center Operations Manager tar du bort datorn från listan Log Analytics-hanterade datorer. Operations Manager uppdaterar agentkonfigurationen så att den inte längre rapporterar till Log Analytics.

Nästa steg