开始使用预配置的解决方案

Azure IoT 套件 预配置解决方案 结合了多个 Azure IoT 服务,以提供实现常见 IoT 业务方案的端到端解决方案。 远程监视预配置解决方案连接到并监视您的设备。 您可以使用解决方案来分析来自设备的数据流,并通过使流程自动响应该数据流来改善业务成果。

本教程介绍如何预配远程监视预配置解决方案。 它还将逐步指导你了解预配置解决方案的基本功能。 可以从作为预配置解决方案的一部分部署的解决方案 仪表板 访问其中的许多功能:

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

若要完成本教程,需要一个有效的 Azure 订阅。

注释

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

部署解决方案

如果尚未在帐户中预配远程监视预配置解决方案:

  1. 使用 Azure 帐户凭据登录到 azureiotsuite.com,然后单击 + 创建解决方案。
  2. 远程监视 磁贴上单击 选择
  3. 输入 解决方案名称 用于您的远程监测预先配置解决方案。
  4. 选择要用于配置解决方案的 区域订阅
  5. 单击 创建解决方案 开始预配过程。 此过程通常需要几分钟才能完成。

等待预配过程完成

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

注释

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

有没有哪些你期望在解决方案中看到但未列出的详细信息? 请向我们提供有关 User Voice平台的功能建议。

场景概述

当您部署远程监控预配置解决方案时,它会自动包含资源,以便您能够逐步体验常见的远程监控场景。 在此方案中,连接到解决方案的多个设备报告意外的温度值。 以下部分介绍如何:

  • 确定发送意外温度值的设备。
  • 配置这些设备以发送更详细的遥测数据。
  • 通过更新这些设备上的固件来解决此问题。
  • 验证您的操作是否已解决问题。

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

查看解决方案仪表板

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

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

    启动预配置解决方案

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

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

仪表板显示以下信息:

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

查看警报

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

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

注释

这些警报由预配置解决方案中包含的规则生成。 当设备发送的温度值超过 60 时,此规则将生成警报。 可以通过在左侧菜单中选择 “规则”“动作” 来定义自己的规则和动作。

查看设备

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

  1. 选择 “设备” 以显示此解决方案的设备列表。

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

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

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

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

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

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

筛选设备列表

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

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

    显示筛选器列表

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

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

更新所需属性

现已确定可能需要整改的一组设备。 但是,你决定 15 秒的数据频率不足以明确诊断问题。 将遥测频率更改为 5 秒,以提供更多数据点,以便更好地诊断问题。 可以从解决方案门户将此配置更改推送到远程设备。 可以进行一次更改,评估影响,然后对结果采取行动。

请按照以下步骤运行作业,以更改受影响设备的 TelemetryInterval 所需属性。 当设备收到新的 TelemetryInterval 属性值时,会更改其配置,每 5 秒发送遥测数据,而不是每 15 秒发送一次:

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

  2. 将作业命名为 更改遥测间隔

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

  4. 选择 “计划”。

    将 TelemetryInterval 属性更改为 5 秒

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

注释

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

此作业为筛选器选择的所有设备在设备孪生中设置TelemetryInterval期望属性的值。 设备从设备孪生中检索此值并更新其行为。 当设备从设备孪生检索和处理所需属性时,它将设置相应的报告值属性。

调用方法

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

查看不健康设备的已报告固件版本

此固件版本可能是意外温度值的根本原因,因为你知道其他正常运行的设备最近已更新到版本 2.0。 可以使用内置的 旧固件设备 筛选器来标识具有旧固件版本的任何设备。 然后,可以从门户远程更新仍在运行旧固件版本的所有设备:

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

    显示筛选器列表

  2. 设备列表现在仅显示具有旧固件版本的设备。 此列表包括 由“不正常设备 ”筛选器标识的五台设备和三个附加设备:

    查看显示旧设备的筛选设备列表

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

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

  5. 选择 InitiateFirmwareUpdate 作为 方法

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

  7. 选择 “计划”。 默认为立即运行任务。

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

注释

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

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

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

注释

在生产环境中,可以调度作业在指定的维护时段内运行。

情景审查

在此方案中,你使用仪表板和筛选器上的警报历史记录发现了某些远程设备的潜在问题。 然后,你使用了筛选器和作业来远程配置设备,以提供更多信息来帮助诊断问题。 最后,你使用了筛选器和作业来计划受影响设备上的维护。 如果返回到仪表板,可以检查解决方案中的设备是否不再出现任何警报。 可以使用筛选器验证固件是否为所有设备的 up-to版本,并确认没有未正常运行的设备。

筛选器显示所有设备都具有版本日期为up-to的固件

显示所有设备都正常运行的筛选器

其他功能

以下部分介绍远程监视预配置解决方案的一些附加功能,这些功能未描述为上一方案的一部分。

自定义列

可以通过选择 “列编辑器”来自定义设备列表中显示的信息。 可以添加和删除显示报告属性和标记值的列。 还可以对列进行重新排序和重命名:

列编辑器在设备列表中

自定义设备图标

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

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

    打开设备映像编辑器

  2. 上传新映像或使用现有映像之一,然后选择“ 保存

    编辑设备图像编辑器

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

注释

映像存储在 Blob 存储中。 设备孪生中的标签包含 Blob 存储中图像的链接。

添加设备

部署预配置解决方案时,会自动预配可在设备列表中查看的 25 个示例设备。 这些设备是在 Azure WebJob 中运行的 模拟设备 。 借助模拟设备,无需部署真实物理设备,即可轻松试验预配置解决方案。 如果要将实际设备连接到解决方案,请参阅将 设备连接到远程监视预配置解决方案 教程。

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

  1. 导航回设备列表。

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

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

  3. “模拟设备”磁贴上选择“添加新”。

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

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

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

  5. 选择创建

    保存新设备

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

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

    在设备列表中查看新设备

  8. 还可以在仪表板上查看新设备上的模拟遥测数据:

    查看来自新设备的遥测数据

禁用和删除设备

可以禁用设备,禁用设备后,可以将其删除:

禁用和删除设备

添加规则

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

  1. 导航回设备列表。

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

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

    添加设备规则

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

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

    添加设备规则

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

    添加设备规则

  7. 返回控制面板。 短时间后,当新设备报告的温度超过 47 度阈值时,你将在 “警报历史记录 ”窗格中看到一个新条目:

    添加设备规则

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

    列出设备规则

  9. 可以在仪表板的“操作”页面上查看和编辑所有可执行的操作,以响应规则。

    列出设备操作

注释

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

管理筛选器

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

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

    打开筛选器编辑器

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

    创建筛选器

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

    筛选的列表

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

    保存筛选器

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

    打开筛选器

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

注释

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

指令

“设备详细信息 ”面板中,可以将命令发送到设备。 设备首次启动时,它会向解决方案发送有关它支持的命令的信息。 有关命令和方法之间的差异的讨论,请参阅 Azure IoT 中心云到设备选项

  1. 在所选设备的“设备详细信息”面板中选择命令

    仪表板中的设备命令

  2. 从命令列表中选择 PingDevice

  3. 选择 “发送”命令

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

    仪表板中的命令状态

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

幕后花絮

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

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

可以通过在资源组中的资源列表中选择每个资源的设置来查看该设置。

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

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

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

注释

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

后续步骤

现在,你已部署了一个工作预配置解决方案,接下来可以阅读以下文章,继续开始使用 IoT 套件: