You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

353 lines
24 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 06 | 请求通道如何实现Kafka请求队列
你好,我是胡夕。日志模块我们已经讲完了,你掌握得怎样了呢?如果你在探索源码的过程中碰到了问题,记得在留言区里写下你的困惑,我保证做到知无不言。
现在让我们开启全新的“请求处理模块”的源码学习之旅。坦率地讲这是我自己给Kafka源码划分的模块在源码中可没有所谓的“请求处理模块”的提法。但我始终觉得这样划分能够帮助你清晰地界定不同部分的源码的作用可以让你的阅读更有针对性学习效果也会事半功倍。
在这个模块我会带你了解请求处理相关的重点内容包括请求处理通道、请求处理全流程分析和请求入口类分析等。今天我们先来学习下Kafka是如何实现请求队列的。源码中位于core/src/main/scala/kafka/network下的RequestChannel.scala文件是主要的实现类。
当我们说到Kafka服务器端也就是Broker的时候往往会说它承担着消息持久化的功能但本质上它其实就是**一个不断接收外部请求、处理请求然后发送处理结果的Java进程**。
你可能会觉得奇怪Broker不是用Scala语言编写的吗怎么这里又是Java进程了呢这是因为Scala代码被编译之后生成.class文件它和Java代码被编译后的效果是一样的因此Broker启动后也仍然是一个普通的Java进程。
**高效地保存排队中的请求是确保Broker高处理性能的关键**。既然这样那你一定很想知道Broker上的请求队列是怎么实现的呢接下来我们就一起看下**Broker底层请求对象的建模**和**请求队列的实现原理**以及Broker**请求处理方面的核心监控指标**。
目前Broker与Clients进行交互主要是基于Request/Response机制所以我们很有必要学习一下源码是如何建模或定义Request和Response的。
## 请求Request
我们先来看一下RequestChannel源码中的Request定义代码。
```
sealed trait BaseRequest
case object ShutdownRequest extends BaseRequest
class Request(val processor: Int,
val context: RequestContext,
val startTimeNanos: Long,
memoryPool: MemoryPool,
@volatile private var buffer: ByteBuffer,
metrics: RequestChannel.Metrics) extends BaseRequest {
......
}
```
简单提一句Scala语言中的“trait”关键字大致类似于Java中的interface接口。从代码中我们可以知道BaseRequest是一个trait接口定义了基础的请求类型。它有两个实现类**ShutdownRequest类**和**Request类**。
ShutdownRequest仅仅起到一个标志位的作用。当Broker进程关闭时请求处理器RequestHandler在第9讲我会具体讲到它会发送ShutdownRequest到专属的请求处理线程。该线程接收到此请求后会主动触发一系列的Broker关闭逻辑。
Request则是真正定义各类Clients端或Broker端请求的实现类。它定义的属性包括processor、context、startTimeNanos、memoryPool、buffer和metrics。下面我们一一来看。
### processor
processor是Processor线程的序号即**这个请求是由哪个Processor线程接收处理的**。Broker端参数num.network.threads控制了Broker每个监听器上创建的Processor线程数。
假设你的listeners配置为PLAINTEXT://localhost:9092,SSL://localhost:9093那么在默认情况下Broker启动时会创建6个Processor线程每3个为一组分别给listeners参数中设置的两个监听器使用每组的序号分别是0、1、2。
你可能会问为什么要保存Processor线程序号呢这是因为当Request被后面的I/O线程处理完成后还要依靠Processor线程发送Response给请求发送方因此Request中必须记录它之前是被哪个Processor线程接收的。另外这里我们要先明确一点**Processor线程仅仅是网络接收线程不会执行真正的Request请求处理逻辑**那是I/O线程负责的事情。
### context
**context是用来标识请求上下文信息的**。Kafka源码中定义了RequestContext类顾名思义它保存了有关Request的所有上下文信息。RequestContext类定义在clients工程中下面是它主要的逻辑代码。我用注释的方式解释下主体代码的含义。
```
public class RequestContext implements AuthorizableRequestContext {
public final RequestHeader header; // Request头部数据主要是一些对用户不可见的元数据信息如Request类型、Request API版本、clientId等
public final String connectionId; // Request发送方的TCP连接串标识由Kafka根据一定规则定义主要用于表示TCP连接
public final InetAddress clientAddress; // Request发送方IP地址
public final KafkaPrincipal principal; // Kafka用户认证类用于认证授权
public final ListenerName listenerName; // 监听器名称可以是预定义的监听器如PLAINTEXT也可自行定义
public final SecurityProtocol securityProtocol; // 安全协议类型目前支持4种PLAINTEXT、SSL、SASL_PLAINTEXT、SASL_SSL
public final ClientInformation clientInformation; // 用户自定义的一些连接方信息
// 从给定的ByteBuffer中提取出Request和对应的Size值
public RequestAndSize parseRequest(ByteBuffer buffer) {
......
}
// 其他Getter方法
......
}
```
### startTimeNanos
**startTimeNanos记录了Request对象被创建的时间主要用于各种时间统计指标的计算**
请求对象中的很多JMX指标特别是时间类的统计指标都需要使用startTimeNanos字段。你要注意的是**它是以纳秒为单位的时间戳信息,可以实现非常细粒度的时间统计精度**。
### memoryPool
memoryPool表示源码定义的一个非阻塞式的内存缓冲区主要作用是**避免Request对象无限使用内存**。
当前该内存缓冲区的接口类和实现类分别是MemoryPool和SimpleMemoryPool。你可以重点关注下SimpleMemoryPool的tryAllocate方法看看它是怎么为Request对象分配内存的。
### buffer
buffer是真正保存Request对象内容的字节缓冲区。Request发送方必须按照Kafka RPC协议规定的格式向该缓冲区写入字节否则将抛出InvalidRequestException异常。**这个逻辑主要是由RequestContext的parseRequest方法实现的**。
```
public RequestAndSize parseRequest(ByteBuffer buffer) {
if (isUnsupportedApiVersionsRequest()) {
// 不支持的ApiVersions请求类型被视为是V0版本的请求并且不做解析操作直接返回
ApiVersionsRequest apiVersionsRequest = new ApiVersionsRequest(new ApiVersionsRequestData(), (short) 0, header.apiVersion());
return new RequestAndSize(apiVersionsRequest, 0);
} else {
// 从请求头部数据中获取ApiKeys信息
ApiKeys apiKey = header.apiKey();
try {
// 从请求头部数据中获取版本信息
short apiVersion = header.apiVersion();
// 解析请求
Struct struct = apiKey.parseRequest(apiVersion, buffer);
AbstractRequest body = AbstractRequest.parseRequest(apiKey, apiVersion, struct);
// 封装解析后的请求对象以及请求大小返回
return new RequestAndSize(body, struct.sizeOf());
} catch (Throwable ex) {
// 解析过程中出现任何问题都视为无效请求,抛出异常
throw new InvalidRequestException("Error getting request for apiKey: " + apiKey +
", apiVersion: " + header.apiVersion() +
", connectionId: " + connectionId +
", listenerName: " + listenerName +
", principal: " + principal, ex);
}
}
}
```
就像前面说过的,这个方法的主要目的是**从ByteBuffer中提取对应的Request对象以及它的大小**。
首先代码会判断该Request是不是Kafka不支持的ApiVersions请求版本。如果是不支持的就直接构造一个V0版本的ApiVersions请求然后返回。否则的话就继续下面的代码。
这里我稍微解释一下ApiVersions请求的作用。当Broker接收到一个ApiVersionsRequest的时候它会返回Broker当前支持的请求类型列表包括请求类型名称、支持的最早版本号和最新版本号。如果你查看Kafka的bin目录的话你应该能找到一个名为kafka-broker-api-versions.sh的脚本工具。它的实现原理就是构造ApiVersionsRequest对象然后发送给对应的Broker。
你可能会问如果是ApiVersions类型的请求代码中为什么要判断一下它的版本呢这是因为和处理其他类型请求不同的是Kafka必须保证版本号比最新支持版本还要高的ApiVersions请求也能被处理。这主要是考虑到了客户端和服务器端版本的兼容问题。客户端发送请求给Broker的时候很可能不知道Broker到底支持哪些版本的请求它需要使用ApiVersionsRequest去获取完整的请求版本支持列表。但是如果不做这个判断Broker可能无法处理客户端发送的ApiVersionsRequest。
通过这个检查之后代码会从请求头部数据中获取ApiKeys信息以及对应的版本信息然后解析请求最后封装解析后的请求对象以及请求大小并返回。
### metrics
metrics是Request相关的各种监控指标的一个管理类。它里面构建了一个Map封装了所有的请求JMX指标。除了上面这些重要的字段属性之外Request类中的大部分代码都是与监控指标相关的后面我们再详细说。
## 响应Response
说完了Request代码我们再来说下Response。Kafka为Response定义了1个抽象父类和5个具体子类如下图所示
![](https://static001.geekbang.org/resource/image/a0/6a/a03ecdba3c118efbc3910b5a1badc96a.jpg)
看到这么多类,你可能会有点蒙,这些都是干吗的呢?别着急,现在我分别给你介绍下各个类的作用。
* Response定义Response的抽象基类。每个Response对象都包含了对应的Request对象。这个类里最重要的方法是onComplete方法用来实现每类Response被处理后需要执行的回调逻辑。
* SendResponseKafka大多数Request处理完成后都需要执行一段回调逻辑SendResponse就是保存返回结果的Response子类。里面最重要的字段是**onCompletionCallback**,即**指定处理完成之后的回调逻辑**。
* NoResponse有些Request处理完成后无需单独执行额外的回调逻辑。NoResponse就是为这类Response准备的。
* CloseConnectionResponse用于出错后需要关闭TCP连接的场景此时返回CloseConnectionResponse给Request发送方显式地通知它关闭连接。
* StartThrottlingResponse用于通知Broker的Socket Server组件后面几节课我会讲到它某个TCP连接通信通道开始被限流throttling
* EndThrottlingResponse与StartThrottlingResponse对应通知Broker的SocketServer组件某个TCP连接通信通道的限流已结束。
你可能又会问了“这么多类我都要掌握吗”其实是不用的。你只要了解SendResponse表示正常需要发送Response而NoResponse表示无需发送Response就可以了。至于CloseConnectionResponse它是用于标识关闭连接通道的Response。而后面两个Response类不是很常用它们仅仅在对Socket连接进行限流时才会派上用场这里我就不具体展开讲了。
Okay现在我们看下Response相关的代码部分。
```
abstract class Response(val request: Request) {
locally {
val nowNs = Time.SYSTEM.nanoseconds
request.responseCompleteTimeNanos = nowNs
if (request.apiLocalCompleteTimeNanos == -1L)
request.apiLocalCompleteTimeNanos = nowNs
}
def processor: Int = request.processor
def responseString: Option[String] = Some("")
def onComplete: Option[Send => Unit] = None
override def toString: String
}
```
这个抽象基类只有一个属性字段request。这就是说**每个Response对象都要保存它对应的Request对象**。我在前面说过onComplete方法是调用指定回调逻辑的地方。SendResponse类就是复写Override了这个方法如下所示
```
class SendResponse(request: Request,
val responseSend: Send,
val responseAsString: Option[String],
val onCompleteCallback: Option[Send => Unit])
extends Response(request) {
......
override def onComplete: Option[Send => Unit] = onCompleteCallback
}
```
这里的SendResponse类继承了Response父类并重新定义了onComplete方法。复写的逻辑很简单就是指定输入参数onCompleteCallback。其实方法本身没有什么可讲的反倒是这里的Scala语法值得多说几句。
Scala中的Unit类似于Java中的void而“Send => Unit”表示一个方法。这个方法接收一个Send类实例然后执行一段代码逻辑。Scala是函数式编程语言函数在Scala中是“一等公民”因此你可以把一个函数作为一个参数传给另一个函数也可以把函数作为结果返回。这里的onComplete方法就应用了第二种用法也就是把函数赋值给另一个函数并作为结果返回。这样做的好处在于你可以灵活地变更onCompleteCallback来实现不同的回调逻辑。
## RequestChannel
RequestChannel顾名思义就是传输Request/Response的通道。有了Request和Response的基础下面我们可以学习RequestChannel类的实现了。
我们先看下RequestChannel类的定义和重要的字段属性。
```
class RequestChannel(val queueSize: Int, val metricNamePrefix : String) extends KafkaMetricsGroup {
import RequestChannel._
val metrics = new RequestChannel.Metrics
private val requestQueue = new ArrayBlockingQueue[BaseRequest](queueSize)
private val processors = new ConcurrentHashMap[Int, Processor]()
val requestQueueSizeMetricName = metricNamePrefix.concat(RequestQueueSizeMetric)
val responseQueueSizeMetricName = metricNamePrefix.concat(ResponseQueueSizeMetric)
......
}
```
RequestChannel类实现了KafkaMetricsGroup trait后者封装了许多实用的指标监控方法比如newGauge方法用于创建数值型的监控指标newHistogram方法用于创建直方图型的监控指标。
**就RequestChannel类本身的主体功能而言它定义了最核心的3个属性requestQueue、queueSize和processors**。下面我分别解释下它们的含义。
每个RequestChannel对象实例创建时会定义一个队列来保存Broker接收到的各类请求这个队列被称为请求队列或Request队列。Kafka使用**Java提供的阻塞队列ArrayBlockingQueue**实现这个请求队列并利用它天然提供的线程安全性来保证多个线程能够并发安全高效地访问请求队列。在代码中这个队列由变量requestQueue定义。
而字段queueSize就是Request队列的最大长度。当Broker启动时SocketServer组件会创建RequestChannel对象并把Broker端参数queued.max.requests赋值给queueSize。因此在默认情况下每个RequestChannel上的队列长度是500。
字段processors封装的是RequestChannel下辖的Processor线程池。每个Processor线程负责具体的请求处理逻辑。下面我详细说说Processor的管理。
### Processor管理
上面代码中的第六行创建了一个Processor线程池——当然它是用Java的ConcurrentHashMap数据结构去保存的。Map中的Key就是前面我们说的processor序号而Value则对应具体的Processor线程对象。
这个线程池的存在告诉了我们一个事实:**当前Kafka Broker端所有网络线程都是在RequestChannel中维护的**。既然创建了线程池代码中必然要有管理线程池的操作。RequestChannel中的addProcessor和removeProcessor方法就是做这些事的。
```
def addProcessor(processor: Processor): Unit = {
// 添加Processor到Processor线程池
if (processors.putIfAbsent(processor.id, processor) != null)
warn(s"Unexpected processor with processorId ${processor.id}")
newGauge(responseQueueSizeMetricName,
() => processor.responseQueueSize,
// 为给定Processor对象创建对应的监控指标
Map(ProcessorMetricTag -> processor.id.toString))
}
def removeProcessor(processorId: Int): Unit = {
processors.remove(processorId) // 从Processor线程池中移除给定Processor线程
removeMetric(responseQueueSizeMetricName, Map(ProcessorMetricTag -> processorId.toString)) // 移除对应Processor的监控指标
}
```
代码很简单基本上就是调用ConcurrentHashMap的putIfAbsent和remove方法分别实现增加和移除线程。每当Broker启动时它都会调用addProcessor方法向RequestChannel对象添加num.network.threads个Processor线程。
如果查询Kafka官方文档的话你就会发现num.network.threads这个参数的更新模式Update Mode是Cluster-wide。这就说明Kafka允许你动态地修改此参数值。比如Broker启动时指定num.network.threads为8之后你通过kafka-configs命令将其修改为3。显然这个操作会减少Processor线程池中的线程数量。在这个场景下removeProcessor方法会被调用。
### 处理Request和Response
除了Processor的管理之外RequestChannel的另一个重要功能是处理**Request和Response**具体表现为收发Request和发送Response。比如收发Request的方法有sendRequest和receiveRequest
```
def sendRequest(request: RequestChannel.Request): Unit = {
requestQueue.put(request)
}
def receiveRequest(timeout: Long): RequestChannel.BaseRequest =
requestQueue.poll(timeout, TimeUnit.MILLISECONDS)
def receiveRequest(): RequestChannel.BaseRequest =
requestQueue.take()
```
所谓的发送Request仅仅是将Request对象放置在Request队列中而已而接收Request则是从队列中取出Request。整个流程构成了一个迷你版的“生产者-消费者”模式然后依靠ArrayBlockingQueue的线程安全性来确保整个过程的线程安全如下所示
![](https://static001.geekbang.org/resource/image/b8/cc/b83a2856a7f8e7b895f47e277e007ecc.jpg)
对于Response而言则没有所谓的接收Response只有发送Response即sendResponse方法。sendResponse是啥意思呢其实就是把Response对象发送出去也就是将Response添加到Response队列的过程。
```
def sendResponse(response: RequestChannel.Response): Unit = {
if (isTraceEnabled) { // 构造Trace日志输出字符串
val requestHeader = response.request.header
val message = response match {
case sendResponse: SendResponse =>
s"Sending ${requestHeader.apiKey} response to client ${requestHeader.clientId} of ${sendResponse.responseSend.size} bytes."
case _: NoOpResponse =>
s"Not sending ${requestHeader.apiKey} response to client ${requestHeader.clientId} as it's not required."
case _: CloseConnectionResponse =>
s"Closing connection for client ${requestHeader.clientId} due to error during ${requestHeader.apiKey}."
case _: StartThrottlingResponse =>
s"Notifying channel throttling has started for client ${requestHeader.clientId} for ${requestHeader.apiKey}"
case _: EndThrottlingResponse =>
s"Notifying channel throttling has ended for client ${requestHeader.clientId} for ${requestHeader.apiKey}"
}
trace(message)
}
// 找出response对应的Processor线程即request当初是由哪个Processor线程处理的
val processor = processors.get(response.processor)
// 将response对象放置到对应Processor线程的Response队列中
if (processor != null) {
processor.enqueueResponse(response)
}
}
```
sendResponse方法的逻辑其实非常简单。
前面的一大段if代码块仅仅是构造Trace日志要输出的内容。根据不同类型的Response代码需要确定要输出的Trace日志内容。
接着代码会找出Response对象对应的Processor线程。当Processor处理完某个Request后会把自己的序号封装进对应的Response对象。一旦找出了之前是由哪个Processor线程处理的代码直接调用该Processor的enqueueResponse方法将Response放入Response队列中等待后续发送。
## 监控指标实现
RequestChannel类还定义了丰富的监控指标用于实时动态地监测Request和Response的性能表现。我们来看下具体指标项都有哪些。
```
object RequestMetrics {
val consumerFetchMetricName = ApiKeys.FETCH.name + "Consumer"
val followFetchMetricName = ApiKeys.FETCH.name + "Follower"
val RequestsPerSec = "RequestsPerSec"
val RequestQueueTimeMs = "RequestQueueTimeMs"
val LocalTimeMs = "LocalTimeMs"
val RemoteTimeMs = "RemoteTimeMs"
val ThrottleTimeMs = "ThrottleTimeMs"
val ResponseQueueTimeMs = "ResponseQueueTimeMs"
val ResponseSendTimeMs = "ResponseSendTimeMs"
val TotalTimeMs = "TotalTimeMs"
val RequestBytes = "RequestBytes"
val MessageConversionsTimeMs = "MessageConversionsTimeMs"
val TemporaryMemoryBytes = "TemporaryMemoryBytes"
val ErrorsPerSec = "ErrorsPerSec"
}
```
可以看到,指标有很多,不过别有压力,我们只要掌握几个重要的就行了。
* **RequestsPerSec**每秒处理的Request数用来评估Broker的繁忙状态。
* **RequestQueueTimeMs**计算Request在Request队列中的平均等候时间单位是毫秒。倘若Request在队列的等待时间过长你通常需要增加后端I/O线程的数量来加快队列中Request的拿取速度。
* **LocalTimeMs**计算Request实际被处理的时间单位是毫秒。一旦定位到这个监控项的值很大你就需要进一步研究Request被处理的逻辑了具体分析到底是哪一步消耗了过多的时间。
* **RemoteTimeMs**Kafka的读写请求PRODUCE请求和FETCH请求逻辑涉及等待其他Broker操作的步骤。RemoteTimeMs计算的就是等待其他Broker完成指定逻辑的时间。因为等待的是其他Broker因此被称为Remote Time。这个监控项非常重要Kafka生产环境中设置acks=all的Producer程序发送消息延时高的主要原因往往就是Remote Time高。因此如果你也碰到了这样的问题不妨先定位一下Remote Time是不是瓶颈。
* **TotalTimeMs**计算Request被处理的完整流程时间。**这是最实用的监控指标,没有之一!**毕竟我们通常都是根据TotalTimeMs来判断系统是否出现问题的。一旦发现了问题我们才会利用前面的几个监控项进一步定位问题的原因。
RequestChannel定义了updateMetrics方法用于实现监控项的更新因为逻辑非常简单我就不展开说了你可以自己阅读一下。
## 总结
好了,又到了总结时间。
今天我带你阅读了Kafka请求队列的实现源码。围绕这个问题我们学习了几个重点内容。
* Request定义了Kafka Broker支持的各类请求。
* Response定义了与Request对应的各类响应。
* RequestChannel实现了Kafka Request队列。
* 监控指标封装了与Request队列相关的重要监控指标。
![](https://static001.geekbang.org/resource/image/4b/15/4bf7b31f368743496018b3f21a528b15.jpg)
希望你结合今天所讲的内容思考一下Request和Response在请求通道甚至是SocketServer中的流转过程这将极大地帮助你了解Kafka是如何处理外部发送的请求的。当然如果你觉得这个有难度也不必着急因为后面我会专门用一节课来告诉你这些内容。
## 课后讨论
如果我想监控Request队列当前的使用情况比如当前已保存了多少个Request你可以结合源码指出应该使用哪个监控指标吗
欢迎你在留言区畅所欲言,跟我交流讨论,也欢迎你把今天的内容分享给你的朋友。