规则引擎
大约 2 分钟
规则引擎
规则引擎用于配置「触发器 → 执行条件 → 执行动作」的场景联动：当设备数据或状态满足设定时，自动执行属性设置、服务调用、消息通知、告警输出等动作。
菜单：物联网 > 规则引擎（规则日志路由 /iot/ruleMessage/rule-engine-log）
规则组成
在规则列表 新增 时仅填写规则名称、描述与启动状态；触发器、条件与动作在 规则详情 编辑器中配置，以 JSON 结构（ruleContent）保存。
触发器（任一满足即触发，最多 10 个）
| 触发类型 | 说明 |
|---|---|
| 定时触发 | 按 Cron 表达式定时执行（内置 Cron 生成器） |
| 属性触发 | 产品级或设备级；选择属性、比较符（> >= == != < <=，布尔仅 ==）与比较值 |
| 事件触发 | 产品级或设备级；指定事件上报时触发 |
| 上下线触发 | 设备上线或下线时触发 |
选择产品即为产品级触发；选择具体设备后自动切换为设备级触发。
执行条件（触发后需全部/任一满足，最多 5 个，条件间支持 与/或）
| 条件类型 | 说明 |
|---|---|
| 设备属性 | 校验某属性当前值 |
| 设备在线状态 | 在线 / 离线 |
| 时间范围 | 仅在指定时间段内执行 |
执行动作（最少 1 个、最多 10 个）
| 动作类型 | 说明 |
|---|---|
| 设置设备属性 | 选择产品/设备与属性，填入目标值 |
| 调用设备服务 | 仅可选择异步（callType=异步）的服务，填写 JSON 入参 |
| 触发 / 启动 / 停止其它规则 | 规则联动编排 |
| 消息通知 | 通知方式：邮箱 / 短信 / 站内信 |
| 告警输出 | 触发后进入告警中心生成告警记录（配合告警中心使用） |
操作步骤
- 物联网 > 规则引擎 > 新增，填写规则名称与描述，保存。
- 单击 查看/修改 进入规则详情，依次配置触发器、执行条件与执行动作，保存。
- 在列表中 启动 规则（也可 停止 暂停生效）。
- 联调时可单击 触发 手动执行一次，验证动作链路。
规则日志
规则列表行操作 日志 进入规则日志页：
- 记录每次规则执行的时间与整体结果（任一动作失败即标红）。
- 单击 查看 展开每个动作的明细：动作标识、扩展内容（JSON）、错误码、错误结果。
提示
动作失败常见原因：目标设备离线、属性设置值类型与物模型不符、同步服务超时。可结合日志中心的云端日志定位。