
# 配置MRS集群作业消息通知
消息通知服务（Simple Message Notification，SMN）是可靠的、可扩展的、海量的消息处理服务。它可以依据用户的需求主动推送通知消息，最终用户可以通过短信、电子邮件等方式接收。MRS联合消息通知服务，采用主题订阅模型，提供一对多的消息订阅以及通知功能，能够实现一站式集成多种推送通知方式（例如短信和邮件通知）。
图1MRS集群消息通知   
![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000002283807042.png "点击放大")
通过配置作业消息通知可以实现您在作业执行成功或作业执行失败时能立即接收到通知。
 #### 创建SMN主题并添加订阅
主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道，为发布者和订阅者提供一个可以相互交流的通道。
1. 登录[SMN管理控制台](https://console.huaweicloud.com/smn/)。
2. 在左侧导航栏，选择"主题管理 \> 主题"，进入主题页面。
3. 单击"创建主题"，开始创建主题。 
   表1创建SMN主题参数 
   | 参数   | 描述                                                                                                                                                                                                                                                                                                                                                                                      | 配置示例           |
   |:---|:---|:---|
   | 主题名称 | 创建的主题名称，用户可自定义名称，规范如下： - 只能包含字母，数字，短横线(-)和下划线(_)，且必须由大写字母、小写字母或数字开头。  - 名称长度限制在1-255字符之间。  - 主题名称为主题的唯一标识，一旦创建后不能再修改主题名称。   | mrs-job        |
   | 显示名  | 显示名，长度限制在192字节或64个中文字。 推送邮件消息时，如果未设置主题的显示名，发件人呈现为"username@example.com"，如果已设置主题的显示名，发件人则呈现为"*显示名*\<username@example.com\>"。                                                                                                                                                                                                                               | mrs-job-failed |
   | 企业项目 | 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理，默认项目为default。 该参数针对企业用户使用。                                                                                                                                                                                                                                                                          | default        |
      
   其他更多关于SMN主题创建的参数说明，可参考[创建SMN主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961401.html)。
   
   
4. 单击"确定"，主题创建成功。 
   主题创建成功后，系统会自动生成主题URN，主题URN是主题的唯一资源标识，不可修改。
   新创建的主题将显示在主题列表中，单击主题名称，可查看主题详情信息。
   
   
5. 在主题列表中，选择您要向其添加订阅者的主题，在右侧"操作"栏单击"添加订阅"。 
   图2向SMN主题添加订阅   
   ![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000002308112901.png "点击放大")
   订阅终端参数为订阅的终端地址，短信、邮件终端支持批量输入，批量添加时，每个终端地址占一行。最多可输入10个终端。
   表2主题订阅参数说明 
   | 参数                                       | 描述                                                                                                                                                                                                                                                                 | 配置示例                 |
   |:---|:---|:---|
   | 协议                                       | 选择需要订阅终端支持的协议，例如可通过短信、邮件等方式收取消息。                                                                                                                                                                                                                                   | 邮件                   |
   | 添加方式                                     | 支持"新建订阅"和"导入订阅"两种方式。 - 新建订阅：创建新的订阅。  - 导入订阅：选择已创建且确认订阅的订阅用户，导入订阅数据。   | 新建订阅                 |
   | 订阅终端  | 订阅的终端地址，短信、邮件、HTTP以及HTTPS终端支持批量输入，批量添加时，每个终端地址占一行，最多可输入10个终端。                                                                                                                                                                                                      | username@example.com |
      
   其他更多关于SMN消息订阅的参数说明和限制条件，可参考[订阅SMN主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961402.html)。
   
   
6. 单击"确定"，新增订阅将显示在页面下方的订阅列表中。 
   添加订阅后，消息通知服务会向订阅终端发送订阅确认信息，信息中包含订阅确认的链接。订阅确认的链接在48小时内有效，用户需要及时在手机端、邮箱或其他协议终端确认订阅。
   **订阅状态为"已确认"后，订阅终端才可以正常接收消息。**
   图3查看订阅状态   
   ![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000002273619018.png "点击放大")
   
   
 
#### 配置MRS集群作业消息通知
1. 登录[MRS管理控制台](https://console.huaweicloud.com/mrs/)。
2. 单击集群名称进入集群详情页面。
3. 选择"告警管理 \> 消息订阅规则 \> 添加消息订阅规则"。 
   图4添加消息订阅规则   
   ![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000002185222493.png "点击放大")
   
   
4. 配置向订阅者发送作业执行结果消息的规则，选择"确定"。 
   表3消息订阅规则参数说明 
   | 参数   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 配置示例                |
   |:---|:---|:---|
   | 规则名称 | 用户自定义发送订阅消息的规则名称，只能包含数字、英文字符、中划线和下划线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | default_alert_rule1 |
   | 提醒通知 | 选择开启，将向订阅者发送对应订阅消息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 开启                  |
   | 主题名称 | 选择[创建SMN主题并添加订阅]中已创建的主题，也可以单击"创建主题"重新创建。                                                                                                                                                                                                                                                                                                                                                                                                                                | mrs-job             |
   | 消息类型 | 选择需要上报到SMN的消息类型，作业信息需选择"事件"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 事件                  |
   | 订阅规则 | 选择要订阅的具体事件类型。 1. 单击"提示"前的![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000001925501009.png)。  2. 单击"Manager"前的![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000001925501009.png)。  3. 勾选"作业执行成功"和"作业执行失败"等与作业执行相关的事件。   | 作业执行失败              |
      
   
   
5. 配置作业信息的消息通知后，后续作业执行失败，相关终端即可收取到对应的详细通知。
 
#### 相关文档
- SMN服务可以依据用户的需求主动推送各云服务的通知消息，更多关于SMN服务的介绍，请参考[消息通知服务 SMN](https://support.huaweicloud.com/smn/index.html)。
- MRS集群的各类告警、事件信息可基于SMN服务进行主动推送，相关操作请参考[配置MRS集群告警事件消息通知](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0062.html)。
- MRS管理控制台上，各类型作业的提交配置操作请参考[在MRS集群中提交作业](https://support.huaweicloud.com/usermanual-mrs/mrs_01_300006.html)。
 
