任务控制-结果通知

1.1 版本

1.2 功能简介

任务执行失败后，可通知相关人员任务执行失败。

• 通知渠道：平台、邮件、短信、钉钉群机器人、飞书群机器人、企业微信群机器人。

• 通知内容：任务异常通知、脏数据通知、源表结构变化通知。

注：数据开发-定时任务需要发布到「生产模式」中，才能使用该功能。

1.3 前提条件

若需要使用邮箱或者短信通知，需要在平台进行配置，步骤请参见：邮箱、短信

任务执行失败后，可通知相关人员任务执失败。

「结果通知」功能默认是关闭状态，需要手动开启。

需注意以下几点：

1）消息通知仅在任务执行失败时，才会通知，任务执行成功不会通知。

2）单个任务的通知限制 10s 一次。例如：

A 任务配置了任务失败提醒和脏数据提醒，在 10:00:00，因为脏数据超限导致任务停止。在 10:00:00~10:00:09.999 之间，如果 A 任务被重复触发，同样因为脏数据超限导致任务停止，不会再重复提醒。在 10:00:00~10:00:09.999 之间，如果 B 任务因为脏数据超限导致任务停止，会再提醒（因为不是同一个任务）。

3）4.1.5.5 以及之后的版本，当构建任务失败，也会给予通知，例如设置通知渠道为「平台」，如下图所示：

2.1 结果通知按钮

默认关闭，需要手动开启。

2.2 通知内容

2.2.1 任务异常通知

任务失败提醒默认为（默认勾选，不可取消）：

独立部署中，各个渠道的通知内容统一为：${任务名} 运行失败，开始执行时间为 2023-03-21 15:22:38，结束时间为 2023-03-21 15:22:41，请前往【任务运维】-【定时任务】-【运行记录】查看详情

具体报错信息：

默认不勾选，勾选后，若任务失败，将发送报错信息

各个渠道的通知内容统一为：

${任务名} 运行失败，开始执行时间为 2023-03-21 15:22:38，结束时间为 2023-03-21 15:22:41，报错节点为【${节点名称}】，具体报错信息。更多报错内容请前往【任务运维】-【定时任务】-【运行记录】查看详情

报错示例：

多个节点出错，各个渠道的通知内容统一为：

${任务名} 运行失败，开始执行时间为 2023-03-21 15:22:38，结束时间为 2023-03-21 15:22:41，报错节点为【${节点名称}】，具体报错信息；报错节点为【${节点名称}】，具体报错信息。更多报错内容请前往【任务运维】-【定时任务】-【运行记录】查看详情

2.2.2 脏数据通知

1）出现脏数据按钮：勾选「脏数据通知」按钮后，「出现脏数据」按钮默认勾选。当定时任务出现脏数据后，进行通知。

2）脏数据汇总信息按钮：勾选后，在定时任务运行完成后，将脏数据按照原因汇总发送给用户。

3）具体报错内容如下表所示：

4）任务日志的「统计」Tab下，展示统计对象的脏数据行数；点击脏数据行数可展开查看各错误原因分类下的脏数据条数。

2.2.3 源表结构变化通知

详情使用步骤请参见：设置结果通知

为了保证定时任务的来源表 DDL 变化能通知用户，可在「任务控制>结果通知」下设置通知情况。当运行中的任务出现来源表的 DDL 变化时，即会通知信息给用户。如下所示：

2.3 平台用户组

当通知渠道为短信/邮件/平台渠道时：基于平台体系配置通知对象，通知对象可选择平台用户、部门、角色，三者取并集。

2.4 通知渠道

统一说明：

1）当通知渠道选择短信/邮件/平台时，「通知对象」中需要勾选「平台用户组」按钮。如下图所示：

2）通知渠道选择短信/邮箱时，「自定义收件人」与「平台用户组」不能同时为空。

3）通知渠道选择短信/邮箱时，「自定义收件人」不支持引用参数。

4）通知渠道选择短信/邮箱时，「平台用户组」中选择了 A 用户，自定义收件人中也设置了 A 用户，不做重复通知。

具体设置说明：

通知渠道选择「客户端」时，可设置通知渠道为钉钉/飞书/企业微信。

注：一个通知渠道中，Webhook 地址不支持填写多个。

钉钉群机器人 Webhook 地址：可参考 自定义机器人接入

飞书群机器人 Webhook 地址：自定义机器人使用指南

企业微信群机器人 Webhook 地址：添加群机器人步骤如下图所示，机器人添加成功的提示页面上会有 webhook 地址：