De Log Analytics-agent voor Windows en Linux beheren en onderhouden
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-agent wordt in augustus 2024 afgeschaft. Na deze datum biedt Microsoft geen ondersteuning meer voor de Logboekanalyse-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 behulp van de Log Analytics VM-extensie, voert u deze uit vanaf de opdrachtprompt, het script of een andere automatiseringsoplossing of gebruikt u de wizard MMASetup-platform<>.msi Installatiewizard.
De nieuwste versie van de Windows-agent downloaden vanuit uw Log Analytics-werkruimte:
Meld u aan bij het Azure-portaal.
Selecteer in de Azure-portal de optie Alle services. Voer in de lijst met resources Log Analytics in. Als u begint te typen, wordt de lijst gefilterd op basis van uw invoer. Selecteer Log Analytics-werkruimten.
Selecteer de werkruimte in uw lijst met Log Analytics-werkruimten.
Selecteer in uw Log Analytics-werkruimte de tegel Agents en selecteer vervolgens Windows-servers.
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
Meld u aan bij de computer met een account met beheerdersrechten.
Voer MMASetup-platform<> uit.exe om de installatiewizard te starten.
Selecteer Volgende op de eerste pagina van de wizard Setup.
Selecteer in het dialoogvenster Setup van Microsoft Monitoring Agent de optie Ik ga akkoord met de gebruiksrechtovereenkomst.
Selecteer Upgrade in het dialoogvenster Setup van Microsoft Monitoring Agent. Op de statuspagina wordt de voortgang van de upgrade weergegeven.
Wanneer de configuratie van de Microsoft Monitoring Agent is voltooid wordt weergegeven, selecteert u Voltooien.
Upgrade uitvoeren vanaf de opdrachtregel
Meld u aan bij de computer met een account met beheerdersrechten.
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 argumentenMMASetup-<platform>.exe /c /t:<Full Path>
door te geven.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
Meld u aan bij de computer met een account met beheerdersrechten.
Open het Configuratiescherm.
Selecteer Microsoft Monitoring Agent en selecteer vervolgens het tabblad Azure Log Analytics .
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.
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.
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.
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.
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
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>]
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
Meld u aan bij de computer met een account met beheerdersrechten.
Open het Configuratiescherm.
Selecteer Microsoft Monitoring Agent en selecteer vervolgens het tabblad Proxyinstellingen .
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.
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
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'
inproxy.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
Meld u aan bij de computer met een account met beheerdersrechten.
Selecteer Programma's en onderdelen in het configuratiescherm.
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.
Meld u aan bij de computer met een account met beheerdersrechten.
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 argumentenextract 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.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.
Meld u aan bij de computer met een account met beheerdersrechten.
Open het Configuratiescherm.
Selecteer Microsoft Monitoring Agent en selecteer vervolgens het tabblad Operations Manager .
Als uw Operations Manager-servers zijn geïntegreerd met Active Directory, selecteert u Automatisch beheergroeptoewijzingen bijwerken vanuit AD DS.
Selecteer Toevoegen om het dialoogvenster Een beheergroep toevoegen te openen.
Voer in het veld Naam van de beheergroep de naam van uw beheergroep in.
Voer in het veld Primaire beheerserver de computernaam van de primaire beheerserver in.
Voer in het veld Poort van de beheerserver het TCP-poortnummer in.
Kies onder Actie-account van agent het lokale systeemaccount of een lokaal domeinaccount.
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.
Bewerk bestand
/etc/opt/omi/conf/omiserver.conf
.Zorg ervoor dat de lijn begint met
httpsport=
het definiëren van poort 1270, zoalshttpsport=1270
.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
- Raadpleeg Het oplossen van problemen met de Linux-agent als u problemen ondervindt tijdens het installeren of beheren van de Linux-agent.
- Raadpleeg Het oplossen van problemen met de Windows-agent als u problemen ondervindt tijdens het installeren of beheren van de Windows-agent.