本文介绍如何在云消息队列 MQTT 版控制台上管理客户端上下线通知规则。

背景信息

在客户端上线和下线事件触发时,MQTT服务器会根据您配置的客户端上下线通知规则,向后端其他云产品推送一条上下线消息。业务应用一般部署在阿里云的服务器上,业务应用通过向后端云产品订阅这条消息来获取所有客户端的上下线动作。上下线事件流出

使用限制

请参见规则限制

创建上下线通知规则

  1. 登录云消息队列 MQTT 版控制台,并在左侧导航栏单击实例列表
  2. 在顶部菜单栏选择目标地域,然后在实例列表中单击实例名称进入实例详情页面。
  3. 在左侧导航栏单击规则管理,然后在页面左上角,单击创建规则
  4. 创建规则页面完成以下操作。
    1. 配置基本信息配置向导页面,填写规则的基本信息,然后单击下一步
      参数取值示例说明
      规则ID111111规则的全局唯一标识,说明如下:
      • 只能包含字母、数字、短划线(-)和下划线(_),至少包含一个字母或数字。
      • 名称长度限制在3~64字符之间,长于64字符将被自动截取。
      • 创建后无法更新。
      描述migrate from rocketmq对规则的描述。
      状态启用是否启用当前规则,取值说明如下:
      • 启用
      • 停用
      规则类型上下线通知创建的规则类型,取值说明如下:
      • 数据流出:用于将云消息队列 MQTT 版的数据导出至其他阿里云产品。详细信息,请参见跨云产品的数据流出
      • 数据流入:用于将其他阿里云产品的数据导入至云消息队列 MQTT 版。详细信息,请参见跨云产品数据流入
      • 上下线通知:用于将获取的云消息队列 MQTT 版客户端上下线事件数据导出至其他阿里云产品。详细信息,请参见MQTT客户端上下线事件数据流出
    2. 配置规则源配置向导页面,配置数据源,然后单击下一步
      参数取值示例说明
      Group IDGID_Client_Status指定需导出数据的设备组。Group ID的详细信息,请参见名词解释
    3. 配置规则目标配置向导页面,配置数据的流转目标,然后单击创建
      参数取值示例说明
      目标服务类型消息队列 RocketMQ 版指定您需将云消息队列 MQTT 版客户端上下线通知流转至哪个目标云产品。
      说明 当前仅支持云消息队列 RocketMQ 版
      RocketMQ 实例MQ_INST_13801563067*****_BbyOD2jQ指定目标云产品的实例ID,即云消息队列 RocketMQ 版的实例ID。
      说明 仅支持选择和云消息队列 MQTT 版实例为同一地域的云产品实例。
      TopicTopicB指定目标云产品的资源键值,即云消息队列 RocketMQ 版的Topic。云消息队列 MQTT 版客户端上下线通知信息将流转至TopicB。
    您可以在规则管理的规则列表查看到刚创建的上下线通知规则。
说明 云消息队列 MQTT 版云消息队列 RocketMQ 版的消息结构映射信息,请参见MQTT和RocketMQ的消息结构映射

编辑上下线通知规则

  1. 在规则列表,找到您想编辑的规则,并在其操作列选择更多 > 编辑
  2. 编辑规则页面,您可以更新除规则ID以外的所有参数。
  3. 编辑完成后,在配置规则目标向导页面单击保存

删除上下线通知规则

  1. 在规则列表,找到您想删除的规则,并在其操作列选择更多 > 删除
  2. 在弹出的提示对话框,单击确认

启用上下线通知规则

  1. 在规则列表,找到您想启用的规则,并在其操作列选择更多 > 启用
  2. 在弹出的提示对话框,单击确认

停用上下线通知规则

  1. 在规则列表,找到您想停用的规则,并在其操作列选择更多 > 停用
  2. 在弹出的提示对话框,单击确认