Resolver problemas de ligação do Azure Connected Machine Agent

Este artigo fornece informações para solucionar problemas que podem ocorrer durante a configuração do agente de Máquina Conectada do Azure para Windows ou Linux. Dicas para os métodos de instalação interativos e em grande escala na configuração da conexão com o serviço estão incluídas.

Para obter informações gerais, consulte Visão geral dos servidores habilitados para Arco do Azure, Visão geral do agente do Azure Connected Machine e Gerenciar e manter o agente do Connected Machine.

Códigos de erro do agente

Use a tabela a seguir para identificar e resolver problemas ao configurar o agente da Máquina Conectada do Azure usando o AZCM0000 código de erro ("0000" pode ser qualquer número de quatro dígitos) impresso na saída do console ou do script.

Códigos de saída do agente

Ao executar comandos do Azure Connected Machine Agent (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, os códigos de saída são retornados pelo sistema operacional quando o processo do agente é encerrado.

Registo detalhado do agente

Para seguir as etapas de resolução de problemas descritas posteriormente neste artigo, as informações mínimas necessárias são o registo detalhado. Esse log contém a saída dos comandos da ferramenta azcmagent , quando o argumento verbose (-v) é usado. Os arquivos de log são gravados em %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log para Windows e em /var/opt/azcmagent/log/azcmagent.log para Linux.

Windows

O comando a seguir é um exemplo que habilita o registro detalhado com o agente de Máquina Conectada 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 seguinte comando é um exemplo que ativa a criação de logs detalhados com o agente de Máquina Conectada para Windows ao realizar uma instalação em larga escala com um principal 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 permite o registro detalhado com o agente 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 seguinte comando é um exemplo que permite o registo verboso com o agente Connected Machine para Linux ao realizar uma instalação em escala usando um principal 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 ligação do agente ao serviço

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

Próximos passos

Se não vir o problema aqui ou não conseguir resolvê-lo, experimente um dos seguintes canais de suporte:

• Obtenha respostas de especialistas do Azure através das Perguntas e Respostas da Microsoft.
• Abra um pedido de suporte para obter assistência. Para obter mais informações, veja Criar um pedido de suporte do Azure.