全部產品
Search
文件中心

ApsaraMQ for MQTT:上下線通知規則管理

更新時間:Dec 27, 2024

在用戶端上線和下線事件觸發時,MQTT伺服器會根據您配置的用戶端上下線通知規則,向後端其他雲產品推送一條上下線訊息。業務應用一般部署在阿里雲的伺服器上,業務應用通過向後端雲產品訂閱這條訊息來擷取所有用戶端的上下線動作。

流程說明

上下線事件流出

規則限制

限制項

限制值

說明

單一實例規則數量

100

如果預設限制不滿足,請聯絡雲Message QueueTT 版支援人員,DingTalk群號:35228338。

規則去重限制

同一個內部資源同種規則只能建立一個規則。

例如一個Group ID只能建立一個上下線通知規則,一個MQTT Topic只能建立一個資料流入規則和一個資料流出規則。

地區限制

不支援跨地區建立規則,規則的資料來源和資料目標所屬的執行個體必須處於同一地區。

例如,建立資料流出規則,資料來源雲Message QueueTT 版執行個體屬於華東1(杭州)地區,則資料目標雲訊息佇列 RocketMQ 版只能選擇華東1(杭州)地區的執行個體。

雲Message QueueTT 版執行個體版本

僅核心版本為V3.x.x的執行個體支援使用規則,V2.x.x的執行個體不支援使用規則。

雲Message QueueTT 版執行個體的核心版本可在控制台執行個體列表或執行個體詳情頁面查看。

雲訊息佇列 RocketMQ 版執行個體版本

僅4.0系列執行個體支援

雲Message QueueTT 版雲訊息佇列 RocketMQ 版通過訊息流程入或訊息流程出規則進行資料互連時,雲訊息佇列 RocketMQ 版僅4.0系列執行個體支援訊息流程入或流出規則,5.0系列執行個體不支援。

建立上下線通知規則

  1. 登入雲Message QueueTT 版控制台,並在左側導覽列單擊实例列表

  2. 在頂部功能表列選擇目標地區,然後在執行個體列表中單擊執行個體名稱進入实例详情頁面。

  3. 在左側導覽列單擊规则管理,然後在頁面左上方,單擊创建规则
  4. 创建规则頁面完成以下操作。
    1. 配置基本信息設定精靈頁面,填寫規則的基本資料,然後單擊下一步
      參數取值樣本說明
      規則ID111111規則的全域唯一標識,說明如下:
      • 只能包含字母、數字、短劃線(-)和底線(_),至少包含一個字母或數字。
      • 名稱長度限制在3~64字元之間,長於64字元將被自動截取。
      • 建立後無法更新。
      描述migrate from rocketmq對規則的描述。
      狀態啟用是否啟用當前規則,取值說明如下:
      • 啟用
      • 停用
      規則類型上下線通知建立的規則類型,取值說明如下:
      • 資料流出:用於將雲Message QueueTT 版的資料匯出至其他阿里雲產品。詳細資料,請參見跨雲產品的資料流出
      • 資料流入:用於將其他阿里雲產品的資料匯入至雲Message QueueTT 版。詳細資料,請參見跨雲產品資料流入
      • 上下線通知:用於將擷取的雲Message QueueTT 版用戶端上下線事件數目據匯出至其他阿里雲產品。詳細資料,請參見MQTT用戶端上下線事件數目據流出
    2. 配置规则源設定精靈頁面,配置資料來源,然後單擊下一步
      參數取值樣本說明
      Group IDGID_Client_Status指定需匯出資料的裝置群組。Group ID的詳細資料,請參見名詞解釋
    3. 配置规则目标設定精靈頁面,配置資料的流轉目標,然後單擊创建
      參數取值樣本說明
      目標服務類型訊息佇列 RocketMQ 版指定您需將雲Message QueueTT 版用戶端上下線通知流轉至哪個目標雲產品。
      說明 當前僅支援雲訊息佇列 RocketMQ 版
      RocketMQ 執行個體MQ_INST_13801563067*****_BbyOD2jQ指定目標雲產品的執行個體ID,即雲訊息佇列 RocketMQ 版的執行個體ID。
      說明 僅支援選擇和雲Message QueueTT 版執行個體為同一地區的雲產品執行個體。
      TopicTopicB指定目標雲產品的資源索引值,即雲訊息佇列 RocketMQ 版的Topic。雲Message QueueTT 版用戶端上下線通知資訊將流轉至TopicB。
    您可以在规则管理的規則列表查看到剛建立的上下線通知規則。
說明 雲Message QueueTT 版雲訊息佇列 RocketMQ 版的訊息結構映射資訊,請參見MQTT和RocketMQ的訊息結構映射

編輯上下線通知規則

  1. 在規則列表,找到您想編輯的規則,並在其操作列選擇更多 > 编辑
  2. 编辑规则頁面,您可以更新除規則ID以外的所有參數。
  3. 編輯完成後,在配置规则目标嚮導頁面單擊保存

刪除上下線通知規則

  1. 在規則列表,找到您想刪除的規則,並在其操作列選擇更多 > 删除
  2. 在彈出的提示對話方塊,單擊確認

啟用上下線通知規則

  1. 在規則列表,找到您想啟用的規則,並在其操作列選擇更多 > 启用
  2. 在彈出的提示對話方塊,單擊確認

停用上下線通知規則

  1. 在規則列表,找到您想停用的規則,並在其操作列選擇更多 > 停用
  2. 在彈出的提示對話方塊,單擊確認