De Log Analytics-agent voor Windows en Linux beheren en onderhouden

  • Artikel

Na de eerste implementatie van de Log Analytics Windows- of Linux-agent in Azure Monitor moet u de agent mogelijk opnieuw configureren, upgraden of verwijderen van de computer als deze de buitengebruikstellingsfase in de levenscyclus heeft bereikt. U kunt deze routineonderhoudstaken eenvoudig handmatig of via automatisering beheren, waardoor zowel operationele fouten als uitgaven worden verminderd.

Belangrijk

De verouderde Log Analytics-agentwordt in augustus 2024 afgeschaft. Na deze datum biedt Microsoft geen ondersteuning meer voor de Log Analytics-agent. Migreer vóór augustus 2024 naar de Azure Monitor-agent om door te gaan met het opnemen van gegevens.

De agent upgraden

Voer een upgrade uit naar de nieuwste versie van de Log Analytics-agent voor Windows en Linux handmatig of automatisch op basis van uw implementatiescenario en de omgeving waarin de VIRTUELE machine wordt uitgevoerd.

Omgeving Installatiemethode Upgrademethode
Azure VM Log Analytics-agent-VM-extensie voor Windows/Linux De agent wordt automatisch bijgewerkt nadat het VM-model is gewijzigd, tenzij u uw Azure Resource Manager-sjabloon hebt geconfigureerd om u af te wijzen door de eigenschap autoUpgradeMinorVersion in te stellen op false. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true. Alleen de Linux-agent ondersteunt automatische update na implementatie met enableAutomaticUpgrade eigenschap (zie Automatisch bijwerken inschakelen voor de Linux-agent). De primaire versie-upgrade is altijd handmatig (zie VirtualMachineExtensionInner.AutoUpgradeMinorVersion Property).
Aangepaste Azure VM-installatiekopieën Handmatige installatie van Log Analytics-agent voor Windows/Linux Het bijwerken van VM's naar de nieuwste versie van de agent moet worden uitgevoerd vanaf de opdrachtregel waarop het Windows Installer-pakket of linux zelf uitpakken en installerende shell scriptbundel wordt uitgevoerd.
Niet-Azure-VM's Handmatige installatie van Log Analytics-agent voor Windows/Linux Het bijwerken van VM's naar de nieuwste versie van de agent moet worden uitgevoerd vanaf de opdrachtregel waarop het Windows Installer-pakket of linux zelf uitpakken en installerende shell scriptbundel wordt uitgevoerd.

De Windows-agent upgraden

Als u de agent op een Windows-VM wilt bijwerken naar de nieuwste versie die niet is geïnstalleerd met de Log Analytics VM-extensie, voert u deze uit vanaf de opdrachtprompt, het script of een andere automatiseringsoplossing of gebruikt u de installatiewizard MMASetup-platform.msi<>.

De nieuwste versie van de Windows-agent downloaden vanuit uw Log Analytics-werkruimte:

  1. Meld u aan bij de Azure-portal.

  2. Selecteer in de Azure-portal de optie Alle services. Voer Log Analytics in de lijst met resources in. Als u begint te typen, wordt de lijst gefilterd op basis van uw invoer. Selecteer Log Analytics-werkruimten.

  3. Selecteer de werkruimte in uw lijst met Log Analytics-werkruimten.

  4. Selecteer in uw Log Analytics-werkruimte de tegel Agents en selecteer vervolgens Windows-servers.

  5. Selecteer in het scherm Windows-servers de juiste windows-agentversie downloaden die u wilt downloaden, afhankelijk van de processorarchitectuur van het Windows-besturingssysteem.

Notitie

Tijdens de upgrade van de Log Analytics-agent voor Windows biedt dit geen ondersteuning voor het configureren of opnieuw configureren van een werkruimte waarnaar een rapport moet worden uitgevoerd. Als u de agent wilt configureren, volgt u een van de ondersteunde methoden die worden vermeld onder Een werkruimte toevoegen of verwijderen.

Upgraden met behulp van de installatiewizard

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Voer MMASetup-platform.exe<> uit om de installatiewizard te starten.

  3. Selecteer Volgende op de eerste pagina van de wizard Setup.

  4. Selecteer in het dialoogvenster Setup van Microsoft Monitoring Agent de optie Ik ga akkoord met de gebruiksrechtovereenkomst.

  5. Selecteer Upgrade in het dialoogvenster Setup van Microsoft Monitoring Agent. Op de statuspagina wordt de voortgang van de upgrade weergegeven.

  6. Wanneer de configuratie van de Microsoft Monitoring Agent is voltooid wordt weergegeven, selecteert u Voltooien.

Upgrade uitvoeren vanaf de opdrachtregel

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Als u de installatiebestanden van de agent wilt extraheren, voert MMASetup-<platform>.exe /c u uit vanaf een opdrachtprompt met verhoogde bevoegdheid en wordt u gevraagd om het pad naar bestanden te extraheren. U kunt ook het pad opgeven door de argumenten MMASetup-<platform>.exe /c /t:<Full Path>door te geven.

  3. Voer de volgende opdracht uit, waarbij D:\ de locatie is voor het upgradelogboekbestand:

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

De Linux-agent upgraden

Upgrade van eerdere versies (>1.0.0-47) wordt ondersteund. Als u de installatie uitvoert met de --upgrade opdracht, worden alle onderdelen van de agent bijgewerkt naar de nieuwste versie.

Voer de volgende opdracht uit om de agent bij te werken:

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

Automatisch bijwerken inschakelen voor de Linux-agent

U wordt aangeraden automatische extensie-upgrade in te schakelen met behulp van deze opdrachten om de agent automatisch bij te werken.

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

Een werkruimte toevoegen of verwijderen

Een werkruimte toevoegen of verwijderen met behulp van de Windows-agent of de Linux-agent.

Windows-agent

De stappen in deze sectie zijn niet alleen nodig wanneer u de Windows-agent opnieuw wilt configureren om te rapporteren aan een andere werkruimte of een werkruimte wilt verwijderen uit de configuratie, maar ook wanneer u de agent wilt configureren om te rapporteren aan meer dan één werkruimte. (Deze praktijk wordt vaak multihoming genoemd.) Het configureren van de Windows-agent voor het rapporteren aan meerdere werkruimten kan alleen worden uitgevoerd na de eerste installatie van de agent en met behulp van de methoden die in deze sectie worden beschreven.

Instellingen bijwerken vanuit Configuratiescherm

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Open het Configuratiescherm.

  3. Selecteer Microsoft Monitoring Agent en selecteer vervolgens het tabblad Azure Log Analytics .

  4. Als u een werkruimte verwijdert, selecteert u deze en selecteert u Verwijderen. Herhaal deze stap voor elke andere werkruimte waarnaar u wilt dat de agent stopt met rapporteren.

  5. Als u een werkruimte toevoegt, selecteert u Toevoegen. Plak in het dialoogvenster Een Log Analytics-werkruimte toevoegen de werkruimte-id en werkruimtesleutel (primaire sleutel). Als u de computer wilt laten rapporteren bij een Log Analytics-werkruimte in de Azure Government-cloud, selecteert u Azure US Government in de vervolgkeuzelijst Azure Cloud.

  6. Selecteer OK om uw wijzigingen op te slaan.

Een werkruimte verwijderen met Behulp van PowerShell

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

Een werkruimte toevoegen in Azure Commercial met behulp van PowerShell

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

Een werkruimte toevoegen in Azure for US Government met behulp van PowerShell

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

Notitie

Als u de opdrachtregel of het script eerder hebt gebruikt om de agent te installeren of te configureren, EnableAzureOperationalInsights is deze vervangen door AddCloudWorkspace en RemoveCloudWorkspace.

Linux-agent

De volgende stappen laten zien hoe u de Linux-agent opnieuw configureert als u besluit deze te registreren bij een andere werkruimte of om een werkruimte uit de configuratie te verwijderen.

  1. Voer de volgende opdracht uit om te controleren of de agent is geregistreerd bij een werkruimte:

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

    Er moet een status worden geretourneerd die vergelijkbaar is met het volgende voorbeeld:

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

    Het is belangrijk dat de status ook laat zien dat de agent wordt uitgevoerd. Anders worden de volgende stappen om de agent opnieuw te configureren niet voltooid.

  2. Als de agent al is geregistreerd bij een werkruimte, verwijdert u de geregistreerde werkruimte door de volgende opdracht uit te voeren. Als dit niet is geregistreerd, gaat u verder met de volgende stap.

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

  3. Voer de volgende opdracht uit om u te registreren bij een andere werkruimte:

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

  4. Voer de volgende opdracht uit om te controleren of uw wijzigingen van kracht zijn:

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

    Er moet een status worden geretourneerd die vergelijkbaar is met het volgende voorbeeld:

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

De agentservice hoeft niet opnieuw te worden gestart om de wijzigingen van kracht te laten worden.

Proxy-instellingen bijwerken

Log Analytics Agent (MMA) maakt geen gebruik van de systeemproxy-instellingen. Als gevolg hiervan moet u proxy-instellingen doorgeven tijdens het installeren van MMA. Deze instellingen worden opgeslagen onder de MMA-configuratie (register) op de VIRTUELE machine. Als u de agent wilt configureren voor communicatie met de service via een proxyserver of Log Analytics-gateway na de implementatie, gebruikt u een van de volgende methoden om deze taak te voltooien.

Windows-agent

Gebruik een Windows-agent.

Instellingen bijwerken met Configuratiescherm

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Open het Configuratiescherm.

  3. Selecteer Microsoft Monitoring Agent en selecteer vervolgens het tabblad Proxy Instellingen.

  4. Selecteer Een proxyserver gebruiken en geef de URL en het poortnummer van de proxyserver of gateway op. Als voor uw proxyserver of Log Analytics-gateway verificatie is vereist, voert u de gebruikersnaam en het wachtwoord in om te verifiëren en selecteert u OK.

Instellingen bijwerken met Behulp van PowerShell

Kopieer de volgende PowerShell-voorbeeldcode, werk deze bij met informatie die specifiek is voor uw omgeving en sla deze op met een PS1-bestandsnaamextensie. Voer het script uit op elke computer die rechtstreeks verbinding maakt met de Log Analytics-werkruimte in 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

Voer de volgende stappen uit als uw Linux-computers moeten communiceren via een proxyserver of Log Analytics-gateway. De proxyconfiguratiewaarde heeft de volgende syntaxis: [protocol://][user:password@]proxyhost[:port]. De proxyhost eigenschap accepteert een volledig gekwalificeerde domeinnaam of IP-adres van de proxyserver.

  1. Bewerk het bestand /etc/opt/microsoft/omsagent/proxy.conf door de volgende opdrachten uit te voeren en de waarden te wijzigen in uw specifieke instellingen:

    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. Start de agent opnieuw door de volgende opdracht uit te voeren:

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

    Als u in het logboek ziet cURL failed to perform on this base url , kunt u proberen te verwijderen '\n' in proxy.conf EOF om de fout op te lossen:

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

Agent verwijderen

Gebruik een van de volgende procedures om de Windows- of Linux-agent te verwijderen met behulp van de opdrachtregel of installatiewizard.

Windows-agent

Gebruik de Windows-agent.

Verwijderen uit Configuratiescherm

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Selecteer Programma's en onderdelen in het configuratiescherm.

  3. Selecteer In Programma's en onderdelen Microsoft Monitoring Agent>Verwijderen>Ja.

Notitie

De wizard Agent instellen kan ook worden uitgevoerd door te dubbelklikken MMASetup-\<platform\>.exe. Deze kan worden gedownload vanuit een werkruimte in Azure Portal.

Verwijderen vanaf de opdrachtregel

Het gedownloade bestand voor de agent is een zelfstandig installatiepakket dat is gemaakt met IExpress. Het installatieprogramma voor de agent en ondersteunende bestanden bevinden zich in het pakket en moeten worden geëxtraheerd om correct te verwijderen met behulp van de opdrachtregel die in het volgende voorbeeld wordt weergegeven.

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Als u de installatiebestanden van de agent wilt extraheren, voert u een opdrachtprompt met verhoogde bevoegdheid uit extract MMASetup-<platform>.exe en wordt u gevraagd om het pad naar bestanden te extraheren. U kunt ook het pad opgeven door de argumenten extract MMASetup-<platform>.exe /c:<Path> /t:<Path>door te geven. Zie Opdrachtregelswitches voor IExpress voor meer informatie over de opdrachtregelswitches die worden ondersteund door IExpress en werk het voorbeeld vervolgens bij naar wens.

  3. Voer bij de prompt het volgende in %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Linux-agent

Voer de volgende opdracht op de Linux-computer uit om de agent te verwijderen. Het --purge argument verwijdert de agent en de configuratie ervan volledig.

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

Agent configureren om te rapporteren aan een Operations Manager-beheergroep

Gebruik de Windows-agent.

Windows-agent

Voer de volgende stappen uit om de Log Analytics-agent voor Windows te configureren om te rapporteren aan een System Center Operations Manager-beheergroep.

Notitie

Als onderdeel van de lopende overgang van Microsoft Operations Management Suite naar Azure Monitor, wordt er naar de Operations Management Suite Agent voor Windows of Linux verwezen als de Log Analytics-agent voor Windows en Log Analytics-agent voor Linux.

  1. Meld u aan bij de computer met een account met beheerdersrechten.

  2. Open het Configuratiescherm.

  3. Selecteer Microsoft Monitoring Agent en selecteer vervolgens het tabblad Operations Manager .

  4. Als uw Operations Manager-servers zijn geïntegreerd met Active Directory, selecteert u Automatisch beheergroeptoewijzingen bijwerken vanuit AD DS.

  5. Selecteer Toevoegen om het dialoogvenster Een beheergroep toevoegen te openen.

  6. Voer in het veld Naam van de beheergroep de naam van uw beheergroep in.

  7. Voer in het veld Primaire beheerserver de computernaam van de primaire beheerserver in.

  8. Voer in het veld Poort van de beheerserver het TCP-poortnummer in.

  9. Kies onder Actie-account van agent het lokale systeemaccount of een lokaal domeinaccount.

  10. Selecteer OK om het dialoogvenster Een beheergroep toevoegen te sluiten. Selecteer vervolgens OK om het dialoogvenster Eigenschappen van Microsoft Monitoring Agent te sluiten.

Linux-agent

Voer de volgende stappen uit om de Log Analytics-agent voor Linux te configureren om te rapporteren aan een System Center Operations Manager-beheergroep.

Notitie

Als onderdeel van de lopende overgang van Microsoft Operations Management Suite naar Azure Monitor, wordt er naar de Operations Management Suite Agent voor Windows of Linux verwezen als de Log Analytics-agent voor Windows en Log Analytics-agent voor Linux.

  1. Bewerk bestand /etc/opt/omi/conf/omiserver.conf.

  2. Zorg ervoor dat de lijn begint met httpsport= het definiëren van poort 1270, zoals httpsport=1270.

  3. Start de OMI-server opnieuw met behulp van de volgende opdracht:

    sudo /opt/omi/bin/service_control restart

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Hoe kan ik voorkomen dat de Log Analytics-agent communiceert met Azure Monitor?

Voor agents die rechtstreeks zijn verbonden met Log Analytics, opent u Configuratiescherm en selecteert u Microsoft Monitoring Agent. Verwijder op het tabblad Azure Log Analytics (OMS) alle weergegeven werkruimten. Verwijder in System Center Operations Manager de computer uit de lijst met beheerde Log Analytics-computers. Operations Manager werkt de configuratie van de agent bij zodat deze niet meer rapporteert aan Log Analytics.

Volgende stappen