tencent cloud

消息队列 RocketMQ 版

动态与公告
新功能发布记录
公告
产品简介
产品概述
什么是消息队列 RocketMQ 版
产品优势
应用场景
产品系列
开源对比
高可用
使用限制
开服地域
基本概念
产品计费
计费概述
价格说明
计费示例
切换集群计费模式(5.x)
续费说明
查看消费明细
退费说明
欠费说明
快速入门
快速入门概述
准备工作
步骤1:创建 RocketMQ 资源
步骤2:使用 SDK 收发消息(推荐)
步骤2:运行 RocketMQ 客户端(可选)
步骤3:查询消息
步骤4:销毁资源
用户指南
使用流程指引
配置账号权限
新建集群
命名空间管理
配置 Topic
配置 Group
连接集群
管理消息
管理集群
查看监控和配置告警
跨集群复制消息
实践教程
RocketMQ 常见概念命名规范
RocketMQ 客户端实践
RocketMQ 性能压测和容量评估
使用社区版 HTTP SDK 接入
客户端风险说明和更新指南
关于 RocketMQ 4.x 集群角色(Role)相关云 API 迁移指引
迁移指南
有感迁移
无感迁移
开发指南
消息类型
消息过滤
消息重试
POP 消费模式(5.x)
集群消费与广播消费
订阅关系一致性
限流
API 参考(5.x)
History
API Category
Making API Requests
Topic APIs
Consumer Group APIs
Message APIs
Role Authentication APIs
Hitless Migration APIs
Cloud Migration APIs
Cluster APIs
Data Types
Error Codes
API 参考(4.x)
SDK 参考
SDK 概述
5.x SDK
4.x SDK
安全与合规
权限管理
云 API 审计
删除保护
常见问题
4.x 实例常见问题
服务协议
服务等级协议
联系我们

消息轨迹与说明

PDF
聚焦模式
字号
最后更新时间: 2026-01-23 16:50:32
消息轨迹记录了消息从生产端到 TDMQ RocketMQ 版服务端,最后到消费端的整个过程,包括各阶段的时间(精确到微秒)、执行结果、生产者 IP、消费者 IP 等。

前提条件

您已经参见 SDK 文档 部署好生产端和消费端服务,并在3天内有消息生产和消费。
如果您使用的是 5.0 及以上版本的 gRPC 客户端进行消息的生产和消费,则无需在客户端另行开启轨迹开关。
如果您使用的是 4.x 版本的客户端,或者 5.0 以上版本的 Remoting 客户端,则需要在客户端来设置开启消息轨迹功能,具体设置示例如下:
更多关于客户端的说明请参见 社区客户端说明
生产者设置
Push 消费者设置
Pull 消费者设置
Spring Boot Starter 接入(2.2.2版本及以上)
DefaultMQProducer producer = new DefaultMQProducer(namespace, groupName,
// ACL权限
new AclClientRPCHook(new SessionCredentials(AK, SK)), true, null);
// 实例化消费者
DefaultMQPushConsumer pushConsumer = new DefaultMQPushConsumer(NAMESPACE,groupName,
new AclClientRPCHook(new SessionCredentials(AK, SK)),
new AllocateMessageQueueAveragely(), true, null);
DefaultLitePullConsumer pullConsumer = new DefaultLitePullConsumer(NAMESPACE,groupName,
new AclClientRPCHook(new SessionCredentials(AK, SK)));
// 设置NameServer的地址
pullConsumer.setNamesrvAddr(NAMESERVER);
pullConsumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_LAST_OFFSET);
pullConsumer.setAutoCommit(false);
pullConsumer.setEnableMsgTrace(true);
pullConsumer.setCustomizedTraceTopic(null);
package com.lazycece.sbac.rocketmq.messagemodel;

import lombok.extern.slf4j.Slf4j;
import org.apache.rocketmq.spring.annotation.MessageModel;
import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Component;

/**
* @author lazycece
* @date 2019/8/21
*/
@Slf4j
@Component
public class MessageModelConsumer {

@Component
@RocketMQMessageListener(
topic = "topic-message-model",
consumerGroup = "message-model-consumer-group",
enableMsgTrace = true,
messageModel = MessageModel.CLUSTERING)
public class ConsumerOne implements RocketMQListener<String> {
@Override
public void onMessage(String message) {
log.info("ConsumerOne: {}", message);
}
}

}

消息轨迹查询结果说明

消息轨迹查询出来的结果分为三段:消息生产、消息存储和消息消费。

消息生产

参数
说明
生产地址
对应生产者的地址以及端口。
生产时间
TDMQ RocketMQ 版服务端确认接收到消息的时间,精确到毫秒。
发送耗时
消息从生产端发送到 TDMQ RocketMQ 版服务端的时间消耗,精确到微秒。
生产状态
表示消息生产成功或失败,如果状态为失败一般是消息在发送过程中遇到了头部数据部分丢失,以上几个字段可能会为空值。

消息存储

参数
说明
存储时间
消息被持久化的时间。
存储状态
表示消息持久化成功或失败,如果状态为失败则表明消息未落盘成功,可能由于底层磁盘损坏或无多余容量导致,遇见此类情况需尽快提交工单咨询。

消息消费

消息消费是以列表形式呈现的,TDMQ RocketMQ 版支持集群消费和广播消费两种消费模式。
列表中展示的信息说明:
参数
说明
消费组名称
消费组的名称。
消费模式
消费组的消费模式,支持集群消费和广播消费两种模式。
推送次数
TDMQ RocketMQ 版服务端向消费者投递该消息的次数。
最后推送时间
TDMQ RocketMQ 版服务端最后一次向消费者投递该消息的时间。
消费结束时间
TDMQ RocketMQ 版服务端接收到消费者回复确认信息的时间。
消费耗时
TDMQ RocketMQ 版服务端第一次向消费者投递该消息到接收到消费者回复确认信息的时间。
消费状态
已推送未确认:TDMQ RocketMQ 版服务端已向消费者投递消息,未接收到消费者回复的确认消息。
已消费:消费者回复确认信息(ACK)到 TDMQ RocketMQ 版服务端,服务端接收到确认信息。
转入重试:已超时,服务端仍未接收到确认信息,将再次投递消息。
已重试未确认:TDMQ RocketMQ 版服务端已再次向消费者投递消息,未接收到消费者回复的确认消息。
已转入死信队列:消息经过一定重试次数后仍未能被正常消费,被投递至死信队列。
说明:如果消费模式为广播模式,则消费状态只有已推送一种。
单击订阅名称左方的右三角,查看服务端每次推送消息的详情。
参数
说明
推送次序
TDMQ RocketMQ 版服务端第几次向消费者投递该消息。
消费地址
收到消息的消费者地址及端口。
开始消费时间
TDMQ RocketMQ 版服务端向消费者投递该消息的时间。
消费结束时间
TDMQ RocketMQ 版服务端接收到消费者回复确认信息的时间。
消费耗时
TDMQ RocketMQ 版服务端向消费者投递该消息到接收到消费者回复确认信息的时间。
消费状态
已推送未确认:TDMQ RocketMQ 版服务端已向消费者投递消息,未接收到消费者回复的确认消息。
已消费:消费者回复确认信息(ACK)到 TDMQ RocketMQ 版服务端,服务端接收到确认信息。
转入重试:已超时,服务端仍未接收到确认信息,将再次投递消息。
已重试未确认:TDMQ RocketMQ 版服务端已再次向消费者投递消息,未接收到消费者回复的确认消息。
已转入死信队列:消息经过一定重试次数后仍未能被正常消费,被投递至死信队列。
页面死信重投完成:在死信队列重发页面上,用户已经将死信消息重新投递到原队列的重试队列中。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈