新 ⬝ 新建数据预警

1 前提条件

1) 新建数据预警，用户需要具备“计划任务”的操作权限，需要为用户的相关角色授予对应的操作权限。详情可参考：操作权限。

2) 数据预警功能依赖于数据预警时序库，需要先部署数据预警时序库。详情可参考：安装部署SmartbiTimeSeries(windows环境）、安装部署SmartbiTimeSeries(Linux环境)

3）需要在“运维设置”-“系统选项”-“高级设置”中设置开启数据预警，并配置“数据预警时序库”地址。
##开启数据预警
ALARM_ENABLED=true
##配置数据预警时序数据库地址，需根据实际地址进行修改
ALARM_TIME_SERIES_DB_URL=http://127.0.0.1:8428

2 应用范围

以下报表、组件支持数据预警功能。

3 功能入口

3.1 交互仪表盘

交互式仪表盘可以通过以下任意一种方式，新建数据预警并进入数据预警配置界面。

1） 通过交互仪表盘编辑页面

a. 在组件的菜单中点击“新建数据预警”

b. 通过交互式仪表盘工具栏的“数据预警”→"新建数据预警”

2） 通过交互式仪表盘编辑页面

a. 在组件的菜单中点击“新建数据预警”

b. 通过交互式仪表盘工具栏的“数据预警”→"新建数据预警”

 3.2 即席查询/透视分析

通过报表工具栏上的“数据预警”→“新建数据预警”

4 数据预警配置

数据预警需要配置基本信息、数据范围、触发条件、预警推送、其他设置共5个步骤的内容。

4.1 基本信息

1）数据预警名称：自定义数据预警名称。

2）数据预警描述：为数据预警添加描述信息。

3）是否启用：设置数据预警是否启用。

4）来源组件：设置数据预警的来源组件，可以选择仪表盘中的组件。

4.2 数据范围

1）数据范围：数据范围用于设置预警检测的目标数据。默认使用组件上的字段、筛选器等内容构建目标数据；同时也支持用户编辑数据范围，从而修改需要进行监测的目标数据。

若基于即席查询、交互式仪表盘中的明细表创建的数据预警，数据范围中的表格亦是明细数据；若基于透视分析、交互式仪表盘中明细表外的组件创建的数据预警，数据范围中的表格是汇总数据。

2）条件生效值说明：若数据范围中存在过滤条件，则数据预警运行时会根据条件的默认值查询监测的目标数据。将鼠标移动到“条件生效值说明”上，可以便捷查看各条件的默认值。

3）从来源同步：清除当前数据范围中的所有内容，重新从来源组件/报表上同步字段、筛选器、数据模型等所有内容。

4.3 触发条件

1）预警度量：选择一个度量字段进行预警监测。

若基于即席查询、交互式仪表盘中的明细表创建的数据预警，则预警度量可选数据范围中的任一数值类型字段；若基于透视分析、交互式仪表盘中明细表外的组件创建的数据预警，则预警度量只能选择数据范围中的度量字段。

2）触发条件：设置所选度量字段的触发条件。其中操作符支持大于、大于等于、小于、小于等于、等于、不等于；阈值支持设置固定值。

3）触发条件计时器：可选择“每次”、“连续”。选择“每次”时，当数据预警运行时监测到数据满足触发条件时，立即触发预警、推送信息给用户；选择“连续”时，同时需要配置连续的时间段，如连续3个月，则需要数据在连续3个月都满足触发条件时，才触发预警进行信息推送。

4）预警数据过滤：支持增加过滤条件，对监测的目标数据进行过滤。

4.4 预警推送

1）消息标题：推送消息的标题，在各推送渠道中会以对应效果展示，如在邮件渠道中，消息标题作为邮件的标题进行展示。

2）消息内容：推送消息的内容，在各推送渠道中会以对应效果展示，如在邮件渠道中，消息内容作为邮件的正文进行展示。

3）推送渠道：通过点击 +增加推送渠道 添加一种或多种推送渠道。

4.5 其他设置

该步骤设置数据预警的执行计划，包括运行日期、开始时间、失败重试机制等。

点击“新建/修改执行计划”，在如下界面中设置“间隔类型”、“运行设置”等内容，设定数据预警的执行时间和执行间隔。

该界面调用系统中“计划”的功能界面，设置项功能请参考：新建计划

5 测试与验证

5.1 信息接收

数据预警会按照设定的计划进行自动监测，当监测到存在数据满足触发条件时，会自动向接收人发送信息。

以如下设置为例

【步骤2 数据范围】

【步骤3 触发条件】

【步骤4 预警推送】

数据预警执行时，根据数据范围的设置进行数据查询，并使用触发条件监测查询的数据。发现有以下数据满足触发条件，此时会触发预警，系统自动向设定的接收人发送邮件。

接收人登录对应的邮箱，可在邮箱内收到系统推送的预警邮件。如下：

5.2 预警记录查看

数据预警的执行结果也可通过“预警记录”功能查看。