排查 Azure Connected Machine 代理连接问题

本文提供了有关排查在配置适用于 Windows 或 Linux 的 Azure Connected Machine 代理时可能出现的问题的信息。 在配置与服务 的连接时，包含交互式和大规模安装方法 的提示。

有关常规信息，请参阅 已启用 Azure Arc 的服务器概述、 Azure Connected Machine 代理概述以及 管理和维护 Connected Machine 代理。

代理错误代码

使用下表确定并解决在使用输出到控制台或脚本输出的 AZCM0000（“0000”可以是任何四位数）配置 Azure Connected Machine 代理时出现的问题。

代理详细日志

若要按照本文后面所述的故障排除步骤作，所需的最低信息是详细日志。 当使用详细 （-v） 参数时，此日志包含 azcmagent 工具命令的输出。 对于 Windows，日志文件将写入 %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log；对于 Linux，日志文件将写入 /var/opt/azcmagent/log/azcmagent.log。

Windows操作系统

以下命令是一个示例，用于在执行交互式安装时，通过用于 Windows 的 Connected Machine 代理启用详细日志记录功能。

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

以下命令是使用服务主体执行大规模安装时，使用适用于 Windows 的 Connected Machine 代理启用详细日志记录的示例。

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

以下命令是执行交互式安装时使用适用于 Linux 的 Connected Machine 代理执行详细日志记录的示例。

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

以下命令是使用服务主体执行大规模安装时，使用适用于 Linux 的 Connected Machine 代理启用详细日志记录的示例。

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

服务的代理连接问题

下表列出了有关如何排查和解决这些错误的各种错误和建议。

后续步骤

如果你的问题未在本文中列出，或者无法解决你遇到的问题，请尝试通过以下途径之一获取支持：

• 通过 Microsoft Q&A 获取 Azure 专家的解答。
• 提出支持请求以获取帮助。 有关详细信息，请参阅创建 Azure 支持请求。