Risolvere i problemi di connessione agente di Azure Connected Machine

Questo articolo fornisce informazioni per la risoluzione dei problemi che possono verificarsi durante la configurazione dell'agente di Azure Connected Machine per Windows o Linux. Sono inclusi i suggerimenti per i metodi di installazione interattivi e su larga scala durante la configurazione della connessione al servizio.

Per informazioni generali, vedere Panoramica dei server abilitati da Azure Arc, Panoramica dell'agente Azure Connected Machine e Gestire e mantenere l'agente macchine connesse.

Codici di errore dell'agente

Usare la tabella seguente per identificare e risolvere i problemi durante la configurazione dell'agente di Azure Connected Machine usando il codice di errore AZCM0000 ("0000" può essere un numero di quattro cifre) stampato nella console o nell'output dello script.

Codici di uscita dell'agente

Quando si eseguono i comandi di Azure Connected Machine Agent (azcmagent), il processo può terminare con un codice di uscita. Questi codici indicano il risultato dell'operazione e consentono di diagnosticare i problemi. A differenza dei codici di errore, i codici di uscita vengono restituiti dal sistema operativo quando il processo dell'agente viene chiuso.

Log dettagliato dell'agente

Per seguire la procedura di risoluzione dei problemi descritta più avanti in questo articolo, le informazioni minime necessarie sono il log dettagliato. Contiene l'output dei comandi dello strumento azcmagent, quando viene usato l'argomento verbose (-v). I file di log vengono scritti in %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log per Windows e Linux in /var/opt/azcmagent/log/azcmagent.log.

Windows

Il comando seguente è un esempio che abilita la registrazione dettagliata con l'agente Connected Machine per Windows durante l'esecuzione di un'installazione interattiva.

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose

Il comando riportato di seguito è un esempio del comando che abilita la registrazione verbose con l'agente Connected Machine per Windows quando si esegue un'installazione su larga scala usando un'entità servizio.

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
  --service-principal-id "{serviceprincipalAppID}" `
  --service-principal-secret "{serviceprincipalPassword}" `
  --resource-group "{ResourceGroupName}" `
  --tenant-id "{tenantID}" `
  --location "{resourceLocation}" `
  --subscription-id "{subscriptionID}"
  --verbose

Linux

Il comando seguente è un esempio che abilita la registrazione dettagliata con l'agente Connected Machine per Linux durante l'esecuzione di un'installazione interattiva.

azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose

Di seguito è riportato un esempio del comando per abilitare la registrazione verbose con l'agente Connected Machine per Linux quando si esegue un'installazione su larga scala usando un'entità servizio.

azcmagent connect \
  --service-principal-id "{serviceprincipalAppID}" \
  --service-principal-secret "{serviceprincipalPassword}" \
  --resource-group "{ResourceGroupName}" \
  --tenant-id "{tenantID}" \
  --location "{resourceLocation}" \
  --subscription-id "{subscriptionID}"
  --verbose

Problemi di connessione dell'agente al servizio

Nella tabella seguente sono elencati vari errori e suggerimenti su come individuarli e risolverli.

Passaggi successivi

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

• Ottenere risposte dagli esperti di Azure tramite Microsoft Q&A.
• Aprire una richiesta di supporto per ottenere assistenza. Per altre informazioni, vedere Creare una richiesta di supporto di Azure.