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

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.

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.

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 för 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. Under listan med resurser, skriv in Log Analytics. När du börjar skriva filtreras listan baserat på dina indata. 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.

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. För att extrahera agentinstallationsfilerna kör du MMASetup-<platform>.exe /c från en upphöjd kommandotolk, så uppmanas du att ange sökvägen dit filerna ska extraheras. 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

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

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.

Windowsagent

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()

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 ange proxyinställningar när 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.

Windowsagent

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 Proxyinställningar .

4. Välj Använd en proxyserver och ange URL:en och portnumret 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.

Windowsagent

Använd Windows-agenten.

Avinstallera från Kontrollpanelen

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

2. Välj Program och funktioner på Kontrollpanelen.

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

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. För att extrahera agentinstallationsfilerna, kör extract MMASetup-<platform>.exe från en upphöjd kommandotolk och du uppmanas att ange sökvägen där filerna ska extraheras 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

Om du vill ta bort agenten kör du följande kommando 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.

Windowsagent

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

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.

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

Den här sektionen ger svar på vanliga frågor.

Hur hindrar jag Log Analytics-agenten från att kommunicera med Azure Monitor?

Öppna Kontrollpanelen för agenter som är anslutna till Log Analytics direkt och välj Microsoft Monitoring Agent. 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

• Läs Felsöka Linux-agenten om du stöter på problem när du installerar eller hanterar Linux-agenten.
• Läs Felsöka Windows-agenten om du stöter på problem när du installerar eller hanterar Windows-agenten.