监视 IoT Edge 部署

适用于： IoT Edge 1.5 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 门户中监视部署

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

检查部署列表。对于每个部署，可以查看以下详细信息：

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

选择想要监视的部署。
在“部署详细信息”页上，向下滚动到底部部分并选择“目标条件”选项卡。选择“查看”以列出符合目标条件的设备。可以更改条件，也可以更改“优先级”。如果进行了更改，请选择“保存”。
选择“指标”选项卡。如果从“选择指标”下拉列表中选择指标，则会出现“查看”按钮，用于显示结果。还可以选择“编辑指标”以调整已定义的任何自定义指标的条件。如果进行了更改，请选择“保存”。

若要更改部署，请参阅修改部署。

使用 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 部署的连接性和运行状况。