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 tillbakadragningssteget 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. 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 den miljö 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 din Azure Resource Manager-mall att välja bort genom att ställa in egenskapen autoUpgradeMinorVersionfalse. När tillägget har distribuerats uppgraderas dock inte delversioner om de inte distribueras om, ä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 Egenskapen VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
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 med självextrahering och installationsbart gränssnitt.
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 med självextrahering och installationsbart gränssnitt.

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-plattformen<>.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 listan över Log Analytics-arbetsytor väljer du arbetsytan.

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

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

Anteckning

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 .exeför MMASetup-plattformen<> för att starta installationsguiden.

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

  4. I dialogrutan Microsoft Installation av övervakningsagent väljer du Jag godkänner licensavtalet.

  5. I dialogrutan Microsoft Installation av övervakningsagenten väljer du Uppgradera. På statussidan visas uppgraderingsförloppet.

  6. När den Microsoft övervakningsagentkonfigurationen har slutförts 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, så uppmanas du 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 dess konfiguration, 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 så att den rapporterar 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 لوحة التحكم

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

  2. Öppna Kontrollpanelen.

  3. Välj Microsoft Övervakningsagent och välj sedan fliken Azure Log Analytics.

  4. Om du tar bort en arbetsyta markerar 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ärnyckel). Om datorn ska rapportera till en Log Analytics-arbetsyta i Azure Government moln väljer du Azure US Government i listrutan Azure Cloud.

  6. Klicka på OK för att spara ändringarna.

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 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 for US Government med PowerShell

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

Anteckning

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 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 började gälla 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 لوحة التحكم

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

  2. Öppna Kontrollpanelen.

  3. Välj Microsoft Övervakningsagent och välj sedan fliken Proxyinstä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 لوحة التحكم

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

  2. I لوحة التحكم väljer du Program och funktioner.

  3. I Program och funktioner väljer du MicrosoftAvinstallera>övervakningsagenten>Ja.

Anteckning

Guiden Agentinstallation kan också köras genom att MMASetup-\<platform\>.exedubbelklicka på , vilket är tillgängligt för nedladdning från en arbetsyta i Azure-Portal.

Avinstallera från kommandoraden

Den nedladdade filen för agenten är ett fristående installationspaket som skapats med IExpress. Konfigurationsprogrammet 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 uppdatera sedan exemplet efter dina behov.

  3. I prompten 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 bort agenten och dess konfiguration helt.

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.

Anteckning

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 Övervakningsagent 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 Övervakningsagent.

Linux-agent

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

Anteckning

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

Nästa steg