IoT Hub

注解

标有“（预览）”的功能为可供试用和评估的可选功能，不建议用于商业用途。如果您对预览功能感兴趣，请联系您的销售代表。


在 EnOS 2.3 中，我们为连接与资产管理服务、告警管理和设备集成服务添加了新功能。详细信息如下。

连接与资产管理服务

设备接入

  • 基于证书的双向认证的设备接入：新增了能使用 HTTP SDK 连接到 EnOS 的功能。


  • 新增了设备接入功能（预览），一套协议网关的接入方式以实现从第三方设备协议到 EnOS IoT 标准协议的双向转换，支持用户通过非 EnOS IoT 协议访问 EnOS 云平台。 用户可以自定义编解码过程将第三方协议数据转换为 EnOS IoT 标准协议并接入 EnOS，可在 IoT Hub 中进行动态建模和资产管理。


    更多信息，参见 设备接入。

设备管理

  • 新增了能将模型，产品和设备共享或迁移到另一个 OU 的功能。

  • 为模型要素的描述新增了对多语言的支持。

  • 在创建模型里新增了模型校验开关，缺省为开，在模型定义比较复杂或数据量较大的情况可选择关闭它，以减少对性能的影响。

  • 在创建产品时新增了 协议网关 的选项。如果选择 仅支持 EnOS IoT 为 接入方式 则自动分配 EnOS 中使用的默认 EnOS IoT 协议网关，且该选项不会出现。如果选择 支持 EnOS IoT 和自定义 为 接入方式 则可选择 禁用 或 启用。


    若启用，可从下拉列表中选择协议网关。所显示的协议网关是在 设备接入 > 协议网关 中 私有网关 里的协议网关，该网关可以从空白创建，也可基于 公有网关 中的模板创建。更多信息，参见 协议网关。若禁用，则需要在该产品上创建一个自定义的数据解析脚本，用于编解码上下行的数据。


  • 在 系统管理 > 证书管理 页面新增了 OU ID 和 更多信息 两个列，以便用户查看证书的对应设备。更多信息，参见 创建证书签名申请（CSR）。


    ../_images/csr_code.png

设备监控

  • 新增了两个功能：连接拓扑 和 在线调试。

    • 连接拓扑: Edge 能通过 MQTT 协议上报设备的连接拓扑结构与状态，在 EnOS 管理控制台 中提供设备和 Edge 的连接拓扑的详细信息，方便 OU 运维人员查看具体接入的中断情况和定位到具体设备中断的位置。

      ../_images/connection_topo_page.png


    • 在线调试: 根据模型中配置的功能定义，调试 IoT Hub 中的注册设备，以快速定位问题或促进应用程序开发。不同状态的设备可使用不同的调试功能。

      • 上报属性: 模拟从设备到云的设备属性上报。
      • 上报测点: 模拟从设备到云的设备测点值上报。
      • 上报事件: 模拟从设备到云的设备事件上报。
      • 获取测点: 获取设备的测点值。
      • 设置测点: 从云到设备发送命令设置测点值。
      • 调用服务: 从云到设备发送命令调用服务。


      更多信息，参见 在线调试。


  • 新增了在查看设备的通信状态时，可查看设备通信状态的完整描述功能。


    ../_images/device_network_stats_desc.png

告警管理

  • 按照模型和测点或事件搜索告警规则，或按规则的触发器类型过滤告警规则列表。

    ../_images/alert_rule_search.gif


  • 为新版告警记录页面新增了按时间搜索告警记录的功能。

  • 新增了配置告警源的功能，以便定义第三方系统数据的来源以及处理数据的方法，以映射到在创建告警规则时做为触发器的所需指标。

  • 为新版告警规则添加了新功能。

    • 新增了规则名称，支持国际化。

    • 可以选择多个资产指标作为触发条件的触发器，并且互相做对比。

    • 支持来自 EnOS IoT Hub 和第三方系统的指标作为触发器。

    • 除 滚动窗口 外，现可在设置时序告警时选择 滑动窗口。更多信息，参见 时间窗口。

    • 在创建告警规则时，可以设置包含所选模型的属性值的自定义标签，携带到告警记录中，便于应用侧根据属性值做聚合或条件筛选等。

    • 在创建告警规则时，为告警规则范围新增了更多选项。更多信息，参见 创建告警规则。

    • 为创建告警规则里的 时序 新增了更多聚合函数，以便在创建告警规则时满足更多场景。更多信息，参见 时序函数。


      ../_images/alert_aggregation_functions.png


    • 新增了能够使用表达式来指定告警条件的选项。


      ../_images/alert_use_expression.gif

设备集成服务

  • 新增了新导出功能，为编排好的集成流，导出成可在站端执行的应用程序启动器。更多信息，参见 导出为可执行的应用程序启动器。

  • 添加了流日志的搜索字段，在其中输入关键字过滤搜索结果。如果在集成流首个节点的输入 msg 中有该关键字，则搜索结果将返回相关日志。更多信息，参见 集成流日志。

  • 新增了连接配置功能，可以在其中配置 MySQL 连接等数据源以供使用。例如，可以通过 Database 节点使用成功配置的 MySQL 连接更新数据库数据。更多信息，参见 连接配置。

  • 新增了具有现成设计流的集成模板，也可以在创建集成流程时将其用作模板。用户还可以将创建的集成流导出为模板，以供将来参考和使用。集成模板分为三种类型。

    • 公有模板：公有模板是由系统创建的集成模板。所有 OU 下的用户都可以访问公有模板，但不能对其进行编辑或删除。
    • 企业模板：企业模板是由 OU 管理员创建并可编辑或删除的集成模板。该模板的 OU 下的所有用户都可以访问企业模板，但不能编辑或删除。
    • 私有模板：用户创建的模板是由用户从已创建的集成流导出成的集成模板。该模板的 OU 下的所有用户都可以访问以及编辑和删除私有模板。


    ../_images/dis_templates.png


  • 新增了 站端集成，用于远程部署和监控站端集成流的功能。用户可在云端设计集成流，并将其导出为 JAR 文件以供本地站端部署。部署成功并运行后，站端集成流将与云端建立连接并发送其状态（在线/离线），用户可在云端远程查看其状态、更新集成流的处理逻辑和发送指令以触发站端集成。

  • 新增了 代理配置，用于配置代理服务器的功能，配置后可在 MQTT Sub 和 MQTT Pub 节点中重复使用。更多信息，参见 代理配置。

节点

  • Action 节点: 新增保留输入 msg 到 metadata 的功能，你可以选择在执行组件前将当前 msg 中的部分内容或者全部内容保存到 metadata，不被覆盖。

  • 新增上传以根据需求设计并创建的自定义节点到 流设计器 里的功能，在创建集成流中使用。更多信息，参见 自定义节点。

  • 在节点的输入和输出日志中添加了 metadata 信息。更多信息，参见 节点日志。


    ../_images/log_node_input.png


  • 增强调试功能以在每个节点的右上角显示节点的状态：绿色图标代表节点操作正常，红色图标代表节点操作出现错误。

    ../_images/dis_log_node_status.png

当前节点

节点 新增功能
Azure Blob 支持文件名通配符。
CSV 新增 测试 标签，以在其中上传 CSV 文件查看其输出示例。
HTTP Client 新增 保持 Cookie 会话管理开关选项。
Kafka Sub 新增 匿名 鉴权选项。
Refresh Token 新增 使用 Cookie 会话管理开关选项。
Script

新增内置的 JavaScript 函数，可以在 Script 标签中使用。

../_images/script_builtin_js.png
SFTP Client
  • 新增新 操作 项目 获取文件列表，以 JSON 数组的形式列出指定路径下的文件，并将其传递给下游节点进行处理。
  • 新增使用 密钥文件 的 登录类型。

新增节点

节点类型: Subflow
节点 描述
Subflow 一个可添加到其他集成流的集成流。


节点类型：Input
节点 描述
AMQP Sub 使用户订阅 AMQP 的消息队列。
Inject 使手动或定时输入自定义 msg 触发流，用于调试和功能扩展。


节点类型：Logic
节点 描述
Loop 流中循环次数的开始，需要 Loop End 配套使用。
Loop End 流中循环次数的结束，需要 Loop 配套使用。
Combine 将数据合并成数组。
Comment 一个独立节点，为集成流添加注释信息。
Catch 存储节点抛出的异常以进行后续处理。


节点类型：Action
节点 描述
Read Context 读取由 Store Context 节点存储在指定范围内的键值对数据，并在 metedata 或输出 msg 中输出。
XML 将 XML 文件里的数据转换为 JSON 格式。
File 从文件中读取数据并输出到 msg，将 msg 中的数据写入文件，或者删除文件。
Store Context 在指定的范围内存储指定的键值对数据，供 Read Context 节点检索。
HTTP Response 发送回从 HTTP Server 节点接收到的请求的响应。


节点类型：IoT Hub
节点 描述
Lookup Mapping 根据映射文件，查找映射关系，并将指定的映射数据作为输出到 msg。
Template 使用输入 msg 中的数据填充模板，并将填充的模板作为输出 msg。目前提供两种预置模板格式：测点和指令。


节点类型：External
节点 描述
AMQP Pub 根据 topic 和路由键将信息推送到消息队列。
Azure Event Hub 对接 Azure 事件中心并从其获取数据。
Email 发送电子邮件给指定的收件人。
AWS S3 建立与 AWS S3 的连接，以便进行 CSV 文件下载。
Kafka Pub 建立一个 Kafka 客户端，将信息推送到第三方 Kafka 服务器。
SMS 发送短信给指定的手机号。
Twilio SMS 通过 Twilio 将输入 msg 发送为短信。
Azure IoT Hub 将输入 msg 发送到 Azure IoT Hub。


节点类型：Enterprise
节点 描述
YBSoftware eDOS 通过 SDK 或者 web serivce 模式根据标签名称从 eDOS 数据库中获取设备的采集数据，输出至 msg。
Database 根据所选操作和数据更新所选数据库。


节点类型：System
节点 描述
Checkpoint 当向云端发送数据失败时，支持发送缓存。
Remote Task 接收来自云端触发的指令，进行处理下游节点。