Delen via

Problemen met de Log Analytics-agent voor Linux oplossen

  • Artikel

Dit artikel bevat hulp bij het oplossen van fouten die kunnen optreden met de Log Analytics-agent voor Linux in Azure Monitor.

Let op

In dit artikel wordt verwezen naar CentOS, een Linux-distributie die de status End Of Life (EOL) nadert. Overweeg uw gebruik en planning dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.

Hulpprogramma voor het oplossen van problemen met Log Analytics

De Log Analytics-agent voor het hulpprogramma voor het oplossen van problemen met Linux is een script dat is ontworpen om problemen met de Log Analytics-agent te vinden en diagnosticeren. Deze wordt automatisch bij de installatie opgenomen bij de agent. Het uitvoeren van het hulpprogramma moet de eerste stap zijn bij het diagnosticeren van een probleem.

Het hulpprogramma voor probleemoplossing gebruiken

Als u het hulpprogramma voor probleemoplossing wilt uitvoeren, plakt u de volgende opdracht in een terminalvenster op een computer met de Log Analytics-agent:

sudo /opt/microsoft/omsagent/bin/troubleshooter

Handmatige installatie

Het hulpprogramma voor probleemoplossing wordt automatisch opgenomen wanneer de Log Analytics-agent is geïnstalleerd. Als de installatie op welke manier dan ook mislukt, kunt u het hulpprogramma ook handmatig installeren:

  1. Zorg ervoor dat het GNU Project Debugger (GDB) op de computer is geïnstalleerd omdat de probleemoplosser ervan afhankelijk is.
  2. Kopieer de probleemoplosserbundel naar uw computer: wget https://raw.github.com/microsoft/OMS-Agent-for-Linux/master/source/code/troubleshooter/omsagent_tst.tar.gz
  3. Pak de bundel uit: tar -xzvf omsagent_tst.tar.gz
  4. Voer de handmatige installatie uit: sudo ./install_tst

Scenario's die worden behandeld

Het hulpprogramma voor probleemoplossing controleert de volgende scenario's:

  • De agent is beschadigd; de heartbeat werkt niet goed.
  • De agent start niet of kan geen verbinding maken met Log Analytics.
  • De agent Syslog werkt niet.
  • De agent heeft een hoog CPU- of geheugengebruik.
  • De agent heeft installatieproblemen.
  • De aangepaste agentlogboeken werken niet.
  • Agentlogboeken kunnen niet worden verzameld.

Zie de documentatie over het hulpprogramma voor probleemoplossing op GitHub voor meer informatie.

Notitie

Voer het hulpprogramma Logboekverzamelaar uit wanneer u een probleem ondervindt. Als u de logboeken in eerste instantie hebt, kan ons ondersteuningsteam uw probleem sneller oplossen.

De Linux-agent leegmaken en opnieuw installeren

Een schone herinstallatie van de agent lost de meeste problemen op. Deze taak is mogelijk de eerste suggestie van ons ondersteuningsteam om de agent in een niet-vervormde status te krijgen. Als u het hulpprogramma Probleemoplossing en logboekverzamelaar uitvoert en een schone installatie probeert uit te voeren, kunt u sneller problemen oplossen.

  1. Download het opschoningsscript:

    $ wget https://raw.githubusercontent.com/microsoft/OMS-Agent-for-Linux/master/tools/purge_omsagent.sh

  2. Voer het opschoningsscript uit (met sudo-machtigingen):

    $ sudo sh purge_omsagent.sh

Belangrijke logboeklocaties en het hulpprogramma Logboekverzamelaar

Bestand Pad
Log Analytics-agent voor Linux-logboekbestand /var/opt/microsoft/omsagent/<workspace id>/log/omsagent.log
Log Analytics-configuratielogboekbestand voor agent /var/opt/microsoft/omsconfig/omsconfig.log

U wordt aangeraden het hulpprogramma Logboekverzamelaar te gebruiken om belangrijke logboeken op te halen voor het oplossen van problemen of voordat u een GitHub-probleem verzendt. Zie OMS Linux Agent Log Collector voor meer informatie over het hulpprogramma en hoe u het kunt uitvoeren.

Belangrijke configuratiebestanden

Categorie Bestandslocatie
Syslog /etc/syslog-ng/syslog-ng.confof /etc/rsyslog.conf/etc/rsyslog.d/95-omsagent.conf
Prestaties, Nagios, Zabbix, Log Analytics-uitvoer en algemene agent /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf
Extra configuraties /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/*.conf

Notitie

Het bewerken van configuratiebestanden voor prestatiemeteritems en Syslog wordt overschreven als de verzameling is geconfigureerd vanuit de configuratie van de agent in Azure Portal voor uw werkruimte. Als u de configuratie voor alle agents wilt uitschakelen, schakelt u de verzameling uit van het beheer van verouderde agents. Voer voor één agent het volgende script uit:

sudo /opt/microsoft/omsconfig/Scripts/OMS_MetaConfigHelper.py --disable && sudo rm /etc/opt/omi/conf/omsconfig/configuration/Current.mof* /etc/opt/omi/conf/omsconfig/configuration/Pending.mof*

Installatiefoutcodes

Foutcode Betekenis
NOT_DEFINED Omdat de benodigde afhankelijkheden niet zijn geïnstalleerd, wordt de gecontroleerde auoms-invoegtoepassing niet geïnstalleerd. Installatie van auoms is mislukt. Installeer pakket gecontroleerd.
2 Ongeldige optie die is opgegeven voor de shellbundel. Wordt uitgevoerd sudo sh ./omsagent-*.universal*.sh --help voor gebruik.
3 Er is geen optie beschikbaar voor de shellbundel. Wordt uitgevoerd sudo sh ./omsagent-*.universal*.sh --help voor gebruik.
4 Ongeldig pakkettype of ongeldige proxy-instellingen. De omsagent-rpm.sh pakketten kunnen alleen worden geïnstalleerd op RPM-systemen. De omsagent-deb.sh pakketten kunnen alleen worden geïnstalleerd op Debian-systemen. U wordt aangeraden het universele installatieprogramma uit de nieuwste versie te gebruiken. Controleer ook of u de proxy-instellingen wilt controleren.
5 De shellbundel moet worden uitgevoerd als root of er is een 403-fout geretourneerd tijdens de onboarding. Voer de opdracht uit met behulp van sudo.
6 Ongeldige pakketarchitectuur of er is een 200-fout geretourneerd tijdens de onboarding. De omsagent-*x64.sh-pakketten kunnen alleen worden geïnstalleerd op 64-bits systemen. De omsagent-*x86.sh-pakketten kunnen alleen worden geïnstalleerd op 32-bits systemen. Download het juiste pakket voor uw architectuur uit de nieuwste versie.
17 Installatie van OMS-pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
18 De installatie van het OMSConfig-pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
19 Installatie van OMI-pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
20 De installatie van het SCX-pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
21 De installatie van providerkits is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
22 Installatie van gebundeld pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout
23 SCX- of OMI-pakket is al geïnstalleerd. Gebruik --upgrade in plaats van --install de shellbundel te installeren.
30 Interne bundelfout. Dien een GitHub-probleem in met details uit de uitvoer.
55 Niet-ondersteunde openssl-versie of kan geen verbinding maken met Azure Monitor of dpkg is vergrendeld of ontbreekt in het curl-programma.
61 Ontbrekende Python-ctypesbibliotheek. Installeer de Python ctypes-bibliotheek of -pakket (python-ctypes).
62 Ontbrekend tar-programma. Installeer tar.
63 Ontbrekend sed-programma. Installeer sed.
64 Ontbrekend curl-programma. Installeer curl.
65 Ontbrekend gpg-programma. Installeer gpg.

Onboardingfoutcodes

Foutcode Betekenis
2 Ongeldige optie die is opgegeven voor het omsadmin-script. Wordt uitgevoerd sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -h voor gebruik.
3 Ongeldige configuratie die is opgegeven voor het omsadmin-script. Wordt uitgevoerd sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -h voor gebruik.
4 Ongeldige proxy die is opgegeven voor het omsadmin-script. Controleer de proxy en raadpleeg onze documentatie voor het gebruik van een HTTP-proxy.
5 403 HTTP-fout ontvangen van Azure Monitor. Zie de volledige uitvoer van het omsadmin-script voor meer informatie.
6 Niet-200 HTTP-fout ontvangen van Azure Monitor. Zie de volledige uitvoer van het omsadmin-script voor meer informatie.
7 Kan geen verbinding maken met Azure Monitor. Zie de volledige uitvoer van het omsadmin-script voor meer informatie.
8 Fout bij onboarding naar Log Analytics-werkruimte. Zie de volledige uitvoer van het omsadmin-script voor meer informatie.
30 Interne scriptfout. Dien een GitHub-probleem in met details uit de uitvoer.
31 Fout bij het genereren van agent-id. Dien een GitHub-probleem in met details uit de uitvoer.
32 Fout bij het genereren van certificaten. Zie de volledige uitvoer van het omsadmin-script voor meer informatie.
33 Fout bij het genereren van metaconfiguration voor omsconfig. Dien een GitHub-probleem in met details uit de uitvoer.
34 Het genereren van metaconfiguratiescripts is niet aanwezig. Onboarding opnieuw proberen met sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -w <Workspace ID> -s <Workspace Key>.

Logboekregistratie voor foutopsporing inschakelen

Foutopsporing voor OMS-uitvoerinvoegtoepassing

FluentD biedt invoegtoepassingsspecifieke logboekniveaus waarmee u verschillende logboekniveaus voor invoer en uitvoer kunt opgeven. Als u een ander logboekniveau voor OMS-uitvoer wilt opgeven, bewerkt u de algemene agentconfiguratie op /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf.

Wijzig in de OMS-uitvoerinvoegtoepassing, vóór het einde van het configuratiebestand, de log_level eigenschap van info :debug

<match oms.** docker.**>
  type out_oms
  log_level debug
  num_threads 5
  buffer_chunk_limit 5m
  buffer_type file
  buffer_path /var/opt/microsoft/omsagent/<workspace id>/state/out_oms*.buffer
  buffer_queue_limit 10
  flush_interval 20s
  retry_limit 10
  retry_wait 30s
</match>

Met logboekregistratie voor foutopsporing kunt u batched uploads bekijken naar Azure Monitor, gescheiden door het type, het aantal gegevensitems en de tijd die nodig is om te verzenden.

Hier volgt een voorbeeld van een logboek met foutopsporing:

Success sending oms.nagios x 1 in 0.14s
Success sending oms.omi x 4 in 0.52s
Success sending oms.syslog.authpriv.info x 1 in 0.91s

Uitgebreide uitvoer

In plaats van de OMS-uitvoerinvoegtoepassing te gebruiken, kunt u gegevensitems rechtstreeks uitvoeren naar stdout, wat zichtbaar is in de Log Analytics-agent voor het Linux-logboekbestand.

Maak in het algemene configuratiebestand /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.confvan de Log Analytics-agent een opmerking bij de OMS-uitvoerinvoegtoepassing door vóór elke regel een # opmerking toe te voegen:

#<match oms.** docker.**>
#  type out_oms
#  log_level info
#  num_threads 5
#  buffer_chunk_limit 5m
#  buffer_type file
#  buffer_path /var/opt/microsoft/omsagent/<workspace id>/state/out_oms*.buffer
#  buffer_queue_limit 10
#  flush_interval 20s
#  retry_limit 10
#  retry_wait 30s
#</match>

Verwijder onder de uitvoerinvoegtoepassing de opmerkingen in de volgende sectie door de # voorzijde van elke regel te verwijderen:

<match **>
  type stdout
</match>

Probleem: Kan geen verbinding maken via proxy met Azure Monitor

Waarschijnlijke oorzaken

  • De proxy die tijdens de onboarding is opgegeven, is onjuist.
  • De Azure Monitor- en Azure Automation-service-eindpunten worden niet opgenomen in de goedgekeurde lijst in uw datacenter.

Oplossing

  1. Ga opnieuw naar Azure Monitor met de Log Analytics-agent voor Linux met behulp van de volgende opdracht met de optie -v ingeschakeld. Hiermee kan uitgebreide uitvoer van de agent die via de proxy verbinding maakt met Azure Monitor: /opt/microsoft/omsagent/bin/omsadmin.sh -w <Workspace ID> -s <Workspace Key> -p <Proxy Conf> -v

  2. Controleer de sectie Proxy-instellingen bijwerken om te controleren of u de agent correct hebt geconfigureerd om te communiceren via een proxyserver.

  3. Controleer of de eindpunten die worden beschreven in de lijst met netwerkfirewallvereisten van Azure Monitor correct worden toegevoegd aan een acceptatielijst. Als u Azure Automation gebruikt, worden de benodigde netwerkconfiguratiestappen ook hierboven gekoppeld.

Probleem: u ontvangt een 403-fout bij het onboarden

Waarschijnlijke oorzaken

  • Datum en tijd zijn onjuist op de Linux-server.
  • De werkruimte-id en werkruimtesleutel zijn niet juist.

Oplossing

  1. Controleer de tijd op uw Linux-server met de opdrachtdatum. Als de tijd +/- 15 minuten vanaf de huidige tijd is, mislukt de onboarding. Werk de datum en/of tijdzone van uw Linux-server bij om deze situatie te corrigeren.
  2. Controleer of u de nieuwste versie van de Log Analytics-agent voor Linux hebt geïnstalleerd. De nieuwste versie meldt u nu als tijdverschil de onboardingfout veroorzaakt.
  3. Ga opnieuw aan boord met behulp van de juiste werkruimte-id en werkruimtesleutel in de installatie-instructies eerder in dit artikel.

Probleem: U ziet een 500- en 404-fout in het logboekbestand direct na onboarding

Dit is een bekend probleem dat optreedt bij het eerste uploaden van Linux-gegevens naar een Log Analytics-werkruimte. Dit probleem heeft geen invloed op gegevens die worden verzonden of service-ervaring.

Probleem: u ziet omiagent met 100% CPU

Waarschijnlijke oorzaken

Een regressie in nss-pem-pakket v1.0.3-5.el7 heeft een ernstig prestatieprobleem veroorzaakt. Er is een groot probleem opgetreden in Redhat/CentOS 7.x-distributies. Zie 1667121 Performance Regression in libcurl voor meer informatie over dit probleem.

Prestatiegerelateerde bugs vinden niet altijd plaats en ze zijn moeilijk te reproduceren. Als u een dergelijk probleem ondervindt met omiagent, gebruikt u het script omiHighCPUDiagnostics.sh, waarmee de stacktracering van het omiagent wordt verzameld wanneer deze een bepaalde drempelwaarde overschrijdt.

  1. Download het script:
    wget https://raw.githubusercontent.com/microsoft/OMS-Agent-for-Linux/master/tools/LogCollector/source/omiHighCPUDiagnostics.sh

  2. Voer diagnostische gegevens gedurende 24 uur uit met een CPU-drempelwaarde van 30%:
    bash omiHighCPUDiagnostics.sh --runtime-in-min 1440 --cpu-threshold 30

  3. Callstack wordt in het omiagent_trace-bestand gedumpt. Als u veel curl- en NSS-functieaanroepen ziet, volgt u deze oplossingsstappen.

Oplossing

  1. Werk het nss-pem-pakket bij naar v1.0.3-5.el7_6.1:
    sudo yum upgrade nss-pem

  2. Als nss-pem niet beschikbaar is voor een upgrade, wat meestal op CentOS gebeurt, downgradet u curl naar 7.29.0-46. Als u per ongeluk yum-update uitvoert, wordt curl bijgewerkt naar 7.29.0-51 en treedt het probleem opnieuw op:
    sudo yum downgrade curl libcurl

  3. START OMI opnieuw op:
    sudo scxadmin -restart

Probleem: u kunt geen doorgestuurde Syslog-berichten zien

Waarschijnlijke oorzaken

  • De configuratie die op de Linux-server wordt toegepast, staat het verzamelen van de verzonden faciliteiten of logboekniveaus niet toe.
  • Syslog wordt niet correct doorgestuurd naar de Linux-server.
  • Het aantal berichten dat per seconde wordt doorgestuurd, is te groot voor de basisconfiguratie van de Log Analytics-agent voor Linux die moet worden verwerkt.

Oplossing

  • Controleer of de configuratie in de Log Analytics-werkruimte voor Syslog alle faciliteiten en de juiste logboekniveaus heeft. Controleer de Syslog-verzameling configureren in Azure Portal.
  • Controleer of de systeemeigen Syslog-berichtendemons (rsyslog, syslog-ng) de doorgestuurde berichten kunnen ontvangen.
  • Controleer de firewallinstellingen op de Syslog-server om ervoor te zorgen dat berichten niet worden geblokkeerd.
  • Simuleer een Syslog-bericht naar Log Analytics met behulp van een logger opdracht:
    logger -p local0.err "This is my test message"

Probleem: u ontvangt het Errno-adres dat al wordt gebruikt in het omsagent-logboekbestand

U ziet [error]: unexpected error error_class=Errno::EADDRINUSE error=#<Errno::EADDRINUSE: Address already in use - bind(2) for "127.0.0.1" port 25224> in omsagent.log.

Waarschijnlijke oorzaken

Deze fout geeft aan dat de diagnostische Linux-extensie (LAD) naast de Log Analytics Linux VM-extensie is geïnstalleerd. Deze gebruikt dezelfde poort voor het verzamelen van Syslog-gegevens als omsagent.

Oplossing

  1. Voer als hoofdmap de volgende opdrachten uit. Houd er rekening mee dat 25224 een voorbeeld is en het is mogelijk dat u in uw omgeving een ander poortnummer ziet dat wordt gebruikt door LAD.

    /opt/microsoft/omsagent/bin/configure_syslog.sh configure LAD 25229

sed -i -e 's/25224/25229/' /etc/opt/microsoft/omsagent/LAD/conf/omsagent.d/syslog.conf

    Vervolgens moet u het juiste rsyslogd of syslog_ng configuratiebestand bewerken en de LAD-gerelateerde configuratie wijzigen om naar poort 25229 te schrijven.

  2. Als de virtuele machine wordt uitgevoerd rsyslogd, is /etc/rsyslog.d/95-omsagent.conf het bestand dat moet worden gewijzigd (als deze bestaat, anders /etc/rsyslog). Als de virtuele machine wordt uitgevoerd syslog_ng, is /etc/syslog-ng/syslog-ng.confhet bestand dat moet worden gewijzigd.

  3. Start omsagent sudo /opt/microsoft/omsagent/bin/service_control restartopnieuw op.

  4. Start de Syslog-service opnieuw op.

Probleem: u kunt omsagent niet verwijderen met behulp van de opschoningsoptie

Waarschijnlijke oorzaken

  • De diagnostische Linux-extensie is geïnstalleerd.
  • De diagnostische Linux-extensie is geïnstalleerd en verwijderd, maar u ziet nog steeds een fout over omsagent die wordt gebruikt door mdsd en kan niet worden verwijderd.

Oplossing

  1. Verwijder de diagnostische Linux-extensie.
  2. Verwijder diagnostische Linux-extensiebestanden van de computer als ze aanwezig zijn op de volgende locatie: /var/lib/waagent/Microsoft.Azure.Diagnostics.LinuxDiagnostic-<version>/ en /var/opt/microsoft/omsagent/LAD/.

Probleem: U kunt geen Nagios-gegevens zien

Waarschijnlijke oorzaken

  • De omsagent-gebruiker heeft geen machtigingen om te lezen uit het Nagios-logboekbestand.
  • De Nagios-bron en het filter zijn niet verwijderd uit het bestand omsagent.conf.

Oplossing

  1. Voeg de omsagent-gebruiker toe om te lezen uit het Nagios-bestand door deze instructies te volgen.

  2. Controleer in de Log Analytics-agent voor het algemene Linux-configuratiebestand op /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.confof zowel de Nagios-bron als het filter niet-commentaar bevat.

    <source>
  type tail
  path /var/log/nagios/nagios.log
  format none
  tag oms.nagios
</source>

<filter oms.nagios>
  type filter_nagios_log
</filter>

Probleem: Er worden geen Linux-gegevens weergegeven

Waarschijnlijke oorzaken

  • Onboarding naar Azure Monitor is mislukt.
  • Verbinding maken ion naar Azure Monitor is geblokkeerd.
  • De virtuele machine is opnieuw opgestart.
  • OMI-pakket is handmatig bijgewerkt naar een nieuwere versie in vergelijking met wat is geïnstalleerd door de Log Analytics-agent voor Linux-pakket.
  • OMI is geblokkeerd, waardoor de OMS-agent wordt geblokkeerd.
  • De klasse DSC-resourcelogboeken is niet gevonden in omsconfig.log het logboekbestand.
  • Er wordt een back-up gemaakt van de Log Analytics-agent voor gegevens.
  • De huidige configuratie van DSC-logboeken bestaat niet. Voer de opdracht Start-DscConfiguration uit met de parameter -Path om eerst een configuratiebestand op te geven en een huidige configuratie te maken. in omsconfig.log het logboekbestand, maar er bestaat geen logboekbericht over PerformRequiredConfigurationChecks bewerkingen.

Oplossing

  1. Installeer alle afhankelijkheden, zoals het gecontroleerde pakket.

  2. Controleer of onboarding naar Azure Monitor is geslaagd door te controleren of het volgende bestand bestaat: /etc/opt/microsoft/omsagent/<workspace id>/conf/omsadmin.conf Als dat niet het was, gaat u opnieuw aan boord met behulp van de omsadmin.sh opdrachtregelinstructies.

  3. Als u een proxy gebruikt, controleert u de voorgaande stappen voor het oplossen van problemen met de proxy.

  4. In sommige Azure-distributiesystemen wordt de omid OMI-server-daemon niet gestart nadat de virtuele machine opnieuw is opgestart. Als dit het geval is, ziet u geen gegevens over de oplossing Audit, ChangeTracking of UpdateManagement. De tijdelijke oplossing is om de OMI-server handmatig te starten door deze uit te voeren sudo /opt/omi/bin/service_control restart.

  5. Nadat het OMI-pakket handmatig is bijgewerkt naar een nieuwere versie, moet het handmatig opnieuw worden opgestart om de Log Analytics-agent te laten functioneren. Deze stap is vereist voor sommige distributies waarbij de OMI-server niet automatisch wordt gestart nadat deze is bijgewerkt. Voer deze opdracht uit sudo /opt/omi/bin/service_control restart om de OMI opnieuw op te starten.

    In sommige gevallen kan de OMI worden geblokkeerd. De OMS-agent kan een geblokkeerde status invoeren die wacht op de OMI, waardoor alle gegevensverzameling wordt geblokkeerd. Het OMS-agentproces wordt uitgevoerd, maar er is geen activiteit, die wordt aangetoond door geen nieuwe logboeklijnen (zoals verzonden heartbeats) die aanwezig zijn in omsagent.log. Start de OMI opnieuw op om sudo /opt/omi/bin/service_control restart de agent te herstellen.

  6. Als er in omsconfig.log een DSC-resourceklasse niet is gevonden , voert u het volgende uit sudo /opt/omi/bin/service_control restart.

  7. In sommige gevallen, wanneer de Log Analytics-agent voor Linux niet kan communiceren met Azure Monitor, wordt er een back-up van gegevens op de agent gemaakt met de volledige buffergrootte van 50 MB. De agent moet opnieuw worden opgestart door de volgende opdracht uit te voeren: /opt/microsoft/omsagent/bin/service_control restart

    Notitie

    Dit probleem is opgelost in agentversie 1.1.0-28 of hoger.

    • Als het omsconfig.log logboekbestand niet aangeeft dat PerformRequiredConfigurationChecks bewerkingen periodiek op het systeem worden uitgevoerd, is er mogelijk een probleem met de cron-taak/-service. Zorg ervoor dat de cron-taak bestaat onder /etc/cron.d/OMSConsistencyInvoker. Voer indien nodig de volgende opdrachten uit om de cron-taak te maken:

      mkdir -p /etc/cron.d/
echo "*/15 * * * * omsagent /opt/omi/bin/OMSConsistencyInvoker >/dev/null 2>&1" | sudo tee /etc/cron.d/OMSConsistencyInvoker

    • Zorg er ook voor dat de cron-service wordt uitgevoerd. U kunt met Debian, Ubuntu en SUSE of service crond status met RHEL, CentOS en Oracle Linux gebruiken service cron status om de status van deze service te controleren. Als de service niet bestaat, kunt u de binaire bestanden installeren en de service starten met behulp van de volgende instructies:

      Ubuntu/Debian

      # To Install the service binaries
sudo apt-get install -y cron
# To start the service
sudo service cron start

      SUSE

      # To Install the service binaries
sudo zypper in cron -y
# To start the service
sudo systemctl enable cron
sudo systemctl start cron

      RHEL/CentOS

      # To Install the service binaries
sudo yum install -y crond
# To start the service
sudo service crond start

      Oracle Linux

      # To Install the service binaries
sudo yum install -y cronie
# To start the service
sudo service crond start

Probleem: Wanneer u verzameling configureert vanuit de portal voor Syslog- of Linux-prestatiemeteritems, worden de instellingen niet toegepast

Waarschijnlijke oorzaken

  • De Log Analytics-agent voor Linux heeft de meest recente configuratie niet opgehaald.
  • De gewijzigde instellingen in de portal zijn niet toegepast.

Oplossing

Achtergrond:omsconfig is de Log Analytics-agent voor Linux-configuratieagent die elke vijf minuten naar nieuwe configuratie aan de portalzijde zoekt. Deze configuratie wordt vervolgens toegepast op de Log Analytics-agent voor Linux-configuratiebestanden op /etc/opt/microsoft/omsagent/conf/omsagent.conf.

In sommige gevallen kan de Log Analytics-agent voor de Linux-configuratieagent mogelijk niet communiceren met de portalconfiguratieservice. Dit scenario resulteert in het niet toepassen van de meest recente configuratie.

  1. Controleer of de omsconfig agent is geïnstalleerd door deze uit te voeren dpkg --list omsconfig of rpm -qi omsconfig. Als deze niet is geïnstalleerd, installeert u de nieuwste versie van de Log Analytics-agent voor Linux opnieuw.

  2. Controleer of de omsconfig agent kan communiceren met Azure Monitor door de volgende opdracht uit te voeren: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/GetDscConfiguration.py' Met deze opdracht wordt de configuratie geretourneerd die de agent van de service ontvangt, inclusief Syslog-instellingen, Linux-prestatiemeteritems en aangepaste logboeken. Als deze opdracht mislukt, voert u de volgende opdracht uit: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'. Met deze opdracht wordt de omsconfig-agent gedwongen om te communiceren met Azure Monitor en de meest recente configuratie op te halen.

Probleem: U ziet geen aangepaste logboekgegevens

Waarschijnlijke oorzaken

  • Onboarding naar Azure Monitor is mislukt.
  • De instelling De volgende configuratie toepassen op mijn Linux-servers is niet geselecteerd.
  • omsconfig heeft de meest recente aangepaste logboekconfiguratie van de service niet opgehaald.
  • De Log Analytics-agent voor Linux-gebruikers omsagent heeft geen toegang tot het aangepaste logboek vanwege machtigingen of niet gevonden. Mogelijk ziet u de volgende fouten:
    • [DATETIME] [warn]: file not found. Continuing without tailing it.
    • [DATETIME] [error]: file not accessible by omsagent.
  • Bekend probleem met racevoorwaarde opgelost in Log Analytics-agent voor Linux-versie 1.1.0-217.

Oplossing

  1. Controleer of onboarding naar Azure Monitor is geslaagd door te controleren of het volgende bestand bestaat: /etc/opt/microsoft/omsagent/<workspace id>/conf/omsadmin.conf Als dat niet het geval is, gaat u als volgende te werk:

    1. Ga opnieuw aan boord met behulp van de omsadmin.sh opdrachtregelinstructies.
    2. Controleer onder Advanced Instellingen in Azure Portal of de instelling De volgende configuratie toepassen op mijn Linux-servers is ingeschakeld.

  2. Controleer of de omsconfig agent kan communiceren met Azure Monitor door de volgende opdracht uit te voeren: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/GetDscConfiguration.py' Met deze opdracht wordt de configuratie geretourneerd die de agent van de service ontvangt, inclusief Syslog-instellingen, Linux-prestatiemeteritems en aangepaste logboeken. Als deze opdracht mislukt, voert u de volgende opdracht uit: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'. Met deze opdracht wordt de omsconfig agent gedwongen om met Azure Monitor te communiceren en de meest recente configuratie op te halen.

Achtergrond: In plaats van de Log Analytics-agent voor Linux die wordt uitgevoerd als bevoegde gebruiker, rootwordt de agent uitgevoerd als de omsagent gebruiker. In de meeste gevallen moet aan deze gebruiker expliciete toestemming worden verleend om bepaalde bestanden te kunnen lezen. Voer de volgende opdrachten uit om de gebruiker toestemming te omsagent geven:

  1. Voeg de omsagent gebruiker toe aan de specifieke groep: sudo usermod -a -G <GROUPNAME> <USERNAME>.
  2. Universele leestoegang verlenen tot het vereiste bestand: sudo chmod -R ugo+rx <FILE DIRECTORY>.

Er is een bekend probleem met een racevoorwaarde met de Log Analytics-agent voor Linux-versie ouder dan 1.1.0-217. Nadat u bijwerkt naar de nieuwste agent, voert u de volgende opdracht uit om de nieuwste versie van de uitvoerinvoegtoepassing op te halen: sudo cp /etc/opt/microsoft/omsagent/sysconf/omsagent.conf /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf.

Probleem: U probeert opnieuw aan boord te gaan naar een nieuwe werkruimte

Wanneer u probeert opnieuw aan boord te gaan van een agent naar een nieuwe werkruimte, moet de configuratie van de Log Analytics-agent worden opgeschoond voordat u opnieuwboarding uitvoert. Als u de oude configuratie van de agent wilt opschonen, voert u de shellbundel uit met --purge:

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

Or

sudo sh ./onboard_agent.sh --purge

U kunt opnieuw aan boord gaan nadat u de --purge optie hebt gebruikt.

Probleem: Log Analytics-agentextensie in Azure Portal is gemarkeerd met de status Mislukt: Inrichten is mislukt

Waarschijnlijke oorzaken

  • De Log Analytics-agent is verwijderd uit het besturingssysteem.
  • De Log Analytics-agentservice is offline, uitgeschakeld of niet geconfigureerd.

Oplossing

  1. Verwijder de extensie uit Azure Portal.
  2. Installeer de agent door de instructies te volgen.
  3. Start de agent opnieuw door de volgende opdracht uit te voeren:
    sudo /opt/microsoft/omsagent/bin/service_control restart.
  4. Wacht enkele minuten totdat de inrichtingsstatus is gewijzigd in Inrichten.

Probleem: De upgrade van de Log Analytics-agent op aanvraag

Waarschijnlijke oorzaken

De Log Analytics-agentpakketten op de host zijn verouderd.

Oplossing

  1. Controleer op de meest recente release op deze GitHub-pagina.

  2. Download het installatiescript (1.4.2-124 is een voorbeeldversie):

    wget https://github.com/Microsoft/OMS-Agent-for-Linux/releases/download/OMSAgent_GA_v1.4.2-124/omsagent-1.4.2-124.universal.x64.sh

  3. Upgradepakketten door uit te sudo sh ./omsagent-*.universal.x64.sh --upgradevoeren.

Probleem: de installatie mislukt en zegt dat Python2 geen ondersteuning biedt voor ctypes, ook al wordt Python3 gebruikt

Waarschijnlijke oorzaken

Als de taal van de VIRTUELE machine geen Engels is, mislukt een controle bij het controleren van welke versie van Python wordt gebruikt voor dit bekende probleem. Dit probleem leidt ertoe dat de agent altijd ervan uitgaat dat Python2 wordt gebruikt en mislukt als er geen Python2 is.

Oplossing

Wijzig de omgevingstaal van de VIRTUELE machine in het Engels:

export LANG=en_US.UTF-8