Condividi tramite

Risolvere i problemi relativi all'agente di aggiornamento Linux

  • Articolo

Importante

Rilevamento modifiche e inventario con l'agente di Log Analytics è stato ritirato il 31 agosto 2024 e funzionerà con supporto limitato fino al 01 febbraio 2025. È consigliabile usare l'agente di monitoraggio di Azure come nuovo agente di supporto. Seguire le linee guida per la migrazione da Rilevamento modifiche e inventario usando Analisi dei log per Rilevamento modifiche e inventario usando la versione dell'agente di monitoraggio di Azure.

I motivi per cui il computer non risulta pronto (integro) in Gestione aggiornamenti possono essere diversi. In Gestione aggiornamenti è possibile controllare l'integrità dell'agente di un ruolo di lavoro ibrido per runbook di Linux per determinare il problema sottostante. I seguenti sono i tre stati di idoneità per un computer:

  • Preparazione - il ruolo di lavoro ibrido per runbook è stato distribuito ed è stato osservato meno di un'ora fa.
  • Disconnesso: il ruolo di lavoro ibrido per runbook è stato distribuito ed è stato osservato più di un'ora fa.
  • Non configurato: il ruolo di lavoro ibrido per runbook non è stato trovato o non ha completato la distribuzione.

Nota

È possibile che si verifichi un lieve ritardo tra quanto visualizzato dal portale di Azure e lo stato corrente di un computer.

Questo articolo illustra come eseguire la risoluzione dei problemi per i computer Azure dal portale di Azure e per i computer non Azure nello scenario offline.

Nota

Lo script dello strumento di risoluzione dei problemi attualmente non instrada il traffico tramite un server proxy se ne è configurato uno.

Avviare la risoluzione dei problemi

Nel caso di computer Azure, selezionando il collegamento Risoluzione dei problemi nella colonna Idoneità agente di aggiornamento nel portale, si apre la pagina Risoluzione dei problemi dell'agente di aggiornamento. Per i computer non Azure, il collegamento indirizza a questo articolo. Per risolvere i problemi relativi a un computer non Azure, vedere le istruzioni nella sezione Risoluzione dei problemi offline.

Screenshot della pagina dell'elenco delle macchine virtuali.

Nota

I controlli richiedono che la macchina virtuale sia in esecuzione. Se la macchina virtuale non è in esecuzione, viene visualizzato Avvia macchina virtuale.

Nella pagina Risoluzione dei problemi dell'agente di aggiornamento fare clic su Esegui controlli per avviare la risoluzione dei problemi. La risoluzione dei problemi usa Esegui comando per eseguire uno script nel computer al fine di verificare le dipendenze. Una volta completata la risoluzione dei problemi, restituisce il risultato dei controlli.

Screenshot della pagina di risoluzione dei problemi.

Al termine dei controlli, i risultati vengono restituiti nella finestra. Le sezioni di controllo forniscono informazioni su ciò che ogni controllo cerca.

Screenshot dello strumento di risoluzione dei problemi di Linux.

Controlli dei prerequisiti

Sistema operativo

Il controllo del sistema operativo verifica se il ruolo di lavoro ibrido per runbook esegue uno dei sistemi operativi supportati.

Controllo dmidecode

Per verificare se una macchina virtuale è una macchina virtuale di Azure, verificare il valore del tag dell'asset usando il comando seguente:

sudo dmidecode

Se il tag dell'asset è diverso da 7783-7084-3265-9085-8269-3286-77, riavviare la macchina virtuale per avviare di nuovo la registrazione.

Controlli di integrità dei servizi dell'agente di monitoraggio

Agente di monitoraggio

Per risolvere questo problema, installare l'agente Linux di Azure Log Analytics e assicurarsi che comunichi con gli endpoint richiesti. Per altre informazioni, vedere Installare l'agente di Log Analytics in computer Linux.

Questa attività controlla se la cartella è presente:

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

Stato dell'agente di monitoraggio

Per risolvere questo problema, è necessario avviare il servizio agente OMS usando il comando seguente:

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

Per convalidare, è possibile eseguire il controllo del processo usando il comando seguente:

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

Per altre informazioni, vedere Risolvere i problemi relativi all'agente Log Analytics per Linux

Multihoming

Questo controllo determina se l'agente invia report a più aree di lavoro. Gestione aggiornamenti non supporta il multihoming.

Per risolvere questo problema, rimuovere completamente l'agente OMS e reinstallarlo con l'area di lavoro collegata a Gestione degli aggiornamenti

Verificare che non siano presenti altre condizioni di multihoming controllando le directory nel percorso seguente:

/var/opt/microsoft/omsagent.

Poiché sono le directory delle aree di lavoro, il numero di directory è uguale al numero di aree di lavoro di cui è stato eseguito l'onboarding in OMSAgent.

Ruolo di lavoro ibrido per runbook

Per risolvere il problema, eseguire il comando seguente:

sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'

Questo comando impone all'agente omsconfig di comunicare con Monitoraggio di Azure e recuperare la configurazione più recente.

Convalidare per verificare se i due percorsi seguenti esistono:

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

Stato del ruolo di lavoro ibrido per runbook

Questo controllo garantisce che il ruolo di lavoro ibrido per runbook sia in esecuzione nel computer. I processi nell'esempio seguente devono essere presenti se il ruolo di lavoro ibrido per runbook è correttamente in esecuzione.

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>

Gestione aggiornamenti scarica i pacchetti del ruolo di lavoro ibrido per runbook dall'endpoint delle operazioni. Pertanto, se il ruolo di lavoro ibrido per runbook non è in esecuzione e il controllo dell'endpoint delle operazioni ha esito negativo, l'aggiornamento potrebbe non riuscire.

Per risolvere questo problema, eseguire il comando seguente:

sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'

Questo comando impone all'agente omsconfig di comunicare con Monitoraggio di Azure e recuperare la configurazione più recente.

Se il problema persiste, eseguire lo strumento di raccolta log omsagent

Controlli della connettività

Controllo dell'abilitazione del proxy

Per risolvere il problema, rimuovere il proxy o assicurarsi che l'indirizzo del proxy sia in grado di accedere all'URL dei prerequisiti.

È possibile convalidare l'attività eseguendo il comando seguente:

HTTP_PROXY

Controllo della connettività IMDS

Per risolvere questo problema, consentire l'accesso all'indirizzo IP 169.254.169.254. Per altre informazioni, vedere Accedere al servizio metadati dell'istanza di Azure

Dopo aver modificato la rete, è possibile eseguire di nuovo lo strumento di risoluzione dei problemi o i comandi seguenti per eseguire la convalida:

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

Connettività Internet generale

Questo controllo assicura che il computer abbia accesso a Internet e possa essere ignorato se è stato bloccato Internet e sono stati consentiti solo URL specifici.

Curl su qualsiasi URL HTTP.

Endpoint di registrazione

Questo controllo determina se il ruolo di lavoro ibrido per runbook può comunicare correttamente con Automazione di Azure nell'area di lavoro Log Analytics.

Le configurazioni di proxy e firewall devono consentire all'agente del ruolo di lavoro ibrido per runbook di comunicare con l'endpoint di registrazione. Per un elenco degli indirizzi e delle porte da aprire, vedere Pianificazione della rete

Risolvere questo problema consentendo gli URL dei prerequisiti. Per altre informazioni, vedere Gestione degli aggiornamenti e Rilevamento modifiche e inventario

Dopo le modifiche della rete è possibile eseguire nuovamente lo strumento di risoluzione dei problemi o Curl sull'endpoint jrds fornito.

Endpoint delle operazioni

Questo controllo determina se l'agente di Log Analytics può comunicare correttamente con il servizio dati del processo di runtime.

Le configurazioni di proxy e firewall devono consentire all'agente del ruolo di lavoro ibrido per runbook di comunicare con il servizio dati del processo di runtime. Per un elenco degli indirizzi e delle porte da aprire, vedere Pianificazione della rete.

Endpoint di Log Analytics 1

Questo controllo verifica che il computer abbia accesso agli endpoint necessari per l'agente di Log Analytics.

Risolvere questo problema consentendo gli URL dei prerequisiti.

Dopo aver apportato le modifiche della rete è possibile eseguire nuovamente lo strumento di risoluzione dei problemi o Curl sull'endpoint ODS fornito.

Endpoint di Log Analytics 2

Questo controllo verifica che il computer abbia accesso agli endpoint necessari per l'agente di Log Analytics.

Risolvere questo problema consentendo gli URL dei prerequisiti.

Dopo aver apportato le modifiche della rete è possibile eseguire nuovamente lo strumento di risoluzione dei problemi o Curl sull'endpoint OMS fornito

Repository software

Risolvere questo problema consentendo l'URL del repository dei prerequisiti. Per RHEL, vedere qui.

Dopo aver apportato le modifiche della rete è possibile eseguire nuovamente lo strumento di risoluzione dei problemi o

Curl sui repository software configurati nella gestione pacchetti.

L'aggiornamento dei repository potrebbe essere utile per confermare la comunicazione.

sudo apt-get check
sudo yum check-update

Nota

Il controllo è disponibile solo in modalità offline.

Risolvere i problemi offline

È possibile usare la risoluzione dei problemi offline per i ruoli di lavoro ibridi per runbook eseguendo lo script in locale. Lo script Python, UM_Linux_Troubleshooter_Offline.py è disponibile in GitHub.

Nota

La versione corrente dello script dello strumento di risoluzione dei problemi non supporta Ubuntu 20.04.

Di seguito è riportato un esempio dell'output di questo script:

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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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

Passaggi successivi

Risolvere i problemi relativi al ruolo di lavoro ibrido per runbook.