预配置的解决方案入门

Azure IoT 套件 预配置解决方案 结合了多项 Azure IoT 服务,以提供可实现常见 IoT 商业应用场景的端到端解决方案。 远程监控预配置解决方案会连接并监视设备。 可使用解决方案分析设备发出的数据流,并让进程自动响应该数据流来提升业务绩效。

本教程演示如何预配远程监控预配置解决方案。 此外,还逐步讲解了预配置解决方案的基本功能。 可通过随预配置解决方案一起部署的解决方案 仪表板 来访问其中的多项功能:

远程监控预配置解决方案仪表板

需要有效的 Azure 订阅才能完成此教程。

Note

如果没有帐户,可以创建一个试用帐户,只需几分钟即可完成。 有关详细信息,请参阅 Trial(试用)。

预配解决方案

如果尚未在帐户中预配远程监控预配置解决方案,请执行以下步骤:

  1. 使用 Azure 帐户凭据登录到 azureiotsuite.cn,并单击“+”创建解决方案。
  2. 单击“远程监控”磁贴上的“选择”。
  3. 为远程监控预配置解决方案输入 解决方案名称
  4. 选择要用于预配解决方案的“区域”和“订阅”。
  5. 单击“创建解决方案” 开始预配过程。 运行此过程通常需要花费几分钟时间。

等待预配过程完成

  1. 单击状态为“正在预配”的解决方案磁贴。
  2. 在 Azure 订阅中部署 Azure 服务时,请注意“预配状态” 。
  3. 预配完成后,状态会更改为“就绪” 。
  4. 单击磁贴,右窗格中随即会显示解决方案的详细信息。

Note

如果在部署预配置解决方案时遇到问题,请参阅 azureiotsuite.cn 站点权限常见问题解答。 如果问题仍然存在,请在 门户中创建服务票证。

是否有你预期会看到但没有列出的解决方案详细信息? 请在 用户之声中向我们提供功能建议。

方案概述

部署远程监控预配置解决方案时,可以通过预先填充在其中的资源来逐步执行常见的远程监控方案。 在本方案中,数个连接到解决方案的设备会报告意外的温度值。 以下部分介绍如何:

  • 标识发送意外温度值的设备。
  • 将这些设备配置为发送更详细的遥测。
  • 通过更新这些设备上的固件来解决问题。
  • 验证自己的操作是否已解决问题。

此方案的关键特点是可以从解决方案仪表板远程执行所有这些操作。 不需对设备进行物理访问。

查看解决方案仪表板

该解决方案仪表板可让你管理部署的解决方案。 例如,可以查看遥测数据、添加设备以及配置规则。

  1. 当预配完成且预配置解决方案的磁贴指示“就绪”时,请选择“启动”,在新的选项卡中打开远程监控解决方案门户。

    启动预配置解决方案

  2. 默认情况下,此解决方案门户会显示 仪表板。 可以通过页面左侧的菜单导航到解决方案门户中的其他区域。

    远程监控预配置解决方案仪表板

仪表板显示以下信息:

  • 显示每个设备连接到解决方案的位置的地图。 第一次运行解决方案时有 25 个模拟设备。
  • 一个“遥测历史记录”面板,用于从所选的设备绘制近实时的湿度和温度遥测数据,并显示聚合数据,例如最大、最小和平均湿度。
  • 一个“警报历史记录”面板,用于在遥测值超过阈值时显示最近的警报事件。 除了预配置解决方案所创建的示例之外,还可以定义自己的警报。
  • 一个“作业”面板,用于显示有关计划作业的信息。 可在“管理作业”页上计划自己的作业。

查看警报

警报历史记录面板显示,五个设备报告的遥测值高于预期。

TODO:解决方案仪表板上的警报历史记录

Note

这些警报是通过预配置解决方案中包含的规则生成的。 当设备发送的温度值超过 60 时,该规则会生成警报。 用户可以通过在左侧菜单中选择规则操作,定义自己的规则和操作。

查看设备

“设备”列表显示解决方案中所有已注册的设备。 在设备列表中,可以查看和编辑设备元数据、添加或删除设备,以及在设备上调用方法。 可对设备列表中的一系列设备进行筛选和排序。 还可以自定义设备列表中显示的列。

  1. 选择“设备”即可显示该解决方案的设备列表。

    在解决方案门户中查看设备列表

  2. 设备列表最初显示预配过程创建的 25 个模拟设备。 可向解决方案添加更多的模拟设备和物理设备。

  3. 若要查看设备详细信息,请在设备列表中选择一个设备。

    在解决方案门户中查看设备详细信息

“设备详细信息”面板包含六个部分:

  • 这是一系列的链接,可让你自定义设备图标、禁用设备、添加规则、调用方法或者发送命令。 有关命令(设备到云的消息)和方法(直接方法)的比较,请参阅云到设备的通信指南
  • 在“设备孪生 - 标记”部分中可以编辑设备的标记值。 可在设备列表中显示标记值,并使用标记值来筛选设备列表。
  • 在“设备孪生 - 所需属性”部分中可以设置要发送到设备的属性值。
  • “设备孪生 - 报告的属性”部分显示设备发送的属性值。
  • “设备属性”部分显示标识注册表中的信息,例如设备 ID 和身份验证密钥。
  • “最近的作业”部分显示有关最近针对此设备执行的任何作业的信息。

筛选设备列表

若只需显示那些发送意外温度值的设备,可以使用筛选器。 远程监控预配置解决方案包含一个“不正常设备”筛选器,用于显示平均温度值超过 60 的设备。 用户还可以创建自己的筛选器

  1. 选择“打开保存的筛选器”以显示可用筛选器的列表。 然后选择 Unhealthy devices 应用筛选器:

    显示筛选器列表

  2. 设备列表现在仅显示平均温度值超过 60 的设备。

    查看显示不正常设备的已筛选设备列表

更新所需属性

现已确定一组可能需要修复的设备。 不过,用户认为 15 秒的数据频率不足以对问题进行明确诊断。 将遥测频率更改为 5 秒可以提供更多的数据点,从而对问题进行更好的诊断。 可以将该配置更改从解决方案门户推送到远程设备。 进行更改后,即可评估影响,并处理结果。

执行以下步骤来运行一个作业,以便更改受影响设备的 TelemetryInterval 所需属性。 收到新的 TelemetryInterval 属性值以后,设备会更改其配置,每隔 5 秒而非 15 秒发送一次遥测:

  1. 在设备列表中显示不正常设备的列表以后,请选择“作业计划程序”,并选择“编辑设备孪生”。

  2. 调用作业“更改遥测时间间隔”。

  3. 所需属性名称 desired.Config.TelemetryInterval 的值更改为 5 秒。

  4. 选择“计划”。

    将 TelemetryInterval 属性更改为 5 秒

  5. 可在门户的“管理作业”页中监视作业进度。

Note

若要更改单个设备的所需属性值,请使用“设备详细信息”面板中的“所需属性”部分,而不要运行一项作业。

此作业在设备孪生中针对筛选器选择的所有设备设置 TelemetryInterval 所需属性值。 这些设备从设备孪生中检索此值,并更新自身的行为。 从设备孪生检索并处理所需属性以后,设备就会设置相应的报告值属性。

调用方法

当作业运行时,用户在不正常设备的列表中注意到,所有这些设备的固件版本都是旧的(低于 1.6 版)。

查看不正常设备的报告固件版本

此固件版本可能是温度值不正常的根本原因,因为已确定其他正常设备最近更新到了 2.0 版。 用户可以使用内置的“旧固件设备”筛选器确定固件版本过旧的设备, 然后在门户中远程更新仍运行旧版固件的所有设备:

  1. 选择“打开保存的筛选器”以显示可用筛选器的列表。 然后选择 Old firmware devices 应用筛选器:

    显示筛选器列表

  2. 设备列表现在仅显示使用旧固件版本的设备。 此列表包含 5 个通过“不正常设备”筛选器识别的设备,以及 3 个其他设备:

    查看显示不正常设备的筛选设备列表

  3. 选择“作业计划程序”,并选择“调用方法”。

  4. 将“作业名称”设置为“固件更新到版本 2.0”。

  5. 选择 InitiateFirmwareUpdate 作为方法

  6. FwPackageUri 参数设置为 https://iotrmassets.blob.core.windows.net/firmwares/FW20.bin

  7. 选择“计划”。 默认设置是让作业立即运行。

    创建作业用于更新所选设备的固件

Note

若要调用单个设备上的方法,请在“设备详细信息”面板中选择“方法”,而不要运行一个作业。

该作业在所有通过筛选器选择的设备上调用 InitiateFirmwareUpdate 直接方法。 设备会即时响应 IoT 中心,并异步启动固件更新过程。 设备通过报告的属性值提供有关固件更新过程的状态信息,如以下屏幕截图所示。 选择“刷新”图标更新设备和作业列表中的信息:

显示固件更新列表正在运行的作业列表 显示固件更新状态的设备列表 显示固件更新列表已完成的作业列表

Note

在生产环境中,可以将作业计划为在指定的维护时段运行。

方案评审

在此方案中,用户使用仪表板上的警报历史记录和筛选器确定了某些远程设备的一个潜在问题, 然后使用筛选器和作业对设备进行了远程配置,使其能够提供有助于诊断问题的详细信息。 最后,用户通过筛选器和作业在受影响设备上对维护进行了计划。 返回到仪表板后,可以检查解决方案中的设备是否不再发出任何警报。 可以使用筛选器来验证解决方案中的所有设备上的固件是否为最新,以及是否没有其他不正常的设备:

显示所有设备的固件均为最新的筛选器

显示所有设备均正常的筛选器

其他功能

以下部分介绍了远程监控预配置解决方案的其他一些功能,这些功能未在前面的方案中介绍。

自定义列

选择“列编辑器”可自定义设备列表中显示的信息。 可以添加和删除用于显示报告的属性和标记值的列。 此外,可以将列重新排序和重命名:

设备列表中的列编辑器图标

自定义设备图标

可按如下所述,通过“设备详细信息”面板自定义设备列表中显示的设备图标:

  1. 选择铅笔图标打开设备的“编辑图像”面板:

    打开设备图像编辑器

  2. 上传新图像或使用现有的某个图像,并选择“保存”:

    编辑设备图像编辑器

  3. 选择的图像随即显示在设备的“图标”列中。

Note

该图像将存储在 Blob 存储中。 设备孪生中的标记包含 Blob 存储中的图像的链接。

添加设备

部署预配置解决方案时,会自动预配在设备列表中可见的 25 个示例设备。 这些设备是在 Azure Web 作业中运行的 模拟设备 。 模拟设备可让你试验预配置解决方案,而不需要部署实际的物理设备。 要将实际设备连接到解决方案,请参阅 将设备连接到远程监控预配置解决方案 教程。

以下步骤说明了如何向解决方案添加模拟设备:

  1. 导航回到设备列表。

  2. 若要添加设备,请选择左下角的“+ 添加设备”。

    将设备添加到预配置解决方案

  3. 选择“模拟设备”磁贴上的“新增”。

    在仪表板中设置新设备详细信息

    如果选择创建“自定义设备”,则除了创建新的模拟设备,也可以添加物理设备。 要深入了解如何将物理设备连接到解决方案,请参阅将设备连接到 IoT 套件远程监控预配置解决方案

  4. 选择“自行定义设备 ID”,并输入唯一的设备 ID 名称,例如 mydevice_01

  5. 选择“创建”。

    保存新设备

  6. 在“添加模拟设备”的步骤 3 中,选择“完成”回到设备列表。

  7. 可以在设备列表中查看“正在运行”的设备。

    查看设备列表中的新设备

  8. 也可以在仪表板上查看来自新设备的模拟遥测:

    查看新设备发出的遥测数据

禁用和删除设备

可以禁用设备,并且在已禁用之后删除:

禁用并删除设备

添加规则

刚才添加的新设备没有规则。 在本节中,将添加一个规则,以便在新设备所报告的温度超过 47 度时触发警报。 在开始之前,请注意仪表板上新设备的遥测历史记录显示设备温度绝不会超过 45 度。

  1. 导航回到设备列表。

  2. 要添加设备规则,请在“设备列表”中选择新设备,并选择“添加规则”。

  3. 创建一个规则,该规则使用“温度”作为数据字段,使用“AlarmTemp”作为温度超过 47 度时的输出:

    添加设备规则

  4. 若要保存更改,请选择“保存并查看规则”。

  5. 选择新设备的设备详细信息窗格中的“命令”。

    添加设备规则

  6. 从命令列表中选择“ChangeSetPointTemp”并将“SetPointTemp”设置为 45。 然后选择 Send Command:

    添加设备规则

  7. 导航回仪表板。 片刻之后,当新设备报告的温度超过 47 度阙值时,“警报历史记录” 窗格中会显示新条目:

    添加设备规则

  8. 可以在仪表板的“规则”页上查看和编辑所有规则:

    列出设备规则

  9. 可以在仪表板的“操作”页上查看和编辑为了响应规则而可采取的所有操作:

    列出设备操作

管理筛选器

在设备列表中,可以创建、保存和重新加载筛选器,以显示与中心连接的设备的自定义列表。 若要创建筛选器,请执行以下操作:

  1. 选择设备列表上面的“编辑筛选器”图标:

    打开筛选器编辑器

  2. 在“筛选器编辑器”中添加字段、运算符和值,用于筛选设备列表。 可以添加多个子句来细化筛选器。 选择“筛选器”应用该筛选器:

    创建筛选器

  3. 在此示例中,已按制造商和型号筛选列表:

    筛选的列表

  4. 若要使用自定义名称保存筛选器,请选择“另存为”图标:

    保存筛选器

  5. 若要重新应用以前保存的筛选器,请选择“打开已保存的筛选器”图标:

    打开筛选器

可以基于设备 ID、设备状态、所需的属性、报告的属性和标记创建筛选器。 可以在“设备详细信息”面板的“标记”部分向设备添加自己的自定义标记,也可以运行一个作业,更新多个设备上的标记。

Note

在“筛选器编辑器”中,可以使用“高级视图”直接编辑查询文本。

命令

可以通过“设备详细信息”面板向设备发送命令。 设备在第一次启动时,会向解决方案发送其支持的命令的相关信息。 有关命令和方法之间的差异介绍,请参阅 Azure IoT Hub cloud-to-device options(Azure IoT 中心云到设备的通信选项)。

  1. 在所选设备的“设备详细信息”窗格中选择“命令”:

    仪表板中的设备命令

  2. 从命令列表中选择“PingDevice”。

  3. 选择“筛选器”应用该筛选器: (试用)。

  4. 可以在命令历史记录中查看命令的状态。

    仪表板中的命令状态

解决方案会跟踪其发送的每个命令的状态。 结果最初为“挂起”。 当设备报告它已执行命令时,结果会设置为“成功”。

幕后

部署预配置解决方案时,部署过程会在选择的 Azure 订阅中创建多个资源。 可以在 Azure 门户中查看这些资源。 部署过程会创建一个 资源组,其名称基于为预配置解决方案选择的名称:

Azure 门户中的预配置解决方案

可以查看每个资源的设置,方法是在资源组中的资源列表中选择该资源。

也可以查看预配置解决方案的源代码。 远程监控预配置解决方案源代码位于 azure-iot-remote-monitoring GitHub 存储库中:

  • DeviceAdministration 文件夹包含仪表板的源代码。
  • Simulator 文件夹包含模拟设备的源代码。
  • EventProcessor 文件夹包含后端进程的源代码,可用于处理传入遥测。

完成后,可在 azureiotsuite.cn 站点的 Azure 订阅中删除预配置解决方案。 通过该站点,可轻松删除创建预配置解决方案时预配的所有资源。

Note

若要确保删除与预配置解决方案相关的所有内容,请在 azureiotsuite.cn 站点中删除这些内容,而不是删除门户中的资源组。

后续步骤

部署正常工作的预配置解决方案后,可以继续通过阅读以下文章开始使用 IoT 套件: