路由规则概览¶
路由规则功能为 EnOS 标准设备数据和自定义设备数据提供了灵活的访问和处理方法，如聚合计算等。用户能创建自定义路由规则，而该规则可过滤和转换来自 IoT 设备和相关资产数据的传入消息，并触发各种操作，如发送关联的通知、命令或与外部系统进行数据通信。
以下是一些可以通过路由规则实现的常见用例：
- 在保存到数据库之前，对传入的遥测或属性进行数据验证和修改。
- 将遥测数据或属性从设备复制到相关资产，以便聚合遥测数据。例如，来自多个设备的数据可以在相关资产中聚合。
- 基于设备生命周期事件触发操作。例如，设备在线/离线时创建告警。
- 触发对外部系统的 REST API 调用。
- 当发生复杂事件时发送电子邮件，并在电子邮件模板内引用其他实体的属性。
- 与外部如 Kafka、Spark、AZ 服务等集成。
关键概念¶
规则¶
规则是可以使用规则节点设计和构建以处理传入消息的路由规则。事件触发的规则必须以 Rule Entry 节点开始，定时触发的规则必须以 Scheduler 节点开始。
系统提供了一个仅能查看，不能编辑或删除的 EnOS_default 规则。该规则提供以下功能：
- 标准数据路由时，作为系统的默认规则。
- 创建的自定义规则可以通过 Checkpoint 节点路由回默认规则。
规则消息¶
规则消息是一个可序列化的、不可变的数据结构，表示系统中的各种消息。例如：
- 接收遥测，属性更新，事件或设备指令。
- 设备状态事件：连接，断开，激活，未激活等。
- 其他系统事件如预定义消息。
规则消息包含以下信息：
- 消息 ID：基于时间的，通用的唯一标识符。
- 消息的发起者：设备、资产或其他实体标识符。
- 信息类型：如 “测点上报” 或 “重启事件” 等。
- 消息的有效载荷：带有实际消息有效载荷的 JSON 正文。
- 元数据：关于消息的附加数据的键-值对列表。
规则节点关系¶
规则节点关系指定两个规则节点之间的关系。每个关系都有关系类型，即用于识别关系逻辑含义的标签。规则节点关系可以有多个标签。
消息处理结果¶
处理消息时有两种可能的结果。
- 成功：当规则的最后一个规则节点成功处理消息时，消息处理尝试将被标记为 “成功”。
- 失败：如果其中一个规则节点产生了消息处理的 “失败”，并且没有规则节点来处理该失败，则消息处理尝试将被标记为 “失败”。
使用限制
在创建任何路由规则之前请阅读以下内容。此处列出的限制条件适用于每个 OU。
| 项目 | 使用限制 |
|---|---|
| 资产类型 | 仅支持设备资产，不支持逻辑资产。 |
| 允许创建的最大规则总数 | 100 |
| 单个规则內包含的最大节点数 | 50 |
| 节点日志的最长存储时间 | 7 天 |
| OU 內可配置的最大运行实例数 | 10 |
| OU 內可配置的最大单实例运行资源数 | 8 CU（4 Core CPU + 16 GB 内存） |