在 Azure 门户中对 IoT Edge 设备进行故障排除

适用于:IoT Edge 1.5 复选标记 IoT Edge 1.5 IoT Edge 1.4 复选标记 IoT Edge 1.4

重要

IoT Edge 1.5 LTS 和 IoT Edge 1.4 LTS 是受支持的版本。 IoT Edge 1.4 LTS 的生命周期结束日期为 2024 年 11 月 12 日。 如果你使用的是较低的版本,请参阅更新 IoT Edge

IoT Edge 提供了一种在 Azure 门户中针对模块的监视和故障排除的简化方法。 “故障排除”页是 IoT Edge 代理直接方法的包装器,使你可以轻松地从部署的模块中检索日志,并以远程方式重启它们。 本文介绍如何在 Azure 门户中访问和筛选设备与模块日志。

访问“故障排除”页

可以通过“IoT Edge 设备详细信息”页或“IoT Edge 模块详细信息”页访问门户中的“故障排除”页。

  1. 登录 Azure 门户,导航到 IoT 中心。

  2. 在左侧窗格中,选择“设备管理”菜单下的“设备”。

  3. 从设备列表中选择要监视的 IoT Edge 设备。

  4. 在此设备详细信息页上,可以从菜单中选择“故障排除”。

    Azure 门户上设备详细信息页中的“故障排除”选项卡位置的屏幕截图。

    或者,选择要检查的特定模块的运行时状态。

    Azure 门户上设备详细信息页中的“运行时状态”列位置的屏幕截图。

  5. 在“设备详细信息”页中,还可以选择模块的名称来打开“模块详细信息”页。 在该页中,可以从菜单中选择“故障排除”。

    Azure 门户上模块详细信息页中的“故障排除”选项卡位置的屏幕截图。

在门户中查看模块日志

在设备的“故障排除”页上,可以查看和下载 IoT Edge 设备上任何正在运行的模块中的日志。

此页的最大日志行数限制为 1500 行,超过此限制的任何日志都将被截断。 如果日志过大,获取模块日志的尝试将会失败。 在这种情况下,请尝试更改时间范围筛选器以检索较少的数据,或考虑使用直接方法从 IoT Edge 部署中检索日志以收集大型日志文件。

使用下拉菜单选择要检查的模块。

显示如何从下拉菜单中选择要检查的模块的屏幕截图。

默认情况下,此页显示最近 15 分钟内的日志。 选择“时间范围”筛选器以查看不同日志。 使用滑块选择过去 60 分钟内的时间范围,或选中“输入时间”以选择特定的日期时间范围。

显示如何从时间范围弹出筛选器中选择时间或时间范围的屏幕截图。

在获取日志并从要进行故障排除的模块设置时间筛选器后,可以使用“查找”筛选器从日志中检索特定的行。 可以筛选警告或错误,也可以提供要搜索的特定字词或短语。

显示如何使用 dotnet 正则表达式模式通过“查找”筛选器搜索日志的屏幕截图。

对于较复杂的搜索,“查找”功能支持纯文本搜索或 .NET 正则表达式

可以将模块日志以文本文件形式下载。 下载的日志文件将反映已应用于日志的所有活动筛选器。

提示

设备上的 CPU 利用率将暂时达到峰值,因为它会收集日志以响应来自门户的请求。 此行为符合预期,任务完成后,利用率应该会稳定下来。

重启模块

“故障排除”页包含重启模块的功能。 选择此选项会向 IoT Edge 代理发送命令以重启所选模块。 重启模块不会影响你在重启之前检索日志的能力。

显示如何在“故障排除”页中重启模块的屏幕截图。

后续步骤

查找有关对 IoT Edge 设备进行故障排除的更多提示,或了解常见问题和解决方法

如果你还有其他问题,请创建支持请求以获取帮助。