Problemen met de Log Analytics-agent voor Linux oplossen

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

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 op te sporen en te diagnosticeren. Deze wordt automatisch opgenomen in de agent bij de installatie. 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 wordt 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 logboeken van de agent werken niet.
  • Agentlogboeken kunnen niet worden verzameld.

Zie de documentatie van 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, helpt ons ondersteuningsteam uw probleem sneller op te lossen.

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 ononderbroken status te krijgen. Door het hulpprogramma voor probleemoplossing en het hulpprogramma Logboekverzamelaar uit te voeren en een schone herinstallatie uit te voeren, kunt u problemen sneller 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

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

U wordt aangeraden het hulpprogramma Log Collector te gebruiken om belangrijke logboeken op te halen voor probleemoplossing of voordat u een GitHub-probleem indient. Zie OMS Linux Agent Log Collector voor meer informatie over het hulpprogramma en hoe u het uitvoert.

Belangrijke configuratiebestanden

Categorie Bestandslocatie
Syslog /etc/syslog-ng/syslog-ng.confof of /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 de Azure Portal voor uw werkruimte. Als u de configuratie voor alle agents wilt uitschakelen, schakelt u het verzamelen van verouderde agents uit. 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 invoegtoepassing voor auoms niet geïnstalleerd. De installatie van auoms is mislukt. Geïnstalleerd pakket gecontroleerd.
2 Er is een ongeldige optie opgegeven voor de shell-bundel. Voer uit sudo sh ./omsagent-*.universal*.sh --help voor gebruik.
3 Er is geen optie opgegeven voor de shell-bundel. Voer uit sudo sh ./omsagent-*.universal*.sh --help voor gebruik.
4 Ongeldig pakkettype of ongeldige proxy-instellingen. De pakketten omsagent-rpm.sh kunnen alleen worden geïnstalleerd op RPM-systemen. De pakketten omsagent-deb.sh kunnen alleen worden geïnstalleerd op Debian-systemen. U wordt aangeraden het universele installatieprogramma uit de nieuwste versie te gebruiken. Controleer ook om uw proxyinstellingen te controleren.
5 De shell-bundel 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 het onboarden. De pakketten omsagent-*x64.sh kunnen alleen worden geïnstalleerd op 64-bits systemen. De pakketten omsagent-*x86.sh kunnen alleen worden geïnstalleerd op 32-bits systemen. Download het juiste pakket voor uw architectuur uit de nieuwste versie.
17 De installatie van het 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 De installatie van het OMI-pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
20 Installatie van SCX-pakket is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
21 Installatie van providerkits is mislukt. Bekijk de uitvoer van de opdracht voor de hoofdfout.
22 De installatie van het gebundelde 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 om 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 het curl-programma.
61 Ontbrekende Python-ctypes-bibliotheek. Installeer de python-ctypes-bibliotheek of -pakket (python-ctypes).
62 Ontbrekend teerprogramma. Installeer tar.
63 Ontbrekend sed-programma. Installeer sed.
64 Ontbrekend curl-programma. Installeer curl.
65 Ontbrekend gpg-programma. Installeer gpg.

Onboardingfoutcodes

Foutcode Betekenis
2 Er is een ongeldige optie opgegeven voor het omsadmin-script. Voer uit sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -h voor gebruik.
3 Ongeldige configuratie opgegeven voor het omsadmin-script. Voer uit sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -h voor gebruik.
4 Er is een ongeldige proxy 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 metaconfiguratie voor omsconfig. Dien een GitHub-probleem in met details uit de uitvoer.
34 Het script voor het genereren van metaconfiguratie is niet aanwezig. Probeer opnieuw te onboarden 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 specifieke logboekregistratieniveaus voor invoegtoepassingen 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 in 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 batchuploads naar Azure Monitor zien, gescheiden door type, 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, dat zichtbaar is in het logboekbestand van de Log Analytics-agent voor Linux.

Maak in het configuratiebestand van de algemene Log Analytics-agent op /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.confcommentaar bij de invoegtoepassing voor OMS-uitvoer door een # voor elke regel 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 opmerking in de volgende sectie door de # voor elke regel te verwijderen:

<match **>
  type stdout
</match>

Probleem: kan geen verbinding maken via proxy met Azure Monitor

Mogelijke oorzaken

  • De proxy die is opgegeven tijdens de onboarding is onjuist.
  • De Azure Monitor- en Azure Automation-service-eindpunten zijn 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 kunt u uitgebreide uitvoer uitvoeren 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. Raadpleeg de sectie Proxy-instellingen bijwerken om te controleren of u de agent correct hebt geconfigureerd voor communicatie via een proxyserver.

  3. Controleer of de eindpunten die worden beschreven in de lijst met vereisten voor azure Monitor-netwerkfirewall correct zijn toegevoegd aan een acceptatielijst. Als u Azure Automation gebruikt, worden hierboven ook de benodigde netwerkconfiguratiestappen gekoppeld.

Probleem: U ontvangt een 403-fout wanneer u probeert te onboarden

Mogelijke 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 van de huidige tijd is, mislukt de onboarding. U kunt deze situatie corrigeren door de datum en/of tijdzone van uw Linux-server bij te werken.
  2. Controleer of u de nieuwste versie van de Log Analytics-agent voor Linux hebt geïnstalleerd. De nieuwste versie geeft nu een bericht als tijdsverschil 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 de onboarding

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

Probleem: u ziet omiagent met 100% CPU

Mogelijke oorzaken

Een regressie in nss-pem-pakket v1.0.3-5.el7 heeft een ernstig prestatieprobleem veroorzaakt. We hebben dit probleem vaak gezien in Redhat/CentOS 7.x-distributies. Zie 1667121 Prestatieregressie in libcurl voor meer informatie over dit probleem.

Prestatiegerelateerde bugs treden niet de hele tijd op en zijn moeilijk te reproduceren. Als u een dergelijk probleem ondervindt met omiagent, gebruikt u het script omiHighCPUDiagnostics.sh, waarmee de stacktracering van de 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. Diagnostische gegevens 24 uur uitvoeren met een CPU-drempelwaarde van 30%:
    bash omiHighCPUDiagnostics.sh --runtime-in-min 1440 --cpu-threshold 30

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

Oplossing

  1. Upgrade het nss-pem-pakket 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 gebeurt op CentOS, downgradet u curl naar 7.29.0-46. Als u 'yum update' per ongeluk uitvoert, wordt curl geüpgraded naar 7.29.0-51 en treedt het probleem opnieuw op:
    sudo yum downgrade curl libcurl

  3. START OMI opnieuw:
    sudo scxadmin -restart

Probleem: u kunt geen doorgestuurde Syslog-berichten zien

Mogelijke oorzaken

  • De configuratie die wordt toegepast op de Linux-server, 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.

Oplossing

  • Controleer of de configuratie in de Log Analytics-werkruimte voor Syslog alle faciliteiten en de juiste logboekniveaus heeft. Bekijk Syslog-verzameling configureren in de Azure Portal.
  • Controleer of de systeemeigen Syslog-berichtendaemons (rsyslog, syslog-ng) de doorgestuurde berichten kunnen ontvangen.
  • Controleer de firewallinstellingen op de Syslog-server om ervoor te zorgen dat berichten niet worden geblokkeerd.
  • Een Syslog-bericht simuleren 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.

Mogelijke oorzaken

Deze fout geeft aan dat de Diagnostische Linux-extensie (LAD) naast de Log Analytics Linux VM-extensie is geïnstalleerd. Het gebruikt dezelfde poort voor syslog-gegevensverzameling 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 door LAD wordt gebruikt.

    /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 VM wordt uitgevoerd rsyslogd, is /etc/rsyslog.d/95-omsagent.conf het bestand dat moet worden gewijzigd (als het bestaat, anders /etc/rsyslog). Als de VM 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.

Probleem: u kunt omsagent niet verwijderen met behulp van de optie voor opschonen

Mogelijke 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 het gebruik van omsagent door mdsd en kan niet worden verwijderd.

Oplossing

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

Probleem: U kunt geen Nagios-gegevens zien

Mogelijke oorzaken

  • De omsagent-gebruiker heeft geen machtigingen om te lezen uit het Nagios-logboekbestand.
  • De bron en het filter van Nagios 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 het algemene configuratiebestand van de Log Analytics-agent voor Linux op /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.confof zowel de Nagios-bron als het filter geen opmerkingen 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: u ziet geen Linux-gegevens

Mogelijke oorzaken

  • Onboarding naar Azure Monitor is mislukt.
  • Verbinding met Azure Monitor is geblokkeerd.
  • De virtuele machine is opnieuw opgestart.
  • Het OMI-pakket is handmatig geüpgraded naar een nieuwere versie in vergelijking met wat is geïnstalleerd door het pakket Log Analytics-agent voor Linux.
  • OMI is geblokkeerd, waardoor de OMS-agent wordt geblokkeerd.
  • Fout in logboekbestand is niet gevonden in omsconfig.log de klasse DSC-resourcelogboeken.
  • Er wordt een back-up gemaakt van de Log Analytics-agent voor gegevens.
  • DSC-logboeken De huidige configuratie bestaat niet. Voer Start-DscConfiguration opdracht uit met parameter -Path om een configuratiebestand op te geven en eerst 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 auditpakket.

  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 zo is, 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 proxy's.

  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 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 gestart om de Log Analytics-agent te laten werken. Deze stap is vereist voor sommige distributies waarbij de OMI-server niet automatisch wordt gestart nadat deze is bijgewerkt. Voer uit sudo /opt/omi/bin/service_control restart om de OMI opnieuw op te starten.

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

  6. Als u de fout DSC-resourceklasse niet gevonden ziet in omsconfig.log, voert u 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 gemaakt van gegevens op de agent naar de volledige buffergrootte van 50 MB. De agent moet opnieuw worden gestart 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 er periodiek bewerkingen worden uitgevoerd op het systeem, 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 gebruiken service cron status met Debian, Ubuntu en SUSE of service crond status met RHEL, CentOS en Oracle Linux 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

Mogelijke 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 een 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 Linux-configuratieagent mogelijk niet communiceren met de portalconfiguratieservice. In dit scenario wordt de meest recente configuratie niet toegepast.

  1. Controleer of de omsconfig agent is geïnstalleerd door of rpm -qi omsconfiguit te voerendpkg --list 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

Mogelijke 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 niet opgehaald van de service.
  • De Log Analytics-agent voor Linux-gebruiker omsagent heeft geen toegang tot het aangepaste logboek vanwege machtigingen of is 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, kunt u het volgende doen:

    1. Ga opnieuw aan boord met behulp van de omsadmin.sh opdrachtregelinstructies.
    2. Zorg ervoor dat onder Geavanceerde instellingen in de Azure Portal 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 te communiceren met Azure Monitor en de meest recente configuratie op te halen.

Achtergrond: In plaats van de Log Analytics-agent voor Linux die wordt uitgevoerd als een 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 machtigingen te omsagent verlenen:

  1. Voeg de omsagent gebruiker toe aan de specifieke groep: sudo usermod -a -G <GROUPNAME> <USERNAME>.
  2. Verleent universele leestoegang 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 naar de meest recente agent hebt bijgewerkt, 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 van een nieuwe werkruimte

Wanneer u een agent opnieuw wilt toevoegen aan een nieuwe werkruimte, moet de configuratie van de Log Analytics-agent worden opgeschoond voordat u opnieuw kunt onboarden. Als u de oude configuratie van de agent wilt opschonen, voert u de shellbundel uit met --purge:

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

of

sudo sh ./onboard_agent.sh --purge

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

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

Mogelijke oorzaken

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

Oplossing

  1. Verwijder de extensie uit de 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 geslaagd.

Probleem: De log analytics-agent upgrade on-demand

Mogelijke oorzaken

De Log Analytics-agentpakketten op de host zijn verouderd.

Oplossing

  1. Controleer op deze GitHub-pagina naar de nieuwste versie.

  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. Upgrade pakketten door uit te sudo sh ./omsagent-*.universal.x64.sh --upgradevoeren.

Probleem: De installatie mislukt en zegt dat Python2 ctypes niet kan ondersteunen, zelfs als Python3 wordt gebruikt

Mogelijke oorzaken

Voor dit bekende probleem, als de taal van de VM niet Engels is, mislukt een controle bij het controleren van welke versie van Python wordt gebruikt. 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 VM in Engels:

export LANG=en_US.UTF-8