Risolvere i problemi del ruolo di lavoro ibrido per runbook basato sull'estensione della macchina virtuale in Automazione

  • Articolo

Questo articolo contiene informazioni sulla risoluzione dei problemi relativi ai ruoli di lavoro ibridi per runbook basati su estensione di Automazione di Azure. Per la risoluzione dei problemi dei ruoli di lavoro ibridi basati su agente, vedere Risoluzione dei problemi dei ruoli di lavoro ibridi per runbook basati su agente in Automazione. Per informazioni generali, vedere Panoramica dei ruoli di lavoro ibrido per runbook.

Elenco di controllo generale

Per risolvere i problemi del ruolo di lavoro ibrido per runbook basato su estensione:

  • Verificare che il sistema operativo sia supportato e che i prerequisiti siano stati soddisfatti. Vedere Prerequisiti.

  • Verificare che l'identità gestita assegnata dal sistema non sia abilitata nella macchina virtuale. Le macchine virtuali di Azure e le macchine virtuali di Azure abilitate per Arc devono essere abilitate con un'identità gestita assegnata dal sistema.

  • Controllare se l'estensione è abilitata con le impostazioni corrette. Il file di impostazione dovrebbe avere il diritto AutomationAccountURL. Verificare l'URL con la proprietà dell'account di Automazione: AutomationHybridServiceUrl. 

    • Per Windows, è possibile trovare il file delle impostazioni qui:

    Suggerimento

    Sostituire * nel percorso seguente con la versione specifica installata se la si conosce.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\RuntimeSettings
    • Per Linux, è possibile trovare il file delle impostazioni qui: 
      /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux/

  • Verificare i messaggi di errore mostrati nello stato/Stato dettagliato dell'estensione del ruolo di lavoro ibrido. Contiene i messaggi di errore e le relative raccomandazioni per correggere il problema.

  • Eseguire lo strumento di risoluzione dei problemi sulla macchina virtuale, che genererà un file di output. Aprire il file di output e verificare gli errori identificati dallo strumento di risoluzione dei problemi.

    • Per Windows, è possibile trovare lo strumento di risoluzione dei problemi qui:

    Suggerimento

    Sostituire * nel percorso seguente con la versione specifica installata se la si conosce.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\TroubleShootWindowsExtension.ps1
    • Per Linux, è possibile trovare lo strumento di risoluzione dei problemi qui:

    Suggerimento

    Sostituire * nel percorso seguente con la versione specifica installata se la si conosce.

    /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/Troubleshooter/LinuxTroubleshooter.py

  • Per i computer Linux, l'estensione del ruolo di lavoro ibrido crea un utente hweautomation e avvia il ruolo di lavoro ibrido sotto l'utente. Verificare se l'utente hweautomation è configurato con le autorizzazioni corrette. Se il runbook sta cercando di accedere a qualsiasi risorsa locale, verificare che hweautomation disponga delle autorizzazioni corrette per le risorse locali.

  • Controllare se il processo del ruolo di lavoro ibrido è in esecuzione.

    • Per Windows, controllare il servizio Hybrid Worker Service (HybridWorkerService).
    • Per Linux, controllare il servizio hwd.

  • Raccogliere i log:

    • Per Windows, eseguire lo strumento dell'agente di raccolta log disponibile qui:

    Suggerimento

    Sostituire * nel percorso seguente con la versione specifica installata se la si conosce.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\PullLogs.ps1

    I log saranno disponibili qui:

    C:\HybridWorkerExtensionLogs
    • Per Linux, i log si trovano nelle cartelle seguenti: 
      /var/log/azure/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux
      e 
      /home/hweautomation

Scenario: i runbook passano a uno stato sospeso in un ruolo di lavoro ibrido per runbook nell'ambito dell'utilizzo di un account personalizzato su un server con Controllo dell'account utente abilitato

Problema

I processi non vanno a buon fine e passano a uno stato sospeso nel ruolo di lavoro ibrido per runbook. I registri eventi Microsoft-SMA indicano Win32 Process Exited with code [2148734720] e un errore corrispondente in registro applicazioni quando il runbook prova a eseguire .NET Runtime version : 4.0.30319.0 indicando che non è stato possibile avviare l'applicazione.

Causa

Quando un sistema ha il Controllo dell'account utente/Account utente con limitazioni in essere, le autorizzazioni devono essere concesse direttamente e non attraverso adesioni a gruppi e quando l'utente deve disporre di autorizzazioni maggiori, i processi iniziano a non riuscire.

Risoluzione

Per gli utenti personalizzati nel ruolo di lavoro ibrido per runbook, aggiornare le autorizzazioni nelle cartelle seguenti:

Cartella Autorizzazioni
C:\ProgramData\AzureConnectedMachineAgent\Tokens Lettura
C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows Lettura ed esecuzione

Scenario: il processo non viene avviato in quanto il ruolo di lavoro ibrido non era disponibile all'avvio del processo pianificato

Problema

Il processo non viene avviato su un ruolo di lavoro ibrido e viene restituito l'errore seguente:

Avvio non riuscito, perché il ruolo di lavoro ibrido non era disponibile all'avvio del processo pianificato, il ruolo di lavoro ibrido è stato attivo l'ultima volta il gg/mm/aaaa.

Causa

Questo errore si può verificare per i motivi seguenti:

  • I computer non esistono più.
  • Il computer è disattivato e non è raggiungibile.
  • Il computer ha un problema di connettività di rete.
  • L'estensione del ruolo di lavoro ibrido per runbook è stata disinstallata dal computer.

Risoluzione

  • Controllare che il computer esista e che l'estensione del ruolo di lavoro ibrido per runbook sia installata su di esso. Il ruolo di lavoro ibrido deve essere integro e restituire un heartbeat. Risolvere qualsiasi problema di rete controllando i registri eventi Microsoft-SMA sui ruoli di lavoro nel gruppo dei ruoli di lavoro ibridi per runbook che ha cercato di eseguire questo processo.
  • È anche possibile monitorare la metrica HybridWorkerPing, che fornisce il numero di ping da un ruolo di lavoro ibrido e può aiutare a identificare i problemi correlati ai ping.

Scenario: il processo è stato sospeso perché ha superato il limite di processi per un ruolo di lavoro ibrido

Problema

Il processo è stato sospeso con il messaggio di errore seguente:

Il processo è stato sospeso perché ha superato il limite di processi per un ruolo di lavoro ibrido. Aggiungere più ruoli di lavoro ibridi al gruppo di ruoli di lavoro ibridi per superare questo problema.

Causa

I processi potrebbero essere sospesi a causa di uno dei motivi seguenti:

  • Ciascun ruolo di lavoro ibrido attivo nel gruppo esegue il polling per i processi ogni 30 secondi per verificare la disponibilità di eventuali processi. Il ruolo di lavoro seleziona i processi in base all'ordine di arrivo. A seconda del momento in cui è stato eseguito il push di un processo, il ruolo di lavoro ibrido all'interno del gruppo di ruoli di lavoro ibridi che esegue per primo il ping del servizio di Automazione è quello che ottiene il processo. Un singolo ruolo di lavoro ibrido in genere può raccogliere quattro processi per ping, ovvero ogni 30 secondi. Se il tasso di push di processi è superiore a quattro ogni 30 secondi e nessun altro ruolo di lavoro seleziona il processo, quest'ultimo potrebbe essere sospeso.
  • Potrebbe non verificarsi il polling del ruolo di lavoro ibrido ogni 30 secondi, come previsto. Questo potrebbe verificarsi se il ruolo di lavoro non è integro o in presenza di problemi di rete.

Risoluzione

  • Se il limite di processi per un ruolo di lavoro ibrido supera i quattro processi ogni 30 secondi, è possibile aggiungere altri ruoli di lavoro ibridi al gruppo di ruoli di lavoro ibridi per ottenere una disponibilità elevata e un bilanciamento del carico. È anche possibile pianificare i processi, in modo che non superino il limite di quattro processi ogni 30 secondi. Il tempo di elaborazione della coda processi dipende dal profilo hardware e dal carico del ruolo di lavoro ibrido. Verificare che il ruolo di lavoro ibrido sia integro e restituisca un heartbeat.
  • Risolvere qualsiasi problema di rete controllando i registri eventi Microsoft-SMA sui ruoli di lavoro nel gruppo dei ruoli di lavoro ibridi per runbook che ha cercato di eseguire questo processo.
  • È anche possibile monitorare la metrica HybridWorkerPing, che fornisce il numero di ping da un ruolo di lavoro ibrido e può aiutare a identificare i problemi correlati ai ping.

Problema

Si sta distribuendo un ruolo di lavoro ibrido per runbook basato su estensione in una macchina virtuale, che non riesce con errore: Autenticazione non riuscita per collegamenti privati.

Causa

La rete virtuale della macchina virtuale è diversa dall'endpoint privato dell'account Automazione di Azure o non sono connessi.

Risoluzione

Verificare che l'endpoint privato dell'account Automazione di Azure sia connesso alla stessa rete virtuale, a cui è connessa la macchina virtuale. Seguire i passaggi menzionati in Pianificazione basata sulla rete per connettersi a un endpoint privato. Impostare flag di accesso alla rete pubblica per configurare un account di Automazione per rifiutare tutte le configurazione pubbliche e consentire solo le connessioni tramite endpoint privati. Per altre informazioni su come configurare le impostazioni DNS per gli endpoint privati, vedere Configurazione DNS

Scenario: la distribuzione di un ruolo di lavoro ibrido ha esito negativo quando il gruppo di ruoli di lavoro ibridi specificato non esiste

Problema

Si sta distribuendo un ruolo di lavoro ibrido per runbook basato su estensione in una macchina virtuale e si verifica l'errore: L'account o il gruppo specificato non esiste.

Causa

Il gruppo di ruoli di lavoro ibridi per runbook in cui deve essere distribuito il ruolo di lavoro ibrido è già stato eliminato.

Risoluzione

Assicurarsi di creare il gruppo di ruoli di lavoro ibridi per runbook e aggiungere la macchina virtuale come ruolo di lavoro ibrido in tale gruppo. Seguire i passaggi menzionati in Creare un gruppo di ruoli di lavoro ibridi per runbook usando il portale di Azure.

Scenario: la distribuzione del ruolo di lavoro ibrido non riesce quando l'identità gestita assegnata dal sistema non è abilitata nella macchina virtuale

Problema

Si sta distribuendo un ruolo di lavoro ibrido per runbook basato su estensione in una macchina virtuale e si verifica l'errore:
Impossibile recuperare l'endpoint dell'identità IMDS per una macchina virtuale non Azure. Assicurarsi che l'agente di Azure Connected Machine sia installato e che l'identità assegnata dal sistema sia abilitata.

Causa

Si sta distribuendo il ruolo di lavoro ibrido basato su estensione su una macchina virtuale non Azure che non presenta un agente di macchina virtuale connessa ad Arc installato.

Risoluzione

I computer non Azure devono avere l'agente di macchina virtuale connessa ad Arc installato prima della distribuzione come ruolo di lavoro ibrido per runbook basato su estensione. Per installare AzureConnectedMachineAgent, vedere Connettere macchine ibride ad Azure dal portale di Azure per i server abilitati per Arc o Gestire macchine virtuali VMware Azure Arc per abilitare la gestione guest per le macchine virtuali VMware abilitate per Arc.

Scenario: la distribuzione del ruolo di lavoro ibrido non riesce quando l'identità assegnata dal sistema non è abilitata

Problema

Si sta distribuendo un ruolo di lavoro ibrido per runbook basato su estensione in una macchina virtuale e si verifica l'errore: Token di autorizzazione non valido.

Causa

L'identità gestita assegnata dall'utente della macchina virtuale è abilitata, ma l'identità gestita assegnata dal sistema non è abilitata.

Risoluzione

Seguire questa procedura:

  1. Abilitare l'identità gestita assegnata dal sistema della macchina virtuale.
  2. Eliminare l'estensione del ruolo di lavoro ibrido non è installata in questa macchina virtuale.
  3. Reinstallare l'estensione del ruolo di lavoro ibrido nella macchina virtuale.

Scenario: il processo di installazione dell'estensione del ruolo di lavoro ibrido in una macchina virtuale Windows si blocca

Problema

Dopo l'installazione dell'estensione del ruolo di lavoro ibrido in una macchina virtuale Windows dal portale non è stata visualizzata la notifica di completamento del processo.

Causa

A volte il processo di installazione potrebbe bloccarsi.

Risoluzione

Seguire i passaggi indicati di seguito per installare nuovamente l'estensione del ruolo di lavoro ibrido:

  1. Aprire la console di PowerShell.

  2. Rimuovere la chiave del Registro di sistema, se presente: HKLM:\Software\Microsoft\Azure\HybridWorker

    1. Codice di PowerShell per rimuovere la chiave del Registro di sistema insieme a tutte le sottochiavi e i valori in esso contenuti:

      Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse

  3. Rimuovere la chiave del Registro di sistema, se presente: HKLM:\Software\Microsoft\HybridRunbookWorkerV2

    1. Codice di PowerShell per rimuovere la chiave del Registro di sistema insieme a tutte le sottochiavi e i valori in esso contenuti:

      Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse

  4. Andare alla cartella di installazione dell'estensione Ruolo di lavoro ibrido:

    Suggerimento

    Sostituire * nel comando seguente con la versione specifica installata se la si conosce.

    cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"

  5. Installare l'estensione Ruolo di lavoro ibrido:

    .\bin\install.ps1

  6. Abilitare l'estensione Ruolo di lavoro ibrido:

    .\bin\enable.ps1

Scenario: il processo di disinstallazione dell'estensione del ruolo di lavoro ibrido in una macchina virtuale Windows si blocca

Problema

Dopo l'installazione di un'estensione del ruolo di lavoro ibrido in una macchina virtuale Windows dal portale non è stata visualizzata la notifica di completamento del processo.

Causa

A volte il processo di disinstallazione potrebbe bloccarsi.

Risoluzione

  1. Aprire la console di PowerShell.

  2. Andare alla cartella di installazione dell'estensione Ruolo di lavoro ibrido:

    Suggerimento

    Sostituire * nel comando seguente con la versione specifica installata se la si conosce.

    cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"

  3. Disabilitare l'estensione Ruolo di lavoro ibrido:

    .\bin\disable.cmd

  4. Disinstallare l'estensione Ruolo di lavoro ibrido:

    .\bin\uninstall.ps1

  5. Rimuovere la chiave del Registro di sistema, se presente: HKLM:\Software\Microsoft\Azure\HybridWorker

    1. Codice di PowerShell per rimuovere la chiave del Registro di sistema insieme a tutte le sottochiavi e i valori in esso contenuti:

      Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse

  6. Rimuovere la chiave del Registro di sistema, se presente: HKLM:\Software\Microsoft\HybridRunbookWorkerV2

    1. Codice di PowerShell per rimuovere la chiave del Registro di sistema insieme a tutte le sottochiavi e i valori in esso contenuti:

      Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse

Scenario: il processo di installazione dell'estensione del ruolo di lavoro ibrido in una macchina virtuale Linux si blocca

Problema

Dopo l'installazione di un'estensione ruolo di lavoro ibrido in una macchina virtuale Linux dal portale non è stata visualizzata la notifica di completamento del processo.

Causa

A volte il processo di disinstallazione potrebbe bloccarsi.

Risoluzione

  1. Eliminare la cartella state:

    rm -r /home/hweautomation/state

  2. Andare alla cartella di installazione dell'estensione Ruolo di lavoro ibrido:

    Suggerimento

    Sostituire * nel comando seguente con la versione specifica installata se la si conosce.

    cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/

  3. Eliminare il file mrseq:

    rm mrseq

  4. Installare l'estensione Ruolo di lavoro ibrido:

    ./extension_shim.sh -c ./HWExtensionHandlers.py -i

  5. Abilitare l'estensione Ruolo di lavoro ibrido:

    ./extension_shim.sh -c ./HWExtensionHandlers.py -e

Scenario: il processo di disinstallazione dell'estensione del ruolo di lavoro ibrido in una macchina virtuale Linux si blocca

Problema

Dopo la disinstallazione dell'estensione del ruolo di lavoro ibrido in una macchina virtuale Linux dal portale non è stata visualizzata la notifica di completamento del processo.

Causa

A volte il processo di disinstallazione potrebbe bloccarsi.

Risoluzione

Seguire i passaggi indicati di seguito per disinstallare completamente l'estensione del ruolo di lavoro ibrido:

  1. Passare alla cartella di installazione dell'estensione del ruolo di lavoro ibrido:

    Suggerimento

    Sostituire * nel comando seguente con la versione specifica installata se la si conosce.

    cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/
  2. Disabilitare l'estensione Ruolo di lavoro ibrido: 
    ./extension_shim.sh -c ./HWExtensionHandlers.py -d
  3. Disinstallare l'estensione Ruolo di lavoro ibrido: 
    ./extension_shim.sh -c ./HWExtensionHandlers.py -u

Scenario: l'esecuzione del runbook ha esito negativo

Problema

L'esecuzione del runbook ha esito negativo e viene visualizzato il messaggio di errore seguente:

The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times.

Il runbook viene sospeso dopo il terzo tentativo di esecuzione. Alcune condizioni possono interrompere il runbook prima del completamento. Il relativo messaggio di errore potrebbe essere privo di informazioni aggiuntive.

Causa

Le possibili cause sono le seguenti:

  • I runbook non possono autenticarsi con le risorse locali.
  • Il ruolo di lavoro ibrido è protetto da proxy o firewall.
  • Il computer designato per eseguire il ruolo di lavoro ibrido per runbook non soddisfa i requisiti hardware minimi.

Risoluzione

Verificare che il computer abbia accesso in uscita a *.azure-automation.net sulla porta 443.

I computer che eseguono il ruolo di lavoro ibrido per runbook devono soddisfare i requisiti hardware minimi per consentire al ruolo di lavoro di ospitare questa funzionalità. I runbook e il processo in background in uso potrebbero causare un sovraccarico al sistema e provocare ritardi o timeout nei processi di runbook.

Verificare che il computer designato per svolgere il ruolo di lavoro ibrido per runbook soddisfi i requisiti hardware minimi. In caso affermativo, monitorare l'utilizzo di CPU e memoria per determinare eventuali correlazioni tra le prestazioni dei processi del ruolo di lavoro ibrido per runbook e Windows. Un uso elevato di CPU o memoria può indicare la necessità di aggiornamento delle risorse. In alternativa, selezionare una risorsa di calcolo diversa in grado di supportare i requisiti minimi e il ridimensionamento quando le esigenze del carico di lavoro indicano la necessità di un aumento.

Verificare se nel registro eventi Microsoft-SMA è presente un evento corrispondente alla descrizione Win32 Process Exited with code [4294967295]. L'errore è causato dalla mancata configurazione dell'autenticazione nei runbook oppure le credenziali Esegui come non sono state specificate per il gruppo del ruolo di lavoro ibrido. Controllare le autorizzazioni del runbook in Esecuzione di runbook in un ruolo di lavoro ibrido per runbook per verificare di avere configurato correttamente l'autenticazione per i runbook.

Scenario: non è stato trovato alcun certificato nell'archivio certificati del ruolo di lavoro ibrido per runbook

Problema

Un runbook in esecuzione nel ruolo di lavoro ibrido per runbook ha esito negativo con il messaggio di errore seguente:

Connect-AzAccount : No certificate was found in the certificate store with thumbprint 0000000000000000000000000000000000000000
At line:3 char:1
+ Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -Appl ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : CloseError: (:) [Connect-AzAccount],ArgumentException
    + FullyQualifiedErrorId : Microsoft.Azure.Commands.Profile.ConnectAzAccountCommand

Causa

Questo errore si verifica quando si prova a usare un account RunAs in un runbook eseguito nel ruolo di lavoro ibrido per runbook in cui non è presente il certificato dell'account RunAs. Per impostazione predefinita, i ruoli di lavoro ibridi per runbook non hanno l'asset del certificato in locale. L'account RunAs richiede il corretto funzionamento di questo asset.

Risoluzione

Se il ruolo di lavoro ibrido per runbook in una macchina virtuale di Azure, è possibile usare l'autenticazione del runbook con le identità gestite. Questo scenario rende più semplice l'autenticazione, consentendo all'utente di autenticarsi nelle risorse di Azure usando l'identità gestita della macchina virtuale di Azure anziché l'account RunAs. Quando il ruolo di lavoro ibrido per runbook è un computer locale, è necessario installare sul computer il certificato dell'account RunAs. Per informazioni su come installare il certificato, vedere la procedura di esecuzione del runbook di PowerShell Export-RunAsCertificateToHybridWorker in Esecuzione di runbook in un ruolo di lavoro ibrido per runbook.

Scenario: macchine virtuali di Microsoft Azure eliminate automaticamente da un gruppo del ruolo di lavoro ibrido

Problema

Non è possibile visualizzare le VM o il ruolo di lavoro ibrido per runbook quando il computer di lavoro è rimasto inattivo per molto tempo.

Causa

Il computer con ruolo di lavoro ibrido per runbook non ha eseguito il ping con Automazione di Azure per più di 30 giorni. Di conseguenza, Automazione ha rimosso il gruppo del ruolo di lavoro ibrido per runbook o del ruolo di lavoro di sistema.

Risoluzione

Avviare il computer con ruolo di lavoro, quindi registrarlo nuovamente con Automazione di Azure. Per istruzioni su come installare l'ambiente per runbook e connettersi ad Automazione di Azure, vedere Distribuzione di un ruolo di lavoro ibrido per runbook di Windows.

Passaggi successivi

Se il problema riscontrato non è presente in questo elenco o se non si riesce a risolverlo, visitare uno dei canali seguenti per ottenere maggiore assistenza:

  • Ottenere risposte dagli esperti di Azure tramite i forum di Azure.
  • Connettersi con @AzureSupport, l'account ufficiale Microsoft Azure per migliorare l'esperienza del cliente. Il supporto di Azure mette in contatto la community di Azure con le risorse giuste: risposte, supporto ed esperti.
  • Archiviare un incidente del supporto tecnico di Azure. Accedere al sito del supporto tecnico di Azure e selezionare Supporto tecnico.