# 管理通知 用户可以通过通知管理功能配置作业通知任务，当作业运行异常或成功时向相关人员发送通知。 #### 配置通知 为作业配置通知前： - 已开通消息通知服务并配置主题。 - 作业已提交，且不是"未启动"状态。 1. [登录DataArts Studio管理控制台](https://console.huaweicloud.com/dayu/)。 详情请参考[访问DataArts Studio实例控制台](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_0001.html)。 2. 在DataArts Studio控制台首页，选择对应工作空间的"数据开发"模块，进入数据开发页面。 3. 在数据开发主界面的左侧导航栏，选择"运维调度 \> 通知管理"。 4. 在"通知管理"页签，单击"通知配置"，弹出"通知配置"页面，配置如[表1]所示的参数。 图1通知配置 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000002515431198.png "点击放大") 表1通知参数 | 参数 | 是否必选 | 说明 | |:---|:---|:---| | 作业范围 | 是 | 选择通知的范围。 - 单个作业：对单个作业发送通知。 - 所有作业：对所有作业发送通知。所有作业指当前已有的作业和后续新创建的作业会使用这个通知配置。同时选择运行异常/失败和此配置时，实例超时不会发送通知。 | | 作业名称 | 是 | 选择作业。 | | 通知类型 | 是 | 选择通知类型： - 单个作业： - 运行异常/失败：作业的状态为"运行异常"或"失败"时，发送通知。 您可以设置作业满足触发条件后最多发送的通知次数，可设置为"不限制"或"自定义"。选择"自定义"时，支持配置"最大通知次数"。 同时，可以配置最小通知间隔（分钟），设置重复通知之间的最短时间间隔，避免短时间内重复发送通知。 系统支持配置"最大通知次数"和"最小通知间隔（分钟）"，作业运行异常或者失败后，在作业未修复前，可以设置间隔时间发送告警通知。 说明： 最大通知次数可设置为1\~50。默认为1时，最小通知间隔不显示。 最小通知间隔可设置为5\~60。 勾选"恢复通知"。开启后，作业重跑成功时会发送通知。 - 运行成功：作业的状态为"成功"时，发送通知。 - 未完成：该功能仅支持按天调度和上游驱动调度的作业配置。如果作业执行时间超过设置的未完成时间，则发送通知。 - 运行取消：作业的状态为"已取消"时，则发送通知。 说明： 调度中的作业手动停止调度时触发告警通知，运行中的作业实例手动停止时触发告警通知。 在作业执行人和作业取消人不一致的场景下，会触发作业取消告警通知。 - 失败作业重跑成功 说明： 该通知需配置运行异常/失败通知为前提，如果作业失败不配置异常/失败通知，则该当失败作业重跑成功后也不会进行通知。 - 作业改动 除了作业责任人外，其他人对作业进行改动（修改作业、删除作业、修改作业引用的脚本、删除作业引用的脚本）时，则发送通知。作业责任人为空时，作业改动也不会发送告警通知。 - 资源繁忙：如果执行作业时，DLI资源队列繁忙时，会遇到作业执行时间过长或无法执行的情况，从而发出告警，则发送通知。 - 所有作业： - 运行异常/失败：作业的状态为"运行异常"或"失败"时，发送通知。 您可以设置作业满足触发条件后最多发送的通知次数，可设置为"不限制"或"自定义"。选择"自定义"时，支持配置"最大通知次数"。 同时，可以配置最小通知间隔（分钟），设置重复通知之间的最短时间间隔，避免短时间内重复发送通知。 系统支持配置"最大通知次数"和"最小通知间隔（分钟）"，作业运行异常或者失败后，在作业未修复前，可以设置间隔时间发送告警通知。 说明： 最大通知次数可设置为1\~50。默认为1时，最小通知间隔不显示。 最小通知间隔可设置为5\~60。 勾选"恢复通知"。开启后，作业重跑成功时会发送通知。 - 运行取消：作业的状态为"已取消"时，则发送通知。 说明： 调度中的作业手动停止调度时触发告警通知，运行中的作业实例手动停止时触发告警通知。 在作业执行人和作业取消人不一致的场景下，会触发作业取消告警通知。 - 失败作业重跑成功 说明： 该通知需配置运行异常/失败通知为前提，如果作业失败不配置异常/失败通知，则该当失败作业重跑成功后也不会进行通知。 - 作业改动 除了作业责任人外，其他人对作业进行改动（修改作业、删除作业、修改作业引用的脚本、删除作业引用的脚本）时，则发送通知。作业责任人为空时，作业改动也不会发送告警通知。 - 资源繁忙：如果执行作业时，DLI资源队列繁忙时，会遇到作业执行时间过长或无法执行的情况，从而发出告警，则发送通知。 说明： - 实时作业只支持状态为**运行异常/失败** 时发送通知，批处理作业在状态为**运行成功** 和**运行异常/失败**时都能发送通知。 - 通常使用默认资源队列时，由于DLI的资源队列繁忙，用户间可能会出现抢占资源的情况，不能保证每次都可以得到资源执行相关操作。建议您在业务低峰期再次重试，或选择自建队列运行业务。 - 作业运行成功时，在补数据、测试运行场景下不发送告警通知。同时，补数据作业实例恢复时也不发送恢复通知。 - 作业运行失败时，重跑作业并且作业运行成功后，会发送作业实例恢复通知。 | | 通知方式 | 是 | - 按主题 - 按责任人 说明： 告警通知设置为责任人时，支持按作业责任人发送通知，建议您使用按主题上报告警或者为作业配置责任人。 如果作业没有配置责任人，就会无法发送通知。 | | 选择主题 | 是 | 通知方式选择"按主题"时才需配置。 选择通知的消息主题。 单击"查看主题"，可以进入消息通知服务（SMN）界面查看消息主题信息。 说明： 当前仅支持"短信"、"邮件"、"HTTPS"这三种协议的订阅终端订阅主题。 | | 终端协议 | 是 | 配置该参数前，请确保工作空间默认项设置中已配置[作业告警通知主题](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_04501.html#dataartsstudio_01_04501__section81976461047)。 通知方式选择"按责任人"时才需配置。 - 短信 - 邮件 - 电话 单击"校验联系方式"，系统会自动校验作业责任人信息是否已配置。如果作业责任人信息未配置，请前往[终端订阅管理](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_2515.html)界面进行配置。 单击"查看订阅信息"，会自动跳转到[终端订阅管理](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_2515.html)界面查看已配置的终端订阅信息。 说明： 终端协议为电话和短信时，依赖SMN服务，给登录用户开通白名单，否则添加订阅会失败，可能会导致告警通知发送失败。 | | 抄送人 | 是 | 通知方式选择"按责任人"时才需配置。 最多只能选择10个抄送人。 | | 开关 | 是 | 是否开启通知，默认开启。 | | 自定义消息 | 否 | 自定义消息开关，默认关闭。 开启自定义消息后，仅支持为实时集成作业配置自定义消息。 说明： 自定义消息当前只支持数据集成（实时作业）。 | | 消息类型 | 否 | 选择消息的发送格式。 - 文本消息：按文本格式发送的消息。 - JSON消息：按JSON格式发送的消息，用户可对不同的订阅者类型发送不同的消息。 | | 消息内容 | 否 | 填写消息的内容，不同消息类型的填写要求如下： - 文本消息：支持向订阅终端发送文本形式的消息内容。所有订阅终端接收的消息相同，且文本长度不超过490个字节。 若消息长度超过490个字节，受运营商限制，短信可能发送失败。 - JSON消息：支持向不同协议的终端发送差异化内容。输入JSON文本时，不同的key对应不同的协议终端。 若default或sms内容超过1000字符，受运营商限制，短信可能发送失败。 当消息内容为JSON格式时，系统默认提供短信、邮件和HTTPS三种协议，用户可直接勾选所需协议，系统会在原有的default模板中追加对应协议的格式，生成新的JSON消息模板。 示例如下： ``` { "default": "Dear Sir or Madam, this is a default message.", "email": "Dear Sir or Madam, this is an email message.", "http": "{'message':'Dear Sir or Madam, this is an HTTP message.'}", "https": "{'message':'Dear Sir or Madam, this is an HTTPS message.'}", "sms": "This is an SMS message, job error: ${job_name}" } ``` 目前支持内置变量（使用 ${内置变量}格式嵌入消息中）： - 工作空间：workspace - 作业名称：job_name - 作业责任人：job_owner - 作业执行人：job_executor - 最后修改人：job_updater - 作业状态：job_status - 触发时间：trigger_time - 告警时间：alarm_time - 调度类型：schedule_type - 失败节点名称：failed_node_name - 告警类型：alarm_type | 5. 单击"确定"，为作业配置通知。 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/public_sys-resources/note_3.0-zh-cn.png) - 数据开发模块的通知管理功能是通过消息通知服务来发送消息，消息通知服务的使用可能会产生费用，具体请咨询消息通知服务。 - 一个作业支持配置多个消息主题，当作业运行成功或失败，可同时向多个订阅了消息主题的终端发送通知。 #### 编辑通知 通知新建完成后，用户可以根据需求修改通知的参数。 1. 在数据开发主界面的左侧导航栏，选择"运维调度 \> 通知管理"。 2. 选择"通知管理"页签。 3. 在通知的"操作"列，单击"编辑"，弹出"通知配置"页面，参考[表1]修改通知的参数。 4. 单击"确定"，保存修改。 #### 关闭通知 用户可以在"编辑"中关闭通知任务，也可以在通知列表中关闭通知任务。 1. 在数据开发主界面的左侧导航栏，选择"运维调度 \> 通知管理"。 2. 选择"通知管理"页签。 3. 在通知的"开关"列，单击![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000001966846997.png)，切换成![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000001939609496.png)时，通知为关闭状态。 图2关闭通知 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000002515581088.png "点击放大") #### 查看通知记录 用户可以在通知记录中查看所有的通知信息。 1. 在数据开发主界面的左侧导航栏，选择"运维调度 \> 通知管理"。 2. 选择"通知记录"页签，进入通知记录页面。系统只能查看最近30天的数据。 图3查看通知记录 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000002547104539.png "点击放大") #### 删除通知 当用户不需要使用某个通知时，可以参考如下操作删除该通知。 1. 在数据开发主界面的左侧导航栏，选择"运维调度 \> 通知管理"。 2. 选择"通知管理"页签。 3. 支持如下两种方式删除通知。 图4删除通知 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000002298226581.png "点击放大") - 在通知的"操作"列，单击"删除"，弹出"删除通知"页面。 - 勾选待删除的通知，单击通知列表上方的"批量删除"，弹出"删除通知"页面。 4. 单击"确认"，删除通知。 #### Subjob/Foreach作业发送通知的特别场景 前提条件：为父作业配置**运行异常/失败**通知。 1. 针对子作业调度为忽略失败的场景，需要在管理通知中对父作业配置"运行异常/失败"通知告警。 2. 子作业状态为取消或者失败，如果在父作业中后续节点的失败策略为"继续执行下一节点"，需要为父作业配置"运行异常/失败"通知。 - 以下场景不会发送告警 - Subjob/Foreach子作业调度为执行异常，但父作业仍在运行中，不会发送告警通知，因为执行异常不是最终状态。 - Subjob/Foreach子作业配置了告警通知，但子作业并未开始调度，即使父作业启动调度后，Subjob/Foreach子作业也不会发送告警。如果在该场景下，需要获取Subjob/Foreach子作业告警通知，需要为父作业配置告警通知。 - 以下场景会发送告警 - Subjob/Foreach子作业实例状态为失败/取消，父作业中配置的后续节点处理策略为失败挂起、失败终止后续、失败终止所有、忽略失败并且工作空间忽略失败设置为失败通知，都会发送告警。工作空间配置项请参见[忽略失败的通知策略](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_04501.html#dataartsstudio_01_04501__section201662581464)。用户配置了父作业的执行失败告警通知，当父作业中的子作业中有失败节点，用户收到通知该子作业有失败。同时，父作业运行成功，子作业有失败时，发送告警通知，也会包含子作业失败告警信息。 图5Subjob子作业失败通知 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000002700952409.png "点击放大") - Subjob/Foreach子作业实例状态为忽略失败，并且工作空间忽略失败设置为失败通知时，会发送告警。工作空间配置项、请参见[忽略失败的通知策略](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_04501.html#dataartsstudio_01_04501__section201662581464)。 - Foreach场景下，每一个失败的foreach都会发送通知。当foreach作业运行失败时，会发送foreach作业具体哪一个循环节点失败。 图6Foreach作业失败通知 ![](https://support.huaweicloud.com/usermanual-dataartsstudio/zh-cn_image_0000002700832381.png "点击放大")