1 前提条件
1) 新建数据预警，用户需要具备“计划任务”的操作权限，需要为用户的相关角色授予对应的操作权限。详情可参考：新建数据预警，用户需要具备“计划任务”和对应报表类型的“数据预警”的操作权限，需要为用户的相关角色授予对应的操作权限。详情可参考：操作权限。
2）需要在“运维设置”-“系统选项”-“高级设置”中设置开启数据预警，并配置“数据预警时序库”地址。
##开启数据预警
ALARM_ENABLED=true
##配置数据预警时序数据库地址，需根据实际地址进行修改
ALARM_TIME_SERIES_DB_URL=http://127.0.0.1:8428
2) 数据预警功能依赖于数据预警时序库，需要先部署数据预警时序库。详情可参考：安装部署SmartbiTimeSeries(windows环境）、安装部署SmartbiTimeSeries(Linux环境)
| 注意 |
|---|
1、从2025-04-04 起，数据预警功能不依赖于数据预警时序库，无需部署、配置数据预警时序库。 2、从2025-01-07起， V11 Windows EXE安装包已包含数据预警时序库，无需单独部署。 |
3）需要在 数据连接 - system 目录下配置数据预警时序库。
2 应用范围
以下报表、组件支持数据预警功能。
| 报表 | 组件 | 备注 |
|---|---|---|
| 即席查询 | / | 仅基于数据模型创建的即席查询支持数据预警 |
| 透视分析 | / | 仅基于数据模型创建的透视分析支持数据预警 |
| 交互式仪表盘 | 支持拖入数据模型字段的所有组件 | 文本组件、树状表组件除外； |
并且仅基于数据模型创建的组件支持数据预警 |
3 功能入口
3.1 交互仪表盘
交互式仪表盘可以通过以下任意一种方式，新建数据预警并进入数据预警配置界面。
...
3.2 即席查询/透视分析
通过报表工具栏上的“数据预警”→“新建数据预警”
4 数据预警配置
数据预警需要配置基本信息、数据范围、触发条件、预警推送、其他设置共5个步骤的内容。
4.1 基本信息
1）数据预警名称：自定义数据预警名称。
2）数据预警描述：为数据预警添加描述信息。
...
| 注意 | ||||
|---|---|---|---|---|
| ||||
1）当从组件菜单新建数据预警，“来源组件”显示对应的组件名称，且不支持切换组件； 2）当在透视分析/即席查询新建数据预警，不显示“来源组件”设置项。 |
4.2 数据范围
1）数据范围：数据范围用于设置预警检测的目标数据。默认使用组件上的字段、筛选器等内容构建目标数据；同时也支持用户编辑数据范围，从而修改需要进行监测的目标数据。1）数据范围：数据范围用于设置预警检测的数据。默认使用组件上的字段、筛选器等内容构建数据；同时也支持用户编辑数据范围，从而修改需要进行监测的数据。
若基于即席查询、交互式仪表盘中的明细表创建的数据预警，数据范围中的表格亦是明细数据；若基于透视分析、交互式仪表盘中明细表外的组件创建的数据预警，数据范围中的表格是汇总数据。若基于即席查询、交互式仪表盘中的明细表创建的数据预警，数据范围中的数据也是明细数据；若基于透视分析、交互式仪表盘明细表外的组件创建的数据预警，数据范围中的数据是汇总数据。
2）条件生效值说明：若数据范围中存在过滤条件，则数据预警运行时会根据条件的默认值查询监测的目标数据。将鼠标移动到“条件生效值说明”上，可以便捷查看各条件的默认值。2）条件生效值说明：若数据范围中存在过滤条件，则数据预警运行时会根据条件的默认值查询需要监测的数据。将鼠标移动到“条件生效值说明”上，可以便捷查看各条件的默认值。
3）从来源同步：清除当前数据范围中的所有内容，重新从来源组件/报表上同步字段、筛选器、数据模型等所有内容。报表上同步字段、筛选器、数据模型等内容。
4.3 触发条件
1）预警度量：选择一个度量字段进行预警监测。
若基于即席查询、交互式仪表盘中的明细表创建的数据预警，则预警度量可选数据范围中的任一数值类型字段；若基于透视分析、交互式仪表盘中明细表外的组件创建的数据预警，则预警度量只能选择数据范围中的度量字段。
...
| 注意 | ||
|---|---|---|
| ||
当前不支持预警度量字段与字段的比较。需要通过计算度量实现，详情可参考示例：销售人员销售额低于销售额目标预警 |
...
3）触发条件计时器：默认支持“每次”。选择“每次”时，当数据预警运行时监测到数据满足触发条件时，立即触发预警、推送信息给用户。
4）预警数据过滤：支持增加过滤条件，对监测的目标数据进行过滤。
| 注意 | ||
|---|---|---|
| ||
触发条件计时器当前仅支持“每次”。”连续“模式即将发布。 |
4）预警数据过滤：支持增加过滤条件，对监测的目标数据进行过滤。
预警数据过滤只支持字符串类型字段。 |
4.4 预警推送
1）消息标题：推送消息的标题，在各推送渠道中会以对应效果展示，如在邮件渠道中，消息标题作为邮件的标题进行展示。
2）消息内容：推送消息的内容，在各推送渠道中会以对应效果展示，如在邮件渠道中，消息内容作为邮件的正文进行展示。3）推送渠道：通过点击
3）报表链接：将报表链接和消息标题、消息内容一起推送，在各推送渠道中会以对应的效果展示。
| 注意 | ||
|---|---|---|
| ||
1）企微、钉钉报表链接免登录访问，需更新2025年04月的V11版本及企业微信/钉钉扩展包。扩展包下载地址：企微集成 · 步骤1 Smartbi环境准备、钉钉集成Smartbi指南2.0 2）邮件渠道报表链接URL地址为 http://xxx/xx/openresource模式，不支持免登录访问。 |
4）推送渠道：通过点击 +增加推送渠道 添加一种或多种推送渠道。
| 设置项 | 设置项说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 推送渠道推送渠道当前仅支持邮件。 | 支持邮件、钉钉、企业微信。
| ||||||||||||
| 接收人 前提：请确保已在用户管理中为用户配置邮箱，详情可参考：用户。 |
|
4.5 其他设置
该步骤设置数据预警的执行计划，包括运行日期、开始时间、失败重试机制等。1）执行计划：设置数据预警的执行计划，包括运行日期、开始时间、失败重试机制等。
点击“新建/修改执行计划”，在如下界面中设置“间隔类型”、“运行设置”等内容，设定数据预警的执行时间和执行间隔。
...
该界面调用系统中“计划”的功能界面，设置项功能请参考：新建计划
2）权限设置（202504新增功能）：支持设置数据预警的资源权限。相关功能可参考：资源权限—右键资源授权
5 测试与验证
5.1 信息接收
数据预警会按照设定的计划进行自动监测，当监测到存在数据满足触发条件时，会自动向接收人发送信息。
...
【步骤2 数据范围】
【步骤3 触发条件】
【步骤4 预警推送】
数据预警执行时，根据数据范围的设置进行数据查询，并使用触发条件监测查询的数据。发现有以下数据满足触发条件，此时会触发预警，系统自动向设定的接收人发送邮件。
接收人登录对应的邮箱，可在邮箱内收到系统推送的预警邮件。如下：
...
| icon | false |
|---|---|
| title | 注意 |
邮件中如下部分为系统自动拼接，当前版本暂不可取消。后续版本将优化对应内容，支持插入函数实现相关内容。
...
接收人接受钉钉消息如下：
5.2 预警记录查看
数据预警的执行结果也可通过“预警记录”功能查看。
