监视 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

Azure IoT Edge 提供报告,让你可以实时监视部署到 IoT Edge 设备上的模块的信息。 IoT 中心服务从设备检索状态,然后将这些状态提供给操作员。 监视对于大规模部署(包括自动部署和分层部署)也很重要。

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

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

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

IoT 中心服务使此数据可供你在 Azure 门户和 Azure CLI 中监视。

在 Azure 门户中监视部署

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

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

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

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

    说明
    ID 部署的名称。
    类型 部署的类型(“部署”或“分层部署”) 。
    目标条件 用于定义目标设备的标记。
    优先级 分配给部署的优先级编号。
    系统指标 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 部署的连接性和运行状况。