文档中心>消息队列 RocketMQ 版>实践教程>4.x 通用集群 Admin API 使用说明

4.x 通用集群 Admin API 使用说明

最近更新时间:2025-08-21 16:28:22

我的收藏
为了便于自建客户迁移,维持客户原始使用方式不变,TDMQ RocketMQ 4.x 通用集群支持单独开启以下功能:
自动创建 Topic/Group
允许客户使用开源 Admin API 操作集群
使用社区提供的 Prometheus Exporter 采集原始指标


自动创建 Topic/Group

4.x 的通用集群在开启自动创建 Topic/Group 后,用户不需要在控制台事先创建对应资源,客户端 SDK 在执行消息发送/消费操作时,如目标 Topic/Group不存在,RocketMQ 将​​自动按默认配置创建​​相关资源,简化开发流程。
自动创建的 Topic/Group 均使用默认的设置,即 Topic 默认为“普通消息”类型,2 个队列;Group 默认为 TCP 类型,且均不带资源标签。如果要修改配置,用户可以随时在控制台进行修改,详见 Topic 管理Group 管理
注意:
为了保证集群的稳定性,服务端对每个集群的Topic和Group上限做了限制,Topic个数上限为2000,Group个数上限为20000,如果自动创建的Topic 超出这个限额时,客户端新创建Topic时会报错。
当集群的 Topic 数量小于集群的限额后,自动创建的 Topic 也不会收取费用。自动创建的 Topic 如果超出当前集群的限额,超出的自动创建的 Topic 默认将按照小时额外收费,不满一小时按一小时计算,收费规则如下:
超出限额外的自动创建 Topic 数量阶梯
价格(地域:北京、广州、南京、上海、清远、重庆)
价格(地域:中国香港、弗吉尼亚、新加坡、硅谷)
价格(地域:上海金融、上海自动驾驶云)
0-100
0.025 元/个/小时
0.0325 元/个/小时
0.04 元/个/小时
101-200
0.02 元/个/小时
0.026 元/个/小时
0.032 元/个/小时
201-500
0.016 元/个/小时
0.0208 元/个/小时
0.0256 元/个/小时
501-1500
0.0125 元/个/小时
0.01625 元/个/小时
0.02 元/个/小时
1501-2000
0.008 元/个/小时
0.0104 元/个/小时
0.0128 元/个/小时
2000 以上
0.004 元/个/小时
0.0052 元/个/小时
0.0064 元/个/小时

使用 Admin API

4.x 通用集群开启 Admin API 后,在 RocketMQ 控制台的基础信息页可以查看 Admin API 的 AccessKey 和 SecretKey。

在使用 Admin API 时有以下注意事项:
1. 如果用户使用了 Admin API,以及集群的 AccessKey 和 SecretKey 进行了一些大量的 Admin 相关的操作,可能会对集群性能产生一定的影响。建议在云 API 提供的情况下,尽量使用云 API 请求,可以有效的进行一些权限和流量的限制。
2. 用户可以通过社区提供的 Prometheus Exporter 来进行原始指标采集,该采集指标和社区 Exporter 基本保持一致,在集群有大量 Topic 和 Group 的情况下,可能产生指标延迟和性能影响。
3. 随着后续版本迭代,由于权限较大,对新增的相关 Admin 接口风险无法评估的,请提交工单与腾讯云确认。

使用开源社区的 Dashboard

如果在迁移前,您使用了开源社区的 Dashboard,在获取了上述 Admin API 的 AccessKey 和 SecretKey 后,您也可以将当前的通用集群纳管到原先的 Dashboard 管理中。
根据开源社区的指引,部署并运行 RocketMQ Dashboard 项目,在运行时,将启动时的 rocketmq.namesrv.addrport 修改成为 TCP 内网接入地址的域名和端口号。成功运行后,即可使用当前通用集群的 Dashboard,详细使用指南见开源 Dashboard 使用文档

使用开源社区的 Prometheus Exporter

获取了上述 Admin API 的 AccessKey 和 SecretKey 后,客户使用自建的 Prometheus 和原生的 Exporter,查询相应的指标,并定期会对MQ的重试、死信队列、堆积等信息做汇总分析,生成质量月报,详见社区 Exporter 使用指南
TDMQ RocketMQ 提供了更加丰富的指标,并提供了告警功能,推荐使用商业化的指标和告警,详见查看监控告警