Solucionar problemas de conexão do agente do Azure Connected Machine

Este artigo fornece informações para solucionar problemas que podem ocorrer ao configurar o agente do Azure Connected Machine para Windows ou Linux. Isso inclui dicas para o método de instalação interativo e o método de instalação em larga escala ao configurar a conexão com o serviço.

Para obter informações gerais, consulte a visão geral dos servidores habilitados para Azure Arc, a visão geral do agente do Azure Connected Machine e gerenciar e manter o agente do Computador Conectado.

Códigos de erro do agente

Use a tabela a seguir para identificar e resolver problemas ao configurar o agente do Azure Connected Machine. A saída de console ou script exibe o AZCM0000 código de erro, em que "0000" pode ser qualquer número de quatro dígitos.

Códigos de saída do agente

Quando você executa comandos do Agente de Máquina Conectada do Azure (azcmagent), o processo pode ser encerrado com um código de saída. Esses códigos indicam o resultado da operação e ajudam a diagnosticar problemas. Ao contrário dos códigos de erro, o sistema operacional retorna códigos de saída quando o processo do agente é encerrado.

Log detalhado do agente

Para seguir as etapas de solução de problemas descritas posteriormente neste artigo, você precisará do log detalhado. Esse log contém a saída dos comandos da ferramenta azcmagent quando você usa o argumento verbose (-v). Os arquivos de log são gravados no %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log para Windows e no /var/opt/azcmagent/log/azcmagent.log para Linux.

Windows

O comando a seguir é um exemplo que habilita o log detalhado usando o agente do Connected Machine para Windows ao executar uma instalação interativa.

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

O comando a seguir é um exemplo que habilita o registro detalhado usando o agente Connected Machine para Windows quando executa uma instalação em escala por meio de uma entidade de serviço.

& "$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

O comando a seguir é um exemplo que habilita o log detalhado usando o agente do Connected Machine para Linux ao executar uma instalação interativa.

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

O comando a seguir é um exemplo que habilita o registro detalhado usando o agente Connected Machine para Linux quando executa uma instalação em escala por meio de uma entidade de serviço.

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

Problemas de conexão do agente com o serviço

A tabela a seguir lista vários erros e sugestões sobre como solucioná-los e resolvê-los.

Próximas etapas

Se você não encontrar seu problema aqui ou não conseguir resolvê-lo, visite um dos seguintes canais para obter suporte:

• Obtenha respostas de especialistas do Azure no Microsoft Q&A.
• Abra uma solicitação de suporte para obter assistência. Para obter mais informações, confira Criar uma solicitação de Suporte do Azure.