监视 IoT Edge 部署

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

重要

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

Azure IoT Edge 提供有关部署到 IoT Edge 设备的模块的实时信息。 IoT 中心服务从设备获取状态,并向你显示状态。 监视对于大规模部署(包括自动部署和分层部署)也很重要。

设备和模块具有类似的数据(如连接性),因此可以根据设备 ID 或模块 ID 获取值。

IoT 中心服务收集设备和模块孪生报告的数据,并提供设备可能具有的不同状态的计数。 IoT 中心服务将此数据组织成四组指标:

类型 说明
目标 显示与部署目标条件匹配的 IoT Edge 设备。
已应用 显示未成为另一优先级更高的部署的目标的目标 IoT Edge 设备。
报告成功 显示 IoT Edge 设备报告模块已成功部署。
报告失败 显示报告一个或多个模块未成功部署的 IoT Edge 设备。 若要调查错误,请远程连接到这些设备并查看日志文件。

可以在 Azure 门户中监视此数据或使用 Azure CLI。

在 Azure 门户中监视部署

若要查看部署详细信息并监视运行它的设备,请执行以下步骤:

  1. 登录到 Azure 门户,然后转到 IoT 中心。

  2. “设备管理”下选择“配置 + 部署”。

  3. 查看部署列表。 对于每个部署,你将看到以下详细信息:

    说明
    身份证件 部署的名称。
    类型 部署的类型(“部署”或“分层部署”) 。
    目标条件 定义目标设备的标记。
    优先级 分配给部署的优先级编号。
    系统指标 IoT 中心内与目标条件匹配的设备孪生数。 “已应用”显示在 IoT 中心将部署内容应用到其模块孪生的设备数。
    设备指标 从 IoT Edge 客户端运行时报告成功或错误的 IoT Edge 设备数。
    自定义指标 针对你为部署定义的任何指标报告数据的 IoT Edge 设备数。
    创建 创建部署时的时间戳。 两个部署具有相同优先级,此时间戳用于消除它们的关系。
  4. 选择要监视的部署。

  5. “部署详细信息 ”页上,转到 “目标条件 ”选项卡。选择 “视图 ”以列出与目标条件匹配的设备。 根据需要更改条件或 优先级 ,然后选择“ 保存”。

    屏幕截图显示了部署的目标设备。

  6. 选择“ 指标 ”选项卡。从 “选择指标 ”下拉列表中选择指标时,将显示 “视图 ”按钮,以便显示结果。 选择 “编辑指标 ”以调整你定义的任何自定义指标的条件。 如有更改,请选择“保存”。

    屏幕截图显示了部署的指标。

若要更改部署,请参阅 “修改部署”。

使用 Azure CLI 监视部署

使用 az iot edge deployment show 命令显示单个部署的详细信息:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

deployment show 命令使用以下参数:

  • --deployment-id - IoT 中心中的部署名称。 必需参数。
  • --hub-name - 部署所在的 IoT 中心的名称。 此中心必须在当前订阅中。 使用 az account set -s [subscription name] 切换到订阅

在命令窗口中检查部署。 metrics 属性列出由每个中心评估的每个指标的计数:

  • targetedCount - 与目标条件匹配的 IoT 中心的设备孪生数。
  • appliedCount - 显示在 IoT 中心将部署内容应用到其模块孪生的设备数
  • reportedSuccessfulCount - 部署中报告 IoT Edge 客户端运行时成功的 IoT Edge 设备数
  • reportedFailedCount - 部署中报告 IoT Edge 客户端运行时失败的 IoT Edge 设备数

使用 az iot edge deployment show-metric 命令显示每个指标的设备 ID 或对象的列表:

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

deployment show-metric 命令使用以下参数:

  • --deployment-id - IoT 中心中的部署名称。
  • --metric-id - 要显示设备 ID 列表的指标的名称,例如 reportedFailedCount
  • --hub-name - 部署所在的 IoT 中心的名称。 此中心必须在当前订阅中。 使用az account set -s [subscription name]切换到订阅。 若要更改部署,请参阅修改部署

后续步骤

了解如何 监视模块孪生(主要是 IoT Edge 代理和 IoT Edge 中心运行时模块)来检查 IoT Edge 部署的连接性和运行状况。