A Linux Update Agent hibáinak elhárítása

Számos oka lehet annak, hogy a gép nem jelenik meg készként (kifogástalan állapotban) az Update Managementben. A linuxos hibrid runbook-feldolgozó ügynök állapotának ellenőrzésével megállapíthatja a mögöttes problémát. The following are the three readiness states for a machine:

  • Ready: The Hybrid Runbook Worker is deployed and was last seen less than one hour ago.
  • Disconnected: The Hybrid Runbook Worker is deployed and was last seen over one hour ago.
  • Nincs konfigurálva: A hibrid runbook-feldolgozó nem található vagy nem fejezte be az üzembe helyezést.

Megjegyzés:

Az Azure Portal és a gép aktuális állapota között némi késés is előfordulhat.

Ez a cikk azt ismerteti, hogyan futtathatja az Azure-gépek hibaelhárítóját az Azure Portalról és nem Azure-beli gépekről offline forgatókönyvben.

Megjegyzés:

A hibaelhárító szkript jelenleg nem irányítja át a forgalmat proxykiszolgálón, ha van konfigurálva.

A hibaelhárító indítása

Azure-gépek esetén válassza a hibaelhárítási hivatkozást a portál Frissítési ügynök készültségi oszlopában a Frissítési ügynök hibaelhárítása lap megnyitásához. For non-Azure machines, the link brings you to this article. A nem Azure-beli gépek hibaelhárításához tekintse meg az offline hibaelhárítás szakasz utasításait.

Screenshot of VM list page.

Megjegyzés:

Az ellenőrzésekhez a virtuális gépnek futnia kell. Ha a virtuális gép nem fut, megjelenik a virtuális gép indítása.

A Frissítési ügynök hibaelhárítása lapon válassza az Ellenőrzések futtatása lehetőséget a hibaelhárító elindításához. A hibaelhárító a Futtatás paranccsal futtat egy szkriptet a gépen a függőségek ellenőrzéséhez. A hibaelhárító a futtatása befejezésekor visszaadja az ellenőrzések eredményét.

Screenshot of Troubleshoot page.

Ha az ellenőrzések befejeződnek, az eredmények az ablakban jelennek meg. Az ellenőrzési szakaszok információt nyújtanak arról, hogy az egyes csekkek mit keresnek.

Screenshot of Linux Troubleshooter.

Prerequisite checks

Operating system

Az operációs rendszer ellenőrzi, hogy a hibrid runbook-feldolgozó futtatja-e az egyik támogatott operációs rendszert.

Dmidecode-ellenőrzés

Annak ellenőrzéséhez, hogy egy virtuális gép Azure-beli virtuális gép-e, ellenőrizze az eszközcímke értékét az alábbi paranccsal:

sudo dmidecode

Ha az eszközcímke eltér a 7783-7084-3265-9085-8269-3286-77 azonosítótól, indítsa újra a virtuális gépet az újraregisztráció elindításához.

Monitoring agent service health checks

Monitorozási ügynök

A probléma megoldásához telepítse az Azure Log Analytics Linux-ügynököt, és győződjön meg arról, hogy közli a szükséges végpontokat. További információ: Log Analytics-ügynök telepítése Linux rendszerű számítógépeken.

Ez a feladat ellenőrzi, hogy a mappa jelen van-e –

/etc/opt/microsoft/omsagent/conf/omsadmin.conf

Monitorozási ügynök állapota

A probléma megoldásához az alábbi paranccsal kell elindítania az OMS-ügynök szolgáltatást:

 sudo /opt/microsoft/omsagent/bin/service_control restart

Az ellenőrzéshez hajtsa végre a folyamatellenőrzést az alábbi paranccsal:

process_name="omsagent"
ps aux | grep %s | grep -v grep" % (process_name)"

További információ: A Linuxhoz készült Log Analytics-ügynökkel kapcsolatos problémák elhárítása

Többutasítás

Ez az ellenőrzés azt határozza meg, hogy az ügynök több munkaterületnek is jelent-e. Az Update Management nem támogatja a többtényezős kezelést.

A probléma megoldásához törölje teljesen az OMS-ügynököt, és telepítse újra a Frissítéskezeléshez társított munkaterülettel

Ellenőrizze, hogy nincs-e többtényezősítés az elérési út alatti könyvtárak ellenőrzésével:

/var/opt/microsoft/omsagent.

Mivel ezek a munkaterületek címtárai, a címtárak száma megegyezik az OMSAgenthez tartozó munkaterületek számával.

Hybrid Runbook Worker

A probléma megoldásához 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.

Ellenőrizze, hogy a következő két elérési út létezik-e:

/opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/VERSION </br> /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/configuration.py

Hibrid runbook-feldolgozó állapota

Ez az ellenőrzés ellenőrzi, hogy a hibrid runbook-feldolgozó fut-e a gépen. Az alábbi példában szereplő folyamatoknak jelen kell lenniük, ha a hibrid runbook-feldolgozó megfelelően fut.

ps -ef | grep python
nxautom+   8567      1  0 14:45 ?        00:00:00 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/main.py /var/opt/microsoft/omsagent/state/automationworker/oms.conf rworkspace:<workspaceId> <Linux hybrid worker version>
nxautom+   8593      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/state/automationworker/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>
nxautom+   8595      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/<workspaceId>/state/automationworker/diy/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>

Az Update Management letölti a hibrid Runbook-feldolgozó csomagokat az operatív végpontról. Ezért ha a hibrid runbook-feldolgozó nem fut, és az operatív végpont ellenőrzése meghiúsul, a frissítés meghiúsulhat.

A probléma megoldásához 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.

Ha a probléma továbbra is fennáll, futtassa az omsagent log collector eszközt

Connectivity checks

Proxyval kompatibilis ellenőrzés

A probléma megoldásához távolítsa el a proxyt, vagy győződjön meg arról, hogy a proxycím hozzáfér az előfeltételként szolgáló URL-címhez.

A feladatot az alábbi parancs futtatásával ellenőrizheti:

HTTP_PROXY

IMDS-kapcsolat ellenőrzése

A probléma megoldásához engedélyezze a hozzáférést az IP 169.254.169.254-hez. További információ: Access Azure Instance Metadata Service

A hálózat módosítása után futtassa újra a hibaelhárítót, vagy futtassa az alábbi parancsokat az ellenőrzéshez:

 curl -H \"Metadata: true\" http://169.254.169.254/metadata/instance?api-version=2018-02-01

Általános internetkapcsolat

Ez az ellenőrzés gondoskodik arról, hogy a gép hozzáférhessen az internethez, és figyelmen kívül hagyható, ha letiltotta az internetet, és csak meghatározott URL-címeket engedélyezett.

CURL bármely HTTP-URL-címen.

Registration endpoint

Ez az ellenőrzés meghatározza, hogy a hibrid runbook-feldolgozó képes-e megfelelően kommunikálni az Azure Automationnel a Log Analytics-munkaterületen.

A proxy- és tűzfalkonfigurációknak lehetővé kell tenni, hogy a hibrid runbook-feldolgozó ügynök kommunikáljon a regisztrációs végponttal. A megnyitni kívánt címek és portok listáját lásd : Hálózattervezés

A probléma megoldása az előfeltételként megadott URL-címek engedélyezésével. További információ: Update Management és változáskövetés és leltározás

A hálózati módosítások közzététele után újra futtathatja a hibaelhárítót vagy a CURL-t a megadott jrds-végponton.

Operations endpoint

Ez az ellenőrzés meghatározza, hogy a Log Analytics-ügynök képes-e megfelelően kommunikálni a Feladat futtatókörnyezeti adatszolgáltatással.

A proxy- és tűzfalkonfigurációknak lehetővé kell tenni, hogy a hibrid runbook-feldolgozó ügynök kommunikáljon a feladat futtatókörnyezeti adatszolgáltatással. A megnyitni kívánt címek és portok listáját lásd : Hálózattervezés.

Log Analytics-végpont 1

Ez az ellenőrzés ellenőrzi, hogy a gép hozzáfér-e a Log Analytics-ügynök által szükséges végpontokhoz.

A probléma megoldása az előfeltételként megadott URL-címek engedélyezésével.

A hálózati módosítások elvégzése után újra futtathatja a hibaelhárítót vagy a Curl-t a megadott ODS-végponton.

Log Analytics-végpont 2

Ez az ellenőrzés ellenőrzi, hogy a gép hozzáfér-e a Log Analytics-ügynök által szükséges végpontokhoz.

A probléma megoldása az előfeltételként megadott URL-címek engedélyezésével.

A hálózati módosítások elvégzése után újrafuttathatja a hibaelhárítót vagy a Curl-t a megadott OMS-végponton

Szoftveradattárak

Ezt a problémát az előfeltételként szolgáló adattár URL-címének engedélyezésével háríthatja el. Az RHEL-ről itt olvashat.

A hálózati módosítások elvégzése után újrafuttathatja a hibaelhárítót, vagy

Curl a csomagkezelőben konfigurált szoftvertárakon.

Az adattárak frissítése segít megerősíteni a kommunikációt.

sudo apt-get check
sudo yum check-update

Megjegyzés:

Az ellenőrzés csak offline módban érhető el.

Hibaelhárítás offline állapotban

A hibaelhárítót offline állapotban is használhatja hibrid runbook-feldolgozón a szkript helyi futtatásával. A UM_Linux_Troubleshooter_Offline.py Python-szkript a GitHubon található.

Megjegyzés:

A hibaelhárító szkript jelenlegi verziója nem támogatja az Ubuntu 20.04-et.

A szkript kimenetére az alábbi példa mutat példát:

Debug: Machine Information:   Static hostname: LinuxVM2
         Icon name: computer-vm
           Chassis: vm
        Machine ID: 00000000000000000000000000000000
           Boot ID: 00000000000000000000000000000000
    Virtualization: microsoft
  Operating System: Ubuntu 16.04.5 LTS
            Kernel: Linux 4.15.0-1025-azure
      Architecture: x86-64


Passed: Operating system version is supported

Passed: Microsoft Monitoring agent is installed

Debug: omsadmin.conf file contents:
        WORKSPACE_ID=00000000-0000-0000-0000-000000000000
        AGENT_GUID=00000000-0000-0000-0000-000000000000
        LOG_FACILITY=local0
        CERTIFICATE_UPDATE_ENDPOINT=https://00000000-0000-0000-0000-000000000000.oms.opinsights.azure.com/ConfigurationService.Svc/RenewCertificate
        URL_TLD=opinsights.azure.com
        DSC_ENDPOINT=https://scus-agentservice-prod-1.azure-automation.net/Accou            nts/00000000-0000-0000-0000-000000000000/Nodes\(AgentId='00000000-0000-0000-0000-000000000000'\)
        OMS_ENDPOINT=https://00000000-0000-0000-0000-000000000000.ods.opinsights            .azure.com/OperationalData.svc/PostJsonDataItems
        AZURE_RESOURCE_ID=/subscriptions/00000000-0000-0000-0000-000000000000/re            sourcegroups/myresourcegroup/providers/microsoft.compute/virtualmachines/linuxvm            2
        OMSCLOUD_ID=0000-0000-0000-0000-0000-0000-00
        UUID=00000000-0000-0000-0000-000000000000


Passed: Microsoft Monitoring agent is running

Passed: Machine registered with log analytics workspace:['00000000-0000-0000-0000-000000000000']

Passed: Hybrid worker package is present

Passed: Hybrid worker is running

Passed: Machine is connected to internet

Passed: TCP test for {scus-agentservice-prod-1.azure-automation.net} (port 443)             succeeded

Passed: TCP test for {eus2-jobruntimedata-prod-su1.azure-automation.net} (port 4            43) succeeded

Passed: TCP test for {00000000-0000-0000-0000-000000000000.ods.opinsights.azure.            com} (port 443) succeeded

Passed: TCP test for {00000000-0000-0000-0000-000000000000.oms.opinsights.azure.            com} (port 443) succeeded

Passed: TCP test for {ods.systemcenteradvisor.com} (port 443) succeeded

Következő lépések

Hibrid runbook-feldolgozóval kapcsolatos problémák elhárítása.