预配置的解决方案入门

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

本教程演示如何预配远程监视预配置解决方案。 此外还将逐步讲解预配置解决方案的基本功能。 可以从部署为预配置解决方案的一部分的解决方案 仪表板 访问其中许多功能:

Remote monitoring preconfigured solution dashboard

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

注意

如果没有帐户,只需花费几分钟就能创建一个免费试用帐户。 有关详细信息,请参阅 Azure 免费试用

预配解决方案

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

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

等待预配过程完成

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

注意

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

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

方案概述

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

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

此方案的一大功能是,用户可以从解决方案仪表板远程执行所有这些操作。 不需对设备进行物理访问。

查看解决方案仪表板

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

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

    Launch the preconfigured solution

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

    Remote monitoring preconfigured solution dashboard

仪表板会显示以下信息:

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

查看警报

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

TODO Alarm history on the solution dashboard

注意

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

查看设备

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

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

    View the device list in the solution portal

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

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

    View the device details in the solution portal

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

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

筛选设备列表

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

  1. 选择“打开保存的筛选器”以显示可用筛选器的列表。 然后选择“不正常设备”应用该筛选器:

    Display the list of filters

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

    View the filtered device list showing unhealthy devices

更新所需属性

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

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

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

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

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

  4. 选择“计划”

    Change the TelemetryInterval property to five seconds

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

注意

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

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

调用方法

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

View the reported firmware version for the unhealthy devices

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

  1. 选择“打开保存的筛选器”以显示可用筛选器的列表。 然后选择“旧固件设备”应用该筛选器:

    Display the list of filters

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

    View the filtered device list showing old devices

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

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

  5. 选择 InitiateFirmwareUpdate 作为方法

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

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

    Create job to update the firmware of the selected devices

注意

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

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

Job list showing the firmware update list running Device list showing firmware update status Job list showing the firmware update list complete

注意

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

方案审核

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

Filter showing that all devices have up-to-date firmware

Filter showing that all devices are healthy

其他功能

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

自定义列

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

Column editor ion the device list

自定义设备图标

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

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

    Open device image editor

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

    Edit device image editor

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

注意

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

添加设备

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

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

  1. 导航回到设备列表。

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

    Add a device to the preconfigured solution

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

    Set new device details in dashboard

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

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

  5. 选择“创建”。

    Save a new device

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

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

    View new device in device list

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

    View telemetry from new device

禁用并删除设备

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

Disable and remove a device

添加规则

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

  1. 导航回到设备列表。

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

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

    Add a device rule

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

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

    Add a device rule

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

    Add a device rule

  7. 导航回仪表板。 一小段时间之后,会在新设备所报告的温度超过 47 度阈值时,在“警报历史记录”窗格中看到新的条目:

    Add a device rule

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

    List device rules

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

    List device actions

注意

可以定义一些这样的操作:发送电子邮件或短信以响应规则,或通过逻辑应用与业务线系统集成。 有关详细信息,请参阅将逻辑应用连接到 Azure IoT 套件远程监视预配置解决方案

管理筛选器

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

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

    Open the filter editor

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

    Create a filter

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

    Filtered list

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

    Save a filter

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

    Open a filter

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

注意

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

命令

通过“设备详细信息”面板可向设备发送命令。 设备在第一次启动时,会向解决方案发送其支持的命令的相关信息。 如需命令和方法之间差异的讨论,请参阅 Azure IoT 中心云到设备选项

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

    Device commands in dashboard

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

  3. 选择“发送命令”

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

    Command status in dashboard

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

幕后

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

Preconfigured solution in the Azure portal

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

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

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

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

注意

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

后续步骤

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