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

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

常规故障排除

有关扩展部署状态的数据可以从 Azure 门户进行检索。

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

若要检查来宾代理日志，请查看在 %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs 中为 Windows（对于 Linux，为 /var/lib/GuestConfig/ext_mgr_logs）预配扩展时的活动。
对于 Windows，请在 %SystemDrive%\ProgramData\GuestConfig\extension_logs\<Extension> 中检查特定扩展的扩展日志以了解详细信息。对于在 Linux 上安装的每个扩展，扩展输出会记录到 /var/lib/GuestConfig/extension_logs 下的文件中。
请查看扩展特定文档中有关错误代码和已知问题等的故障排除部分。可在扩展概述的“故障排除和支持”部分中找到每个扩展的其他故障排除信息。这包括写入日志的错误代码的说明。扩展文章链接在扩展表中。
查看系统日志。检查其他可能影响了扩展的操作，例如，长时间安装另一个需要包管理器独占访问权限的应用程序。

为已启用 Azure Arc 的服务器启用 VM Insights 时，它会安装依赖项和 Log Analytics 代理。在运行速度较慢的计算机或网络连接速度缓慢的计算机上，可能会在安装过程中遇到超时的情况。 Azure 正在采取措施来解决已连接的计算机代理中的此问题，以帮助改进这种状况。在此期间，重试安装可能会成功。

Log Analytics 代理版本 1.13.9（对应的扩展版本为 1.13.15）未正确将上传的数据标记为已启用 Azure Arc 的服务器的资源 ID。尽管日志会发送到服务，但当你在选择“日志”或“见解”后，尝试从所选启用的服务器查看数据时，不会返回任何数据。可以通过从 Azure Monitor 日志（或从用于 VM 的 Azure Monitor）中运行查询来查看其数据，这些查询的范围限定在工作区中。
适用于 Linux 的 Log Analytics 代理目前不支持某些分发版。代理需要安装其他依赖项，包括 Python 2。在此处查看支持矩阵和必备组件。
状态消息中的错误代码 52 指示缺少依赖项。若要详细了解缺少的依赖项，请查看输出和日志。
如果安装失败，请查看扩展概述中的“故障排除和支持”部分。在大多数情况下，状态消息中会包含一个错误代码。对于适用于 Linux 的 Log Analytics 代理，此处介绍了状态消息以及此 VM 扩展的常规故障排除信息。

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