RocketMQ消息轨迹-设计篇

目录

• 一、消息轨迹数据格式
• 二、记录消息轨迹
• 三、如何存储消息轨迹数据

@(本节目录)
RocketMQ消息轨迹主要包含两篇文章：设计篇与源码分析篇，本节将详细介绍RocketMQ消息轨迹-设计相关。

RocketMQ消息轨迹，主要跟踪消息发送、消息消费的轨迹，即详细记录消息各个处理环节的日志，从设计上至少须要解决以下三个核心问题：

• 消费轨迹数据格式
• 记录消息轨迹(消息日志)
• 消息轨迹数据存储在哪？

一、消息轨迹数据格式

RocketMQ4.5版本消息轨迹主要记录以下信息：

• traceType
  跟踪类型，可选值：Pub(消息发送)、SubBefore(消息拉取到客户端，执行业务定义的消费逻辑以前)、SubAfter(消费后)。
• timeStamp
  当前时间戳。
• regionId
  broker所在的区域ID，取自BrokerConfig#regionId。
• groupName
  组名称，traceType为Pub时为生产者组的名称；若是traceType为subBefore或subAfter时为消费组名称。
• requestId
  traceType为subBefore、subAfter时使用，消费端的请求Id。
• topic
  消息主题。
• msgId
  消息惟一ID。
• tags
  消息tag。
• keys
  消息索引key，根据该key可快速检索消息。
• storeHost
  跟踪类型为PUB时为存储该消息的Broker服务器IP；跟踪类型为subBefore、subAfter时为消费者IP。
• bodyLength
  消息体的长度。
• costTime
  耗时。
• msgType
  消息的类型，可选值：Normal_Msg(普通消息),Trans_Msg_Half(预提交消息),Trans_msg_Commit(提交消息),Delay_Msg(延迟消息)。
• offsetMsgId
  消息偏移量ID,该ID中包含了broker的ip以及偏移量。
• success
  是发送成功。
• contextCode
  消费状态码，可选值：SUCCESS,TIME_OUT,EXCEPTION,RETURNNULL,FAILED。

二、记录消息轨迹

消息中间件的两大核心主题：消息发送、消息消费，其核心载体就是消息，消息轨迹（消息的流转）主要是记录消息是什么时候发送到哪台Broker，发送耗时多少时间，在什么是被哪一个消费者消费。记录消息的轨迹主要是集中在消息发送先后、消息消费先后，能够经过RokcetMQ的Hook机制。经过以下两个接口来定义钩子函数。

经过实行上述两个接口，能够实如今消息发送、消息消费先后记录消息轨迹，为了避免明显增长消息发送与消息消费的时延，记录消息轨迹最好使用异步发送模式。

三、如何存储消息轨迹数据

消息轨迹须要存储什么消息以及在何时记录消息轨迹的问题都以及解决，那接下来就得思考将消息轨迹存储在哪里？存储在数据库中或其余媒介中，都会加剧消息中间件，使其依赖外部组件，最佳的选择仍是存储在Broker服务器中，将消息轨迹数据也当成一条消息存储到Broker服务器。

既然把消息轨迹当成消息存储在Broker服务器，那存储消息轨迹的Topic如何肯定呢？RocketMQ提供了两种方法来定义消息轨迹的Topic。

• 系统默认Topic
  若是Broker的traceTopicEnable配置设置为true，表示在该Broker上建立topic名为：RMQ_SYS_TRACE_TOPIC，队列个数为1，默认该值为false，表示该Broker不承载系统自定义用于存储消息轨迹的topic。
• 自定义Topic
  在建立消息生产者或消息消费者时，能够经过参数自定义用于记录消息轨迹的Topic名称，不过要注意的是，rokcetmq控制台(rocketmq-console)中只支持配置一个消息轨迹Topic，故自定义Topic，在目前这个阶段或许还不是一个最佳实践，建议使用系统默认的Topic便可。

一般为了不消息轨迹的数据与正常的业务数据混合在一块儿，官方建议，在Broker集群中，新增长一台机器，只在这台机器上开启消息轨迹跟踪，这样该集群内的消息轨迹数据只会发送到这一台Broker服务器上，并不会增长集群内原先业务Broker的负载压力。

RocketMQ消息轨迹的设计细节就介绍到这里了，下一篇将从源码的角度对其实现细节进行详细的剖析；若是以为本文对您有帮助的话，期待您的点赞，谢谢。

---

做者介绍：
丁威，《RocketMQ技术内幕》做者，RocketMQ 社区布道师，公众号：中间件兴趣圈 维护者，目前已陆续发表源码分析Java集合、Java 并发包(JUC)、Netty、Mycat、Dubbo、RocketMQ、Mybatis等源码专栏。