规则信息

*规则名称

监控规则的名称，自动填充，可编辑。

描述信息

监控规则的描述信息，以便后续管理。

运行设置

*集群

要创建规则的数据库集群，支持Apache Hadoop、MiniBase Hadoop、LAS三种引擎类型，下拉可选相应引擎下已创建的集群。
支持快捷模式和安全模式两类集群，相关配置说明请参见集群管理。

• 快捷模式：选择监控对象时不会进行鉴权，可选择监控集群下所有数据表。
• 安全模式：选择监控对象时会进行数据鉴权，若无该表的读取权限，则无法创建相应的监控规则。

*关联任务

数据开发关联调度任务的名称。
通过任务ID或者任务名称关键词搜索后，下拉可选。

*规则强弱

提供强、弱两个配置选项。

• 当选择强时，需设置熔断方式。关联任务执行完成之后会进入强规则运行阶段，由熔断方式决定下游任务运行情况。
• 当选择弱时，关联任务执行完成之后会进入弱规则运行阶段，如果发现关联任务质量异常，则该规则发送报警通知，但不会阻塞下游任务运行。

*熔断方式

如果是强规则，可选择以下两种熔断方式：

• 在规则运行完成之前，Dorado实例将一直处于运行中状态：是指在质量规则运行完成之前，关联任务实例一直处于运行中，期间若触发强规则告警，则关联任务实例状态置为失败，阻塞下游任务运行；若未触发告警，则关联任务实例置为成功，并触发下游任务运行。
• 若规则运行超过x分钟仍未结束，直接置Dorado实例为成功：是指质量规则运行超过设定时间，关联任务实例状态会直接置为成功，但规则仍继续运行，可以触发告警通知。此时，下游任务仍被触发运行，但可能存在数据质量污染风险，需要及时关注监控结果。超时时间可自行设定，取值范围为0~200。

*执行引擎

使用的计算引擎，支持 SPARK 和 PRESTO 两个选项。

*运行队列

规则使用的运行队列，支持使用任务队列、自行指定队列两个选项。

• 使用任务队列：使用关联任务的引擎队列。当选择关联任务后，才可选择该选项。
• 自行指定队列：自行选择要使用的引擎队列，下拉可选当前项目下所选集群已绑定的队列。项目绑定队列的操作请参见新建项目或编辑项目配置。

自定义SQL及监控逻辑

*自定义SQL

符合Hive语法规范的SQL语句，支持join和group by（group by后通常需设置维度字段）。

*字段名称

SQL字段名称。解析SQL语句后，自动填充，可编辑。

*字段类型

支持维度和指标两个选项。解析SQL语句后，自动填充，可编辑。

• 维度：规则报警后，会通报维度信息，便于用户拆解报警内容。如：维度app=toutiao下，指标DAU发出报警。用户可设置多个维度。
• 指标：监控的具体指标，需要设置报警条件。多个指标之间是独立的，任何一个满足报警条件，都会触发规则报警。

目前自定义SQL主要提供以下监控场景：

• 当所有字段的字段类型全部设置为指标时，可进行多指标监控（单行多列）。例如，监控某个产品线的DAU、MAU、人均在线时长等指标。
• 当至少有一个字段的字段类型设置为维度时，可进行多指标多维度监控（多行多列）。例如，监控多个产品线的DAU、MAU、人均在线时长等指标，一旦发出报警，会知道是哪个产品线下的哪个指标触发了报警。
  1. 监控配置示例如下：
     • 自定义SQL语句：SELECT APP,DAU,MAU from databases.table group by APP;
     • 将 APP 设置成维度，DAU、MAU 设置成指标，并为指标设定监控阈值。
  2. 当实际结果不符合监控预期时，便发出报警，报警信息示例如下：
     • APP=toutiao, 指标DAU为XXX，触发报警。
     • APP=douyin, 指标MAU为XXX，触发报警。

*报警条件

解析SQL语句后，自动填充，可编辑。
支持数值类型、波动率等的报警，具体说明可参见配置Hive模板规则的参数说明。

高级参数

规则重试条件

运行失败

运行参数

按需配置 SQL 语句前的运行参数，如“set 参数名1=取值；”。

过滤条件

where之后的条件语句，语法逻辑跟HSQL一致，无需输入Where，如 type='xxx'。

报警设置

*报警方式

支持邮箱、Webhook、飞书的告警方式。

*hookUrl

Webhook 请求地址，以 http 或 https 开头。 从下拉列表中选择 http 或 https，填写 Webhook URL 地址。欲了解详细的配置说明，请参见Webhook使用说明。
当报警方式选择 Webhook 时，需设置该参数。

*报警接收

接收报警的用户、飞书群。

• 当报警方式选择邮箱或Webhook时，需选择接收报警的用户。
  • 用户：输入用户账号关键词后，在下拉列表中选择，支持设置多个。
• 当报警方式选择飞书时，需设置接收报警消息的用户或您所加入的飞书群。
  • 用户：报警消息将发送至用户名对应的飞书中。
    输入用户账号关键词后，在下拉列表中选择，支持设置多个。
  • 飞书群：报警消息将发送至飞书群ID对应的飞书群中。
    可通过下拉列表中的获取群ID按钮，查看要输入的飞书群ID。