云端规则
概述
当用户设置云端规则时,物联网平台会判断是否满足规则触发条件,在条件满足时,平台会执行用户预设的动作。比如:事件告警、主题通知、设备命令下发等。
操作步骤
- 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
- 选择左侧导航栏的“创建规则”。 ,单击页面
- 参考下表参数说明,创建设备联动规则。
参数名称
说明
最佳实践
规则名称
创建的规则名称。
激活规则
- 勾选:创建规则后,规则处于激活状态。
规则类型
- 云端规则:创建的规则在云端平台执行。
- 端侧规则:创建的规则下发到端侧执行,需要端侧设备搭载有端侧规则引擎能力的SDK,详见端侧规则。
生效时间
- 一直生效:没有时间限制,持续检查当前规则条件是否满足。
- 指定时间:可以选择时间段,在特定的时间检查规则条件是否满足。
描述
对该规则的描述。
触发条件
满足条件:可设置满足全部条件,或者任意一个条件,触发规则。
- 设备属性触发:可以将设备上报的属性作为触发条件,如:温度过高达到80℃,关闭设备。
- 选择产品:选择特定产品。
- 选择设备范围:
- 全部设备:对选择产品下的全部设备进行条件设置。
- 指定设备:对选择产品下的指定设备进行条件设置。
- 选择服务:选择产品后选择对应的服务类型。
- 选择属性:选择所需的设备属性作为条件。
说明:
- 属性的数据类型为int、long和decimal时,支持选择多种判断符号。
- 属性的数据类型为string,date time,jsonObject时,判断条件仅支持相等。
- 触发机制:选择触发策略类型,建议选择重复抑制。
- 数据时效(秒):数据有效时间。例如:设备产生数据时间为19:00,时效设为30分钟,平台收到数据时间为20:00,该情况下即使满足触发条件也不触发动作。
- 定时触发:可以设置规则触发的时间点,该条件一般用于周期性的触发条件,如每天7:00,关闭路灯。
说明:
当触发条件选择“定时触发”,则动作中不能设置“发送通知”、“上报告警”、“恢复告警”的执行动作。
- 每日定时触发:可选择每日指定时间点触发。
- 按策略定时触发:
- 时间点:可以选择规则触发的起始时间点。
- 重复次数:规则重复触发的次数(1~1440次)。
- 间隔(分钟):在起始时间点后,重复触发规则的时间间隔(1~1440分钟)。
- 设备状态触发:可以将设备的上下线状态作为触发条件,如:设备离线持续时长达到5分钟,上报告警。
- 选择产品:选择特定产品。
- 选择设备范围:
- 全部设备:对选择产品下的全部设备进行条件设置。
- 指定设备:对选择产品下的指定设备进行条件设置。
- 选择触发设备状态:
- 上线:设备由离线状态转变为在线状态。
- 下线:设备由在线状态转变为离线状态。
- 上下线:设备状态发生变更。
- 状态持续时长:设备状态发生变更后,新状态的持续时长,单位:分钟,可选0-60分钟。
执行动作
单击“添加动作”,设置在规则触发后,需要执行的动作。
- 下发命令:依次选择需要执行下发命令的设备、服务、命令,然后配置下发命令的参数。
- 发送通知:选择SMN云服务对应所在区域。如果未授权,根据界面提示配置云服务访问授权,单击相应链接跳转到SMN云服务页面设置主题。
- 消息标题:给邮箱订阅者发送邮件时作为邮件主题。
- 消息类型:可从自定义和使用模板中选择。
- 消息内容:发送的自定义的消息内容。
- 模板选择:使用SMN云服务定义的模板,发送消息时将模板中变量替换成对应的参数值。设备接入定义了一些通用的模板变量,在规则触发后,以下模板变量将会替换成相应的具体值。
{ruleId}:触发的规则ID
{deviceId}:触发规则的设备ID
{deviceName}:触发规则的设备名称
{productId}:触发规则的设备所属产品的产品ID
{productName}:触发规则的设备所属产品的产品名称
{YYYY}:规则触发的年(UTC时间)
{MM}:规则触发的月(UTC时间)
{DD}:规则触发的日(UTC时间)
{HH}:规则触发的时(UTC时间)
{mm}:规则触发的分钟(UTC时间)
{ss}:规则触发的秒(UTC时间)
说明:例如,在SMN云服务创建消息模板为以下内容:
时间:{YYYY}-{MM}-{DD} {HH}:{mm}:{ss}
规则名称:{ruleName}
规则Id:{ruleId}
产品Id:{productId}
产品名称:{productName}
设备Id:{deviceId}
设备名称:{deviceName}
事件:设备上下线
则设备上线并触发规则后,收到的消息内容为以下图片所示:
- 上报告警:定义告警级别、告警名称、告警隔离级别和告警内容等。当触发设置的条件后,在应用运维管理界面产生一条对应的设备告警。
- 告警级别:可从提示、次要、重要和紧急中选择。
- 告警隔离维度:可从用户、资源空间和设备三个维度中选择,选择不同维度,上报的告警会带上不同的维度标识,如选择设备维度,上报的告警会携带设备ID作为隔离标识。
- 告警名称:上报的告警名称。
- 告警内容:上报的告警需要携带的内容。
- 恢复告警:定义告警级别、告警名称、告警隔离级别和告警内容等,参数描述同上报告警参数描述,表示清除设备上报到平台的告警。
说明:
在应用运维管理中,告警级别、告警名称、告警隔离级别组合起来共同标识一条告警,恢复告警时,这三个属性需要和上报告警时保持一致。
- 单击右下角“创建规则”,完成设备联动规则的创建。新创建的规则默认状态为“激活”,您可以在规则列表“状态”列,禁用规则。
图1 新建联动规则-BatteryProperty