你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

排查已启用 Azure Arc 的服务器 VM 扩展问题

本文介绍如何排查和解决尝试在已启用 Azure Arc 的服务器上部署或删除 Azure 虚拟机(VM)扩展时可能发生的问题。 有关一般信息,请参阅 已启用 Azure Arc 的服务器进行虚拟机扩展管理

常规故障排除

可以通过选择适用的计算机,然后选择“设置扩展”>,从 Azure 门户检索有关扩展部署状态的数据。

有关常规故障排除,请尝试以下步骤。 这些步骤适用于所有 VM 扩展。

  1. 确保已连接 Azure Connected Machine 代理(azcmagent)并且依赖服务 正在运行/活动

    运行azcmagent show命令并检查输出以查看状态(可以忽略Azure Arc代理):

    表的屏幕截图,其中显示了正在运行或已停止的依赖服务状态。

    如果 Azure Arc 代理 以外的任何服务已停止,请重启它们以恢复扩展作。

  2. 重试扩展安装。

    由于各种原因,扩展可能会卡在 “失败 ”或其他状态中。 如果扩展的状态未列为 “成功”,请删除该扩展并再次安装它。 以下 Azure PowerShell 命令可用于删除扩展:

    Remove-AzConnectedMachineExtension -Name <Extension Name> -ResourceGroupName <RG Name> -MachineName <Machine Name>
    
  3. 检查来宾代理日志并了解从预配扩展开始的活动。 对于 Windows,请在 %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs 中检查,对于 Linux,请在 /var/lib/GuestConfig/ext_mgr_logs 中检查。

  4. 检查特定扩展的扩展日志来了解详细信息。

    对于 Windows 计算机:

    • 日志存储在 C:\ProgramData\GuestConfig
    • 扩展设置和状态文件位于 C:\Packages\Plugins

    对于 Linux 计算机:

    • 日志存储在 /var/lib/GuestConfig
    • 扩展设置和状态文件位于 /var/lib/waagent

    扩展服务日志被写入到 …GuestConfig\ext_mgr_logs\gc_ext.log 中。 有关下载或验证包的错误会显示在那里。

  5. 有关错误代码、已知问题或其他详细信息,请查看特定于扩展的文档故障排除部分。 可以在 扩展表中查找许多扩展的文档。

  6. 查看系统日志。 检查其他可能影响了扩展的操作,例如,长时间安装另一个需要包管理器独占访问权限的应用程序。

后续步骤

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