教程：监视 IoT Edge 设备

项目
04/12/2024

适用于： IoT Edge 1.4

使用 Azure Monitor 工作簿监视 Azure IoT Edge 部署的运行状况和性能。

在本教程中，你将了解：

了解 IoT Edge 设备共享哪些指标以及指标收集器模块如何对其进行处理。
将指标收集器模块部署到 IoT Edge 设备。
查看从设备收集的指标的策展可视化效果。

先决条件

部署了模拟温度传感器模块的 IoT Edge 设备。如果没有准备好设备，请按照将第一个 IoT Edge 模块部署到虚拟 Linux 设备中的步骤，使用虚拟机创建一个。

了解 IoT Edge 标记

每个 IoT Edge 设备都依赖于两个模块，即运行时模块，用于管理设备上所有其他模块的生命周期和通信。这些模块称为“IoT Edge 代理”和“IoT Edge 中心” 。若要详细了解这些模块，请参阅了解 Azure IoT Edge 运行时及其体系结构。

两个运行时模块均可创建指标，让你可远程监视 IoT Edge 设备或各个模块的性能情况。 IoT Edge 代理报告各个模块和主机设备的状态，因此会创建模块正常运行的时间、设备上使用的 RAM 量和 CPU 百分比等指标。 IoT Edge 中心报告设备上的通信情况，因此会创建发送和接收的消息总数、解析直接方法所需的时间等指标。有关可用指标的完整列表，请参阅访问内置指标。

这两个模块会自动公开这些指标，以便你可以创建自己的解决方案来访问和报告这些指标。为了简化此过程，Azure 提供了 azureiotedge-metrics-collector 模块，用于为没有或不想要自定义解决方案的用户处理此过程。指标收集器模块从两个运行时模块和可能需要监视的任何其他模块收集指标，并将这些指标传输到设备外。

指标收集器模块以两种方式之一将指标发送到云。第一种方式将在本教程中使用，该方式将指标直接发送到 Log Analytics。第二种方式（仅在网络策略需要时才建议使用）通过 IoT 中心发送指标，然后设置路由以将指标消息传递到 Log Analytics。无论使用哪种方式，只要指标位于 Log Analytics 工作区中，就可以通过 Azure Monitor 工作簿进行查看。

创建 Log Analytics 工作区

Log Analytics 工作区是收集指标数据所必需的，并提供查询语言和与 Azure Monitor 的集成，以便监视设备。

登录到 Azure 门户。
搜索并选择“Log Analytics 工作区”。
选择“创建”，然后按提示创建新工作区。
创建工作区后，选择“转到资源”。
从主菜单的“设置”下，选择“代理管理” 。
复制“工作区 ID”和“主密钥”的值。本教程稍后将使用这两个值来配置指标收集器模块，以将指标发送到此工作区。

检索 IoT 中心资源 ID

配置指标收集器模块时，为其提供 IoT 中心的 Azure 资源管理器资源 ID。立即检索该 ID。

在 Azure 门户，导航到 IoT 中心。
从左侧菜单的“设置”下，选择“属性” 。
复制“资源 ID”的值。它应当采用 /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name> 格式。

部署指标收集器模块

将指标收集器模块部署到要监视的每台设备。该模块像其他所有模块那样在设备上运行，并监视其分配的终结点，以收集指标并将其发送到云。

按照以下步骤部署和配置收集器模块：

登录 Azure 门户并转到 IoT 中心。
在左侧菜单中，选择“设备管理”菜单下的“设备”。
从 IoT Edge 设备列表中选择目标设备的设备 ID，打开设备详细信息页面。
在上方的菜单栏上，选择“设置模块”，打开包含三步的模块部署页面。
从门户部署模块的第一步是声明设备上应该有哪些模块。如果使用的是在快速入门中创建的同一设备，则应该可以看到列出的“SimulatedTemperatureSensor”。如果未出现，请立即添加：
1. 选择“添加”，然后从下拉菜单中选择“市场模块” 。
2. 搜索并选择“SimulatedTemperatureSensor”。

添加和配置指标收集器模块：

选择“添加”，然后从下拉菜单中选择“市场模块” 。
搜索并选择“IoT Edge 指标收集器”。
从模块列表中选择指标收集器模块，打开其配置详细信息页面。
导航到“环境变量”选项卡。

请更新以下值：

名称	值
ResourceId	在上一部分检索到的 IoT 中心资源 ID。
UploadTarget	`AzureMonitor`
LogAnalyticsWorkspaceId	在上一部分检索到的 Log Analytics 工作区 ID。
LogAnalyticsSharedKey	在上一部分检索到的 Log Analytics 密钥。

删除“OtherConfig”环境变量，该变量是将来可能需要添加的额外配置选项的占位符。本教程并不需要。
选择“更新”以保存更改。

选择“下一步: 路由”继续进行部署模块的第二步。
门户会自动为指标收集器添加路由。如果将收集器模块配置为通过 IoT 中心发送指标，会用到此路由，但在本教程中，我们将指标直接发送到 Log Analytics，因此不需要它。删除“FromMetricsCollectorToUpstream”路由。
选择“查看 + 创建”继续部署模块的最后一步。
选择“创建”以完成部署。

完成模块部署后，返回到设备详细信息页面，可以在其中看到四个列为“在部署中指定”的模块。可能需要一些时间才能将所有四个模块都列为“由设备报告”，这意味着它们已成功启动并将其状态报告给 IoT 中心。刷新页面以查看最新状态。

监视设备运行状况

设备监视工作簿可能需要 15 分钟才可供查看。部署指标收集器模块后，该模块会开始将指标消息发送到 Log Analytics，并在该处整理到一个表中。你提供的 IoT 中心资源 ID 将引入的指标链接到它们所属的中心。因此，策展 IoT Edge 工作簿可使用资源 ID 查询指标表，从而检索指标。

Azure Monitor 为 IoT 提供了三个默认工作簿模板：

“车队视图”工作簿显示跨多个 IoT 资源的设备运行状况。该视图允许配置用于确定设备运行状况的阈值，并显示每个设备的主要指标聚合。
“设备详细信息”工作簿提供围绕三种类别的可视化效果：消息传递、模块和主机。消息视图可直观呈现设备的消息路由，并报告消息系统的整体运行状况。模块视图显示了设备上各个模块的运行情况。主机视图显示有关主机设备的信息，包括主机组件的版本信息和资源使用情况。
“警报”工作簿视图显示跨多个 IoT 资源的设备警报。

浏览队列视图和运行状况快照工作簿

队列视图工作簿会显示你的所有设备，并可以选择特定设备以查看其运行状况快照。使用以下步骤浏览工作簿可视化效果：

返回到 Azure 门户中的 IoT 中心页面。
向下滚动主菜单，找到“监视”部分，然后选择“工作簿” 。
选择“车队视图”工作簿。
你应该会看到运行指标收集器模块的设备。该设备列为“运行正常”或“运行不正常” 。
选择设备名称以查看设备的详细指标。
在任何时间图表上，使用 X 轴下方的箭头图标，或单击图表并拖动光标以更改时间范围。
关闭运行状况快照工作簿。从队列视图工作簿中选择“工作簿”，返回到工作簿库。

浏览设备详细信息工作簿

设备详细信息工作簿显示单个设备的性能详细信息。使用以下步骤浏览工作簿可视化效果：

从工作簿库中，选择“IoT Edge 设备详细信息”工作簿。
设备详细信息工作簿中显示的第一页是已选中“路由”选项卡的“消息”视图。

在左侧，表中会显示设备上的路由（按终结点整理）。对于我们的设备，我们会看到“上游终结点”（用于指代路由到 IoT 中心的特殊术语）正在接收来自模拟温度传感器模块的“temperatureOutput”输出的消息。

在右侧，图形中会随时间跟踪连接的客户端数量。可以单击并拖动图形以更改时间范围。
选择“图形”选项卡以查看路由的不同可视化效果。在图形页上，可以拖放不同的终结点来重新排列图形。要直观呈现的路由很多时，此功能非常有用。
“运行状况”选项卡会报告消息传递的任何问题，例如删除的消息或断开连接的客户端。
选择“模块”视图以查看部署在设备上的所有模块的状态。可以选择每个模块，详细了解它们使用的 CPU 和内存量。
选择“主机”视图以查看有关主机设备的信息，包括其操作系统、IoT Edge 守护程序版本和资源使用情况。