更新时间:2024-10-22 GMT+08:00

云端规则

概述

当用户设置云端规则时,物联网平台会判断是否满足规则触发条件,在条件满足时,平台会执行用户预设的动作。比如:事件告警、主题通知、设备命令下发等。

操作步骤

  1. 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 选择左侧导航栏的规则 > 设备联动,单击页面“创建规则”
  3. 参考下表参数说明,创建设备联动规则。

    参数名称

    说明

    最佳实践

    规则名称

    创建的规则名称。

    激活规则

    • 勾选:创建规则后,规则处于激活状态。
    • 不勾选:创建规则后,规则处于未激活状态。

    规则类型

    • 云端规则:创建的规则在云端平台执行。
    • 端侧规则:创建的规则下发到端侧执行,需要端侧设备搭载有端侧规则引擎能力的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云服务定义的模板,发送消息时将模板中变量替换成对应的参数值。设备接入定义了一些通用的模板变量,在规则触发后,以下模板变量将会替换成相应的具体值。

        {ruleName}:触发的规则名称

        {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作为隔离标识。
      • 告警名称:上报的告警名称。
      • 告警内容:上报的告警需要携带的内容。
    • 恢复告警:定义告警级别、告警名称、告警隔离级别和告警内容等,参数描述同上报告警参数描述,表示清除设备上报到平台的告警。
      说明:

      在应用运维管理中,告警级别、告警名称、告警隔离级别组合起来共同标识一条告警,恢复告警时,这三个属性需要和上报告警时保持一致。

  4. 单击右下角“创建规则”,完成设备联动规则的创建。新创建的规则默认状态为“激活”,您可以在规则列表“状态”列,禁用规则。

    图1 新建联动规则-BatteryProperty