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

本文提供有关排查和解决尝试在已启用 Azure Arc 的服务器上部署或删除 Azure VM 扩展时可能出现的问题的信息。 如需常规信息，请参阅管理和使用 Azure VM 扩展。

常规故障排除

可以通过选择适用的计算机，然后选择“设置”>“扩展”，从 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 支持事件。 请转到 Azure 支持站点提交请求。