终端订阅管理

操作场景

系统支持按照责任人配置终端订阅信息（短信、邮件、电话），配置好订阅信息后，通过通知管理功能配置作业通知任务，当作业运行异常或成功时向已配置的责任人发送通知。

• 在DataArts Studio数据开发平台中，您管理着多个ETL作业，每个作业都配置了责任人。当作业运行异常或失败时，您希望通过短信、邮件或电话第一时间通知到对应的责任人。
  

  ETL的含义是：E（Extract）、T（Transfer）、L（Load）。

  在作业开发中：数据流完成的是主要的数据抽取、数据转换、数据加载任务，是ETL开发的主体。

• DataArts Studio的通知管理功能支持两种通知方式：按主题和按责任人。按主题通知时，所有告警都发送到同一个SMN主题的订阅者，无法区分不同作业的责任人；而按责任人通知时，系统会根据作业配置的责任人自动匹配终端信息，实现精准通知。但按责任人通知需要预先为每个责任人配置终端订阅信息（手机号、邮箱等），否则无法发送通知。此外，终端订阅需要经过“请求订阅”确认流程，责任人需要确认后才能正式接收告警。
• 为作业责任人配置终端订阅信息（短信、邮件、电话），确保按责任人发送告警通知时能准确送达。
• DataArts Studio提供 终端订阅管理功能，支持按照责任人配置终端订阅信息。配置完成后，通过通知管理功能配置作业通知任务，当作业运行异常或成功时即可向已配置的责任人发送通知。

相关概念

• SMN：Simple Message Notification（消息通知服务），华为云服务提供的消息通知服务，支持通过短信、邮件、HTTPS等协议向订阅终端推送消息。终端订阅管理功能基于SMN实现。
• 终端订阅：为作业责任人配置的接收通知的终端信息，包括短信（手机号）、邮件（邮箱）、电话（手机号）等。每个责任人可配置多种终端协议。
• 请求订阅：SMN的订阅确认流程。添加订阅后状态为“未确认”，需要责任人确认订阅后状态变为“已确认”，才能正式接收告警通知。这是SMN的安全机制，确保终端所有者同意接收消息。
• 作业告警通知主题：工作空间默认项设置中的配置项，用于指定按责任人发送通知时所依赖的SMN主题。按责任人通知时，系统会在该主题下为每个责任人的终端创建订阅。
• 作业责任人：创建作业时配置的责任人信息。按责任人发送通知时，系统根据作业的责任人信息匹配终端订阅配置。

前提条件

已开通消息通知服务并配置主题。按照责任人配置订阅信息前，请确保已在工作空间配置了作业告警通知主题。

终端订阅管理功能基于消息通知服务（SMN）实现，SMN的使用可能会产生费用。具体请参见消息通知服务计费说明。

配置通知

1. 登录DataArts Studio管理控制台。

   详情请参考访问DataArts Studio实例控制台。

2. 在DataArts Studio控制台首页，选择对应工作空间的“数据开发”模块，进入数据开发页面。
3. 在数据开发主界面的左侧导航栏，选择“配置管理 > 配置”。单击“默认项设置”，设置“作业告警通知主题”配置项。按责任人配置工作空间作业告警通知主题的详细操作请参见作业告警通知主题。如果已配置，请忽略。
   图1 配置作业告警通知主题
   

4. 在数据开发主界面的左侧导航栏，选择“运维调度 > 通知管理”。
5. 选择“终端订阅管理”页签，单击“添加订阅”，弹出“添加订阅”页面，配置如表1所示的参数。
   图2 添加订阅
   

   表1 添加订阅参数

   参数	是否必选	说明
   责任人	是	设置添加订阅的责任人。责任人是创建作业时所配置的责任人信息。
   终端协议	是	短信 邮件 电话
   终端信息	是	设置订阅的终端信息。

6. 单击“确定”。
7. 终端订阅配置完成后，您可以在通知的“操作”列进行如下操作。
   • 单击“请求订阅”，打开“请求订阅”页面，订阅状态为“未确认”，单击“确定”，确认订阅后，订阅状态为“已确认”。
   • 单击“编辑”，可以对终端订阅配置进行修改。
   • 单击“删除”，打开“删除订阅”页面，选择“确定”，删除通知。
     

     终端订阅管理页面支持批量删除和批量请求订阅，不支持编辑。

8. 以上操作完成后，请在管理通知界面按照责任人配置作业运行告警通知。

常见问题

• 添加订阅后状态一直是“未确认”怎么办？

  请按以下步骤排查：

  1. 单击“请求订阅”重新发送确认消息。
  2. 检查责任人的手机短信或邮箱是否收到确认链接。
  3. 确认消息可能被拦截为垃圾短信或邮件，请检查垃圾箱。
  4. 如果终端协议为短信或电话，确认是否已在SMN为登录用户开通白名单。
  5. 确认终端信息（手机号/邮箱）是否正确。
• 为什么按责任人发送通知时收不到告警？

  请检查以下几项：

  1. 责任人是否已在终端订阅管理中配置了终端信息。
  2. 订阅状态是否为“已确认”（未确认的订阅无法接收通知）。
  3. 工作空间默认项设置中是否已配置“作业告警通知主题”。
  4. 作业是否配置了责任人（责任人为空时不会发送通知）。
  5. 通知管理中是否选择了"按责任人"通知方式且通知开关已开启。
• 一个责任人可以配置多个终端订阅吗？

  可以。一个责任人可以分别配置短信、邮件、电话等多种终端协议的订阅。添加多条订阅记录即可，每条记录对应一种终端协议。作业异常时，系统会同时向该责任人的所有已确认终端发送通知。

• 如何修改已配置的终端信息？

  如需修改终端信息（例如，更换手机号），请先删除原有订阅记录，再重新添加新的订阅，并重新完成“请求订阅”确认流程。或者，在终端订阅管理页面进行编辑操作，输入新的手机号，并重新完成“请求订阅”确认流程。