管理 Pulsar 通知

区别于业务数据通道 Topic ${clientId}/out/event，Pulsar 通知采用独立的 Pulsar 通道，它的 Topic 是 ${clientId}/out/notice，不受业务通道的影响，可以准实时地接收各类高优先级非业务事件。

例如，如果 ${clientId}/out/event 通道发生堆积告警，涂鸦会向 Pulsar 通知通道里推送一条堆积消息，方便您后续自定义处理。相较于之前的短信和邮件告警，Pulsar 通知更加灵活。

开通方式

1. 登录 涂鸦开发者平台。

2. 找到目标项目后，单击 操作 栏的 进入项目。

   

3. 在 消息订阅 页签，单击下方的 开启。

   

4. 在弹出的 配置订阅消息参数 窗口中，勾选 Pulsar 报警订阅，设置堆积报警阈值和间隔后，单击 确定。

   
   上图设置含义是当业务 Topic ${clientId}/out/event 堆积条数大于 2,000 时，每隔 15 分钟会向您推送一条 Pulsar 消息，直到堆积条数不超过阈值 2,000 为止。

数据签名

数据签名和消息格式是与之前业务 Topic ${clientId}/out/event 完全一致。更多信息，参考 数据签名。

Pulsar 通知协议号

消息格式

• bizData 数据体说明

  Code	数据类型	描述
  eventType	String	事件类型
  eventData	Json	堆积具体信息

• eventData 数据体说明

  Code	数据类型	描述
  dataCenter	String	堆积对应的数据中心
  topic	String	堆积主题
  subscription	String	堆积主题的订阅者名称
  backLogNum	String	堆积条数

• 数据示例

  {
   "bizCode": "HighPriorityNotice",
   "bizData": {
       "eventData": "{\"dataCenter\":\"AY\",\"topic\":\"****/out/event\",\"subscription\":\"****-sub\",\"backLogNum\":2004}",
       "eventType": "pulsar_backlog_notice"
   },
   "ts": 1722432061033
  }
  

订阅方式

需要将 SDK 里面的 Topic 改为 ${clientId}/out/notice，即可接收到 Pulsar 消息。当出现堆积时，涂鸦会推送消息给开发者。更多信息，参考 最佳实践。