A Linuxhoz készült Log Analytics-ügynökkel kapcsolatos hibák elhárítása

Ez a cikk segítséget nyújt az Azure Monitorban a Linuxhoz készült Log Analytics-ügynökkel kapcsolatos hibák elhárításához.

Log Analytics hibaelhárító eszköz

A Linuxhoz készült Log Analytics-hibaelhárító eszköz egy olyan szkript, amely segít megtalálni és diagnosztizálni a Log Analytics-ügynökkel kapcsolatos problémákat. A telepítéskor automatikusan bekerül az ügynökbe. Az eszköz futtatásának kell lennie a probléma diagnosztizálása első lépésének.

A hibaelhárítási eszköz használata

A hibaelhárító eszköz futtatásához illessze be a következő parancsot egy terminálablakba egy gépen a Log Analytics-ügynökkel:

sudo /opt/microsoft/omsagent/bin/troubleshooter

Manuális telepítés

A Hibaelhárító eszköz automatikusan megjelenik a Log Analytics-ügynök telepítésekor. Ha a telepítés bármilyen módon meghiúsul, manuálisan is telepítheti az eszközt:

  1. Győződjön meg arról, hogy a GNU-projekt hibakeresője (GDB) telepítve van a gépen, mert a hibaelhárító támaszkodik rá.
  2. Másolja a hibaelhárító csomagot a gépére: wget https://raw.github.com/microsoft/OMS-Agent-for-Linux/master/source/code/troubleshooter/omsagent_tst.tar.gz
  3. Csomagolja ki a csomagot: tar -xzvf omsagent_tst.tar.gz
  4. Futtassa a manuális telepítést: sudo ./install_tst

Érintett forgatókönyvek

A hibaelhárító eszköz a következő forgatókönyveket ellenőrzi:

  • Az ügynök nem megfelelő állapotú; a szívverés nem működik megfelelően.
  • Az ügynök nem indul el, vagy nem tud csatlakozni a Log Analyticshez.
  • A Syslog ügynök nem működik.
  • Az ügynök magas processzor- vagy memóriahasználattal rendelkezik.
  • Az ügynök telepítési problémái vannak.
  • Az ügynök egyéni naplói nem működnek.
  • Az ügynöknaplók nem gyűjthetők.

További információ: A Hibaelhárító eszköz dokumentációja a GitHubon.

Megjegyzés

Amikor problémát tapasztal, futtassa a Naplógyűjtő eszközt. A naplók kezdeti használata segít a támogatási csapatnak a probléma gyorsabb elhárításában.

A Linux-ügynök végleges törlése és újratelepítése

Az ügynök tiszta újratelepítése megoldja a legtöbb problémát. Ez a feladat lehet az első javaslat a támogatási csapatunktól, hogy az ügynök javítatlan állapotba kerüljön. A hibaelhárító eszköz és a naplógyűjtő eszköz futtatása és a tiszta újratelepítési kísérlet segít a problémák gyorsabb megoldásában.

  1. Töltse le a törlési szkriptet:

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

  2. Futtassa a végleges törlési szkriptet (sudo engedélyekkel):

    $ sudo sh purge_omsagent.sh

Fontos naplóhelyek és a Naplógyűjtő eszköz

Fájl Elérési út
Log Analytics-ügynök Linux-naplófájlhoz /var/opt/microsoft/omsagent/<workspace id>/log/omsagent.log
Log Analytics-ügynök konfigurációs naplófájlja /var/opt/microsoft/omsconfig/omsconfig.log

Javasoljuk, hogy a Naplógyűjtő eszközzel kérje le a fontos naplókat a hibaelhárításhoz vagy a GitHub-probléma elküldése előtt. Az eszközzel és annak futtatásával kapcsolatos további információkért lásd: OMS Linux-ügynöknapló-gyűjtő.

Fontos konfigurációs fájlok

Kategória Fájl helye
Rendszernapló /etc/syslog-ng/syslog-ng.confvagy /etc/rsyslog.conf/etc/rsyslog.d/95-omsagent.conf
Teljesítmény, Nagios, Zabbix, Log Analytics-kimenet és általános ügynök /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf
További konfigurációk /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/*.conf

Megjegyzés

A teljesítményszámlálók konfigurációs fájljainak szerkesztése és a Syslog felülíródik, ha a gyűjtemény az ügynök konfigurációjából van konfigurálva a munkaterület Azure Portal. Ha le szeretné tiltani az összes ügynök konfigurációját, tiltsa le a gyűjteményt az Örökölt ügynökök kezelése szolgáltatásból. Egyetlen ügynök esetében futtassa a következő szkriptet:

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*

Telepítési hibakódok

Hibakód Értelmezés
NOT_DEFINED Mivel a szükséges függőségek nincsenek telepítve, a naplózott beépülő modul nem lesz telepítve. Az auoms telepítése nem sikerült. Telepítse az auditált csomagot.
2 Érvénytelen beállítás van megadva a rendszerhéjcsomaghoz. Futtassa a parancsot sudo sh ./omsagent-*.universal*.sh --help a használatra.
3 Nincs lehetőség a rendszerhéjcsomag számára. Futtassa a parancsot sudo sh ./omsagent-*.universal*.sh --help a használatra.
4 Érvénytelen csomagtípus vagy érvénytelen proxybeállítások. Az omsagent-rpm.sh csomagok csak RPM-alapú rendszereken telepíthetők. Az omsagent-deb.sh csomagok csak Debian-alapú rendszereken telepíthetők. Javasoljuk, hogy a legújabb kiadásban használja az univerzális telepítőt. Ellenőrizze a proxybeállításokat is.
5 A rendszerhéjcsomagot gyökérként kell végrehajtani, vagy 403-as hiba történt az előkészítés során. Futtassa a parancsot a paranccsal sudo.
6 Érvénytelen csomagarchitektúra, vagy az előkészítés során 200 hiba történt. Az omsagent-*x64.sh csomagok csak 64 bites rendszereken telepíthetők. Az omsagent-*x86.sh csomagok csak 32 bites rendszereken telepíthetők. Töltse le az architektúrához megfelelő csomagot a legújabb kiadásból.
17 Az OMS-csomag telepítése nem sikerült. Tekintse át a gyökérhiba parancskimenetét.
18 Az OMSConfig-csomag telepítése nem sikerült. Tekintse át a gyökérhiba parancskimenetét.
19 Az OMI-csomag telepítése nem sikerült. Tekintse át a gyökérhiba parancskimenetét.
20 Az SCX-csomag telepítése nem sikerült. Tekintse át a gyökérhiba parancskimenetét.
21 A szolgáltatói készletek telepítése sikertelen volt. Tekintse át a gyökérhiba parancskimenetét.
22 A csomagcsomag telepítése sikertelen volt. Tekintse át a gyökérhiba parancskimenetét
23 Az SCX- vagy OMI-csomag már telepítve van. A --upgrade rendszerhéjcsomag telepítése helyett --install használja a parancsot.
30 Belső csomaghiba. Küldjön be egy GitHub-problémát a kimenet részleteivel.
55 Nem támogatott openssl-verzió , vagy nem lehet csatlakozni az Azure Monitorhoz , vagy a DPKG zárolva van , vagy hiányzik a curl program.
61 Hiányzik a Python ctypes kódtára. Telepítse a Python ctypes kódtárat vagy -csomagot (python-ctypes).
62 Hiányzik a tar program. Telepítse a kátrányt.
63 Hiányzik a sed program. Telepítse a sed-et.
64 Hiányzik a curl program. Telepítse a curl-t.
65 Hiányzik a gpg program. Telepítse a gpg-t.

Előkészítési hibakódok

Hibakód Értelmezés
2 Érvénytelen beállítás van megadva az omsadmin szkripthez. Futtassa a parancsot sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -h a használathoz.
3 Az omsadmin szkripthez megadott konfiguráció érvénytelen. Futtassa a parancsot sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -h a használathoz.
4 Az omsadmin szkripthez megadott proxy érvénytelen. Ellenőrizze a proxyt, és tekintse meg a HTTP-proxy használatára vonatkozó dokumentációt.
5 403 HTTP-hiba érkezett az Azure Monitortól. A részletekért tekintse meg az omsadmin szkript teljes kimenetét.
6 Nem 200 HTTP-hiba érkezett az Azure Monitortól. A részletekért tekintse meg az omsadmin szkript teljes kimenetét.
7 Nem lehet csatlakozni az Azure Monitorhoz. A részletekért tekintse meg az omsadmin szkript teljes kimenetét.
8 Hiba történt a Log Analytics-munkaterületre való előkészítéskor. A részletekért tekintse meg az omsadmin szkript teljes kimenetét.
30 Belső szkripthiba. Küldjön be egy GitHub-problémát a kimenet részleteivel.
31 Hiba történt az ügynökazonosító létrehozásakor. Küldjön be egy GitHub-problémát a kimenet részleteivel.
32 Hiba történt a tanúsítványok létrehozásakor. A részletekért tekintse meg az omsadmin szkript teljes kimenetét.
33 Hiba történt az omsconfig metakonfigurálásának létrehozásakor. Küldjön be egy GitHub-problémát a kimenet részleteivel.
34 A metakonfigurálás-létrehozási szkript nincs jelen. Próbálkozzon újra az előkészítéssel a használatával sudo sh /opt/microsoft/omsagent/bin/omsadmin.sh -w <Workspace ID> -s <Workspace Key>.

Hibakeresési naplózás engedélyezése

OMS kimeneti beépülő modul hibakeresése

A FluentD beépülő modulspecifikus naplózási szinteket tesz lehetővé, amelyek lehetővé teszik különböző naplózási szintek megadását a bemenetekhez és kimenetekhez. Ha más naplószintet szeretne megadni az OMS-kimenethez, szerkessze az általános ügynökkonfigurációt a következő helyen: /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf.

Az OMS kimeneti beépülő modulban a konfigurációs fájl vége előtt módosítsa a tulajdonságot a log_level következőre infodebug:

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

A hibakeresési naplózás lehetővé teszi, hogy a kötegelt feltöltéseket az Azure Monitorba típus, adatelemek száma és küldéshez szükséges idő szerint különítse el.

Íme egy példa a hibakeresésre képes naplóra:

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

Részletes kimenet

Az OMS kimeneti beépülő modul használata helyett az adatelemeket közvetlenül a fájlba stdoutis kiadhatja, amely a Linux-alapú Log Analytics-ügynök naplófájljában látható.

A Log Analytics általános ügynökkonfigurációs fájljában /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conftegye megjegyzésbe az OMS kimeneti beépülő modult úgy, hogy minden sor elé beszed egy-egy # elemet:

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

A kimeneti beépülő modul alatt távolítsa el a következő szakaszt úgy, hogy eltávolítja a # sor elejét:

<match **>
  type stdout
</match>

Probléma: Nem lehet proxyn keresztül csatlakozni az Azure Monitorhoz

Lehetséges okok

  • Az előkészítés során megadott proxy helytelen volt.
  • Az Azure Monitor és Azure Automation szolgáltatásvégpontok nem szerepelnek az adatközpont jóváhagyott listájában.

Feloldás

  1. Jelentkezzen be újra az Azure Monitorba a Linuxhoz készült Log Analytics-ügynökkel az alábbi paranccsal, engedélyezve a beállítással -v . Lehetővé teszi a proxyn keresztül az Azure Monitorhoz csatlakozó ügynök részletes kimenetét: /opt/microsoft/omsagent/bin/omsadmin.sh -w <Workspace ID> -s <Workspace Key> -p <Proxy Conf> -v

  2. Tekintse át a Proxybeállítások frissítése című szakaszt annak ellenőrzéséhez, hogy megfelelően konfigurálta-e az ügynököt a proxykiszolgálón keresztüli kommunikációra.

  3. Ellenőrizze, hogy az Azure Monitor hálózati tűzfalkövetelmény-listájában szereplő végpontok helyesen vannak-e hozzáadva egy engedélyezési listához. Ha Azure Automation használ, a szükséges hálózati konfigurációs lépések a fentiekben is össze vannak kapcsolva.

Probléma: 403-at jelző hibaüzenet jelenik meg a bevezetési kísérlet során

Lehetséges okok

  • A dátum és az idő helytelen a Linux-kiszolgálón.
  • A munkaterület azonosítója és a munkaterület kulcsa nem helyes.

Feloldás

  1. Ellenőrizze a Linux-kiszolgálón töltött időt a parancs dátumával. Ha az idő az aktuális időponttól +/- 15 perc, az előkészítés sikertelen lesz. A probléma megoldásához frissítse a Linux-kiszolgáló dátum- és/vagy időzónáját.
  2. Ellenőrizze, hogy telepítette-e a Log Analytics-ügynök linuxos legújabb verzióját. A legújabb verzió értesítést küld, ha az időeltérés okozza az előkészítési hibát.
  3. A cikk korábbi, telepítési útmutatójában szereplő megfelelő munkaterület-azonosító és munkaterületkulcs használatával jelentkezzen be újra.

Probléma: 500-404-et jelző hiba jelenik meg a naplófájlban közvetlenül az előkészítés után

Ez egy ismert probléma, amely a Linux-adatok Log Analytics-munkaterületre való első feltöltésekor fordul elő. Ez a probléma nincs hatással az elküldött adatokra vagy a szolgáltatási élményre.

Probléma: Azt látja, hogy az Omiagent 100%-ban leköti a processzor kapacitását

Lehetséges okok

Az nss-pem csomag 1.0.3-5.el7-regressziója súlyos teljesítményproblémát okozott. Azt tapasztaljuk, hogy ez a probléma sokat merült fel a Redhat/CentOS 7.x disztribúciókban. A problémával kapcsolatos további információkért lásd: 1667121 Teljesítményregresszió a libcurlban.

A teljesítménnyel kapcsolatos hibák nem mindig fordulnak elő, és nehezen reprodukálhatók. Ha ilyen problémát tapasztal az omiagenttel kapcsolatban, használja a szkriptet omiHighCPUDiagnostics.sh, amely összegyűjti az omiagent verem-nyomkövetését, amikor túllép egy bizonyos küszöbértéket.

  1. Töltse le a szkriptet:
    wget https://raw.githubusercontent.com/microsoft/OMS-Agent-for-Linux/master/tools/LogCollector/source/omiHighCPUDiagnostics.sh

  2. Futtasson diagnosztikát 24 órán keresztül 30%-os CPU-küszöbértékkel:
    bash omiHighCPUDiagnostics.sh --runtime-in-min 1440 --cpu-threshold 30

  3. A hívásokat a omiagent_trace fájlba dobjuk. Ha sok curl- és NSS-függvényhívást észlel, kövesse az alábbi feloldási lépéseket.

Feloldás

  1. Frissítse az nss-pem csomagot az 1.0.3-5.el7_6.1 verzióra:
    sudo yum upgrade nss-pem

  2. Ha az nss-pem nem érhető el frissítésre, ami többnyire a CentOS-en történik, a curl 7.29.0-46-ra csökken. Ha véletlenül a "yum update" parancsot futtatja, a curl 7.29.0-51-re frissül, és a probléma ismét bekövetkezik:
    sudo yum downgrade curl libcurl

  3. Indítsa újra az OMI-t:
    sudo scxadmin -restart

Probléma: Nem láthatók a továbbított rendszernapló-üzenetek

Lehetséges okok

  • A Linux-kiszolgálóra alkalmazott konfiguráció nem teszi lehetővé az elküldött létesítmények vagy naplószintek gyűjtését.
  • A rendszer nem továbbítja megfelelően a syslogot a Linux-kiszolgálóra.
  • A másodpercenként továbbított üzenetek száma túl nagy ahhoz, hogy a Linuxhoz készült Log Analytics-ügynök alapkonfigurációja kezelhető legyen.

Feloldás

  • Ellenőrizze, hogy a Syslog Log Analytics-munkaterületének konfigurációja rendelkezik-e az összes lehetőséggel és a megfelelő naplózási szinttel. Tekintse át a Syslog-gyűjtemény konfigurálását a Azure Portal.
  • Ellenőrizze, hogy a syslog natív üzenetkezelési démonai (rsyslog, syslog-ng) megkaphatják-e a továbbított üzeneteket.
  • Ellenőrizze a syslog-kiszolgálón található tűzfalbeállításokat, és győződjön meg arról, hogy az üzenetek nincsenek blokkolva.
  • Syslog-üzenet szimulálása a Log Analyticsnek egy logger paranccsal:
    logger -p local0.err "This is my test message"

Probléma: A kapott Errno-cím már használatban van az omsagent naplófájljában

Az omsagent.logban látható [error]: unexpected error error_class=Errno::EADDRINUSE error=#<Errno::EADDRINUSE: Address already in use - bind(2) for "127.0.0.1" port 25224> .

Lehetséges okok

Ez a hiba azt jelzi, hogy a Linux diagnosztikai bővítmény (LAD) a Log Analytics Linux virtuálisgép-bővítmény mellett van telepítve. Ugyanazt a portot használja a Syslog-adatgyűjtéshez, mint az omsagent.

Feloldás

  1. Gyökérként hajtsa végre a következő parancsokat. Vegye figyelembe, hogy a 25224 egy példa, és lehetséges, hogy a környezetében egy másik portszámot lát, amelyet a LAD használ.

    /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
    

    Ezután szerkesztenie kell a megfelelő rsyslogd vagy syslog_ng konfigurációs fájlt, és módosítania kell a LAD-hoz kapcsolódó konfigurációt, hogy a 25229-ös portra írjon.

  2. Ha a virtuális gép fut rsyslogd, a módosítani /etc/rsyslog.d/95-omsagent.conf kívánt fájl (ha létezik, más néven /etc/rsyslog). Ha a virtuális gép fut syslog_ng, a módosítani kívánt fájl a következő /etc/syslog-ng/syslog-ng.conf: .

  3. Indítsa újra az omsagent parancsot sudo /opt/microsoft/omsagent/bin/service_control restart.

  4. Indítsa újra a Syslog szolgáltatást.

Probléma: Az omsagent nem távolítható el a törlési lehetőséggel

Lehetséges okok

  • A Linux diagnosztikai bővítmény telepítve van.
  • A Linux diagnosztikai bővítményt telepítették és eltávolították, de továbbra is hibaüzenet jelenik meg arról, hogy az mdsd használja az omsagentet, és nem távolítható el.

Feloldás

  1. Távolítsa el a Linux diagnosztikai bővítményt.
  2. Távolítsa el a Linux diagnosztikai bővítményfájlokat a gépről, ha az a következő helyen található: /var/lib/waagent/Microsoft.Azure.Diagnostics.LinuxDiagnostic-<version>/ és /var/opt/microsoft/omsagent/LAD/.

Probléma: Nem látja a Nagios-adatokat

Lehetséges okok

  • Az omsagent felhasználó nem rendelkezik olvasási engedéllyel a Nagios-naplófájlból.
  • A Nagios-forrás és -szűrő nem lett kibontva az omsagent.conf fájlból.

Feloldás

  1. Adja hozzá az omsagent felhasználót, hogy elolvassa a Nagios-fájlból ezeket az utasításokat.

  2. A Linuxhoz készült Log Analytics-ügynök általános konfigurációs fájljában /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.confgyőződjön meg arról, hogy a Nagios-forrás és a szűrő nincs kibontva.

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

Probléma: Nem látja a Linux-adatokat

Lehetséges okok

  • Az Azure Monitorba való előkészítés nem sikerült.
  • Az Azure Monitorhoz való csatlakozás le van tiltva.
  • A virtuális gép újraindult.
  • Az OMI-csomagot manuálisan frissítették egy újabb verzióra a Linux-alapú Log Analytics-ügynök által telepített csomaghoz képest.
  • Az OMI le van fagyasztva, és blokkolja az OMS-ügynököt.
  • A DSC erőforrásnaplók osztálya nem található hiba a naplófájlban omsconfig.log .
  • Az adatokhoz tartozó Log Analytics-ügynökről biztonsági másolatot készítünk.
  • DSC-naplók Az aktuális konfiguráció nem létezik. Futtassa Start-DscConfiguration parancsot a -Path paraméterrel egy konfigurációs fájl megadásához, majd hozzon létre egy aktuális konfigurációt. a naplófájlban omsconfig.log , de a műveletekről PerformRequiredConfigurationChecks nem létezik naplóüzenet.

Feloldás

  1. Telepítse az összes függőséget, például a naplózott csomagot.

  2. Ellenőrizze, hogy az Azure Monitorba való előkészítés sikeres volt-e, és ellenőrizze, hogy létezik-e a következő fájl: /etc/opt/microsoft/omsagent/<workspace id>/conf/omsadmin.conf. Ha nem, akkor a omsadmin.sh parancssori utasítások használatával helyezze újra a táblát.

  3. Proxy használata esetén tekintse meg az előző proxy hibaelhárítási lépéseit.

  4. Egyes Azure-disztribúciós rendszerekben az omid OMI-kiszolgáló démonja nem indul el a virtuális gép újraindítása után. Ebben az esetben nem jelenik meg a Naplózás, a ChangeTracking vagy az UpdateManagement megoldással kapcsolatos adatok. A megkerülő megoldás az OMI-kiszolgáló manuális elindítása a futtatásával sudo /opt/omi/bin/service_control restart.

  5. Miután az OMI-csomagot manuálisan frissítette egy újabb verzióra, manuálisan újra kell indítani a Log Analytics-ügynököt a működés folytatásához. Ez a lépés bizonyos disztribúciókhoz szükséges, amelyeknél az OMI-kiszolgáló nem indul el automatikusan a frissítés után. Futtassa a parancsot sudo /opt/omi/bin/service_control restart az OMI újraindításához.

    Bizonyos esetekben az OMI lefagyhat. Előfordulhat, hogy az OMS-ügynök blokkolt állapotot ad meg az OMI-ra várva, amely blokkolja az összes adatgyűjtést. Az OMS-ügynök folyamata futni fog, de nem lesz tevékenység, amit az igazol, hogy nincsenek új naplósorok (például az elküldött szívverések) a rendszerben omsagent.log. Indítsa újra az OMI-t az sudo /opt/omi/bin/service_control restart ügynök helyreállításához.

  6. Ha egy DSC-erőforrásosztály nem található hibát az omsconfig.logban, futtassa a következőt sudo /opt/omi/bin/service_control restart: .

  7. Bizonyos esetekben, amikor a Linuxhoz készült Log Analytics-ügynök nem tud beszélni az Azure Monitorral, az ügynök adatairól a rendszer 50 MB-os teljes pufferméretre készít biztonsági másolatot. Az ügynököt a következő parancs futtatásával kell újraindítani: /opt/microsoft/omsagent/bin/service_control restart.

    Megjegyzés

    Ezt a problémát az ügynök 1.1.0-28-es vagy újabb verziójában javítottuk.

    • Ha a omsconfig.log naplófájl nem jelzi, hogy PerformRequiredConfigurationChecks a műveletek rendszeresen futnak a rendszeren, probléma lehet a cron-feladattal/szolgáltatással. Győződjön meg arról, hogy a cron feladat létezik a alatt /etc/cron.d/OMSConsistencyInvoker. Ha szükséges, futtassa a következő parancsokat a cron feladat létrehozásához:

      mkdir -p /etc/cron.d/
      echo "*/15 * * * * omsagent /opt/omi/bin/OMSConsistencyInvoker >/dev/null 2>&1" | sudo tee /etc/cron.d/OMSConsistencyInvoker
      
    • Győződjön meg arról is, hogy a cron szolgáltatás fut. service cron status A szolgáltatás állapotát a Debian, az Ubuntu és a SUSE, illetve service crond status az RHEL, a CentOS és az Oracle Linux használatával ellenőrizheti. Ha a szolgáltatás nem létezik, telepítheti a bináris fájlokat, és elindíthatja a szolgáltatást az alábbi utasításokat követve:

      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
      

Probléma: Ha a portálról konfigurálja a gyűjteményt a Syslog- vagy Linux-teljesítményszámlálókhoz, a rendszer nem alkalmazza a beállításokat

Lehetséges okok

  • A Linuxhoz készült Log Analytics-ügynök nem vette fel a legújabb konfigurációt.
  • A portál módosított beállításai nem lettek alkalmazva.

Feloldás

Háttér:omsconfig a Linux-konfigurációs ügynökHöz készült Log Analytics-ügynök, amely öt percenként keres új portáloldali konfigurációt. A rendszer ezt a konfigurációt alkalmazza a Log Analytics-ügynökre a /etc/opt/microsoft/omsagent/conf/omsagent.conf címen található Linux-konfigurációs fájlokhoz.

Bizonyos esetekben előfordulhat, hogy a Linux-konfigurációs ügynök Log Analytics-ügynöke nem tud kommunikálni a portál konfigurációs szolgáltatásával. Ez a forgatókönyv azt eredményezi, hogy a legújabb konfiguráció nem lesz alkalmazva.

  1. Ellenőrizze, hogy az omsconfig ügynök telepítve van-e a vagy rpm -qi omsconfiga futtatásávaldpkg --list omsconfig. Ha nincs telepítve, telepítse újra a Linuxhoz készült Log Analytics-ügynök legújabb verzióját.

  2. Ellenőrizze, hogy az omsconfig ügynök tud-e kommunikálni az Azure Monitorral a következő parancs futtatásával: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/GetDscConfiguration.py'. Ez a parancs visszaadja az ügynök által a szolgáltatástól kapott konfigurációt, beleértve a Syslog-beállításokat, a Linux-teljesítményszámlálókat és az egyéni naplókat. Ha ez a parancs nem sikerül, futtassa a következő parancsot: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'. Ez a parancs kényszeríti az omsconfig ügynököt, hogy beszéljen az Azure Monitorral, és kérje le a legújabb konfigurációt.

Probléma: Nem látja az egyéni naplóadatokat

Lehetséges okok

  • Az Azure Monitorba való előkészítés nem sikerült.
  • A Következő konfiguráció alkalmazása a Linux-kiszolgálókra beállítás nincs kiválasztva.
  • omsconfig nem vette fel a szolgáltatás legújabb egyéni naplókonfigurációját.
  • A Linux-felhasználó omsagent Log Analytics-ügynöke engedélyek miatt nem tud hozzáférni az egyéni naplóhoz, vagy nem található. A következő hibák jelenhetnek meg:
    • [DATETIME] [warn]: file not found. Continuing without tailing it.
    • [DATETIME] [error]: file not accessible by omsagent.
  • Ismert probléma a Log Analytics-ügynök 1.1.0-217-es verziójában kijavított versenyfeltételekkel kapcsolatban.

Feloldás

  1. Ellenőrizze, hogy az Azure Monitorba való előkészítés sikeres volt-e, és ellenőrizze, hogy létezik-e a következő fájl: /etc/opt/microsoft/omsagent/<workspace id>/conf/omsadmin.conf. Ha nem, a következők valamelyike:

    1. A omsadmin.sh parancssori utasításokat követve próbálkozzon újra az előkészítéssel.
    2. A Azure Portal Speciális beállítások csoportjában győződjön meg arról, hogy a Következő konfiguráció alkalmazása a Linux-kiszolgálókra beállítás engedélyezve van.
  2. Ellenőrizze, hogy az omsconfig ügynök tud-e kommunikálni az Azure Monitorral a következő parancs futtatásával: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/GetDscConfiguration.py'. Ez a parancs visszaadja az ügynök által a szolgáltatástól kapott konfigurációt, beleértve a Syslog-beállításokat, a Linux-teljesítményszámlálókat és az egyéni naplókat. Ha ez a parancs nem sikerül, futtassa a következő parancsot: sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'. Ez a parancs arra kényszeríti az ügynököt, hogy beszéljen az omsconfig Azure Monitorral, és kérje le a legújabb konfigurációt.

Háttér: A Linuxhoz készült Log Analytics-ügynök helyett, amely jogosultsággal rendelkező felhasználóként fut , rootaz ügynök felhasználóként omsagent fut. A legtöbb esetben explicit engedélyt kell adni a felhasználónak bizonyos fájlok olvasásához. Ha engedélyt szeretne adni a felhasználónak omsagent , futtassa a következő parancsokat:

  1. Adja hozzá a felhasználót omsagent az adott csoporthoz: sudo usermod -a -G <GROUPNAME> <USERNAME>.
  2. Adjon univerzális olvasási hozzáférést a szükséges fájlhoz: sudo chmod -R ugo+rx <FILE DIRECTORY>.

Az 1.1.0-217-es verziónál korábbi Linux-verzióhoz készült Log Analytics-ügynök versenyfeltételével kapcsolatban ismert probléma merült fel. Miután frissített a legújabb ügynökre, futtassa a következő parancsot a kimeneti beépülő modul legújabb verziójának lekéréséhez: sudo cp /etc/opt/microsoft/omsagent/sysconf/omsagent.conf /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf.

Probléma: Új munkaterületre próbál újra bejelentkezni

Amikor új munkaterületre próbál újra létrehozni egy ügynököt, a Log Analytics-ügynök konfigurációját törölni kell az újrabevezetés előtt. Ha törölni szeretné a régi konfigurációt az ügynökből, futtassa a rendszerhéjcsomagot a következővel --purge:

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

Vagy

sudo sh ./onboard_agent.sh --purge

A lehetőség használata után folytathatja az újrabevezetést --purge .

Probléma: A Log Analytics-ügynök bővítménye a Azure Portal sikertelen állapotúként van megjelölve: A kiépítés sikertelen

Lehetséges okok

  • A Log Analytics-ügynök el lett távolítva az operációs rendszerből.
  • A Log Analytics-ügynök szolgáltatása leállt, le van tiltva, vagy nincs konfigurálva.

Feloldás

  1. Távolítsa el a bővítményt a Azure Portal.
  2. Telepítse az ügynököt az utasításokat követve.
  3. Indítsa újra az ügynököt a következő parancs futtatásával:
    sudo /opt/microsoft/omsagent/bin/service_control restart.
  4. Várjon néhány percet, amíg a kiépítési állapot sikeres lesz.

Probléma: A Log Analytics-ügynök igény szerinti frissítése

Lehetséges okok

A gazdagép Log Analytics-ügynökcsomagjai elavultak.

Feloldás

  1. Keresse meg a legújabb kiadást ezen a GitHub-oldalon.

  2. Töltse le a telepítési szkriptet (az 1.4.2-124 példaverzió):

    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. Csomagok frissítése a következő végrehajtásával sudo sh ./omsagent-*.universal.x64.sh --upgrade: .

Probléma: A telepítés sikertelen, és azt mondja, hogy a Python2 nem támogatja a ctype-fájlokat, annak ellenére, hogy a Python3-at használják

Lehetséges okok

Ebben az ismert problémában, ha a virtuális gép nyelve nem angol, az ellenőrzés sikertelen lesz, amikor ellenőrzi, hogy melyik Python-verziót használja. Ez a probléma azt eredményezi, hogy az ügynök mindig feltételezi, hogy a Python2-t használják, és sikertelenek, ha nincs Python2.

Feloldás

Módosítsa a virtuális gép környezeti nyelvét angolra:

export LANG=en_US.UTF-8