文档

管理场景

更新时间:

场景是一系列设备状态或事件组合而成的规则,一个场景可对应实际业务中的一种异常,这种异常需要多种条件组合进行判断。例如产线异常场景需要结合温度、震动、噪声及转速数据等综合判断是否需要工程师介入检查维修。在场景定义的规则触发后,可以通知相应的异常到指定的联系人或联系人组,联系人收到通知后可以及时采取措施,避免异常造成进一步损失。本文介绍如何管理场景的规则,实现异常事件的及时响应。

场景运行原理

在事件响应服务中,场景规则按照以下模式运行:

  1. 触发事件:包括设备上下线变更、物模型属性上报、定时事件和自定义API事件满足条件的触发。例如产线中监测设备的噪声大于100分贝。

  2. 检查条件:当场景事件被触发后,同时检查某些条件是否满足。例如当产品线监测设备的噪声大于100分贝时,同时检查设备转速是否低于20转每秒且设备水温大于90℃。

  3. 执行动作:当触发事件和检查条件都满足时,执行场景规则中定义的动作。

场景规则

创建场景

  1. 登录物联网平台控制台,选择华东2(上海)地域,单击对应实例。

  2. 在左侧导航栏,选择监控运维事件响应,进入场景管理页签。

  3. 场景管理页签,按照以下操作添加和配置场景规则。

配置场景名称

  1. 场景管理页面,单击创建场景

  2. 在创建场景对话框,输入场景名称和场景描述。

    场景名称支持中文、英文、数字、下划线(_)和短划线(-),长度限制为1~30个字符,一个中文算两个字符。

  3. 单击确认,进入场景详情页面。

配置场景定义和动作

场景详情页面,配置事件、条件和动作,然后单击确认

以温度告警为例:在08:00至18:00之间,当温度计上报的室内温度低于16.00摄氏度且电流大于30.00A时,通知管理员。场景详情

参数

描述

场景定义

包含触发事件检查条件,支持定义多个触发事件检查条件组来代表多种规则对应的同一类场景。单击新增场景定义即可增加场景定义。不同场景定义之间是或关系。

配置触发事件

设置场景的事件类型设备上下线变更物模型属性上报定时事件自定义API事件。当设置的场景满足设定的事件过滤条件,触发执行条件判断。

  • 设备上下线变更:需选择已创建的产品、设备(一个或全部设备)和过滤条件。

    重要
    • 设备首次接入物联网平台上线不会触发事件。

    • 针对全部产品或产品同一设备的关联规则不超过10条。

  • 物模型属性上报:需选择已创建的产品、设备(一个或全部设备)、设备属性(一个或全部属性)和过滤条件。

    重要

    针对全部产品或产品同一设备的关联规则不超过10条。

  • 定时事件:仅支持循环执行模式,需设置循环周期的单位(分钟、小时、天、周、月)和对应的时间:

    • 分钟小时:需设置时间间隔。场景启动后,在离当前时间最近的一个可以整除时间间隔的时间点首次触发。

      例如时间间隔为3分钟,若场景启动时间为某一时的23分钟,则1分钟后的24分钟可整除3,即24分钟场景开始触发,然后每隔3分钟循环触发。

    • :设置具体的触发时间点。

  • 自定义API事件:设置后,当前场景API事件支持通过另一个场景的场景动作来触发。配置说明,请参见场景动作的触发场景自定义事件

上图示例中,设置为物模型属性上报:以温度计上报的室内温度低于16摄氏度作为触发事件。

新增条件

可选。定义检查条件,即当场景定义事件触发后,是否要同时检查其他条件。

条件之间可定义为关系,也可定义为关系组。关系是以条件组形式存在,即每个条件组的检查任意一个生效,则场景命中生效,就需执行场景动作。

可选条件类型:

  • 设备状态:需选择已创建的产品、设备(一个或全部设备)和过滤条件。

  • 物模型属性值:需选择已创建的产品、设备(一个或全部设备)、设备属性(一个或全部属性)和过滤条件。

  • 当前时间:需设置时间范围。

  • 实时天气:需选择产品、设备(一个设备)和天气情况(天气现象、风力、风向和温湿度范围),来判断天气情况。

    设备位置的判断逻辑:若所选产品的物模型默认模块中存在标准地理位置属性(GeoLocation),则使用坐标确定位置;否则,使用设备接入点IP地址判断设备位置。

  • 静默周期:设置场景频繁触发的时间间隔,支持时间单位为秒、分钟、小时、天。目前最长支持1天静默。

上图示例中:当在每天08:00-18:00时间区间,且设备的工作电流大于30.00A时,需执行场景动作。

场景动作

设置需执行的动作。您可以设置多个动作。某一动作执行失败时,不影响其他动作。

  • 发送通知消息:通过短信、钉钉通知联系人或联系人组,通知内容为系统模板。

  • 设置物模型属性:需选择已创建的产品、设备(一个设备)、物模型模块(一个模块)、参数(一个或全部属性)。

  • 调用物模型服务:需选择已创建的产品、设备(一个设备)、物模型模块(一个模块)、服务(一个服务)、参数(服务的入参)。

  • 调用Web服务:设置您自己定义的HTTP请求,需设置请求方式、服务地址、编码、请求和参数信息。

  • 触发场景自定义事件:选择场景的事件类型自定义API事件的场景。

    重要

    事件响应服务不支持嵌套触发场景,所以,此处选择的被触发场景中,场景动作不可设置触发场景自定义事件

上图示例中:设置通知给指定联系人。

运行场景

启动场景

完成场景触发事件、检查条件和场景动作的完整定义后,单击立即启动,使场景运行状态为运行中

image

手动触发验证场景

通过物联网平台的设备模拟器功能,手动触发条件,验证场景运行。

  1. 登录物联网平台控制台

  2. 实例概览页面,找到您的实例,单击实例进入实例详情页面。

  3. 在左侧导航栏,选择设备管理 > 设备模拟器

  4. 选择本次模拟的设备,单击属性上报页签,单击启动设备模拟器

  5. 设置温度为10和电流为35,单击发送指令调试设备

  6. 在钉钉机器人群,可收到通知信息。

查看日志

您可以查看该场景运行的日志,并且可在详情中查看运行结果。

  1. 登录物联网平台控制台,选择华东2(上海)地域,单击对应实例。

  2. 在左侧导航栏,选择监控运维事件响应,进入场景管理页签。

  3. 场景管理页签,找到要查看日志的场景,单击右侧操作栏中的日志

  4. 单击日志操作栏的详情,查看该条日志的详情信息。

    说明

    若有执行状态失败的日志,可单击对应操作栏中的详情,查看场景执行失败的详细信息。

    image

场景的其他操作

编辑场景

  1. 登录物联网平台控制台,选择华东2(上海)地域,单击对应实例。

  2. 在左侧导航栏,选择监控运维事件响应,进入场景管理页签。

  3. 场景管理页签,找到要修改的场景,单击右侧操作栏中的查看

  4. 场景详情页面,单击右上角的编辑,完成场景定义和动作更改,单击确认

    场景定义和动作配置说明,请参见创建场景

删除场景

重要

如果场景正在运行,需先停止运行才能进行删除操作。

  1. 登录物联网平台控制台,选择华东2(上海)地域,单击对应实例。

  2. 在左侧导航栏,选择监控运维事件响应,进入场景管理页签。

  3. 场景管理页签,单击右侧操作栏中的删除

更改场景运行状态

  1. 登录物联网平台控制台,选择华东2(上海)地域,单击对应实例。

  2. 在左侧导航栏,选择监控运维事件响应,进入场景管理页签。

  3. 场景管理页签,找到要目标场景,单击运行状态栏中的开关按钮,可停止或启动场景。

  • 本页导读 (1)
文档反馈