操作场景
在成功创建 MQTT 集群后,您可以通过控制台随时查看和调整集群的基本信息,包括集群名称、描述说明、资源标签、接入地址等,确保集群配置始终符合您的业务需求。本文将介绍如何在控制台中查看集群的基本信息,并对这些基础配置项进行修改和管理。
查看集群基本信息
1. 登录 MQTT 控制台。
2. 在左侧导航栏选择资源管理 > 集群管理,选择好地域后,可以查看集群列表信息。
TDMQ MQTT 版集群的生命周期是指集群从启动到释放所经历的状态。通过对集群从启动到删除期间的合理的管理,可确保运行于集群上的应用程序能高效经济地提供服务。集群有以下状态:
状态名 | 状态属性 | 状态描述 |
创建中 | 中间状态 | 集群创建后,进入运行中之前的状态。 |
正在运行(健康/告警) | 稳定状态 | 集群正常运行状态,表明您的节点状况、磁盘利用率等指标都处于正常范围内。 |
迁移中 | 中间状态 | 集群调整配置时,在进行数据迁移。 |
删除中 | 中间状态 | 集群通过控制台或通过 API 执行删除操作。 |
已隔离 | 中间状态 | 集群已经欠费,进入隔离状态。处于已隔离状态的集群不能生产和消费,已保存在集群内的数据和配置不会被删除。 |
创建失败 | 中间状态 | |
删除失败 | 稳定状态 | 集群被手动删除或者在到期7天后未进行续费,TDMQ MQTT 版执行资源释放时失败。 |
3. 单击目标集群的 ID,在基本信息页,可查看集群的基本信息、集群概况、健康状态、接入信息和客户端配置等信息。
分类 | 说明 |
基本配置 | 展示集群的基本配置信息,您可以在此模块根据实际业务需求调整部分参数。 |
高级配置 | 在此模块您可以调整客户端限流配置。 |
运行概览 | 展示集群当前整体的资源使用情况和消息生产消费情况,您可以通过这些指标了解集群整体的运行状态,若发现生产消费速率异常波动等情况,表明集群可能面临性能压力或存在潜在问题,需要及时进行扩容优化或问题排查,以确保消息服务的稳定性和可用性。 |
接入信息 | |
认证配置 | 展示当前集群的认证相关配置与状态。 |

修改集群的基本信息
在集群的基本信息页面,您可以对以下参数进行修改。
参数 | 修改方式 |
集群名称和说明 | 单击“说明”旁的编辑按钮,输入集群名称和说明信息后,单击提交。 集群名称:名称需符合命名规则:3-64个字符,只能包含字母、数字、'-'及'_'。 集群说明:集群说明不能超过128个字符。 |
资源标签 |
高级配置
在集群的基本信息页面包含客户端配置模块,支持对集群配置的精细化管理。

配置项 | 说明 |
客户端限流 | 对单客户端的消息发布速率进行限制,防止异常或突增流量。 |
消息 Hash 策略 | 决定共享订阅组内消息如何分配给多个消费客户端。基于 Topic 哈希可保证同一 Topic 消息的顺序性;基于 Client ID 哈希按客户端维度分配。默认策略为基于 Topic 哈希。 |
Token 过期后操作 | 当客户端认证 Token 过期时,对其已建立连接的处理方式。可根据自身安全策略自定义,默认为过期后断开已有连接。 |
系统时间方言 | |
自动响应 | 结合消息增强规则使用,为 MQTT 3.x 版本的客户端提供 Request-Response 交互能力。 |
删除保护 | 启用后,MQTT 集群将无法被删除,需关闭删除保护开关后才能删除集群(集群欠费停服或到期未续费等情况除外)。 |