Copyright © 1998-2023 maxiaoke.com All rights reserved.

当前位置:　 首页>> 技术小册>> kafka入门到实战

小册名称：kafka入门到实战

如何发起Request请求
如果配置了多个listeners,如何正确的选择listener发起请求？
Controller2Broker、Broker2Broker、Client2Broker 的区别是什么？
构建Request并发起请求
关键类
客户端发起请求的几个关键类

NetworkSend
该类继承自ByteBufferSend, 超类是 Send,有以下几个接口

  1.     String destination();
  2.     boolean completed();
  3.     long writeTo(GatheringByteChannel channel) throws IOException;
  4.     long size();

它的作用主要是用来缓存待发送的数据的, writeTo 方法会把缓存的数据写入到入参的通道里面。 例如ByteBufferSend,的写入方法如下。

  1.     @Override
  2.     public long writeTo(GatheringByteChannel channel) throws IOException {
  3.         long written = channel.write(buffers);
  4.         if (written < 0)
  5.             throw new EOFException("Wrote negative bytes to channel. This shouldn't happen.");
  6.         remaining -= written;
  7.         pending = TransportLayers.hasPendingWrites(channel);
  8.         return written;
  9.     }

Send接口,还有很多其他的实现类。

NetworkClientUtils
客户端的工具类, 只要构建好了NetworkClient,就可以用这个工具类发送请求。

NetworkClient
用于异步请求/响应网络 i/o 的网络客户端。这是一个内部类，用于实现面向用户的生产者和消费者客户端。 这个类不是线程安全的！

NetworkClient的一些关键属性

  1.     /* 用于执行网络 io 的选择器 */
  2.     private final Selectable selector;
  4.     /* Metadata元信息的更新器, 他可以尝试更新元信息 */
  5.     private final MetadataUpdater metadataUpdater;
  7.     /* 每个节点的连接状态 */
  8.     private final ClusterConnectionStates connectionStates;
  10.     /* 当前正在发送或等待响应的一组请求 */
  11.     private final InFlightRequests inFlightRequests;
  13.     /* 套接字发送缓冲区大小（以字节为单位） */
  14.     private final int socketSendBuffer;
  16.     /* 套接字接收大小缓冲区（以字节为单位） */
  17.     private final int socketReceiveBuffer;
  19.     /* 用于在对服务器的请求中识别此客户端的客户端 ID */
  20.     private final String clientId;
  22.     /* 向服务器发送请求时使用的当前关联 ID*/
  23.     private int correlation;
  25.     /* 单个请求等待服务器确认的默认超时*/
  26.     private final int defaultRequestTimeoutMs;
  28.  //.... 省略

发送请求

  1. // 根据拿到的BrokerNode，和RequestBuilder构建 Request请求
  2.            val clientRequest = networkClient.newClientRequest(brokerNode.idString, requestBuilder,
  3.              time.milliseconds(), true)
  4.       // 发起请求并接受Response
  5.            clientResponse = NetworkClientUtils.sendAndReceive(networkClient, clientRequest, time)

主要的发送请求逻辑就是上面的关键代码, 先构建clientRequest请求,然后用NetworkClientUtils发送请求。

具体代码就不贴出来了, 简要概述一下整个流程吧

创建networkclient还有clientRequest, 注意brokerNode是具体Broker的EndPoint,一个Broker可能有多个EndPoint,具体选择哪个是由调用层决定的。

开始执行发送流程
校验是否能够发送Request,判断逻辑为：连接状态Ready&&通道Ready&&当然正在发送中的请求数量<maxInFlightRequestsPerConnection(最大未完成请求数,这个是上层参数决定的) 。当然,如果这个请求的类型是内部请求,是不需要这个判断的。

如果能够发送Request, 则开始构建NetworkSend, 然后调用Selector.send(send) 开始发送,这个过程其实是注册SelectionKey.OP_WRITE 事件。当然在这之前会将请求保存起来放到inFlightRequests中,用于后面判断请求数是否超过阈值等等。

循环遍历 networkClient.poll 获取Response, 直到结束。

Request的几个场景
客户端发起请求,总共分为以下几个场景。

Controller2Broker
关键类 ControllerChannelManager

Controller会向Broker发起一些请求,比如UpdateMetadataRequest 更新元信息请求。

那么Controller是如何构建networkClient的呢？
如果Broker配置了多个listeners, 怎么选择listeners去发送请求呢？
在Controller重新选举初始化的时候,或者有新的Broker启动上线之后, Controller节点会执行添加Broker的操作。

ControllerChannelManager#addBroker

  1. private def addNewBroker(broker: Broker): Unit = {
  2.     val messageQueue = new LinkedBlockingQueue[QueueItem]
  3.     // 获取内部Broker之间通信的监听器名称
  4.     val controllerToBrokerListenerName = config.controlPlaneListenerName.getOrElse(config.interBrokerListenerName)
  5.     // 读取内部Broker之间通信的安全协议
  6.     val controllerToBrokerSecurityProtocol = config.controlPlaneSecurityProtocol.getOrElse(config.interBrokerSecurityProtocol)
  7.     // 根据监听器名称选择合适的节点和监听器名称
  8.     val brokerNode = broker.node(controllerToBrokerListenerName)
  9.     // 省略部分
  10.     .......
  11.  val networkClient = new NetworkClient(
  12.         selector,
  13.         new ManualMetadataUpdater(Seq(brokerNode).asJava),
  14.         config.brokerId.toString,
  15.         // 一次只能发一个请求,保证顺序性
  16.         1,
  17.         0,
  18.         0,
  19.         Selectable.USE_DEFAULT_BUFFER_SIZE,
  20.         Selectable.USE_DEFAULT_BUFFER_SIZE,
  21.         config.requestTimeoutMs,
  22.         config.connectionSetupTimeoutMs,
  23.         config.connectionSetupTimeoutMaxMs,
  24.         ClientDnsLookup.USE_ALL_DNS_IPS,
  25.         time,
  26.         false,
  27.         new ApiVersions,
  28.         logContext
  29.       )
  30.     // 省略部分
  31.     .......
  32.     val requestThread = new RequestSendThread(config.brokerId, controllerContext, messageQueue, networkClient,
  33.       brokerNode, config, time, requestRateAndQueueTimeMetrics, stateChangeLogger, threadName)
  34. }

  • 解析配置control.plane.listener.name 获取ControllerPlane（控制面板）使用的listeners, 并解析出listener_name 和 安全协议。 如果没有配置control.plane.listener.name, 则使用inter.broker.listener.name的监听器和安全协议

  • 根据上面得到的监听器名称, 就可以指定使用哪个BrokerNode了。例如某个新增的Broker配置如下:
    listeners = OUTSIDE1://172.23.164.160:9093,OUTSIDE2://172.23.164.160:9094 listener.security.protocol.map=OUTSIDE1:PLAINTEXT,OUTSIDE2:PLAINTEXT inter.broker.listener.name=OUTSIDE2
    那么新增Broker的时候,Controller得到的Broker就有2个Endpoint。

那么Controller应该选哪个EndPoint去跟这个Broker建立连接呢？这得看Controller这台Broker的配置是什么了。假设Controller的配置如下：

  1. listeners = OUTSIDE1://xxx.xxx:xxx,OUTSIDE2://xxx.xxx:xxx listener.security.protocol.map=OUTSIDE1:PLAINTEXT,OUTSIDE2:PLAINTEXT inter.broker.listener.name=OUTSIDE2

那么通过上面1中的判断逻辑, 会找到监听器为OUTSIDE2 的EndPoint进行连接。 注意：是Controller拿本地配置,去匹配Broker的EndPoint配置。一般情况下,所有的Broker配置都应该一致！ 如果Controller本地配置的监听器,不存在于其他Broker中会造成什么情况？ 如果找不到正确的BrokerNode,从日志里面看,好像并没有打印出明显的异常。但是实际上它是会抛出一个异常BrokerEndPointNotAvailableException.

s”End point with listener name ${listenerName.value} not found “ +
s”for broker $id”

构建NetworkClient, 将用于发起网络请求。

构建完NetworkClient,创建RequestSendThread线程对象,该对象包含networClient、BrokerNode等等实例。ThreadName为: “Controller-当前BrokerID-to-broker-目标BrokerID-send-thread”
启动RequestSendThread, 这个线程做的事情就是跟BrokerNode建立起连接、发起UpdateMetadataRequest请求, 接受请求Response。就是上面的NetworkClientUtils.sendAndReceive流程

PS: 这里传入的maxInFlightRequestsPerConnection 是1，也就说Controller给某个Broker发送请求同一时间只有一个请求。确保请求的顺序性。

Broker2Controller
在Kafka启动过程中,会构建一个brokerToControllerChannelManager 的实例。这个是专门管理Broker向Controller发起请求的类,里面有一个BrokerToControllerRequestThread线程负责真正的想Controller发起请求。

  1.   brokerToControllerChannelManager = new BrokerToControllerChannelManagerImpl(metadataCache, time, metrics, config, threadNamePrefix)
  2.   brokerToControllerChannelManager.start()

线程名格式：自定义前缀:broker-${config.brokerId}-to-controller-send-thread

可以看看他里面的类, 也是先构建networkClient, 然后发起请求。具体构建就不再分析了,跟上面的Controller2Broker一样。但是列出几个重点需要注意的地方：

Controller2Broker通过配置可以找到具体的BrokerNode, 也就是说在发起请求之前就知道向Broker的哪个EndPoint发起请求, 这个时候的Broker2Controller在发起之前是不知道的,只知道监听器名称。当然这个监听器名称的寻找逻辑 跟Controller2Broker一样,也是先找配置control.plane.listener.name ,找不到就用inter.broker.listener.name配置。

Broker刚启动的时候,还没有设置activeController,不知道谁是Controller,所以等元信息更新之后,才拿到Controller Broker节点,但是Controller可能有多个EndPoint,那么获取哪个呢？ 当然是根据上面的1中获取到的监听器名 listenerName,过滤出BrokerNode。并赋值给activeController(是具体的Node,一个Broker可以有多个Node的)
元信息更新器是ManualMetadataUpdater. 这个更新器是手动更新,直接调用metadataUpdater.setNodes 来更新节点。

  1. // 获取正确的ControllerNode
  2. activeController = Option(controllerOpt.get.node(listenerName))
  3. // 手动更新一下Nodes信息。所有其他的Broker都只接收listenerName的Node
  4. metadataUpdater.setNodes(metadataCache.getAliveBrokers.map(_.node(listenerName)).asJava)

有了activeController之后，就可以正常的走网络请求了。但是这个时候还没有请求进来, 它会去循环的poll requestQueue里面的请求, 有请求的话就走请求流程。请求成功后,会调用回调接口request.callback.onComplete(response)

所以,你想要发送一个请求,只需要把请求参数放到队列requestQueue里面就行了。 例如：Broker定时向Controller发送AlterIsr请求。

AlterIsrManager.star()

PS: 这里传入的maxInFlightRequestsPerConnection 也是1，也就说Broker给Controller发送请求同一时间只有一个请求。确保请求的顺序性。

Broker2Broker
Broker之间的请求, 例如 AbstractFetcherThread 副本同步线程。 Follower去Leader Fetch数据,FetchRequest 请求, 那么他们的通信又是什么样子呢？

基本上都是差不多的, 需要注意几个问题

Broker2Broker 之间的请求用什么EndPoint呢？ 答: 用本地的inter.broker.listener.name 配置去匹配对应的EndPoint。Broker2Broker是属于内部Broker之间的请求。具体的代码在 ReplicaManager#makeFollowers

ReplicaFetcher的线程名: “配置的前缀ReplicaFetcherThread-
{sourceBroker.id}”
这里传入的maxInFlightRequestsPerConnection 也是1，也就说Broker给Controller发送请求同一时间只有一个请求。确保请求的顺序性。

Client2Broker
这个就是 例如 Producer 和 Consumer 等等向Broker发起请求模块。

方式都是一样的,构建自己的 networkClient，配置不同属性。

该分类下的相关小册推荐：

Kafka面试指南
Kafka面试指南
Kafka核心源码解读
Kafka核心源码解读
消息队列入门与进阶
消息队列入门与进阶
Kafka核心技术与实战
Kafka核心技术与实战
Kafka 原理与源码精讲
Kafka 原理与源码精讲