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

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

常规故障排除

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

以下故障排除步骤适用于所有 VM 扩展。

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

   运行azcmagent show命令并检查输出以查看状态（可以忽略Azure Arc代理）：

   

   如果服务已停止，请重启服务以恢复扩展操作。

2. 重试扩展安装

   由于各种原因，扩展可能会停滞在正在创建/正在更新或失败状态下。 在这种情况下，请移除扩展并再次安装它。 若要移除某个扩展，请使用以下命令：

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

后续步骤

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

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