实践部署与使用apache kafka框架技术博文资料汇总

￡神魔★判官ぃ 2022-08-01 06:02 388阅读 0赞

[实践部署与使用apache kafka框架技术博文资料汇总][apache kafka]

http://blog.csdn.net/zhongwen7710/article/details/41252649

前一篇Kafka框架设计来自英文原文（Kafka Architecture Design）的翻译及整理文章，很有借鉴性，本文是从一个企业使用Kafka框架的角度来记录及整理的Kafka框架的技术资料，也很有借鉴价值，为了便于阅读与分享，我将其整理一篇Blog。本文内容目录摘要如下：

**1）apache kafka消息服务**

**2）kafka在zookeeper中存储结构**

**3）kafka log4j配置**

**4）kafka replication设计机制**

**5）apache kafka监控系列-监控指标**

**6）kafka.common.ConsumerRebalanceFailedException异常解决办法**

**7）kafak安装与使用**

**8）apache kafka中server.properties配置文件参数说明**

**9）apache kafka的consumer初始化时获取不到消息**

**10）Kafka Producer处理逻辑**

**11）apache kafka源代码工程环境搭建(IDEA)**

**12）apache kafka监控系列-KafkaOffsetMonitor**

**13）Kafka Controller设计机制**

**14）Kafka性能测试报告(虚拟机版)**

**15）apache kafka监控系列-kafka-web-console**

**16）apache kafka迁移与扩容工具用法**

**17）kafka LeaderNotAvailableException**

**18）apache kafka jmx监控指标参数**

**19）apache kafka性能测试命令使用和构建kafka-perf**

**20）apache kafka源码构建打包**

**21）Apache kafka客户端开发-java**

**22） kafka broker内部架构**

**23）apache kafka源码分析走读-kafka整体结构分析**

**24）apache kafka源码分析走读-Producer分析**

**25）apache kafka性能优化架构分析**

**26）apache kafka源码分析走读-server端网络架构分析**

**27）apache kafka源码分析走读-ZookeeperConsumerConnector分析**

**28）kafka的ZkUtils类的java版本部分代码**

**29）kafka & mafka client开发与实践**

**30)   kafka文件系统设计那些事**

**31）kafka的ZookeeperConsumer实现**

详细内容如下所示：

**1）apache kafka消息服务**

## apache kafka参考 ##

[http://kafka.apache.org/documentation.html][http_kafka.apache.org_documentation.html]

消息队列分类：

点对点：

消息生产者生产消息发送到queue中，然后消息消费者从queue中取出并且消费消息。这里要注意：

*  消息被消费以后，queue中不再有存储，所以消息消费者不可能消费到已经被消费的消息。
 *  Queue支持存在多个消费者，但是对一个消息而言，只会有一个消费者可以消费。

### 发布/订阅 ###

消息生产者（发布）将消息发布到topic中，同时有多个消息消费者（订阅）消费该消息。和点对点方式不同，发布到topic的消息会被所有订阅者消费。

## kafka消息队列调研 ##

背景介绍

kafka是最初由Linkedin公司开发，使用Scala语言编写，Kafka是一个分布式、分区的、多副本的、多订阅者的日志系统(分布式MQ系统)，可以用于web/nginx日志，搜索日志，监控日志，访问日志等等。

kafka目前支持多种客户端语言：java，python，c++，php等等。

### 总体结构： ###

![SouthEast][]

kafka名词解释和工作方式：

*  Producer ：消息生产者，就是向kafka broker发消息的客户端。
 *  Consumer ：消息消费者，向kafka broker取消息的客户端
 *  Topic ：咋们可以理解为一个队列。
 *  Consumer Group （CG）：这是kafka用来实现一个topic消息的广播（发给所有的consumer）和单播（发给任意一个consumer）的手段。一个topic可以有多个CG。topic的消息会复制（不是真的复制，是概念上的）到所有的CG，但每个CG只会把消息发给该CG中的一个consumer。如果需要实现广播，只要每个consumer有一个独立的CG就可以了。要实现单播只要所有的consumer在同一个CG。用CG还可以将consumer进行自由的分组而不需要多次发送消息到不同的topic。
 *  Broker ：一台kafka服务器就是一个broker。一个集群由多个broker组成。一个broker可以容纳多个topic。
 *  Partition：为了实现扩展性，一个非常大的topic可以分布到多个broker（即服务器）上，一个topic可以分为多个partition，每个partition是一个有序的队列。partition中的每条消息都会被分配一个有序的id（offset）。kafka只保证按一个partition中的顺序将消息发给consumer，不保证一个topic的整体（多个partition间）的顺序。
 *   Offset：kafka的存储文件都是按照offset.kafka来命名，用offset做名字的好处是方便查找。例如你想找位于2049的位置，只要找到2048.kafka的文件即可。当然the first offset就是00000000000.kafka

###  kafka特性： ###

*  通过O(1)的磁盘数据结构提供消息的持久化，这种结构对于即使数以TB的消息存储也能够保持长时间的稳定性能。
 *  高吞吐量：即使是非常普通的硬件kafka也可以支持每秒数十万的消息。
 *  支持同步和异步复制两种HA
 *  Consumer客户端pull，随机读,利用sendfile系统调用，zero-copy ,批量拉数据
 *  消费状态保存在客户端
 *  消息存储顺序写
 *  数据迁移、扩容对用户透明  
    
 *  支持Hadoop并行数据加载。
 *  支持online和offline的场景。
 *  持久化：通过将数据持久化到硬盘以及replication防止数据丢失。
 *  scale out：无需停机即可扩展机器。
 *  定期删除机制，支持设定partitions的segment file保留时间。

### 可靠性（一致性) ###

kafka(MQ)要实现从producer到consumer之间的可靠的消息传送和分发。传统的MQ系统通常都是通过broker和consumer间的确认（ack）机制实现的，并在broker保存消息分发的状态。

即使这样一致性也是很难保证的（参考原文）。kafka的做法是由consumer自己保存状态，也不要任何确认。这样虽然consumer负担更重，但其实更灵活了。

因为不管consumer上任何原因导致需要重新处理消息，都可以再次从broker获得。

### kafak系统扩展性 ###

kafka使用zookeeper来实现动态的集群扩展，不需要更改客户端（producer和consumer）的配置。broker会在zookeeper注册并保持相关的元数据（topic，partition信息等）更新。

而客户端会在zookeeper上注册相关的watcher。一旦zookeeper发生变化，客户端能及时感知并作出相应调整。这样就保证了添加或去除broker时，各broker间仍能自动实现负载均衡。

### kafka设计目标 ###

高吞吐量是其核心设计之一。

*  数据磁盘持久化：消息不在内存中cache，直接写入到磁盘，充分利用磁盘的顺序读写性能。
 *  zero-copy：减少IO操作步骤。
 *  支持数据批量发送和拉取。
 *  支持数据压缩。
 *  Topic划分为多个partition，提高并行处理能力。

### Producer负载均衡和HA机制 ###

*  producer根据用户指定的算法，将消息发送到指定的partition。
 *  存在多个partiiton，每个partition有自己的replica，每个replica分布在不同的Broker节点上。
 *  多个partition需要选取出lead partition，lead partition负责读写，并由zookeeper负责fail over。
 *  通过zookeeper管理broker与consumer的动态加入与离开。

### Consumer的pull机制 ###

由于kafka broker会持久化数据，broker没有cahce压力，因此，consumer比较适合采取pull的方式消费数据，具体特别如下：

*  简化kafka设计，降低了难度。
 *  Consumer根据消费能力自主控制消息拉取速度。
 *  consumer根据自身情况自主选择消费模式，例如批量，重复消费，从制定partition或位置(offset)开始消费等.

### Consumer与topic关系以及机制 ###

本质上kafka只支持Topic.每个consumer属于一个consumer group;反过来说,每个group中可以有多个consumer.对于Topic中的一条特定的消息,  
只会被订阅此Topic的每个group中的一个consumer消费,此消息不会发送给一个group的多个consumer;那么一个group中所有的consumer将会交错的消费整个Topic.  
如果所有的consumer都具有相同的group,这种情况和JMS queue模式很像;消息将会在consumers之间负载均衡.  
如果所有的consumer都具有不同的group,那这就是"发布-订阅";消息将会广播给所有的消费者.

在kafka中,一个partition中的消息只会被group中的一个consumer消费(同一时刻);每个group中consumer消息消费互相独立;我们可以认为一个group是一个"订阅"者,

一个Topic中的每个partions,只会被一个"订阅者"中的一个consumer消费,不过一个consumer可以同时消费多个partitions中的消息.

kafka只能保证一个partition中的消息被某个consumer消费时是顺序的.事实上,从Topic角度来说,当有多个partitions时,消息仍不是全局有序的.

通常情况下,一个group中会包含多个consumer,这样不仅可以提高topic中消息的并发消费能力,而且还能提高"故障容错"性,如果group中的某个consumer失效,

那么其消费的partitions将会有其他consumer自动接管.kafka的设计原理决定,对于一个topic,同一个group中不能有多于partitions个数的consumer同时消费,

否则将意味着某些consumer将无法得到消息.

### Producer均衡算法 ###

kafka集群中的任何一个broker,都可以向producer提供metadata信息,这些metadata中包含"集群中存活的servers列表"/"partitions leader列表"  
等信息(请参看zookeeper中的节点信息).当producer获取到metadata信心之后, producer将会和Topic下所有partition leader保持socket连接;  
消息由producer直接通过socket发送到broker,中间不会经过任何"路由层".事实上,消息被路由到哪个partition上,有producer客户端决定.  
比如可以采用"random""key-hash""轮询"等,如果一个topic中有多个partitions,那么在producer端实现"消息均衡分发"是必要的.  
在producer端的配置文件中,开发者可以指定partition路由的方式.

### **Consumer均衡算法** ###

当一个group中,有consumer加入或者离开时,会触发partitions均衡.均衡的最终目的,是提升topic的并发消费能力.  
1) 假如topic1,具有如下partitions: P0,P1,P2,P3  
2) 加入group中,有如下consumer: C0,C1  
3) 首先根据partition索引号对partitions排序: P0,P1,P2,P3  
4) 根据consumer.id排序: C0,C1  
5) 计算倍数: M = \[P0,P1,P2,P3\].size / \[C0,C1\].size,本例值M=2(向上取整)  
6) 然后依次分配partitions: C0 = \[P0,P1\],C1=\[P2,P3\],即Ci = \[P(i \* M),P((i + 1) \* M -1)\]

### kafka broker集群内broker之间replica机制 ###

kafka中,replication策略是基于partition,而不是topic;kafka将每个partition数据复制到多个server上,任何一个partition有一个leader和多个follower(可以没有);

备份的个数可以通过broker配置文件来设定.leader处理所有的read-write请求,follower需要和leader保持同步.Follower就像一个"consumer",

消费消息并保存在本地日志中;leader负责跟踪所有的follower状态,如果follower"落后"太多或者失效,leader将会把它从replicas同步列表中删除.

当所有的follower都将一条消息保存成功,此消息才被认为是"committed",那么此时consumer才能消费它,这种同步策略,就要求follower和leader之间必须具有良好的网络环境.

即使只有一个replicas实例存活,仍然可以保证消息的正常发送和接收,只要zookeeper集群存活即可.(备注:不同于其他分布式存储,比如hbase需要"多数派"存活才行)

k**afka判定一个follower存活与否的条件有2个**:

1) follower需要和zookeeper保持良好的链接

2) 它必须能够及时的跟进leader,不能落后太多.

如果同时满足上述2个条件,那么leader就认为此follower是"活跃的".如果一个follower失效(server失效)或者落后太多,

leader将会把它从同步列表中移除\[备注:如果此replicas落后太多,它将会继续从leader中fetch数据,直到足够up-to-date,

然后再次加入到同步列表中;kafka不会更换replicas宿主!因为"同步列表"中replicas需要足够快,这样才能保证producer发布消息时接受到ACK的延迟较小。

**当leader失效时**,需在followers中选取出新的leader,可能此时follower落后于leader,因此需要选择一个"up-to-date"的follower.kafka中leader选举并没有采用"投票多数派"的算法,

因为这种算法对于"网络稳定性"/"投票参与者数量"等条件有较高的要求,而且kafka集群的设计,还需要容忍N-1个replicas失效.对于kafka而言,

每个partition中所有的replicas信息都可以在zookeeper中获得,那么选举leader将是一件非常简单的事情.选择follower时需要兼顾一个问题,

就是新leader server上所已经承载的partition leader的个数,如果一个server上有过多的partition leader,意味着此server将承受着更多的IO压力.

在选举新leader,需要考虑到"负载均衡",partition leader较少的broker将会更有可能成为新的leader.

在整几个集群中,只要有一个replicas存活,那么此partition都可以继续接受读写操作.

### *总结:*  ###

1) Producer端直接连接broker.list列表,从列表中返回TopicMetadataResponse,该Metadata包含Topic下每个partition leader建立socket连接并发送消息.

2) Broker端使用zookeeper用来注册broker信息,以及监控partition leader存活性.

3) Consumer端使用zookeeper用来注册consumer信息,其中包括consumer消费的partition列表等,同时也用来发现broker列表,并和partition leader建立socket连接,并获取消息.

### 性能测试 ###

目前我已经在虚拟机上做了性能测试。

测试环境：cpu: 双核   内存 ：2GB   硬盘：60GB

<table style="color:rgb(51,51,51); border-collapse:collapse; margin:0px; overflow-x:auto"> 
 <thead> 
 <tr> 
 <th style="border:1px solid rgb(221,221,221); padding:7px 15px 7px 10px; vertical-align:top; color:rgb(0,0,0); background-color:rgb(240,240,240)"> 
 <div style="margin:0px; padding:0px">
 测试指标 
 </div> </th> 
 <th style="border:1px solid rgb(221,221,221); padding:7px 15px 7px 10px; vertical-align:top; color:rgb(0,0,0); background-color:rgb(240,240,240)"> 
 <div style="margin:0px; padding:0px">
 性能相关说明 
 </div> </th> 
 <th colspan="1" style="border:1px solid rgb(221,221,221); padding:7px 15px 7px 10px; vertical-align:top; color:rgb(0,0,0); background-color:rgb(240,240,240)"> 
 <div style="margin:0px; padding:0px">
 结论 
 </div> </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 消息堆积压力测试</td> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 单个kafka broker节点测试，启动一个kafka broker和Producer，Producer不断向broker发送数据， 直到broker堆积数据为18GB为止(停止Producer运行)。启动Consumer，不间断从broker获取数据， 直到全部数据读取完成为止，最后查看Producer==Consumer数据，没有出现卡死或broker不响应现象 </td> 
 <td colspan="1" style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 数据大量堆积不会出现broker卡死 或不响应现象 </td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 生产者速率</td> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 1.200byte/msg,4w/s左右。2.1KB/msg,1w/s左右</td> 
 <td colspan="1" style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 性能上是完全满足要求，其性能主要由磁盘决定</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 消费者速率</td> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 1.200byte/msg,4w/s左右。2.1KB/msg,1w/s左右</td> 
 <td colspan="1" style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 性能上是完全满足要求，其性能主要由磁盘决定</td> 
 </tr> 
 </tbody> 
</table>

**2）kafka在zookeeper中存储结构**

> ![SouthEast 1][]

# 1.topic注册信息 #

/brokers/topics/\[topic\] :

存储某个topic的partitions所有分配信息

# 2.partition状态信息 #

/brokers/topics/\[topic\]/partitions/\[0...N\]  其中\[0..N\]表示partition索引号

/brokers/topics/\[topic\]/partitions/\[partitionId\]/state

# 3. Broker注册信息 #

/brokers/ids/\[0...N\]

每个broker的配置文件中都需要指定一个数字类型的id(全局不可重复),此节点为临时znode(EPHEMERAL)

# 4. Controller epoch:  #

/controller\_epoch -> int (epoch)

此值为一个数字,kafka集群中第一个broker第一次启动时为1，以后只要集群中center controller中央控制器所在broker变更或挂掉，就会重新选举新的center controller，每次center controller变更controller\_epoch值就会 + 1;

# 5. Controller注册信息: #

/controller -> int (broker id of the controller)  存储center controller中央控制器所在kafka broker的信息

<table style="font-family:Arial,sans-serif; color:rgb(51,51,51); border-collapse:collapse; margin:0px; overflow-x:auto"> 
 <tbody> 
 <tr> 
 <td style="border-style:solid; border-color:rgb(221,221,221); padding:7px 10px; vertical-align:top"> 
 <div title="Hint: double-click to select code" style="margin:0px; padding:0px"> 
 <div style="margin:0px; padding:0px"> 
 <code>Schema:</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code></code> 
 </div> 
 { 
 
 "version": 版本编号默认为1, "brokerid":&nbsp;kafka集群中broker唯一编号, "timestamp": kafka broker中央控制器变更时的时间戳 
 
 } 
 <div style="margin:0px; padding:0px"> 
 <code></code> 
 </div> 
 <div style="margin:0px; padding:0px">
 &nbsp; 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>Example:</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code></code> 
 </div> 
 
 </div> { "version": 1, "brokerid": 3, "timestamp": "1403061802981" } 
 <div title="Hint: double-click to select code" style="margin:0px; padding:0px"> 
 
 <div style="margin:0px; padding:0px"> 
 <code></code> 
 </div> 
 </div> </td> 
 </tr> 
 </tbody> 
</table>

Consumer and Consumer group概念:

> ![SouthEast 2][]

> a.每个consumer客户端被创建时,会向zookeeper注册自己的信息;  
>  b.此作用主要是为了"负载均衡".  
>  c.同一个Consumer Group中的Consumers，Kafka将相应Topic中的每个消息只发送给其中一个Consumer。  
>  d.Consumer Group中的每个Consumer读取Topic的一个或多个Partitions，并且是唯一的Consumer；  
>  e.一个Consumer group的多个consumer的所有线程依次有序地消费一个topic的所有partitions,如果Consumer group中所有consumer总线程大于partitions数量，则会出现空闲情况;
> 
> > 举例说明：
> 
> > kafka集群中创建一个topic为report-log   4 partitions 索引编号为0,1,2,3
> 
> > 假如有目前有三个消费者node：注意-->一个consumer中一个消费线程可以消费一个或多个partition.
> 
> > 如果每个consumer创建一个consumer thread线程,各个node消费情况如下，node1消费索引编号为0,1分区，node2费索引编号为2,node3费索引编号为3
> 
> > 如果每个consumer创建2个consumer thread线程，各个node消费情况如下(是从consumer node先后启动状态来确定的)，node1消费索引编号为0,1分区；node2费索引编号为2,3；node3为空闲状态
> 
> 总结 ：  
>  从以上可知，Consumer Group中各个consumer是根据先后启动的顺序有序消费一个topic的所有partitions的。
> 
> 如果Consumer Group中所有consumer的总线程数大于partitions数量，则可能consumer thread或consumer会出现空闲状态。

> **Consumer均衡算法**  
> 当一个group中,有consumer加入或者离开时,会触发partitions均衡.均衡的最终目的,是提升topic的并发消费能力.  
> 1) 假如topic1,具有如下partitions: P0,P1,P2,P3  
> 2) 加入group中,有如下consumer: C0,C1  
> 3) 首先根据partition索引号对partitions排序: P0,P1,P2,P3  
> 4) 根据(consumer.id + '-'+ thread序号)排序: C0,C1  
> 5) 计算倍数: M = \[P0,P1,P2,P3\].size / \[C0,C1\].size,本例值M=2(向上取整)  
> 6) 然后依次分配partitions: C0 = \[P0,P1\],C1=\[P2,P3\],即Ci = \[P(i \* M),P((i + 1) \* M -1)\]

# 6. Consumer注册信息: #

每个consumer都有一个唯一的ID(consumerId可以通过配置文件指定,也可以由系统生成),此id用来标记消费者信息.

/consumers/\[groupId\]/ids/\[consumerIdString\]

是一个临时的znode,此节点的值为请看consumerIdString产生规则,即表示此consumer目前所消费的topic + partitions列表.

consumerId产生规则：

String**consumerUuid** = null;  
    if(config.consumerId!=null && config.consumerId)  
      consumerUuid = consumerId;  
    else \{  
      String **uuid** = UUID.randomUUID()  
      consumerUuid = "%s-%d-%s".format(  
        InetAddress.getLocalHost.getHostName, System.currentTimeMillis,  
        uuid.getMostSignificantBits().toHexString.substring(0,8));

\}  
     String **consumerIdString** = config.groupId + "\_" + consumerUuid;

# 7. Consumer owner: #

/consumers/\[groupId\]/owners/\[topic\]/\[partitionId\] -> consumerIdString + threadId索引编号

当consumer启动时,所触发的操作:

a) 首先进行"Consumer Id注册";

b) 然后在"Consumer id 注册"节点下注册一个watch用来监听当前group中其他consumer的"**退出**"和"**加入**";只要此znode path下节点列表变更,都会触发此group下consumer的负载均衡.(比如一个consumer失效,那么其他consumer接管partitions).

c) 在"Broker id 注册"节点下,注册一个watch用来监听broker的存活情况;如果broker列表变更,将会触发所有的groups下的consumer重新balance.

# 8. Consumer offset: #

/consumers/\[groupId\]/offsets/\[topic\]/\[partitionId\] -> long (offset)

用来跟踪每个consumer目前所消费的partition中最大的offset

此znode为持久节点,可以看出offset跟group\_id有关,以表明当消费者组(consumer group)中一个消费者失效,

重新触发balance,其他consumer可以继续消费.

9. Re-assign partitions

/admin/reassign\_partitions

<table style="color:rgb(51,51,51); border-collapse:collapse; margin:0px; overflow-x:auto"> 
 <tbody> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 
 <div title="Hint: double-click to select code" style="margin:0px; padding:0px"> 
 <div style="margin:0px; padding:0px"> 
 <code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;</code> 
 <code>"fields"</code><code>:[</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"version"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"int"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"version id"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>},</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"partitions"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"array"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"items"</code><code>:{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"fields"</code><code>:[</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"topic"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"string"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"topic of the partition to be reassigned"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>},</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"partition"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"int"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"the partition to be reassigned"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>},</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"replicas"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"array"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"items"</code><code>:</code><code>"int"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"a list of replica ids"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>],</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"an array of partitions to be reassigned to new replicas"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;</code><code>]</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px">
 &nbsp; 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>Example:</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;</code><code>"version"</code><code>:&nbsp;</code><code>1</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;</code><code>"partitions"</code><code>:</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>[</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"topic"</code><code>:&nbsp;</code><code>"Foo"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"partition"</code><code>:&nbsp;</code><code>1</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"replicas"</code><code>: [</code><code>0</code><code>,&nbsp;</code><code>1</code><code>,&nbsp;</code><code>3</code><code>]</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>}</code> 
 </div> 
 </div> </td> 
 </tr> 
 </tbody> 
</table>

10. Preferred replication election

/admin/preferred\_replica\_election

<table style="color:rgb(51,51,51); border-collapse:collapse; margin:0px; overflow-x:auto"> 
 <tbody> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221); padding:7px 10px; vertical-align:top"> 
 <div title="Hint: double-click to select code" style="margin:0px; padding:0px"> 
 <div style="margin:0px; padding:0px"> 
 <code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;</code><code>"fields"</code><code>:[</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"version"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"int"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"version id"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>},</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"partitions"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"array"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"items"</code><code>:{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"fields"</code><code>:[</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"topic"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"string"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"topic of the partition for which preferred replica election should be triggered"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>},</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"name"</code><code>:</code><code>"partition"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"type"</code><code>:</code><code>"int"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"the partition for which preferred replica election should be triggered"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>],</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"doc"</code><code>:</code><code>"an array of partitions for which preferred replica election should be triggered"</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;</code><code>]</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px">
 &nbsp; 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>例子:</code> 
 </div> 
 <div style="margin:0px; padding:0px">
 &nbsp; 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;</code><code>"version"</code><code>:&nbsp;</code><code>1</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;</code><code>"partitions"</code><code>:</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>[</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"topic"</code><code>:&nbsp;</code><code>"Foo"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"partition"</code><code>:&nbsp;</code><code>1</code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>},</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{ </code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"topic"</code><code>:&nbsp;</code><code>"Bar"</code><code>,</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>"partition"</code><code>:&nbsp;</code><code>0</code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
 </div> 
 <div style="margin:0px; padding:0px"> 
 <code>}</code> 
 </div> 
 </div> </td> 
 </tr> 
 </tbody> 
</table>

11. 删除topics  
/admin/delete\_topics

Topic配置

/config/topics/\[topic\_name\]

例子

**3）kafka log4j配置**

kafka日志文件分为5种类型，依次为：controller,kafka-request,server,state-change,log-cleaner，不同类型log数据，写到不同文件中:

**\[java\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  kafka.logs.dir=logs  
2.     
3.  log4j.rootLogger=INFO, stdout  
4.     
5.  log4j.appender.stdout=org.apache.log4j.ConsoleAppender  
6.  log4j.appender.stdout.layout=org.apache.log4j.PatternLayout  
7.  log4j.appender.stdout.layout.ConversionPattern=\[%d\] %p %m (%c)%n  
8.     
9.  log4j.appender.kafkaAppender=org.apache.log4j.DailyRollingFileAppender  
10. log4j.appender.kafkaAppender.DatePattern='.'yyyy-MM-dd-HH  
11. log4j.appender.kafkaAppender.File=$\{kafka.logs.dir\}/server.log  
12. log4j.appender.kafkaAppender.layout=org.apache.log4j.PatternLayout  
13. log4j.appender.kafkaAppender.layout.ConversionPattern=\[%d\] %p %m (%c)%n  
14.    
15. log4j.appender.stateChangeAppender=org.apache.log4j.DailyRollingFileAppender  
16. log4j.appender.stateChangeAppender.DatePattern='.'yyyy-MM-dd-HH  
17. log4j.appender.stateChangeAppender.File=$\{kafka.logs.dir\}/state-change.log  
18. log4j.appender.stateChangeAppender.layout=org.apache.log4j.PatternLayout  
19. log4j.appender.stateChangeAppender.layout.ConversionPattern=\[%d\] %p %m (%c)%n  
20.    
21. log4j.appender.requestAppender=org.apache.log4j.DailyRollingFileAppender  
22. log4j.appender.requestAppender.DatePattern='.'yyyy-MM-dd-HH  
23. log4j.appender.requestAppender.File=$\{kafka.logs.dir\}/kafka-request.log  
24. log4j.appender.requestAppender.layout=org.apache.log4j.PatternLayout  
25. log4j.appender.requestAppender.layout.ConversionPattern=\[%d\] %p %m (%c)%n  
26.    
27. log4j.appender.cleanerAppender=org.apache.log4j.DailyRollingFileAppender  
28. log4j.appender.cleanerAppender.DatePattern='.'yyyy-MM-dd-HH  
29. log4j.appender.cleanerAppender.File=log-cleaner.log  
30. log4j.appender.cleanerAppender.layout=org.apache.log4j.PatternLayout  
31. log4j.appender.cleanerAppender.layout.ConversionPattern=\[%d\] %p %m (%c)%n  
32.    
33.    
34. log4j.appender.controllerAppender=org.apache.log4j.DailyRollingFileAppender  
35. log4j.appender.controllerAppender.DatePattern='.'yyyy-MM-dd-HH  
36. log4j.appender.controllerAppender.File=$\{kafka.logs.dir\}/controller.log  
37. log4j.appender.controllerAppender.layout=org.apache.log4j.PatternLayout  
38. log4j.appender.controllerAppender.layout.ConversionPattern=\[%d\] %p %m (%c)%n  
39.    
40. \# Turn on all our debugging info  
41. \#log4j.logger.kafka.producer.async.DefaultEventHandler=DEBUG, kafkaAppender  
42. \#log4j.logger.kafka.client.ClientUtils=DEBUG, kafkaAppender  
43. \#log4j.logger.kafka.perf=DEBUG, kafkaAppender  
44. \#log4j.logger.kafka.perf.ProducerPerformance$ProducerThread=DEBUG, kafkaAppender  
45. \#log4j.logger.org.I0Itec.zkclient.ZkClient=DEBUG  
46. log4j.logger.kafka=INFO, kafkaAppender  
47.    
48. log4j.logger.kafka.network.RequestChannel$=WARN, requestAppender  
49. log4j.additivity.kafka.network.RequestChannel$=**false**  
50.    
51. \#log4j.logger.kafka.network.Processor=TRACE, requestAppender  
52. \#log4j.logger.kafka.server.KafkaApis=TRACE, requestAppender  
53. \#log4j.additivity.kafka.server.KafkaApis=**false**  
54. log4j.logger.kafka.request.logger=WARN, requestAppender  
55. log4j.additivity.kafka.request.logger=**false**  
56.    
57.    
58. log4j.logger.kafka.controller=TRACE, controllerAppender  
59. log4j.additivity.kafka.controller=**false**  
60.    
61.    
62. log4j.logger.kafka.log.LogCleaner=INFO, cleanerAppender  
63. log4j.additivity.kafka.log.LogCleaner=**false**  
64. log4j.logger.kafka.log.Cleaner=INFO, cleanerAppender  
65. log4j.additivity.kafka.log.Cleaner=**false**  
66.    
67.    
68. log4j.logger.state.change.logger=TRACE, stateChangeAppender  
69. log4j.additivity.state.change.logger=**false**

**4）kafka replication设计机制**

> 概览:

其中一个broker被选举作为整个集群控制器，他将负责几个方面工作：

1.管理或领导分区变化.

2.create topic,delete topic

3.replicas(执行复制计划，复制partition)

集群控制器做出决定以后，操作信息或状态将永久注册并存储在zookeeper上，并且也可以通过RPC方式发送新的决定操作broker。控制器发布的决定来源真实，他将用于client请求路由和broker的重启或恢复状态。

如果有一个新的broker加入或启动。controller会通过RPC调用发出新的决定。

潜在的优点：

1.当leader发生变化时，更容易集中到一个地方做调试(排除故障)。

2.当leader发生变化时，ZK可以把读取/写状态信息成批广播到其他broker，因此当leader failover的时候会减少broker之间恢复的延迟时间。

3.需要更少的监听器。

4.使用更高效的RPC通信方式，代替在zookeeper中队列实现方式。

潜在的缺点：

需要考虑controller failover

## zookeeper中路径列表说明 ##

1.Controller path:存储当前controller信息.

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  /controller --> \{brokerid\} (ephemeral; created by controller)

2.Broker path:存储当前所有活着的brokers信息。

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  /brokers/ids/\[broker\_id\] --> host:port (ephemeral; created by admin)

3.存储一个主题的所有分区副本任务。对于每一个副本，我们存储的副本指派一个broker ID。第一个副本是首选的复制品。注意，对于一个给定的分区，在一个broker上有至多一个副本。因此，broker ID可以作副本标识.

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  /brokers/topics/\[topic\]/\[partition\_id\]/leaderAndISR --> \{leader\_epoc: epoc, leader: broker\_id, ISR: \{broker1, broker2\}\}  
2.  此路径被controller或leader修改，当前leader只修改ISR一部分信息。当更新path需要使用条件同步到zookeeper上。

4.LeaderAndISR path:存储一个分区leader and ISR

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

5.分区分配path：当我们重新分配某些分区到不同的brokers时，此path会被使用。对于每个分区重新分配，他将会存储一个新副本列表和他们相应的brokers信息。

每当某个管理员操作如下命令成功后，且这个分区迁移到目标broker成功后，源broker上的分区会自动删除。

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  /admin/partitions\_add/\[topic\]/\[partition\_id\] --> \{broker\_id …\} (created by admin)  
2.  /admin/partitions\_remove/\[topic\]/\[partition\_id\] (created by admin)

## kafka中专有词语解释： ##

AR(assign replicas):分配副本  ISR(in-sync replicas)：在同步中的副本

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  Replica \{                                // 一个分区副本信息  
2.    broker\_id               : **int**  
3.    partition               : Partition    //分区信息  
4.    log                     : Log          //本地日志与副本关联信息  
5.    hw                      : **long**         //最后被commit的message的offset信息  
6.    leo                     : **long**         // 日志结尾offset  
7.    isLeader                : Boolean      //是否为该副本的leader  
8.  \}  
9.      
10. Partition \{                              //topic名称  
11.   topic                   : string  
12.   partition\_id            : **int**  
13.   leader                  : Replica      // 这个分区的leader副本  
14.   ISR                     : Set\[Replica\] // 正在同步中的副本集合  
15.   AR                      : Set\[Replica\] // 这个分区的所有副本分配集合  
16.   LeaderAndISRVersionInZK : **long**         // version id of the LeaderAndISR path; used for conditionally update the LeaderAndISR path in ZK  
17. \}  
18.     
19. LeaderAndISRRequest \{  
20.   request\_type\_id         : int16 // 当前request的版本  
21.   version\_id              : int16 // request的版本号  
22.   client\_id               : int32 // this can be the broker id of the controller  
23.   ack\_timeout             : int32 // the time in ms to wait for a response  
24.   isInit                  : **byte**  // whether this is the first command issued by a controller  
25.   leaderAndISRMap         : Map\[(topic: String, partitionId: int32) => LeaderAndISR) // a map of LeaderAndISR  
26. \}  
27.     
28. LeaderAndISR \{  
29.   leader                  : int32          // leader的broker编号  
30.   leaderEpoc              : int32          // leader epoc, incremented on each leadership change  
31.   ISR                     : Set\[int32\]     // 所有在ISR复制副本的broker集合  
32.   zkVersion               : int64          // version of the LeaderAndISR path in ZK  
33. \}  
34.     
35. LeaderAndISRResponse \{  
36.   version\_id              : int16 // 当前request的版本  
37.   responseMap             : Map\[(topic: String, partitionId: int32) => int16) // error code表  
38. \}  
39.     
40. StopReplicaRequest \{  
41.   request\_type\_id         : int16 // request id  
42.   version\_id              : int16 // 当前request的版本  
43.   client\_id               : int32 // this can be the broker id of the controller  
44.   ack\_timeout             : int32 // ack响应时间，单位为毫秒  
45.   stopReplicaSet          : Set\[(topic: String, partitionId: **int**)) // 需要停止的分区集合  
46. \}  
47.     
48. StopReplicaResponse \{  
49.   version\_id              : int16 // 当前request的版本  
50.   responseMap             : Map\[(topic: String, partitionId: int32) => int16) //error code表  
51. \}

**5）apache kafka监控系列-监控指标**

## **1、监控目标** ##

##     1.当系统可能或处于亚健康状态时及时提醒，预防故障发生 ##

##     2.报警提示 a.短信方式 b.邮件 ##

## 2、监控内容 ##

**2.1 机器监控**

Kafka服务器指标

1.  CPU Load
2.  Disk IO
3.  Memory
4.  磁盘log.dirs目录下数据文件大小,要有定时清除策略

**2.2 JVM监控**

主要监控JAVA的 GC time(垃圾回收时间)，JAVA的垃圾回收机制对性能的影响比较明显

**2.3 Kafka系统监控**

1、Kafka总体监控

*  zookeeper上/XXX/broker/ids目录下节点数量
 *  leader 选举频率

2、Kafka Broker监控

*  kafka集群中Broker列表,broker运行状况,包括node下线，活跃数量
 *  Broker是否提供服务
 *  数据流量  流入速度，流出速度 (message / byte)
 *  ISR 收缩频率

3、Kafka Controller监控

*  controller存活数目

4、Kafka Producer监控

*  producer数量，排队情况
 *  请求响应时间
 *  QPS/分钟

5、Kafka Consumer监控

*  consumer队列中排队请求数
 *  请求响应时间
 *  最近一分钟平均每秒请求数

6、Topic监控

*  数据量大小；
 *  offset
 *  数据流量 流入速度，流出速度 (message / byte)

3.监控指标

## 3.1 JVM监控 ##

## a.通过JMX获取GC time ##

## b.jvm full gc次数 ##

c.通过jmx监控kafka相关参数

**3.2 kafka系统监控**

**监控数据获取方式**

1、生存节点信息可以从zookeeper获取

2、除生存节点 和

a、Broker是否提供服务。

b、Topic数据量大小，

c、Topic的offset 外，其他数据都可以通过JMX获取

6）kafka.common.ConsumerRebalanceFailedException异常解决办法

kafka.common.ConsumerRebalanceFailedException :log-push-record-consumer-group\_mobile-pushremind02.lf.xxx.com-1399456594831-99f15e63 can't rebalance after 3 retries

at kafka.consumer.ZookeeperConsumerConnector$ZKRebalancerListener.syncedRebalance(Unknown Source)  
at kafka.consumer.ZookeeperConsumerConnector.kafka$consumer$ZookeeperConsumerConnector$$reinitializeConsumer(Unknown Source)  
at kafka.consumer.ZookeeperConsumerConnector.consume(Unknown Source)  
at kafka.javaapi.consumer.ZookeeperConsumerConnector.createMessageStreams(Unknown Source)  
at com.xxx.mafka.client.consumer.DefaultConsumerProcessor.getKafkaStreams(DefaultConsumerProcessor.java:149)  
at com.xxx.mafka.client.consumer.DefaultConsumerProcessor.recvMessage(DefaultConsumerProcessor.java:63)  
at com.xxx.service.mobile.push.kafka.MafkaPushRecordConsumer.main(MafkaPushRecordConsumer.java:22)

at com.xxx.service.mobile.push.Bootstrap.main(Bootstrap.java:34)

## 出现以上问题原因分析： ##

同一个消费者组(consumer group)有多个consumer先后启动，就是一个消费者组内有多个consumer同时负载消费多个partition数据.

解决办法：

1.配置zk问题(kafka的consumer配置)

**zookeeper.session.timeout.ms=5000**

**zookeeper.connection.timeout.ms=10000**

**zookeeper.sync.time.ms=2000**

在使用高级API过程中，一般出现这个问题是zookeeper.sync.time.ms时间间隔配置过短，不排除有其他原因引起，但笔者遇到一般是这个原因。

给大家解释一下原因：一个消费者组中(consumer数量<partitions数量)每当有consumer发送变化，会触发负载均衡。第一件事就是释放当consumer资源，无则免之，调用ConsumerFetcherThread关闭并释放当前kafka broker所有连接，释放当前消费的partitons，实际就是删除临时节点(/xxx/consumer/owners/topic-xxx/partitions\[0-n\]),所有同一个consumer group内所有consumer通过计算获取本consumer要消费的partitions，然后本consumer注册相应临时节点卡位，代表我拥有该partition的消费所有权，其他consumer不能使用。

如果大家理解上面解释，下面就更容易了，当consumer调用Rebalance时，它是按照时间间隔和最大次数采取失败重试原则，每当获取partitions失败后会重试获取。举个例子，假如某个公司有个会议，B部门在某个时间段预订该会议室，但是时间到了去会议室看时，发现A部门还在使用。这时B部门只有等待了，每隔一段时间去询问一下。如果时间过于频繁，则会议室一直会处于占用状态，如果时间间隔设置长点，可能去个2次，A部门就让出来了。

同理，当新consumer加入重新触发rebalance时，已有(old)的consumer会重新计算并释放占用partitions，但是会消耗一定处理时间，此时新(new)consumer去抢占该partitions很有可能就会失败。我们假设设置足够old consumer释放资源的时间，就不会出现这个问题。

zookeeper.sync.time.ms时间设置过短就会导致old consumer还没有来得及释放资源，new consumer重试失败多次到达阀值就退出了。

zookeeper.sync.time.ms设置时间阀值，要考虑网络环境，服务器性能等因素在内综合衡量。

**kafka zk节点存储，请参考：[kafka在zookeeper中存储结构][kafka_zookeeper]**

**7）kafak安装与使用**

# kafak安装与使用 #

## 1.前言 ##

学习kafka的基础是先把kafka系统部署起来，然后简单的使用它，从直观上感觉它，然后逐步的深入了解它。  
本文介绍了kafka部署方法，包括配置，安装和简单的使用。

## 2.kafka下载和安装 ##

kafka版本一直在更新，且每次更新，变化均比较大，如配置文件有改动，kafka 0.7到0.8.1版本变化很大，包括加入，支持集群内复制，支持多个数据目录，请求处理改为异步，实现partition动态管理，基于时间的日志段删除

### 2.1下载地址： ###

https://www.apache.org/dyn/closer.cgi?path=/kafka/0.8.1.1/kafka\_2.10-0.8.1.1.tgz。

kafka目录结构

如 图-1

![20140504170822953][]

说明:涂黑部分为我自己创建文件夹

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0); border-collapse:collapse"> 
 <tbody> 
 <tr> 
 <td style="width:63px; height:9px; border:1px solid rgb(0,0,0); padding:4px"> 目录 </td> 
 <td style="width:469px; height:9px; border:1px solid rgb(0,0,0); padding:4px"> 说明 </td> 
 </tr> 
 <tr> 
 <td style="width:63px; height:11px; border:1px solid rgb(0,0,0); padding:4px"> bin </td> 
 <td style="width:469px; height:11px; border:1px solid rgb(0,0,0); padding:4px"> 操作kafka的可执行脚本，还包含windows下脚本 </td> 
 </tr> 
 <tr> 
 <td style="width:63px; height:12px; border:1px solid rgb(0,0,0); padding:4px"> config </td> 
 <td style="width:469px; height:12px; border:1px solid rgb(0,0,0); padding:4px"> 配置文件所在目录 </td> 
 </tr> 
 <tr> 
 <td style="width:63px; height:11px; border:1px solid rgb(0,0,0); padding:4px"> libs </td> 
 <td style="width:469px; height:11px; border:1px solid rgb(0,0,0); padding:4px"> 依赖库目录 </td> 
 </tr> 
 <tr> 
 <td style="width:63px; height:11px; border:1px solid rgb(0,0,0); padding:4px"> logs </td> 
 <td style="width:469px; height:11px; border:1px solid rgb(0,0,0); padding:4px"> 日志数据目录，目录kafka把server端日志分为5种类型，分为:server,request,state，log-cleaner，controller </td> 
 </tr> 
 </tbody> 
</table>

### 2.1 安装以及启动kafka ###

#### 步骤1： ####

lizhitao@localhost:~$ tar -xzf kafka\_2.10-0.8.1.1.tgz  
lizhitao@localhost:~$ cd kafka\_2.10-0.8.1.1.tgz

#### 步骤2： ####

配置zookeeper(假设您已经安装了zookeeper,如果没有安装，请再网上搜索安装方法)

进入kafka安装工程根目录编辑 vim config/server.properties  修改属性zookeeper.connect=ip:8081,ip2:8082

#### 步骤3： ####

kafka最为重要三个配置依次为：broker.id、log.dir、zookeeper.connect

kafka server端config/server.properties参数说明和解释如下:

[server.properties配置属性说明][server.properties]

根据属性说明完成配置

broker.id = 1

port = 9092

#### 步骤4： 启动服务 ####

cd kafka-0.8.1

lizhitao@localhost:~$ bin/kafka-server-start.sh config/server.properties

\[2014-04-16 15:01:47,028\] INFO Verifying properties (kafka.utils.VerifiableProperties)

\[2014-04-16 15:01:47,051\] INFO Property socket.send.buffer.bytes is overridden to 1048576 (kafka.utils.VerifiableProperties)

...

#### 步骤5：创建topic ####

**lizhitao@localhost:~$ bin/kafka-topics.sh --create --zookeeper localhost:2181 --replication-factor 1 --partitions 1 --topic test**

#### 步骤6：验证topic是否创建成功 ####

**lizhitao@localhost:~$ bin/kafka-topics.sh --list --zookeeper localhost:2181**

test

Alternatively, instead of manually creating topics you can also configure your brokers to auto-create topics when a non-existent topic is published to.

步骤7：发送一些消息验证，在console模式下，启动producer

**bin/kafka-console-producer.sh --broker-list localhost:9092 --topic test**

**This is a message**

**This is another message**

步骤7:启动一个consumer

**lizhitao@localhost:~$ bin/kafka-console-consumer.sh --zookeeper localhost:2181 --topic test --from-beginning**

This is a message

This is another message

## 3.配置kafka集群模式，需要由多个broker组成 ##

### 步骤1： ###

**因为需要在同一个目录（config）下配置多个server.properties，操作步骤如下：**

**lizhitao@localhost:~$ ****cp config/server.properties config/server-1.properties**

**lizhitao@localhost:~$ **cp config/server.properties config/server-2.properties

### 步骤2： ###

需要编辑并设置如下文件属性：

config/server-1.properties:

broker.id=1

port=9093

log.dir=/tmp/kafka-logs-1

config/server-2.properties:

broker.id=2

port=9094

log.dir=/tmp/kafka-logs-2

启动服务

**lizhitao@localhost:~$ ****bin/kafka-server-start.sh config/server-1.properties &**

...

**lizhitao@localhost:~$ ****bin/kafka-server-start.sh config/server-2.properties &**

...

### 步骤3： ###

创建topic

**lizhitao@localhost:~$ bin/kafka-topics.sh --create --zookeeper localhost:2181 --replication-factor 3 --partitions 1 --topic my-replicated-topic**

.....

topic created success....

**lizhitao@localhost:~$ bin/kafka-topics.sh --describe --zookeeper localhost:2181 --topic my-replicated-topic**

Topic:my-replicated-topic     PartitionCount:1    ReplicationFactor:3Configs:

Topic: my-replicated-topic     Partition: 0Leader: 1Replicas: 1,2,0Isr: 1,2,0

描述topic中分区，同步副本情况

**lizhitao@localhost:~$ bin/kafka-topics.sh --describe --zookeeper localhost:2181 --topic test**

Topic:test PartitionCount:1 ReplicationFactor:1Configs:

Topic: test Partition: 0 Leader: 0Replicas: 0Isr: 0

### 步骤4：作为生产者发送消息 ###

**lizhitao@localhost:~$ bin/kafka-console-producer.sh --broker-list localhost:9092 --topic my-replicated-topic**

...

my test message 1

my test message 2

### **步骤5：消费topic数据** ###

**lizhitao@localhost:~$ bin/kafka-console-consumer.sh --zookeeper localhost:2181 --from-beginning --topic my-replicated-topic**

...

my test message 1

my test message 2

### 步骤6： ###

检查consumer offset位置

**lizhitao@localhost:~$ bin/kafka-run-class.sh kafka.tools.ConsumerOffsetChecker --zkconnect localhost:2181 --group test**

Group           Topic                          Pid Offset          logSize         Lag             Owner

my-group        my-topic                       0   0               0               0               test\_jkreps-mn-1394154511599-60744496-0

my-group        my-topic                       1   0               0               0               test\_jkreps-mn-1394154521217-1a0be913-0

**8）apache kafka中server.properties配置文件参数说明**

每个kafka broker中配置文件server.properties默认必须配置的属性如下：

**\[java\]**  [view plain][view plain 2] [copy][view plain 2] [![在CODE上查看代码片][CODE]][CODE_CODE 2] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 3]

1.  broker.id=0  
2.  num.network.threads=2  
3.  num.io.threads=8  
4.  socket.send.buffer.bytes=1048576  
5.  socket.receive.buffer.bytes=1048576  
6.  socket.request.max.bytes=104857600  
7.  log.dirs=/tmp/kafka-logs  
8.  num.partitions=2  
9.  log.retention.hours=168  
10.   
11. log.segment.bytes=536870912  
12. log.retention.check.interval.ms=60000  
13. log.cleaner.enable=**false**  
14.   
15. zookeeper.connect=localhost:2181  
16. zookeeper.connection.timeout.ms=1000000

server.properties中所有配置参数说明(解释)如下列表：

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0); border-collapse:collapse"> 
 <tbody> 
 <tr> 
 <td style="width:175px; height:12px; border-style:solid; border-width:1px; border-color:rgb(33,33,33) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> 参数 </td> 
 <td style="width:381px; height:12px; border-style:solid; border-width:1px; border-color:rgb(33,33,33) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 说明(解释) </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:28px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> broker.id =0 </td> 
 <td style="width:381px; height:28px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 每一个broker在集群中的唯一表示，要求是正数。当该服务器的IP地址发生改变时，broker.id没有变化，则不会影响consumers的消息情况 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.dirs=/data/kafka-logs </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> kafka数据的存放地址，多个地址的话用逗号分割,多个目录分布在不同磁盘上可以提高读写性能 &nbsp;/data/kafka-logs-1，/data/kafka-logs-2 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:15px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> port =9092 </td> 
 <td style="width:381px; height:15px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> broker server服务端口 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> message.max.bytes =6525000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 表示消息体的最大大小，单位是字节 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> num.network.threads =4 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> broker处理消息的最大线程数，一般情况下不需要去修改 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:15px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> num.io.threads =8 </td> 
 <td style="width:381px; height:15px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> broker处理磁盘IO的线程数，数值应该大于你的硬盘数 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> background.threads =4 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 一些后台任务处理的线程数，例如过期消息文件的删除等，一般情况下不需要去做修改 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:43px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> queued.max.requests =500 </td> 
 <td style="width:381px; height:43px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 等待IO线程处理的请求队列最大数，若是等待IO的请求超过这个数值，那么会停止接受外部消息，应该是一种自我保护机制。 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> host.name </td> 
 <td style="width:381px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> broker的主机地址，若是设置了，那么会绑定到这个地址上，若是没有，会绑定到所有的接口上，并将其中之一发送到ZK，一般不设置 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> socket.send.buffer.bytes=100*1024 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> socket的发送缓冲区，socket的调优参数SO_SNDBUFF </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> socket.receive.buffer.bytes =100*1024 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> socket的接受缓冲区，socket的调优参数SO_RCVBUFF </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:63px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> socket.request.max.bytes =100*1024*1024 </td> 
 <td style="width:381px; height:63px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> socket请求的最大数值，防止serverOOM，message.max.bytes必然要小于socket.request.max.bytes，会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.segment.bytes =1024*1024*1024 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> topic的分区是以一堆segment文件存储的，这个控制每个segment的大小，会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.roll.hours =24*7 </td> 
 <td style="width:381px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 这个参数会在日志segment没有达到log.segment.bytes设置的大小，也会强制新建一个segment会被&nbsp;topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleanup.policy = delete </td> 
 <td style="width:381px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志清理策略选择有：delete和compact主要针对过期数据的处理，或是日志文件达到限制的额度，会被&nbsp;topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:92px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.retention.minutes=3days </td> 
 <td style="width:381px; height:92px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 数据存储的最大时间超过这个时间会根据log.cleanup.policy设置的策略处理数据，也就是消费端能够多久去消费数据 log.retention.bytes和log.retention.minutes任意一个达到要求，都会执行删除，会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:79px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.retention.bytes=-1 </td> 
 <td style="width:381px; height:79px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> topic每个分区的最大文件大小，一个topic的大小限制&nbsp;=&nbsp;分区数*log.retention.bytes。-1没有大小限log.retention.bytes和log.retention.minutes任意一个达到要求，都会执行删除，会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.retention.check.interval.ms=5minutes </td> 
 <td style="width:381px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 文件大小检查的周期时间，是否处罚&nbsp;log.cleanup.policy中设置的策略 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.enable=false </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 是否开启日志压缩 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.threads =&nbsp;2 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志压缩运行的线程数 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.io.max.bytes.per.second=None </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志压缩时候处理的最大大小 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.dedupe.buffer.size=500*1024*1024 </td> 
 <td style="width:381px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志压缩去重时候的缓存空间，在空间允许的情况下，越大越好 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.io.buffer.size=512*1024 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志清理时候用到的IO块大小一般不需要修改 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.io.buffer.load.factor =0.9 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志清理中hash表的扩大因子一般不需要修改 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.backoff.ms =15000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 检查是否处罚日志清理的间隔 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.min.cleanable.ratio=0.5 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 日志清理的频率控制，越大意味着更高效的清理，同时会存在一些空间上的浪费，会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:60px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.cleaner.delete.retention.ms =1day </td> 
 <td style="width:381px; height:60px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 对于压缩的日志保留的最长时间，也是客户端消费消息的最长时间，同log.retention.minutes的区别在于一个控制未压缩数据，一个控制压缩后的数据。会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.index.size.max.bytes =10*1024*1024 </td> 
 <td style="width:381px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 对于segment日志的索引文件大小限制，会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.index.interval.bytes =4096 </td> 
 <td style="width:381px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 当执行一个fetch操作后，需要一定的空间来扫描最近的offset大小，设置越大，代表扫描速度越快，但是也更好内存，一般情况下不需要搭理这个参数 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:114px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.flush.interval.messages=None </td> 
 <td style="width:381px; height:114px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> log文件”sync”到磁盘之前累积的消息条数,因为磁盘IO操作是一个慢操作,但又是一个”数据可靠性"的必要手段,所以此参数的设置,需要在"数据可靠性"与"性能"之间做必要的权衡.如果此值过大,将会导致每次"fsync"的时间较长(IO阻塞),如果此值过小,将会导致"fsync"的次数较多,这也意味着整体的client请求有一定的延迟.物理server故障,将会导致没有fsync的消息丢失. </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.flush.scheduler.interval.ms =3000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 检查是否需要固化到硬盘的时间间隔 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:49px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.flush.interval.ms = None </td> 
 <td style="width:381px; height:49px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 仅仅通过interval来控制消息的磁盘写入时机,是不足的.此参数用于控制"fsync"的时间间隔,如果消息量始终没有达到阀值,但是离上一次磁盘同步的时间间隔达到阀值,也将触发. </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.delete.delay.ms =60000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 文件在索引中清除后保留的时间一般不需要去修改 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> log.flush.offset.checkpoint.interval.ms =60000 </td> 
 <td style="width:381px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 控制上次固化硬盘的时间点，以便于数据恢复一般不需要去修改 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> auto.create.topics.enable =true </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 是否允许自动创建topic，若是false，就需要通过命令创建topic </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> default.replication.factor =1 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 是否允许自动创建topic，若是false，就需要通过命令创建topic </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> num.partitions =1 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 每个topic的分区个数，若是在topic创建时候没有指定的话会被topic创建时的指定参数覆盖 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:15px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> </td> 
 <td style="width:381px; height:15px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> 以下是kafka中Leader,replicas配置参数 </td> 
 <td style="width:381px; height:46px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> controller.socket.timeout.ms =30000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> partition&nbsp;leader与replicas之间通讯时,socket的超时时间 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> controller.message.queue.size=10 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> partition&nbsp;leader与replicas数据同步时,消息的队列尺寸 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:49px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.lag.time.max.ms =10000 </td> 
 <td style="width:381px; height:49px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> replicas响应partition&nbsp;leader的最长等待时间，若是超过这个时间，就将replicas列入ISR(in-sync replicas)，并认为它是死的，不会再加入管理中 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:146px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.lag.max.messages =4000 </td> 
 <td style="width:381px; height:146px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 如果follower落后与leader太多,将会认为此follower[或者说partition&nbsp;relicas]已经失效 ##通常,在follower与leader通讯时,因为网络延迟或者链接断开,总会导致replicas中消息同步滞后 ##如果消息之后太多,leader将认为此follower网络延迟较大或者消息吞吐能力有限,将会把此replicas迁移 ##到其他follower中. ##在broker数量较少,或者网络不足的环境中,建议提高此值. </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.socket.timeout.ms=30*1000 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> follower与leader之间的socket超时时间 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.socket.receive.buffer.bytes=64*1024 </td> 
 <td style="width:381px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> leader复制时候的socket缓存大小 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.fetch.max.bytes =1024*1024 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> replicas每次获取数据的最大大小 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.fetch.wait.max.ms =500 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> replicas同leader之间通信的最大等待时间，失败了会重试 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.fetch.min.bytes =1 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> fetch的最小数据尺寸,如果leader中尚未同步的数据不足此值,将会阻塞,直到满足条件 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> num.replica.fetchers=1 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> leader进行复制的线程数，增大这个数值会增加follower的IO </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> replica.high.watermark.checkpoint.interval.ms =5000 </td> 
 <td style="width:381px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 每个replica检查是否将最高水位进行固化的频率 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> controlled.shutdown.enable =false </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 是否允许控制器关闭broker ,若是设置为true,会关闭所有在这个broker上的leader，并转移到其他broker </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> controlled.shutdown.max.retries =3 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 控制器关闭的尝试次数 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> controlled.shutdown.retry.backoff.ms =5000 </td> 
 <td style="width:381px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 每次关闭尝试的时间间隔 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> leader.imbalance.per.broker.percentage =10 </td> 
 <td style="width:381px; height:47px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> leader的不平衡比例，若是超过这个数值，会对分区进行重新的平衡 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> leader.imbalance.check.interval.seconds =300 </td> 
 <td style="width:381px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 检查leader是否不平衡的时间间隔 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> offset.metadata.max.bytes </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> 客户端保留offset信息的最大空间大小 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:29px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> kafka中zookeeper参数配置 </td> 
 <td style="width:381px; height:29px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> zookeeper.connect = localhost:2181 </td> 
 <td style="width:381px; height:48px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> zookeeper集群的地址，可以是多个，多个之间用逗号分割hostname1:port1,hostname2:port2,hostname3:port3 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> zookeeper.session.timeout.ms=6000 </td> 
 <td style="width:381px; height:32px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> ZooKeeper的最大超时时间，就是心跳的间隔，若是没有反映，那么认为已经死了，不易过大 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(0,0,0) rgb(33,33,33); padding:4px"> zookeeper.connection.timeout.ms =6000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(0,0,0) rgb(0,0,0); padding:4px"> ZooKeeper的连接超时时间 </td> 
 </tr> 
 <tr> 
 <td style="width:175px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(0,0,0) rgb(33,33,33) rgb(33,33,33); padding:4px"> zookeeper.sync.time.ms =2000 </td> 
 <td style="width:381px; height:31px; border-style:solid; border-width:1px; border-color:rgb(0,0,0) rgb(33,33,33) rgb(33,33,33) rgb(0,0,0); padding:4px"> ZooKeeper集群中leader和follower之间的同步实际那 </td> 
 </tr> 
 </tbody> 
</table>

**9）apache kafka的consumer初始化时获取不到消息**

问题

发现一个问题，如果使用的是一个高级的kafka接口 那么默认的情况下如果某个topic没有变化 则consumer消费不到消息 比如某个消息生产了2w条，此时producer不再生产消息，然后另外一个consumer启动，此时拿不到消息.

原因解释：

auto.offset.reset：如果zookeeper没有offset值或offset值超出范围。那么就给个初始的offset。有smallest、largest、anything可选，分别表示给当前最小的offset、当前最大的offset、抛异常。默认largest

默认值:auto.offset.reset=largest

**10）Kafka Producer处理逻辑**

Kafka Producer处理逻辑

Kafka Producer产生数据发送给Kafka Server，具体的分发逻辑及负载均衡逻辑，全部由producer维护。

## Kafka结构图 ##

![Center][]

## Kafka Producer默认调用逻辑 ##

![20140523114138265][]

默认Partition逻辑

**1、没有key时的分发逻辑**

每隔 topic.metadata.refresh.interval.ms 的时间，随机选择一个partition。这个时间窗口内的所有记录发送到这个partition。

发送数据出错后也会重新选择一个partition

**2、根据key分发**

对key求hash，然后对partition数量求模

如何获取Partition的leader信息(元数据)

决定好发送到哪个Partition后，需要明确该Partition的leader是哪台broker才能决定发送到哪里。

**具体实现位置**

** 实现方案**

1、从broker获取Partition的元数据。由于Kafka所有broker存有所有的元数据，所以任何一个broker都可以返回所有的元数据

2、broker选取策略：将broker列表随机排序，从首个broker开始访问，如果出错，访问下一个

3、出错处理：出错后向下一个broker请求元数据

**注意**

*  Producer是从broker获取元数据的，并不关心zookeeper。
 *  broker发生变化后，producer获取元数据的功能不能动态变化。
 *  获取元数据时使用的broker列表由producer的配置中的 metadata.broker.list 决定。该列表中的机器只要有一台正常服务，producer就能获取元数据。
 *  获取元数据后，producer可以写数据到非 metadata.broker.list 列表中的broker

错误处理

producer的send函数默认没有返回值。出错处理有EventHandler实现。

DefaultEventHandler的错误处理如下：

*  获取出错的数据
 *  等待一个间隔时间，由配置 retry.backoff.ms 决定这段时间长短
 *  重新获取元数据
 *  重新发送数据

出错重试次数由配置 message.send.max.retries 决定

所有重试全部失败时，DefaultEventHandler会抛出异常。代码如下

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  **if**(outstandingProduceRequests.size >0) \{  
2.    producerStats.failedSendRate.mark()  
3.    val correlationIdEnd = correlationId.get()  
4.    error("Failed to send requests for topics %s with correlation ids in \[%d,%d\]"  
5.      .format(outstandingProduceRequests.map(\_.topic).toSet.mkString(","),  
6.      correlationIdStart, correlationIdEnd-1))  
7.    thrownewFailedToSendMessageException("Failed to send messages after "\+ config.messageSendMaxRetries +" tries.",**null**)  
8.  \}

**11）apache kafka源代码工程环境搭建(IDEA)**

## 1.[gradle安装][gradle] ##

[gradle安装][gradle]

## 2.下载apache kafka源代码 ##

[apache kafka下载][apache kafka 1]

## 3.用gradle构建产生IDEA工程文件 ##

**先装好idea的scala插件，不然构建时就会自动下载，由于没有国内镜像，速度会很慢。**

lizhitao@users-MacBook-Pro:~/Downloads/kafka\_2.10-0.8.1$ gradle idea

如果是eclipse工程，执行:gradle eclipse

生成IDEA工程文件如下:

![20140524232649546][]

## 4.项目导入到IDEA工程中 ##

File-->Open

![20140524233201312][]

## 5.IDEA中查看源码工程 ##

![20140524233527218][]

## 6.Kafka启动时，参数设置 ##

[配置server.properties][server.properties 1]

![20140524233845781][]

## 7.log4j.properties文件路径设置 ##

启动kafka server很奇怪，log4j.properties文件找不到，报如下错误。

**log4j:WARN No appenders could be found for logger (kafka.utils.VerifiableProperties).log4j:WARN Please initialize the log4j system properly.**

只有把log4j.properties放置到src/main/scala路径下，才能找到文件,然后运行程序，正确输出日志信息。输出如下所示

![20140524234413765][]

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1. \[2014\-05\-24 23:45:31,965\] INFO Verifying properties (kafka.utils.VerifiableProperties)    
2. \[2014\-05\-24 23:45:32,009\] INFO Property broker.id is overridden to 9 (kafka.utils.VerifiableProperties)    
3. \[2014\-05\-24 23:45:32,009\] INFO Property log.cleaner.enable is overridden to **false** (kafka.utils.VerifiableProperties)    
4. \[2014\-05\-24 23:45:32,009\] INFO Property log.dirs is overridden to /Users/lizhitao/kafka-logs (kafka.utils.VerifiableProperties)    
5. \[2014\-05\-24 23:45:32,009\] INFO Property log.retention.check.interval.ms is overridden to 60000 (kafka.utils.VerifiableProperties)    
6. \[2014\-05\-24 23:45:32,010\] INFO Property log.retention.hours is overridden to 168 (kafka.utils.VerifiableProperties)    
7. \[2014\-05\-24 23:45:32,010\] INFO Property log.segment.bytes is overridden to 536870912 (kafka.utils.VerifiableProperties)    
8. \[2014\-05\-24 23:45:32,010\] INFO Property num.io.threads is overridden to 8 (kafka.utils.VerifiableProperties)    
9. \[2014\-05\-24 23:45:32,010\] INFO Property num.network.threads is overridden to 2 (kafka.utils.VerifiableProperties)    
10. \[2014\-05\-24 23:45:32,010\] INFO Property num.partitions is overridden to 2 (kafka.utils.VerifiableProperties)    
11. \[2014\-05\-24 23:45:32,010\] INFO Property port is overridden to 9092 (kafka.utils.VerifiableProperties)    
12. \[2014\-05\-24 23:45:32,010\] INFO Property socket.receive.buffer.bytes is overridden to 1048576 (kafka.utils.VerifiableProperties)    
13. \[2014\-05\-24 23:45:32,011\] INFO Property socket.request.max.bytes is overridden to 104857600 (kafka.utils.VerifiableProperties)    
14. \[2014\-05\-24 23:45:32,011\] INFO Property socket.send.buffer.bytes is overridden to 1048576 (kafka.utils.VerifiableProperties)    
15. \[2014\-05\-24 23:45:32,011\] INFO Property zookeeper.connect is overridden to 192.168.2.225:2181,192.168.2.225:2182,192.168.2.225:2183 (kafka.utils.VerifiableProperties)    
16. \[2014\-05\-24 23:45:32,011\] INFO Property zookeeper.connection.timeout.ms is overridden to 1000000 (kafka.utils.VerifiableProperties)    
17. \[2014\-05\-24 23:45:32,032\] INFO \[Kafka Server 9\], starting (kafka.server.KafkaServer)    
18. \[2014\-05\-24 23:45:32,036\] INFO \[Kafka Server 9\], Connecting to zookeeper on 192.168.2.225:2181,192.168.2.225:2182,192.168.2.225:2183 (kafka.server.KafkaServer)    
19. \[2014\-05\-24 23:45:32,045\] INFO Starting ZkClient event thread. (org.I0Itec.zkclient.ZkEventThread)    
20. \[2014\-05\-24 23:45:32,370\] INFO Client environment:zookeeper.version=3.3.3\-1203054, built on 11/17/2011 05:47 GMT (org.apache.zookeeper.ZooKeeper)    
21. \[2014\-05\-24 23:45:32,370\] INFO Client environment:host.name=192.168.2.104 (org.apache.zookeeper.ZooKeeper)    
22. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.version=1.7.0\_55 (org.apache.zookeeper.ZooKeeper)    
23. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.vendor=Oracle Corporation (org.apache.zookeeper.ZooKeeper)    
24. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.home=/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre (org.apache.zookeeper.ZooKeeper)    
25. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.**class**.path=/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/ant-javafx.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/dt.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/javafx-doclet.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/javafx-mx.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/jconsole.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/sa-jdi.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/lib/tools.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/charsets.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/deploy.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/htmlconverter.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/javaws.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/jce.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/jfr.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/jfxrt.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/jsse.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/management-agent.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/plugin.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/resources.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/rt.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/ext/dnsns.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/ext/localedata.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/ext/sunec.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/ext/sunjce\_provider.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/ext/sunpkcs11.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0\_55.jdk/Contents/Home/jre/lib/ext/zipfs.jar:/Users/lizhitao/mt\_wp/open\_source/kafka-platform/kafka-0.8.1\-src/out/production/core:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/org.scala-lang/scala-library/2.8.0/95bf967bf2e0a26727736228bba3451f4dd3e5b9/scala-library-2.8.0.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/org.apache.zookeeper/zookeeper/3.3.4/6471e17c92181da9e143559c4c4779925a5e6eb0/zookeeper-3.3.4.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/com.101tec/zkclient/0.3/dedcf2b53fb742adba7080ac3aed781694ba616e/zkclient-0.3.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/com.yammer.metrics/metrics-core/2.2.0/f82c035cfa786d3cbec362c38c22a5f5b1bc8724/metrics-core-2.2.0.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/com.yammer.metrics/metrics-annotation/2.2.0/62962b54c490a95c0bb255fa93b0ddd6cc36dd4b/metrics-annotation-2.2.0.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/net.sf.jopt-simple/jopt-simple/3.2/d625f12ba08083c8c16dcedd5396ec730e9e77ab/jopt-simple-3.2.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/org.xerial.snappy/snappy-java/1.0.5/10cb4550360a0ec6b80f09a5209d00b6058e82bf/snappy-java-1.0.5.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/log4j/log4j/1.2.15/f0a0d2e29ed910808c33135a3a5a51bba6358f7b/log4j-1.2.15.jar:/Users/lizhitao/.gradle/caches/modules-2/files-2.1/org.slf4j/slf4j-api/1.7.2/81d61b7f33ebeab314e07de0cc596f8e858d97/slf4j-api-1.7.2.jar:/Applications/IntelliJ IDEA 12.app/lib/idea\_rt.jar (org.apache.zookeeper.ZooKeeper)    
26. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.library.path=/Users/lizhitao/Library/Java/Extensions:/Library/Java/Extensions:/Network/Library/Java/Extensions:/System/Library/Java/Extensions:/usr/lib/java:. (org.apache.zookeeper.ZooKeeper)    
27. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.io.tmpdir=/var/folders/pn/qjf0v4k52mq965jxjd72hlx00000gp/T/ (org.apache.zookeeper.ZooKeeper)    
28. \[2014\-05\-24 23:45:32,370\] INFO Client environment:java.compiler=<NA> (org.apache.zookeeper.ZooKeeper)    
29. \[2014\-05\-24 23:45:32,370\] INFO Client environment:os.name=Mac OS X (org.apache.zookeeper.ZooKeeper)    
30. \[2014\-05\-24 23:45:32,370\] INFO Client environment:os.arch=x86\_64 (org.apache.zookeeper.ZooKeeper)    
31. \[2014\-05\-24 23:45:32,371\] INFO Client environment:os.version=10.9.2 (org.apache.zookeeper.ZooKeeper)    
32. \[2014\-05\-24 23:45:32,371\] INFO Client environment:user.name=lizhitao (org.apache.zookeeper.ZooKeeper)    
33. \[2014\-05\-24 23:45:32,371\] INFO Client environment:user.home=/Users/lizhitao (org.apache.zookeeper.ZooKeeper)    
34. \[2014\-05\-24 23:45:32,371\] INFO Client environment:user.dir=/Users/lizhitao/mt\_wp/open\_source/kafka-platform/kafka-0.8.1\-src (org.apache.zookeeper.ZooKeeper)    
35. \[2014\-05\-24 23:45:32,372\] INFO Initiating client connection, connectString=192.168.2.225:2181,192.168.2.225:2182,192.168.2.225:2183 sessionTimeout=6000 watcher=org.I0Itec.zkclient.ZkClient@6e739617 (org.apache.zookeeper.ZooKeeper)    
36. \[2014\-05\-24 23:45:32,387\] INFO Opening socket connection to server /192.168.2.225:2181 (org.apache.zookeeper.ClientCnxn)    
37. \[2014\-05\-24 23:45:32,393\] ERROR Unable to open socket to 192.168.2.225/192.168.2.225:2181 (org.apache.zookeeper.ClientCnxn)

通过如上7步后就可以正确启动kafka程序，进行相关debug，并研究其源代码了。

**12）apache kafka监控系列-KafkaOffsetMonitor**

# 概览 #

最近kafka server消息服务上线了，基于jmx指标参数也写到zabbix中了，但总觉得缺少点什么东西，可视化可操作的界面。zabbix中数据比较分散，不能集中看整个集群情况。或者一个cluster中broker列表，自己写web-console比较耗时耗力，用原型工具画了一些管理界面东西，关键自己也不前端方面技术，这方面比较薄弱。这不开源社区提供了kafka的web管理平台KafkaOffsetMonitor.就迅速拿过来运行。大家不要着急，马上娓娓道来。

## 说明： ##

这个应用程序来实时监控你kafka服务的consumer以及他们在partition中的offset(偏移)。

你可以浏览当前的消费者组，每个topic的所有partition的消费情况都可以一览无余。这其实是很有用得，从这里你很快知道每个partition的message是否很快被消费(没有阻塞)。他能指导你(kafka producer和consumer)优化代码。

这个web管理平台保留的partition offset和consumer滞后的历史数据，所以你可以很轻易了解这几天consumer消费情况。

## KafkaOffsetMonitor功能： ##

1.从标题都可以看出来，Kafka Offset Monitor，是对consumer消费情况进行监控,并能列出每个consumer offset,滞后数据。

2.消费者组列表

3.每个topic的所有parition列表(topic,pid,offset,logSize,lag,owner)

4.查看topic的历史消费信息.

虽然功能覆盖面不全，但是很实用。

## 1.下载 ##

github官网下载

[KafkaOffsetMonitor][]

百度云下载(网速快)

[百度云KafkaOffsetMonitor下载][KafkaOffsetMonitor 1]

**说明**:**百度云下载为修改版本，因为KafkaOffsetMonitor中有些资源文件(css,js)是访问外网的，特别是有访问google资源，大家都懂的，经常不能访问。建议下载修改版**

## 2.安装 ##

KafkaOffsetMonitor运行比较简单，因为所有运行文件，资源文件，jar文件都打包到KafkaOffsetMonitor-assembly-0.2.0.jar了，直接运行就可以，这种方式太棒了。既不用编译也不用配置，呵呵，也不是绝对不配置。

a.新建一个目录kafka-offset-console,然后把jar拷贝到该目录下.

b.新建脚本，因为您可能不是一个kafka集群。用脚本可以启动多个

lizhitao@users-MacBook-Pro:   vim mobile\_start\_en.sh

\#!/bin/bashjava -Xms512M -Xmx512M -Xss1024K -XX:PermSize=256m -XX:MaxPermSize=512m -cp KafkaOffsetMonitor-assembly-0.2.0.jar \\     com.quantifind.kafka.offsetapp.OffsetGetterWeb \\     --zk 192.168.2.101:2181,192.168.2.102:2182,192.168.2.103:2181**/config/mobile/xxx** \\                    --port 8086 \\     --refresh 10.seconds \\     --retain 7.days 1>mobile-logs/stdout.log 2>mobile-logs/stderr.log &

注意:**/config/mobile/xxx**  表示zk的根目录,需要手工创建,也可以不设置

## 3.运行 ##

lizhitao@users-MacBook-Pro:  chmod +x mobile\_start\_en.sh

lizhitao@users-MacBook-Pro:  ./mobile\_start\_en.sh

serving resources from: jar:file:/opt/xxx/kafka-offset-console/KafkaOffsetMonitor-assembly-0.2.0.jar!/offsetapp

## 6 演示截图： ##

**消费者组列表**

![SouthEast 3][]

**topic的所有partiton消费情况列表**

**![SouthEast 4][]**

**kafka正在运行的topic**

![SouthEast 5][]

**kafka集群中topic列表**

![SouthEast 6][]

kafka集群中broker列表

![SouthEast 7][]

**13）Kafka Controller设计机制**

在kafka集群中，其中一个broker server作为中央控制器，负责管理分区和副本状态并执行管理着这些分区的重新分配。下面说明如何通过中央控制器操作分区和副本的状态。

名词解释：

isr：同步副本组

OfflinePartitionLeaderSelector:分区下线后新的领导者选举

OAR：老的分配副本

**PartitionStateChange：**

其有效状态如下:

*  NonExistentPartition:  这种状态表明该分区从来没有创建过或曾经创建过后来又删除了。
 *  NewPartition：创建分区后,分区处于NewPartition状态。在这种状态下,分区副本应该分配给它,但还没有领导者/同步复制组。
 *  OnlinePartition：一旦一个分区领导者被选出，就会为在线分区状态。
 *  OfflinePartition：如果分区领导者成功选举后,当领导者分区崩溃或挂了,分区状态转变下线分区状态。

其有效的状态转移如下：

NonExistentPartition -> NewPartition

1.群集中央控制器根据计算规则，从zk中读取分区信息，创建新分区和副本。

NewPartition -> OnlinePartition

1.分配第一个活着的副本作为分区领导者,并且该分区所有副本作为一个同步复制组,写领导者和同步副本组数据到zk中。

2.对于这个分区,发送LeaderAndIsr请求给每一个副本分区和并发送UpdateMetadata请求到每个活者的broker server。

OnlinePartition,OfflinePartition -> OnlinePartition

1.对于这个分区，需要选择新的领导者和同步副本组，一个副本组要接受LeaderAndIsr请求，最后写领导者和同步副本组信息到zk中。

a.OfflinePartitionLeaderSelector:新领导者=存活副本(最好是在isr);新isr =存活isr如果不是空或恰好为新领导者，否则;正在接受中副本=存活已分配副本。

b.ReassignedPartitionLeaderSelector:新领导者=存活分区重新分配副本;新isr =当前isr;正在接受中副本=重新分配副本

c.PreferredReplicaPartitionLeaderSelector:新领导这=第一次分配副本(如果在isr);新isr =当前isr;接受副本=分配副本

d.ControlledShutdownLeaderSelector:新领导者=当前副本在isr中且没有被关闭,新isr =当前isr -关闭副本;接受副本=存活已分配副本。

2.对于这个分区,发送LeaderAndIsr请求给每一个接收副本和UpdateMetadata请求到每个broker server

NewPartition,OnlinePartition -> OfflinePartition

1.这只不过标识该分区为下线状态

OfflinePartition -> NonExistentPartition

1.这只不过标识该分区为不存在分区状态

**ReplicaStateChange:**

有效状态如下：

1.NewReplica：当创建topic或分区重新分配期间副本被创建。在这种状态下,副本只能成为追随者变更请求状态。

2.OnlineReplica：一旦此分区一个副本启动且部分分配副本,他将处于在线副本状态。在这种状态下,它可以成为领导者或成为跟随者状态变更请求。

3.OfflineReplica：每当broker server副本宕机或崩溃发生时,如果一个副本崩溃或挂了,它将变为此状态。

4.NonExistentReplica：如果一个副本被删除了,它将变为此状态。

有效状态转移如下:

NonExistentReplica - - > NewReplica

1.使用当前领导者和isr分区发送LeaderAndIsr请求到新副本和UpdateMetadata请求给每一个存活borker

NewReplica - > OnlineReplica

1.添加新的副本到副本列表中

OnlineReplica,OfflineReplica - > OnlineReplica

1.使用当前领导者和isr分区发送LeaderAndIsr请求到新副本和UpdateMetadata请求给每一个存活borker

NewReplica,OnlineReplica - > OfflineReplica

1.发送StopReplicaRequest到相应副本(w / o删除)

2.从isr和发送LeaderAndIsr请求重删除此副本(isr)领导者副本和UpdateMetadata分区每个存活broker。

OfflineReplica - > NonExistentReplica

1.发送StopReplicaRequest到副本(删除)

**KafkaController操作:**

当新建topic时:

1.  调用方法onNewPartitionCreation

当创建新分区时:

1.  创建新分区列表 -> 调用方法NewPartition
2.  创建所有新分区副本 -> 调用方法NewReplica
3.  新分区在线列表 -> 调用方法OnlinePartition
4.  新分区所有在线副本 -> OnlineReplica

当broker失败或挂掉时:

1.  当前broker所有领导者分区为下线分区 -> 调用方法OfflinePartition
2.  下线和在线分区列表 -> OnlinePartition (使用下线分区领导者选举)
3.  在broker上所有fail副本 -> OfflineReplica

当broker启动时:

1.  发送UpdateMetadate请求给新启动broker的所有分区。
2.  新启动broker的分区副本-> OnlineReplica
3.  下线和在线分区列表 -> OnlinePartition (使用下线分区领导者选举)
4.  当新的broker启动时，对于所有分区副本，系统会调用方法onPartitionReassignment执行未完成的分区分配。

当分区重新分配时: (OAR: 老的分配副本; RAR:每当重新分配副本会有新的副本组)

1.  用OAR + RAR副本组修改并分配副本列表.
2.  当处于OAR + RAR时，发送LeaderAndIsr请求给每个副本。
3.  副本处于RAR - OAR  -> 调用方法NewReplica
4.  等待直到新的副本加入isr中
5.  副本处于RAR  -> 调用方法OnlineReplica
6.  设置AR to RAR并写到内存中
7.  send LeaderAndIsr request 给一个潜在领导者 (如果当前领导者不在RAR中)和一个被分配的副本列表(使用RAR) 和相同sir到每个处于RAR的broker中。
8.  replicas in OAR - RAR -> Offline (强制这些副本从isr重剔除)
9.  replicas in OAR - RAR -> NonExistentReplica (强制这些副本被删除)
10. 在zk上修改重分配副本到RAR中。
11. 在zk上修改 /admin/reassign\_partitions路径，并删除此分区
12. 选举领导者后,副本和isr信息变化,所以重新发送更新元数据请求给每一个broker。

例如, if OAR = \{1, 2, 3\} and RAR = \{4,5,6\}, 在zk上重分配副本和领导者/is这些值可能经历以下转化。

AR                  leader/isr

\{1,2,3\}            1/\{1,2,3\}           (初始化状态)

\{1,2,3,4,5,6\}   1/\{1,2,3\}           (step 2)

\{1,2,3,4,5,6\}   1/\{1,2,3,4,5,6\}  (step 4)

\{1,2,3,4,5,6\}   4/\{1,2,3,4,5,6\}  (step 7)

\{1,2,3,4,5,6\}   4/\{4,5,6\}           (step 8)

\{4,5,6\}            4/\{4,5,6\}           (step 10)

注意,当只有一个地方我们能存储OAR持久化数据，必须用RAR在zk修改AR节点数据,这样,如果控制器在这一步之前崩溃,我们仍然可以恢复。

当中央控制器failover时:

1.  replicaStateMachine.startup():
    
    1.  从任何下线副本或上线副本中初始化每个副本
    2.  每个副本 -> OnlineReplica (强制LeaderAndIsr请求发送到每个副本)
2.  partitionStateMachine.startup():
    
    1.  从新建分区中初始化每个分区, 下线或上线分区
    2.  each OfflinePartition and NewPartition -> OnlinePartition (强制领导者选举)
3.  恢复分区分配
4.  恢复领导者选举

当发送首选副本选举时:

1.  影响分区列表 -> 调用方法OnlinePartition (with PreferredReplicaPartitionLeaderSelector)

关闭broker:

1.  在关闭broker中对于每个分区如果是领导者分区 -> 调用方法OnlinePartition (ControlledShutdownPartitionLeaderSelector)
2.  在关闭broker中每个副本是追随者,将发送StopReplica请求 (w/o deletion)
3.  在关闭broker中每个副本是追随者 -> 调用方法OfflineReplica (强制从同步副本组中删除副本)

**14）Kafka性能测试报告(虚拟机版)**

测试方法

在其他虚拟机上使用 Kafka 自带 kafka-producer-perf-test.sh 脚本进行测试 Kafka 写入性能

尝试使用 kafka-simple-consumer-perf-test.sh 脚本测试 Kafka Consumer 性能，但由于获取到的数据不靠谱，放弃这个测试方法

性能数据

注：Gzip 和 Snappy 的传输速度 MB/S 是通过压缩前数据计算的，压缩后的实际传输量并没有超过百兆网卡上限

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0)"> 
 <tbody> 
 <tr> 
 <td> 单条消息大小 </td> 
 <td> batch size/条 </td> 
 <td> 线程数 </td> 
 <td> 压缩方式 </td> 
 <td> 传输速度 MB/S </td> 
 <td> 传输速度 Message/S </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> 不压缩 </td> 
 <td> 11.1513 (约为百兆网卡上线) </td> 
 <td> 23369.8916 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Gzip </td> 
 <td> 14.0450 </td> 
 <td> 29425.1878 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Snappy </td> 
 <td> 32.2064 </td> 
 <td> 67471.7850 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> 不压缩 </td> 
 <td> 5.3654 </td> 
 <td> 111399.5121 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Gzip </td> 
 <td> 2.6479 </td> 
 <td> 54979.4926 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Snappy </td> 
 <td> 4.4217 </td> 
 <td> 91836.6410 </td> 
 </tr> 
 <tr> 
 <td> 0~1800 (avg 900) 仿线上数据量大小 </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> 不压缩 </td> 
 <td> 11.0518 (约为百兆网卡上线) </td> 
 <td> 12867.3632 </td> 
 </tr> 
 <tr> 
 <td> 0~1800 (avg 900) 仿线上数据量大小 </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Gzip </td> 
 <td> 17.3944 </td> 
 <td> 20261.3717 </td> 
 </tr> 
 <tr> 
 <td> 0~1800 (avg 900) 仿线上数据量大小 </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Snappy </td> 
 <td> 31.0658 </td> 
 <td> 36174.2150 </td> 
 </tr> 
 <tr> 
 <td> 以下数据为第二天测试数据 </td> 
 <td> &nbsp; </td> 
 <td> &nbsp; </td> 
 <td> &nbsp; </td> 
 <td> &nbsp; </td> 
 <td> &nbsp; </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> 不压缩 </td> 
 <td> 1.8482 </td> 
 <td> 38387.7159 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Gzip </td> 
 <td> 1.3591 </td> 
 <td> 28219.0930 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Snappy </td> 
 <td> 2.0213 </td> 
 <td> 41979.7658 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 50 </td> 
 <td> 不压缩 </td> 
 <td> 2.0900 </td> 
 <td> 43402.7778 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 50 </td> 
 <td> Gzip </td> 
 <td> 1.4639 </td> 
 <td> 30387.7477 </td> 
 </tr> 
 <tr> 
 <td> 0~100（avg 50） </td> 
 <td> 200 </td> 
 <td> 50 </td> 
 <td> Snappy </td> 
 <td> 2.0871 </td> 
 <td> 43323.8021 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> 不压缩 </td> 
 <td> 9.8287 </td> 
 <td> 20594.3530 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Gzip </td> 
 <td> 13.0659 </td> 
 <td> 27386.0058 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 10 </td> 
 <td> Snappy </td> 
 <td> 20.1827 </td> 
 <td> 42265.4269 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 1 </td> 
 <td> 不压缩 </td> 
 <td> 7.0980 </td> 
 <td> 14885.6041 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 1 </td> 
 <td> Gzip </td> 
 <td> 7.4438 </td> 
 <td> 15587.7356 </td> 
 </tr> 
 <tr> 
 <td> 0~1000 (avg 500) </td> 
 <td> 200 </td> 
 <td> 1 </td> 
 <td> Snappy </td> 
 <td> 15.3256 </td> 
 <td> 32088.3070 </td> 
 </tr> 
 </tbody> 
</table>

测试结论

1、线上的实际message平均大小略小于1k，在这种情况下(对应 0~1800 的test case)，虚拟机可以应对每秒上万条写入请求。测试环境下，网络带宽是其瓶颈。通过压缩可以绕过瓶颈，Snappy算法可以处理36000+条请求每秒

2、在使用小数据进行测试时，Kafka每秒可以处理10万条左右数据，网络和IO都不是瓶颈，说明Kafka在虚拟机上处理写入请求的上限约为10万条每秒。

3、第二天的测试在相同条件下与第一天差距很大(0~100 大小数据，10线程，batch size 200)，第二天在不压缩情况下只有第一天的三分之一的处理能力，snappy压缩情况下也只有二分之一处理能力，说明虚拟机的性能不够稳定。

4、生产者线程数对比，说明在网络和IO及Kafka处理能力没有达到瓶颈时，更多的线程能够增加写入速度，但是增长不明显。

测试推论

1、虚拟机上的Kafka最高也可以处理10万条请求，物理机的处理能力强得多，应当超过10万条每秒的处理能力。对应线上平均数据大小接近1K，处理数据流量能力不会低于100MB/S，接近千兆网卡上限。说明物理机上，在遇到网络带宽瓶颈前，Kafka性能应当不会是瓶颈。

2、虚拟机测试是在单topic 单replication 的情况下测试的。无法确定在多个replication时性能下降情况。从网上查找看，性能下降不是很明显。

3、从测试看，虚拟机的性能能够承担线上请求。但虚拟机性能不稳定，需要非常谨慎。

**15）apache kafka监控系列-kafka-web-console**

Kafka Web Console是kafka的开源web监控程序.

功能介绍如下:

*  brokers列表
 *  连接kafka的zk集群列表
 *  所有topic列表，操作相应topic可以浏览查看相应message生产和消费流量图.

## 1.下载Kafka Web Console ##

[Kafka Web Console][]

## 2.安装sbt ##

a. centos  : yum install sbt

b. ubuntu : apt-get install sbt

## 3.配置Kafka Web Console ##

a.增加数据库依赖包(mysql)，解压kafka-web-console.tar.gz,进入目录cd kafka-web-console

编辑文件vim build.sbt

增加mysql配置：

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  ......  
2.  libraryDependencies ++= Seq(  
3.    jdbc,  
4.    cache,  
5.    "org.squeryl" % "squeryl\_2.10" % "0.9.5-6",  
6.    "com.twitter" % "util-zk\_2.10" % "6.11.0",  
7.    "com.twitter" % "finagle-core\_2.10" % "6.15.0",  
8.    "org.apache.kafka" % "kafka\_2.10" % "0.8.1",  
9.    "org.quartz-scheduler" % "quartz" % "2.2.1",  
10.   "mysql" % "mysql-connector-java" % "5.1.9"  
11.     exclude("javax.jms", "jms")  
12.     exclude("com.sun.jdmk", "jmxtools")  
13.     exclude("com.sun.jmx", "jmxri")  
14. )  
15. .......

## 4.配置mysql的jdbc驱动 ##

vim application.conf

增加代码如下:

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  .......    
2.  db.**default**.driver=com.mysql.jdbc.Driver    
3.  db.**default**.url="jdbc:mysql://192.168.2.105:3306/mafka?useUnicode=true&characterEncoding=UTF8&connectTimeout=5000&socketTimeout=10000"    
4.  db.**default**.user=xxx    
5.  db.**default**.password=xxx    
6.  .......

## 5.执行sql语句(如下绿色选框所示) ##

![SouthEast 8][]

## 6.编译 ##

lizhitao@localhost:~$ sbt package

打包编译时会从官网上下载很多jar，由于网络原因，所以很慢，需要耐心等待。

注意:下载的jar是隐藏的，**在cd  ~/.ivy2 目录(相应子目录)下可以看到所有jar.**

**ivy2所有jar包百度云下载**

[ivy2所有jar包下载][ivy2_jar]

## 7.运行 ##

lizhitao@localhost:~$ sbt run

![SouthEast 9][]

## 8.浏览访问 ##

访问地址: http://ip:9000/

**16）apache kafka迁移与扩容工具用法**

参考官网site:https://cwiki.apache.org/confluence/display/KAFKA/Replication+tools\#Replicationtools-6.ReassignPartitionsTool

说明:

当我们对kafka集群扩容时，需要满足2点要求:

1.  将指定topic迁移到集群内新增的node上。
2.  将topic的指定partition迁移到新增的node上。

## 1. 迁移topic到新增的node上 ##

假如现在一个kafka集群运行三个broker，broker.id依次为101,102,103,后来由于业务数据突然暴增，需要新增三个broker,broker.id依次为104,105,106.目的是要把push-token-topic迁移到新增node上。脚本(json格式)如下所示:

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  lizhitao@localhost:$  ./bin/kafka-reassign-partitions.sh --zookeeper 192.168.2.225:2183/config/mobile/mq/mafka  
2.  \--topics-to-move-json-file  migration-push-token-topic.json  --broker-list  "104,105,106"  --generate

脚本migration-push-token-topic.json文件内容如下:

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  \{  
2.  "topics":  
3.  \[  
4.  \{  
5.  "topic": "push-token-topic"  
6.  \}  
7.  \],  
8.  "version":1  
9.  \}

生成分配partitions的json脚本：

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  Current partition replica assignment  
2.  \{ "version":1,"partitions":\[\{ "topic":"cluster-switch-topic","partition":10,"replicas":\[8\]\},\{ "topic":"cluster-switch-topic","partition":5,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":3,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":4,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":9,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":1,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":11,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":7,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":2,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":0,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":6,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":8,"replicas":\[4\]\}\]\}

重新分配parttions的json脚本如下：

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  migration-topic-cluster-**switch**\-topic.json   
2.   \{ "version":1,"partitions":\[\{ "topic":"cluster-switch-topic","partition":10,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":5,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":4,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":3,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":9,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":1,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":11,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":7,"replicas":\[4\]\},\{ "topic":"cluster-switch-topic","partition":2,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":0,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":6,"replicas":\[5\]\},\{ "topic":"cluster-switch-topic","partition":8,"replicas":\[5\]\}\]\}  
3.    
4.  lizhitao@localhost:$   bin/kafka-reassign-partitions.sh --zookeeper 192.168.2.225:2183/config/mobile/mq/mafka01 --reassignment-json-file migration-topic-cluster-**switch**\-topic.json --execute

## 2.topic修改(replicats-factor)副本个数 ##

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  lizhitao@localhost:$ ./bin/kafka-reassign-partitions.sh --zookeeper   192.168.2.225:2183/config/mobile/mq/mafka  
2.  \--reassignment-json-file  replicas-update-push-token-topic.json  --execute

假如初始时push-token-topic为一个副本，为了提高可用性，需要改为2副本模式。

脚本replicas-push-token-topic.json文件内容如下:

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  \{  
2.          "partitions":  
3.                  \[  
4.                  \{  
5.                          "topic": "log.mobile\_nginx",  
6.                          "partition": 0,  
7.                          "replicas": \[101,102,104\]  
8.                  \},  
9.                  \{  
10.                         "topic": "log.mobile\_nginx",  
11.                         "partition": 1,  
12.                         "replicas": \[102,103,106\]  
13.                 \},  
14. \{  
15. "topic": "xxxx",  
16. "partition": 数字,  
17. "replicas": \[数组\]  
18. \}                  
19. \],               
20.         "version":1  
21. \}

## 3.topic的分区扩容用法 ##

a.先扩容分区数量，脚本如下:

例如:push-token-topic初始分区数量为12，目前到增加到15个

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  lizhitao@localhost:$ ./bin/kafka-topics.sh --zookeeper 192.168.2.225:2183/config/mobile/mq/mafka  --alter   --partitions 15   --topic   push-token-topic

b.设置topic分区副本

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  lizhitao@localhost:$ ./bin/kafka-reassign-partitions.sh --zookeeper  192.168.2.225:2183/config/mobile/mq/mafka  
2.  \--reassignment-json-file partitions-extension-push-token-topic.json  --execute

脚本partitions-extension-push-token-topic.json文件内容如下:

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  \{    
2.          "partitions":    
3.                  \[    
4.                  \{    
5.                          "topic": "push-token-topic",    
6.                          "partition": 12,    
7.                          "replicas": \[101,102\]    
8.                  \},    
9.                  \{    
10.                         "topic": "push-token-topic",    
11.                         "partition": 13,    
12.                         "replicas": \[103,104\]    
13.                 \},    
14.                 \{    
15.                         "topic": "push-token-topic",    
16.                         "partition": 14,    
17.                         "replicas": \[105,106\]    
18.                 \}    
19.                 \],                 
20.         "version":1    
21. \}

**17）kafka LeaderNotAvailableException**

经常producer和consumer会包如下异常

LeaderNotAvailableException

原因:

1.其中该分区所在的broker挂了，如果是多副本，该分区所在broker恰好为leader

**18）apache kafka jmx监控指标参数**

Kafka使用Yammer Metrics来监控server和client指标数据。

JMX监控指标参数列表如下:

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0); border:1px solid rgb(169,169,169); border-collapse:collapse; width:1000px"> 
 <tbody> 
 <tr> 
 <th style="border:1px solid rgb(136,136,136); padding:2px; background-color:rgb(204,204,204)"> 参数</th> 
 <th style="border:1px solid rgb(136,136,136); padding:2px; background-color:rgb(204,204,204)"> Mbean名称</th> 
 <th style="border:1px solid rgb(136,136,136); padding:2px; background-color:rgb(204,204,204)"> 说明</th> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Message in rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="AllTopicsMessagesInPerSec",type="BrokerTopicMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">所有topic消息(进出)流量</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Byte in rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="AllTopicsBytesInPerSec",type="BrokerTopicMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Request rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.network":name="{Produce|Fetch-consumer|Fetch-follower}-RequestsPerSec",type="RequestMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Byte out rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="AllTopicsBytesOutPerSec",type="BrokerTopicMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Log flush rate and time</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.log":name="LogFlushRateAndTimeMs",type="LogFlushStats"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"># of under replicated partitions (|ISR| &lt; |all replicas|)</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="UnderReplicatedPartitions",type="ReplicaManager"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">0</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Is controller active on broker</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.controller":name="ActiveControllerCount",type="KafkaController"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">only one broker in the cluster should have 1</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Leader election rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.controller":name="LeaderElectionRateAndTimeMs",type="ControllerStats"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">non-zero when there are broker failures</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Unclean leader election rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.controller":name="UncleanLeaderElectionsPerSec",type="ControllerStats"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">0</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Partition counts</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="PartitionCount",type="ReplicaManager"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">mostly even across brokers</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Leader replica counts</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="LeaderCount",type="ReplicaManager"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">mostly even across brokers</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">ISR shrink rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="ISRShrinksPerSec",type="ReplicaManager"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">If a broker goes down, ISR for some of the partitions will shrink. When that broker is up again, ISR will be expanded once the replicas are fully caught up. Other than that, the expected value for both ISR shrink rate and expansion rate is 0.</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">ISR expansion rate</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="ISRExpandsPerSec",type="ReplicaManager"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">See above</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Max lag in messages btw follower and leader replicas</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="([-.\w]+)-MaxLag",type="ReplicaFetcherManager"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">副本消息滞后数量</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Lag in messages per follower replica</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="([-.\w]+)-ConsumerLag",type="FetcherLagMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">副本消息滞后数量</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Requests waiting in the producer purgatory</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="PurgatorySize",type="ProducerRequestPurgatory"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Requests waiting in the fetch purgatory</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.server":name="PurgatorySize",type="FetchRequestPurgatory"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Request total time</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.network":name="{Produce|Fetch-Consumer|Fetch-Follower}-TotalTimeMs",type="RequestMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Time the request waiting in the request queue</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.network":name="{Produce|Fetch-Consumer|Fetch-Follower}-QueueTimeMs",type="RequestMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Time the request being processed at the leader</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.network":name="{Produce|Fetch-Consumer|Fetch-Follower}-LocalTimeMs",type="RequestMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Time the request waits for the follower</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.network":name="{Produce|Fetch-Consumer|Fetch-Follower}-RemoteTimeMs",type="RequestMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">Time to send the response</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px">"kafka.network":name="{Produce|Fetch-Consumer|Fetch-Follower}-ResponseSendTimeMs",type="RequestMetrics"</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px"></td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(136,136,136); padding:2px; color:rgb(51,51,51); font-family:'Source Sans Pro',sans-serif; line-height:30.3333358764648px"> Number of messages the consumer lags behind the producer by</td> 
 <td style="border:1px solid rgb(136,136,136); padding:2px; color:rgb(51,51,51); line-height:30.3333358764648px"> "kafka.consumer":name="([-.\w]+)-MaxLag",type="ConsumerFetcherManager"</td> 
 </tr> 
 </tbody> 
</table>

**19）apache kafka性能测试命令使用和构建kafka-perf**

本来想用kafka官方提供的工具做性能测试的。但事与愿违，当我执行官方提供的kafka测试脚本，却报错没有找到ProducerPerformance，后来浏览一些代码文件，才发现没有把perf性能测试程序打包到kafka\_2.x.0-0.8.x.x.jar发行版本中。

现在来教您如何打包做测试。

# 1.准备工作： #

[安装gradle][gradle]

# 2.下载kafka源代码 #

[kafka-0.8.1源代码][apache kafka 1]

# 3.编译kafka-perf\_2.x-0.8.1.x.jar #

**编译注意事项：默认情况下是编译为2.8.0版本，也可以指定版本编译。目前编译高版本的kafka-perf(2.8.0以上版本)是由问题的，因为build.gradle配置参数有问题(版本不同，会报如下错误，[版本不兼容错误][Link 1])，如果要构建高版本kafka-perf多版本修改内容如下：**

下载[build.gradle][]   替换掉kafka-0.8.1.1-src根目录下文件即可

编译构建执行命令：

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  gradle jar              默认生成2.8.0版本的kafka和kafka-perf的jar  
2.  gradle jar\_core\_2\_8\_0       生成2.8.0版本的kafka的jar  
3.  gradle jar\_core\_2\_8\_2       生成2.8.2版本的kafka的jar  
4.  gradle jar\_core\_2\_9\_1       生成2.9.1版本的kafka的jar  
5.  gradle jar\_core\_2\_9\_2       生成2.9.2版本的kafka的jar  
6.  gradle jar\_core\_2\_10\_1      生成2.10.1版本的kafka的jar  
7.  gradle perf:jar         生成2.8.0版本的kafka和kafka-perf的jar  
8.  gradle perf\_2\_9\_1       生成2.9.1版本的kafka和kafka-perf的jar  
9.  gradle perf\_2\_10\_1      生成2.10.1版本的kafka和kafka-perf的jar  
10. gradle -PscalaVersion=2.8.0 jar         编译scala 2.8.0版本编译所有jar  
11. gradle -PscalaVersion=2.8.2 jar         编译scala 2.8.2版本编译所有jar  
12. gradle -PscalaVersion=2.9.1 jar         编译scala 2.9.1版本编译所有jar  
13. gradle -PscalaVersion=2.10.1 jar        编译scala 2.10.1版本编译所有jar

如果不想编译jar，可以直接下载：[kafka-perf\_2.x.x-0.8.1.jar][kafka-perf_2.x.x-0.8.1.jar]

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1. lizhitao@users\-MacBook-Pro:~/mt\_wp/tmp$ cd kafka-0.8.1.1\-src  
2. lizhitao@users\-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1\-src$gradle jar  
3. lizhitao@users\-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1\-src$gradle perf:jar  
4. The TaskContainer.add() method has been deprecated and is scheduled to be removed in Gradle 2.0. Please use the create() method instead.  
5. Building project 'core' with Scala version 2.8.0  
6. Building project 'perf' with Scala version 2.8.0  
7. :core:compileJava UP-TO-DATE  
8. :core:compileScala  
9. /Users/lizhitao/mt\_wp/tmp/kafka-0.8.1.1\-src/core/src/main/scala/kafka/admin/AdminUtils.scala:243: non variable type-argument String in type pattern scala.collection.Map\[String,\_\] is unchecked since it is eliminated by erasure  
10.         **case** Some(map: Map\[String, \_\]) =>  
11.                        ^  
12. /Users/lizhitao/mt\_wp/tmp/kafka-0.8.1.1\-src/core/src/main/scala/kafka/admin/AdminUtils.scala:246: non variable type-argument String in type pattern scala.collection.Map\[String,String\] is unchecked since it is eliminated by erasure  
13.             **case** Some(config: Map\[String, String\]) =>  
14.                               ^  
15. /Users/lizhitao/mt\_wp/tmp/kafka-0.8.1.1\-src/core/src/main/scala/kafka/api/LeaderAndIsrResponse.scala:66: non variable type-argument String in type pattern (String, Int) is unchecked since it is eliminated by erasure  
16.     **for** ((key:(String, Int), value) <- responseMap) \{  
17.               ^  
18. /Users/lizhitao/mt\_wp/tmp/kafka-0.8.1.1\-src/core/src/main/scala/kafka/utils/Utils.scala:363: non variable type-argument V in type pattern List\[V\] is unchecked since it is eliminated by erasure  
19.         **case** Some(l: List\[V\]) => m.put(k, v :: l)  
20.                      ^  
21. four warnings found  
22. :core:processResources UP-TO-DATE  
23. :core:classes  
24. :core:copyDependantLibs UP-TO-DATE  
25. :core:jar UP-TO-DATE  
26. :perf:compileJava UP-TO-DATE  
27. :perf:compileScala  
28. :perf:processResources UP-TO-DATE  
29. :perf:classes  
30. :perf:jar UP-TO-DATE  
31.   
32. BUILD SUCCESSFUL  
33. Total time: 54.41 secs

编译jar包目录如下：

a. kafka\_2.x-0.8.1.1.jar

kafka-0.8.1.1-src/core/build

![SouthEast 10][]

b.kafka-perf\_2.x-0.8.1.x.jar

kafka-0.8.1.1-src/perf/build/libs

![SouthEast 11][]

kafka多版本jar：

![SouthEast 12][]

# 4. kafka性能测试命令用法： #

## 4.1 创建topic ##

bin/kafka-topics.sh --zookeeper 192.168.2.225:2182,192.168.2.225:2183/config/mobile/mq/mafka02 --create --topic test-rep-one --partitions 6 --replication-factor 1

## **4.2 kafka-producer-perf-test.sh**中参数说明： ##

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  messages        生产者发送总的消息数量  
2.  message-size        每条消息大小  
3.  batch-size      每次批量发送消息的数量  
4.  topics          生产者发送的topic  
5.  threads         生产者使用几个线程同时发送  
6.  broker-list     安装kafka服务的机器ip:port列表  
7.  producer-num-retries    一个消息失败发送重试次数  
8.  request-timeout-ms  一个消息请求发送超时时间

## **4.3 bin/kafka-consumer-perf-test.sh**中参数说明： ##

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  zookeeperzk     配置  
2.  messages        消费者消费消息总数量  
3.  topic           消费者需要消费的topic  
4.  threads         消费者使用几个线程同时消费  
5.  group           消费者组名称  
6.  socket-buffer-sizesocket    缓冲大小  
7.  fetch-size      每次向kafka broker请求消费大小  
8.  consumer.timeout.ms 消费者去kafka broker拿去一条消息超时时间

## 4.4 生产者发送数据： ##

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  lizhitao@users\-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1\-src$ bin/kafka-producer-perf-test.sh --messages 5000000 --message-size 5000  --batch-size 5000 --topics test-rep-one --threads 8 --broker-list mobile-esb03:9092,mobile-esb04:9092,mobile-esb05:9092  
2.  start.time, end.time, compression, message.size, batch.size, total.data.sent.in.MB, MB.sec, total.data.sent.in.nMsg, nMsg.sec  
3.  \[2014\-07\-06 12:52:36,139\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
4.  SLF4J: Failed to load **class** "org.slf4j.impl.StaticLoggerBinder".  
5.  SLF4J: Defaulting to no-operation (NOP) logger implementation  
6.  SLF4J: See http://www.slf4j.org/codes.html\#StaticLoggerBinder for further details.  
7.  \[2014\-07\-06 12:52:36,199\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
8.  \[2014\-07\-06 12:52:36,202\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
9.  \[2014\-07\-06 12:52:36,204\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
10. \[2014\-07\-06 12:52:36,206\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
11. \[2014\-07\-06 12:52:36,207\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
12. \[2014\-07\-06 12:52:36,209\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)  
13. \[2014\-07\-06 12:52:36,214\] WARN Property reconnect.interval is not valid (kafka.utils.VerifiableProperties)

## 4.5 消费者消费数据 ##

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  lizhitao@users\-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1\-src$ bin/kafka-consumer-perf-test.sh --zookeeper  
2.  192.168.2.225:2182,192.168.2.225:2183/config/mobile/mq/mafka02 --messages 50000000 --topic test-rep-one --threads 1  
3.  start.time, end.time, fetch.size, data.consumed.in.MB, MB.sec, data.consumed.in.nMsg, nMsg.sec  
4.  SLF4J: Failed to load **class** "org.slf4j.impl.StaticLoggerBinder".  
5.  SLF4J: Defaulting to no-operation (NOP) logger implementation  
6.  SLF4J: See http://www.slf4j.org/codes.html\#StaticLoggerBinder for further details.

**20）apache kafka源码构建打包**

# 准备工作： #

[安装gradle][gradle]

## 1.构建kafka的jar并运行 ##

打包kafka-0.8.1.1下所有jar，包括core,perf,clients等。

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle jar

![SouthEast 13][]

## 2.构建源代码jar ##

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle srcJar

![SouthEast 14][]

## 3.运行序列化测试 ##

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle -Dtest.single=RequestResponseSerializationTest core:test

![SouthEast 15][]

## 4.gradle任务列表 ##

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle tasks

![SouthEast 16][]

## 5.构建所有jar，包括tasks中各个版本jar ##

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle jarAll

## 6.指定构建jar包版本 ##

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle  \-PscalaVersion=2.10.1 jar

7.发布文件到maven仓库

lizhitao@users-MacBook-Pro:~/mt\_wp/tmp/kafka-0.8.1.1-src$ gradle uploadArchivesAll

编辑文件~/.gradle/gradle.properties，增加如下内容：

mavenUrl=
    mavenUsername=
    mavenPassword=
    signing.keyId=
    signing.password=
    signing.secretKeyRingFile=

**21）Apache kafka客户端开发-java**

1.依赖包

<dependency> 
            <groupId>org.apache.kafka</groupId> 
            <artifactId>kafka\_2.10</artifactId> 
            <version>0.8.1</version> 
        </dependency>

# 2.producer程序开发例子 #

## 2.1 producer参数说明 ##

#指定kafka节点列表，用于获取metadata，不必全部指定
    metadata.broker.list=192.168.2.105:9092,192.168.2.106:9092
    # 指定分区处理类。默认kafka.producer.DefaultPartitioner，表通过key哈希到对应分区
    #partitioner.class=com.meituan.mafka.client.producer.CustomizePartitioner
     
    # 是否压缩，默认0表示不压缩，1表示用gzip压缩，2表示用snappy压缩。压缩后消息中会有头来指明消息压缩类型，故在消费者端消息解压是透明的无需指定。
    compression.codec=none
      
    # 指定序列化处理类(mafka client API调用说明-->3.序列化约定wiki)，默认为kafka.serializer.DefaultEncoder,即byte[]
    serializer.class=com.meituan.mafka.client.codec.MafkaMessageEncoder
    # serializer.class=kafka.serializer.DefaultEncoder
    # serializer.class=kafka.serializer.StringEncoder
    # 如果要压缩消息，这里指定哪些topic要压缩消息，默认empty，表示不压缩。
    #compressed.topics=
     
    ########### request ack ###############
    # producer接收消息ack的时机.默认为0. 
    # 0: producer不会等待broker发送ack 
    # 1: 当leader接收到消息之后发送ack 
    # 2: 当所有的follower都同步消息成功后发送ack. 
    request.required.acks=0 
    # 在向producer发送ack之前,broker允许等待的最大时间 
    # 如果超时,broker将会向producer发送一个error ACK.意味着上一次消息因为某种 
    # 原因未能成功(比如follower未能同步成功) 
    request.timeout.ms=10000
    ########## end #####################
     
     
    # 同步还是异步发送消息，默认“sync”表同步，"async"表异步。异步可以提高发送吞吐量,
    # 也意味着消息将会在本地buffer中,并适时批量发送，但是也可能导致丢失未发送过去的消息
    producer.type=sync
    ############## 异步发送 (以下四个异步参数可选) ####################
    # 在async模式下,当message被缓存的时间超过此值后,将会批量发送给broker,默认为5000ms
    # 此值和batch.num.messages协同工作.
    queue.buffering.max.ms = 5000
    # 在async模式下,producer端允许buffer的最大消息量
    # 无论如何,producer都无法尽快的将消息发送给broker,从而导致消息在producer端大量沉积
    # 此时,如果消息的条数达到阀值,将会导致producer端阻塞或者消息被抛弃，默认为10000
    queue.buffering.max.messages=20000
    # 如果是异步，指定每次批量发送数据量，默认为200
    batch.num.messages=500
    # 当消息在producer端沉积的条数达到"queue.buffering.max.meesages"后 
    # 阻塞一定时间后,队列仍然没有enqueue(producer仍然没有发送出任何消息) 
    # 此时producer可以继续阻塞或者将消息抛弃,此timeout值用于控制"阻塞"的时间 
    # -1: 无阻塞超时限制,消息不会被抛弃 
    # 0:立即清空队列,消息被抛弃 
    queue.enqueue.timeout.ms=-1
    ################ end ###############
     
    # 当producer接收到error ACK,或者没有接收到ACK时,允许消息重发的次数 
    # 因为broker并没有完整的机制来避免消息重复,所以当网络异常时(比如ACK丢失) 
    # 有可能导致broker接收到重复的消息,默认值为3.
    message.send.max.retries=3
     
     
    # producer刷新topic metada的时间间隔,producer需要知道partition leader的位置,以及当前topic的情况 
    # 因此producer需要一个机制来获取最新的metadata,当producer遇到特定错误时,将会立即刷新 
    # (比如topic失效,partition丢失,leader失效等),此外也可以通过此参数来配置额外的刷新机制，默认值600000 
    topic.metadata.refresh.interval.ms=60000

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1. **import** java.util.\*;    
2.      
3. **import** kafka.javaapi.producer.Producer;    
4. **import** kafka.producer.KeyedMessage;    
5. **import** kafka.producer.ProducerConfig;    
6.      
7. **public** **class** TestProducer \{    
8.     **public** **static** **void** main(String\[\] args) \{    
9.         **long** events = Long.parseLong(args\[0\]);    
10.         Random rnd = **new** Random();    
11.      
12.         Properties props = **new** Properties();    
13.         props.put("metadata.broker.list", "192.168.2.105:9092");    
14.         props.put("serializer.class", "kafka.serializer.StringEncoder"); //默认字符串编码消息    
15.         props.put("partitioner.class", "example.producer.SimplePartitioner");    
16.         props.put("request.required.acks", "1");    
17.      
18.         ProducerConfig config = **new** ProducerConfig(props);    
19.      
20.         Producer<String, String> producer = **new** Producer<String, String>(config);    
21.      
22.         **for** (**long** nEvents = 0; nEvents < events; nEvents++) \{     
23.                **long** runtime = **new** Date().getTime();      
24.                String ip = “192.168.2.” + rnd.nextInt(255);     
25.                String msg = runtime + “,www.example.com,” + ip;     
26.                KeyedMessage<String, String> data = **new** KeyedMessage<String, String>("page\_visits", ip, msg);    
27.                producer.send(data);    
28.         \}    
29.         producer.close();    
30.     \}    
31. \}

## 2.1 指定关键字key，发送消息到指定partitions ##

说明：如果需要实现自定义partitions消息发送，需要实现Partitioner接口

**\[java\]**  [view plain][view plain 3] [copy][view plain 3] [![在CODE上查看代码片][CODE]][CODE_CODE 3] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 4]

1.  **public** **class** CustomizePartitioner **implements** Partitioner \{  
2.      **public** CustomizePartitioner(VerifiableProperties props) \{  
3.     
4.      \}  
5.      /\*\* 
6.       \* 返回分区索引编号 
7.       \* @param key sendMessage时，输出的partKey 
8.       \* @param numPartitions topic中的分区总数 
9.       \* @return 
10.      \*/  
11.     @Override  
12.     **public** **int** partition(Object key, **int** numPartitions) \{  
13.         System.out.println("key:" + key + "  numPartitions:" + numPartitions);  
14.         String partKey = (String)key;  
15.         **if** ("part2".equals(partKey))  
16.             **return** 2;  
17. //        System.out.println("partKey:" + key);  
18.    
19.         ........  
20.         ........  
21.         **return** 0;  
22.     \}  
23. \}

# 3.consumer程序开发例子 #

## 3.1 consumer参数说明 ##

# zookeeper连接服务器地址，此处为线下测试环境配置(kafka消息服务-->kafka broker集群线上部署环境wiki)
    # 配置例子："127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002"
    zookeeper.connect=192.168.2.225:2181,192.168.2.225:2182,192.168.2.225:2183/config/mobile/mq/mafka
    # zookeeper的session过期时间，默认5000ms，用于检测消费者是否挂掉，当消费者挂掉，其他消费者要等该指定时间才能检查到并且触发重新负载均衡
    zookeeper.session.timeout.ms=5000
    zookeeper.connection.timeout.ms=10000
    # 指定多久消费者更新offset到zookeeper中。注意offset更新时基于time而不是每次获得的消息。一旦在更新zookeeper发生异常并重启，将可能拿到已拿到过的消息
    zookeeper.sync.time.ms=2000
     
    #指定消费组
    group.id=xxx
    # 当consumer消费一定量的消息之后,将会自动向zookeeper提交offset信息 
    # 注意offset信息并不是每消费一次消息就向zk提交一次,而是现在本地保存(内存),并定期提交,默认为true
    auto.commit.enable=true
    # 自动更新时间。默认60 * 1000
    auto.commit.interval.ms=1000
     
    # 当前consumer的标识,可以设定,也可以有系统生成,主要用来跟踪消息消费情况,便于观察
    conusmer.id=xxx 
     
    # 消费者客户端编号，用于区分不同客户端，默认客户端程序自动产生
    client.id=xxxx
    # 最大取多少块缓存到消费者(默认10)
    queued.max.message.chunks=50
    # 当有新的consumer加入到group时,将会reblance,此后将会有partitions的消费端迁移到新 
    # 的consumer上,如果一个consumer获得了某个partition的消费权限,那么它将会向zk注册 
    # "Partition Owner registry"节点信息,但是有可能此时旧的consumer尚没有释放此节点, 
    # 此值用于控制,注册节点的重试次数. 
    rebalance.max.retries=5
    # 获取消息的最大尺寸,broker不会像consumer输出大于此值的消息chunk
    # 每次feth将得到多条消息,此值为总大小,提升此值,将会消耗更多的consumer端内存
    fetch.min.bytes=6553600
    # 当消息的尺寸不足时,server阻塞的时间,如果超时,消息将立即发送给consumer
    fetch.wait.max.ms=5000
    socket.receive.buffer.bytes=655360
     
    # 如果zookeeper没有offset值或offset值超出范围。那么就给个初始的offset。有smallest、largest、
    # anything可选，分别表示给当前最小的offset、当前最大的offset、抛异常。默认largest
    auto.offset.reset=smallest
    # 指定序列化处理类(mafka client API调用说明-->3.序列化约定wiki)，默认为kafka.serializer.DefaultDecoder,即byte[]
    derializer.class=com.meituan.mafka.client.codec.MafkaMessageDecoder

## 3.2 多线程并行消费topic ##

ConsumerTest类

**\[java\]**  [view plain][view plain 3] [copy][view plain 3] [![在CODE上查看代码片][CODE]][CODE_CODE 3] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 4]

1. **import** kafka.consumer.ConsumerIterator;  
2. **import** kafka.consumer.KafkaStream;  
3.    
4. **public** **class** ConsumerTest **implements** Runnable \{  
5.     **private** KafkaStream m\_stream;  
6.     **private** **int** m\_threadNumber;  
7.    
8.     **public** ConsumerTest(KafkaStream a\_stream, **int** a\_threadNumber) \{  
9.         m\_threadNumber = a\_threadNumber;  
10.         m\_stream = a\_stream;  
11.     \}  
12.    
13.     **public** **void** run() \{  
14.         ConsumerIterator<**byte**\[\], **byte**\[\]> it = m\_stream.iterator();  
15.         **while** (it.hasNext())  
16.             System.out.println("Thread " + m\_threadNumber + ": " + **new** String(it.next().message()));  
17.         System.out.println("Shutting down Thread: " + m\_threadNumber);  
18.     \}  
19. \}

ConsumerGroupExample类

**\[java\]**  [view plain][view plain 3] [copy][view plain 3] [![在CODE上查看代码片][CODE]][CODE_CODE 3] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 4]

1. **import** kafka.consumer.ConsumerConfig;  
2. **import** kafka.consumer.KafkaStream;  
3. **import** kafka.javaapi.consumer.ConsumerConnector;  
4.    
5. **import** java.util.HashMap;  
6. **import** java.util.List;  
7. **import** java.util.Map;  
8. **import** java.util.Properties;  
9. **import** java.util.concurrent.ExecutorService;  
10. **import** java.util.concurrent.Executors;  
11.    
12. **public** **class** ConsumerGroupExample \{  
13.     **private** **final** ConsumerConnector consumer;  
14.     **private** **final** String topic;  
15.     **private**  ExecutorService executor;  
16.    
17.     **public** ConsumerGroupExample(String a\_zookeeper, String a\_groupId, String a\_topic) \{  
18.         consumer = kafka.consumer.Consumer.createJavaConsumerConnector(  
19.                 createConsumerConfig(a\_zookeeper, a\_groupId));  
20.         **this**.topic = a\_topic;  
21.     \}  
22.    
23.     **public** **void** shutdown() \{  
24.         **if** (consumer != **null**) consumer.shutdown();  
25.         **if** (executor != **null**) executor.shutdown();  
26.     \}  
27.    
28.     **public** **void** run(**int** a\_numThreads) \{  
29.         Map<String, Integer> topicCountMap = **new** HashMap<String, Integer>();  
30.         topicCountMap.put(topic, **new** Integer(a\_numThreads));  
31.         Map<String, List<KafkaStream<**byte**\[\], **byte**\[\]>>> consumerMap = consumer.createMessageStreams(topicCountMap);  
32.         List<KafkaStream<**byte**\[\], **byte**\[\]>> streams = consumerMap.get(topic);  
33.    
34.         // 启动所有线程  
35.         executor = Executors.newFixedThreadPool(a\_numThreads);  
36.    
37.         // 开始消费消息  
38.         **int** threadNumber = 0;  
39.         **for** (**final** KafkaStream stream : streams) \{  
40.             executor.submit(**new** ConsumerTest(stream, threadNumber));  
41.             threadNumber++;  
42.         \}  
43.     \}  
44.    
45.     **private** **static** ConsumerConfig createConsumerConfig(String a\_zookeeper, String a\_groupId) \{  
46.         Properties props = **new** Properties();  
47.         props.put("zookeeper.connect", "192.168.2.225:2183/config/mobile/mq/mafka");  
48.         props.put("group.id", "push-token");  
49.         props.put("zookeeper.session.timeout.ms", "60000");  
50.         props.put("zookeeper.sync.time.ms", "2000");  
51.         props.put("auto.commit.interval.ms", "1000");  
52.    
53.         **return** **new** ConsumerConfig(props);  
54.     \}  
55.    
56.     **public** **static** **void** main(String\[\] args) \{  
57.         String zooKeeper = args\[0\];  
58.         String groupId = args\[1\];  
59.         String topic = args\[2\];  
60.         **int** threads = Integer.parseInt(args\[3\]);  
61.    
62.         ConsumerGroupExample example = **new** ConsumerGroupExample(zooKeeper, groupId, topic);  
63.         example.run(threads);  
64.    
65.         **try** \{  
66.             Thread.sleep(10000);  
67.         \} **catch** (InterruptedException ie) \{  
68.    
69.         \}  
70.         example.shutdown();  
71.     \}  
72. \}

**总结：**  
 kafka消费者api分为high api和low api，目前上述demo是都是使用kafka high api，高级api不用关心维护消费状态信息和负载均衡，

系统会根据配置参数，  
定期flush offset到zk上，如果有多个consumer且每个consumer创建了多个线程，高级api会根据zk上注册consumer信息，进行自动负载均衡操作。  
注意事项：  
1.高级api将会内部实现持久化每个分区最后读到的消息的offset，数据保存在zookeeper中的消费组名中

(如/consumers/push-token-group/offsets/push-token/2。  
其中push-token-group是消费组，push-token是topic，最后一个2表示第3个分区)，每间隔一个(默认1000ms)时间更新一次offset，  
那么可能在重启消费者时拿到重复的消息。此外，当分区leader发生变更时也可能拿到重复的消息。

因此在关闭消费者时最好等待一定时间（10s）然后再shutdown()  
2.消费组名是一个全局的信息，要注意在新的消费者启动之前旧的消费者要关闭。如果新的进程启动并且消费组名相同，

kafka会添加这个进程到可用消费线程组中用来消费  
topic和触发重新分配负载均衡，那么同一个分区的消息就有可能发送到不同的进程中。  
3.如果消费者组中所有consumer的总线程数量大于分区数，一部分线程或某些consumer可能无法读取消息或处于空闲状态。  
4.如果分区数多于线程数(如果消费组中运行者多个消费者，则线程数为消费者组内所有消费者线程总和)，一部分线程会读取到多个分区的消息  
5.如果一个线程消费多个分区消息，那么接收到的消息是不能保证顺序的。  
备注：可用zookeeper web ui工具管理查看zk目录树数据： xxx/consumers/push-token-group/owners/push-token/2其中  
push-token-group为消费组，push-token为topic,2为分区3.查看里面的内容如：  
push-token-group-mobile-platform03-1405157976163-7ab14bd1-0表示该分区被该标示的线程所执行。

producer性能优化:异步化，消息批量发送，具体浏览上述参数说明。consumer性能优化:如果是高吞吐量数据，

设置每次拿取消息(fetch.min.bytes)大些，   
拿取消息频繁(fetch.wait.max.ms)些(或时间间隔短些)，如果是低延时要求，则设置时间时间间隔小，每次从kafka broker拿取消息尽量小些。

**22） kafka broker内部架构**

下面介绍kafka broker的主要子模块，帮助您更好地学习并理解kafka源代码和架构。

如下介绍几个子模块：

*  Kafka API layer
 *  LogManager and Log
 *  ReplicaManager
 *  ZookeeperConsumerConnector
 *  service Schedule

如下是系统几个模块如何组成到一起架构图：

![SouthEast 17][]

**23）apache kafka源码分析走读-kafka整体结构分析**

kafka源代码工程目录结构如下图：

![SouthEast 18][]

下面只对core目录结构作说明，其他都是测试类或java客户端代码

admin   --管理员模块，操作和管理topic，paritions相关，包含create,delete topic,扩展patitions Api       --该模块主要负责组装数据，组装2种类型数据， 1.读取或解码客户端发送的二进制数据. 2.编码log消息数据，组装为需要发送的数据。 client    --该模块比较简单，就一个类，Producer读取kafka broker元数据信息， topic和partitions，以及leader cluster   --该模块包含几个实体类，Broker,Cluster,Partition,Replica,解释他们之间关系：Cluster由多个broker组成，一个Broker包含多个partition，一个 topic的所有partitions分布在不同broker的中，一个Replica包含多个Partition。 common     --通用模块,只包含异常类和错误验证 consumer    --consumer处理模块，负责所有客户端消费者数据和逻辑处理 contoroller  --负责中央控制器选举，partition的leader选举，副本分配，副本重新分配， partition和replica扩容。 javaapi   --提供java的producer和consumer接口api log          --kafka文件系统，负责处理和存储所有kafka的topic数据。 message    --封装kafka的ByteBufferMessageSet metrics    --内部状态的监控模块 network        --网络事件处理模块，负责处理和接收客户端连接 producer        --producer实现模块，包括同步和异步发送消息。 serializer        --序列化或反序列化当前消息 kafka         --kafka门面入口类，副本管理，topic配置管理，leader选举实现(由contoroller模块调用)。 tools           --一看这就是工具模块，包含内容比较多： a.导出对应consumer的offset值. b.导出LogSegments信息，当前topic的log写的位置信息. c.导出zk上所有consumer的offset值. d.修改注册在zk的consumer的offset值. f.producer和consumer的使用例子. utils   --Json工具类，Zkutils工具类，Utils创建线程工具类，KafkaScheduler公共调度器类，公共日志类等等。

1.kafka启动类：kafka.scala

kafka为kafka broker的main启动类，其主要作用为加载配置，启动report服务(内部状态的监控)，注册释放资源的钩子，以及门面入口类。

kafka类代码如下：

**\[java\]**  [view plain][view plain 1] [copy][view plain 1] [![在CODE上查看代码片][CODE]][CODE_CODE 1] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 2]

1.  ......  
2.   **try** \{  
3.        val props = Utils.loadProps(args(0))          //加载配置文件  
4.        val serverConfig = **new** KafkaConfig(props)  
5.        KafkaMetricsReporter.startReporters(serverConfig.props)             //启动report服务(内部状态的监控)  
6.        val kafkaServerStartble = **new** KafkaServerStartable(serverConfig)    //kafka server核心入口类  
7.        // attach shutdown handler to catch control-c  
8.        Runtime.getRuntime().addShutdownHook(**new** Thread() \{                 //钩子程序，当jvm退出前，销毁所有资源  
9.          override def run() = \{  
10.           kafkaServerStartble.shutdown  
11.         \}  
12.       \})  
13.   
14.       kafkaServerStartble.startup  
15.       kafkaServerStartble.awaitShutdown  
16.     \}  
17. ......

KafkaServerStartble**类包装了**KafkaSever**类，其实啥都没有做。只是调用包装类而已**

KafkaSever**类是kafka broker运行控制的核心入口类，它是采用门面模式设计的。**

**![SouthEast 19][]**

kafka中KafkaServer类，采用门面模式，是网络处理，io处理等得入口.

ReplicaManager     副本管理

KafkaApis   api处理

KafkaRequestHandlerPoolkafka  请求处理池  <-- num.io.threads io线程数量

LogManager    kafka文件系统，负责处理和存储所有kafka的topic数据

TopicConfigManager   topic管理

KafkaHealthcheck   健康检查

KafkaController   kafka集群中央控制器选举，leader选举，副本分配。

KafkaScheduler   负责副本管理和日志管理调度等等

ZkClient         负责注册zk相关信息.

BrokerTopicStats   topic信息统计和监控

ControllerStats          中央控制器统计和监控

KafkaServer部分主要代码如下：

**\[java\]**  [view plain][view plain 4] [copy][view plain 4] [![在CODE上查看代码片][CODE]][CODE_CODE 4] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 5]

1.  ......    
2.  def startup() \{  
3.      info("starting")  
4.      isShuttingDown = **new** AtomicBoolean(**false**)  
5.      shutdownLatch = **new** CountDownLatch(1)  
6.    
7.      /\* start scheduler \*/  
8.      kafkaScheduler.startup()  
9.        
10.     /\* setup zookeeper \*/  
11.     zkClient = initZk()  
12.   
13.     /\* start log manager \*/  
14.     logManager = createLogManager(zkClient)  
15.     logManager.startup()  
16.   
17.     socketServer = **new** SocketServer(config.brokerId,  
18.                                     config.hostName,  
19.                                     config.port,  
20.                                     config.numNetworkThreads,  
21.                                     config.queuedMaxRequests,  
22.                                     config.socketSendBufferBytes,  
23.                                     config.socketReceiveBufferBytes,  
24.                                     config.socketRequestMaxBytes)  
25.     socketServer.startup()  
26.   
27.     replicaManager = **new** ReplicaManager(config, time, zkClient, kafkaScheduler, logManager, isShuttingDown)  
28.     kafkaController = **new** KafkaController(config, zkClient)  
29.       
30.     /\* start processing requests \*/  
31.     apis = **new** KafkaApis(socketServer.requestChannel, replicaManager, zkClient, config.brokerId, config, kafkaController)  
32.     requestHandlerPool = **new** KafkaRequestHandlerPool(config.brokerId, socketServer.requestChannel, apis, config.numIoThreads)  
33.      
34.     Mx4jLoader.maybeLoad()  
35.   
36.     replicaManager.startup()  
37.   
38.     kafkaController.startup()  
39.       
40.     topicConfigManager = **new** TopicConfigManager(zkClient, logManager)  
41.     topicConfigManager.startup()  
42.       
43.     /\* tell everyone we are alive \*/  
44.     kafkaHealthcheck = **new** KafkaHealthcheck(config.brokerId, config.advertisedHostName, config.advertisedPort, config.zkSessionTimeoutMs, zkClient)  
45.     kafkaHealthcheck.startup()  
46.   
47.       
48.     registerStats()  
49.     startupComplete.set(**true**);  
50.     info("started")  
51.   \}  
52.     
53.   **private** def initZk(): ZkClient = \{  
54.     info("Connecting to zookeeper on " + config.zkConnect)  
55.     val zkClient = **new** ZkClient(config.zkConnect, config.zkSessionTimeoutMs, config.zkConnectionTimeoutMs, ZKStringSerializer)  
56.     ZkUtils.setupCommonPaths(zkClient)  
57.     zkClient  
58.   \}  
59.   
60.   /\*\* 
61.    \*  Forces some dynamic jmx beans to be registered on server startup. 
62.    \*/  
63.   **private** def registerStats() \{  
64.     BrokerTopicStats.getBrokerAllTopicsStats()  
65.     ControllerStats.uncleanLeaderElectionRate  
66.     ControllerStats.leaderElectionTimer  
67.   \}  
68. .......

**24）apache kafka源码分析走读-Producer分析**

# producer的发送方式剖析 #

Kafka提供了Producer类作为java producer的api，该类有sync和async两种发送方式。

sync架构图

![SouthEast 20][]

async架构图

![SouthEast 21][]

调用流程如下：

![SouthEast 22][]

代码流程如下：

Producer:当new Producer(new ProducerConfig()),其底层实现，实际会产生两个核心类的实例：Producer、DefaultEventHandler。在创建的同时，会默认new一个ProducerPool，即我们每new一个java的Producer类，就会有创建Producer、EventHandler和ProducerPool，ProducerPool为连接不同kafka broker的池，初始连接个数有broker.list参数决定。

调用producer.send方法流程：

当应用程序调用producer.send方法时，其内部其实调的是eventhandler.handle(message)方法,eventHandler会首先序列化该消息,

eventHandler.serialize(events)-->dispatchSerializedData()-->partitionAndCollate()-->send()-->SyncProducer.send()

调用逻辑解释：当客户端应用程序调用producer发送消息messages时(既可以发送单条消息，也可以发送List多条消息)，调用eventhandler.serialize首先序列化所有消息，序列化操作用户可以自定义实现Encoder接口，下一步调用partitionAndCollate根据topics的messages进行分组操作，messages分配给dataPerBroker(多个不同的Broker的Map)，根据不同Broker调用不同的SyncProducer.send批量发送消息数据，SyncProducer包装了nio网络操作信息。

Producer的sync与async发送消息处理，大家看以上架构图一目了然。

partitionAndCollate方法详细作用:获取所有partitions的leader所在leaderBrokerId(就是在该partiionid的leader分布在哪个broker上),

创建一个HashMap<int, Map<TopicAndPartition, List<KeyedMessage<K,Message>>>>,把messages按照brokerId分组组装数据，然后为SyncProducer分别发送消息作准备工作。

名称解释：partKey:分区关键字，当客户端应用程序实现Partitioner接口时，传入参数key为分区关键字，根据key和numPartitions，返回分区(partitions)索引。记住partitions分区索引是从0开始的。

# Producer平滑扩容机制 #

如果开发过producer客户端代码，会知道metadata.broker.list参数，它的含义是kafak broker的ip和port列表，producer初始化时，就连接这几个broker，这时大家会有疑问，producer支持kafka cluster新增broker节点？它又没有监听zk broker节点或从zk中获取broker信息，答案是肯定的，producer可以支持平滑扩容broker，他是通过定时与现有的metadata.broker.list通信，获取新增broker信息，然后把新建的SyncProducer放入ProducerPool中。等待后续应用程序调用。

DefaultEventHandler类中初始化实例化BrokerPartitionInfo类，然后定期brokerPartitionInfo.updateInfo方法，DefaultEventHandler部分代码如下：

**\[java\]**  [view plain][view plain 5] [copy][view plain 5] [![在CODE上查看代码片][CODE]][CODE_CODE 5] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 6]

1.  def handle(events: Seq\[KeyedMessage\[K,V\]\]) \{  
2.    ......  
3.    **while** (remainingRetries > 0 && outstandingProduceRequests.size > 0) \{  
4.      topicMetadataToRefresh ++= outstandingProduceRequests.map(\_.topic)  
5.      **if** (topicMetadataRefreshInterval >= 0 &&  
6.          SystemTime.milliseconds - lastTopicMetadataRefreshTime > topicMetadataRefreshInterval) \{  
7.        Utils.swallowError(brokerPartitionInfo.updateInfo(topicMetadataToRefresh.toSet, correlationId.getAndIncrement))  
8.        sendPartitionPerTopicCache.clear()  
9.        topicMetadataToRefresh.clear  
10.       lastTopicMetadataRefreshTime = SystemTime.milliseconds  
11.     \}  
12.     outstandingProduceRequests = dispatchSerializedData(outstandingProduceRequests)  
13.     **if** (outstandingProduceRequests.size > 0) \{  
14.       info("Back off for %d ms before retrying send. Remaining retries = %d".format(config.retryBackoffMs, remainingRetries-1))  
15.       //休眠时间，多长时间刷新一次  
16.       Thread.sleep(config.retryBackoffMs)  
17.       // 生产者定期请求刷新最新topics的broker元数据信息  
18.       Utils.swallowError(brokerPartitionInfo.updateInfo(outstandingProduceRequests.map(\_.topic).toSet, correlationId.getAndIncrement))  
19.       .....  
20.     \}  
21.   \}  
22.   
23. \}

BrokerPartitionInfo的updateInfo方法代码如下：

**\[java\]**  [view plain][view plain 5] [copy][view plain 5] [![在CODE上查看代码片][CODE]][CODE_CODE 5] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 6]

1.  def updateInfo(topics: Set\[String\], correlationId: Int) \{  
2.    var topicsMetadata: Seq\[TopicMetadata\] = Nil  
3.    //根据topics列表,meta.broker.list,其他配置参数,correlationId表示请求次数，一个计数器参数而已  
4.    //创建一个topicMetadataRequest，并随机的选取传入的broker信息中任何一个去取metadata，直到取到为止  
5.    val topicMetadataResponse = ClientUtils.fetchTopicMetadata(topics, brokers, producerConfig, correlationId)  
6.    topicsMetadata = topicMetadataResponse.topicsMetadata  
7.    // throw partition specific exception  
8.    topicsMetadata.foreach(tmd =>\{  
9.      trace("Metadata for topic %s is %s".format(tmd.topic, tmd))  
10.     **if**(tmd.errorCode == ErrorMapping.NoError) \{  
11.       topicPartitionInfo.put(tmd.topic, tmd)  
12.     \} **else**  
13.       warn("Error while fetching metadata \[%s\] for topic \[%s\]: %s ".format(tmd, tmd.topic, ErrorMapping.exceptionFor(tmd.errorCode).getClass))  
14.     tmd.partitionsMetadata.foreach(pmd =>\{  
15.       **if** (pmd.errorCode != ErrorMapping.NoError && pmd.errorCode == ErrorMapping.LeaderNotAvailableCode) \{  
16.         warn("Error while fetching metadata %s for topic partition \[%s,%d\]: \[%s\]".format(pmd, tmd.topic, pmd.partitionId,  
17.           ErrorMapping.exceptionFor(pmd.errorCode).getClass))  
18.       \} // any other error code (e.g. ReplicaNotAvailable) can be ignored since the producer does not need to access the replica and isr metadata  
19.     \})  
20.   \})  
21.   producerPool.updateProducer(topicsMetadata)  
22. \}

ClientUtils.fetchTopicMetadata方法代码：

**\[java\]**  [view plain][view plain 5] [copy][view plain 5] [![在CODE上查看代码片][CODE]][CODE_CODE 5] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 6]

1. def fetchTopicMetadata(topics: Set\[String\], brokers: Seq\[Broker\], producerConfig: ProducerConfig, correlationId: Int): TopicMetadataResponse = \{  
2.   var fetchMetaDataSucceeded: Boolean = **false**  
3.   var i: Int = 0  
4.   val topicMetadataRequest = **new** TopicMetadataRequest(TopicMetadataRequest.CurrentVersion, correlationId, producerConfig.clientId, topics.toSeq)  
5.   var topicMetadataResponse: TopicMetadataResponse = **null**  
6.   var t: Throwable = **null**  
7.   val shuffledBrokers = Random.shuffle(brokers) //生成随机数  
8.   **while**(i < shuffledBrokers.size && !fetchMetaDataSucceeded) \{  
9.     //对随机选到的broker会创建一个SyncProducer  
10.     val producer: SyncProducer = ProducerPool.createSyncProducer(producerConfig, shuffledBrokers(i))  
11.     info("Fetching metadata from broker %s with correlation id %d for %d topic(s) %s".format(shuffledBrokers(i), correlationId, topics.size, topics))  
12.     **try** \{  //发送topicMetadataRequest到该broker去取metadata，获得该topic所对应的所有的broker信息  
13.       topicMetadataResponse = producer.send(topicMetadataRequest)  
14.       fetchMetaDataSucceeded = **true**  
15.     \}  
16.     **catch** \{  
17.       ......  
18.     \}  
19.   \}  
20.   **if**(!fetchMetaDataSucceeded) \{  
21.     **throw** **new** KafkaException("fetching topic metadata for topics \[%s\] from broker \[%s\] failed".format(topics, shuffledBrokers), t)  
22.   \} **else** \{  
23.     debug("Successfully fetched metadata for %d topic(s) %s".format(topics.size, topics))  
24.   \}  
25.   **return** topicMetadataResponse  
26. \}

ProducerPool的updateProducer

**\[java\]**  [view plain][view plain 5] [copy][view plain 5] [![在CODE上查看代码片][CODE]][CODE_CODE 5] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 6]

1.  def updateProducer(topicMetadata: Seq\[TopicMetadata\]) \{  
2.      val newBrokers = **new** collection.mutable.HashSet\[Broker\]  
3.      topicMetadata.foreach(tmd => \{  
4.        tmd.partitionsMetadata.foreach(pmd => \{  
5.          **if**(pmd.leader.isDefined)  
6.            newBrokers+=(pmd.leader.get)  
7.        \})  
8.      \})  
9.      lock **synchronized** \{  
10.       newBrokers.foreach(b => \{  
11.         **if**(syncProducers.contains(b.id))\{  
12.           syncProducers(b.id).close()  
13.           syncProducers.put(b.id, ProducerPool.createSyncProducer(config, b))  
14.         \} **else**  
15.           syncProducers.put(b.id, ProducerPool.createSyncProducer(config, b))  
16.       \})  
17.     \}  
18.   \}

当我们启动kafka broker后，并且大量producer和consumer时，经常会报如下异常信息。

**root@lizhitao:/opt/soft$ Closing socket connection to 192.168.11.166**

笔者也是经常很长时间看源码分析，才明白了为什么ProducerConfig配置信息里面并不要求使用者提供完整的kafka集群的broker信息，而是任选一个或几个即可。因为他会通过您选择的broker和topics信息而获取最新的所有的broker信息。

值得了解的是用于发送TopicMetadataRequest的SyncProducer虽然是用ProducerPool.createSyncProducer方法建出来的，但用完并不还回ProducerPool，而是直接Close.

**重难点理解：**

刷新metadata并不仅在第一次初始化时做。为了能适应kafka broker运行中因为各种原因挂掉、paritition改变等变化，

eventHandler会定期的再去刷新一次该metadata，刷新的间隔用参数topic.metadata.refresh.interval.ms定义，默认值是10分钟。  
这里有三点需要强调：

*  客户端调用send, 才会新建SyncProducer，只有调用send才会去定期刷新metadata
 *  在每次取metadata时，kafka会新建一个SyncProducer去取metadata，逻辑处理完后再close。
 *  根据当前SyncProducer(一个Broker的连接)取得的最新的完整的metadata，刷新ProducerPool中到broker的连接.
 *  每10分钟的刷新会直接重新把到每个broker的socket连接重建，意味着在这之后的第一个请求会有几百毫秒的延迟。如果不想要该延迟，把topic.metadata.refresh.interval.ms值改为-1，这样只有在发送失败时，才会重新刷新。Kafka的集群中如果某个partition所在的broker挂了，可以检查错误后重启重新加入集群，手动做rebalance，producer的连接会再次断掉，直到rebalance完成，那么刷新后取到的连接着中就会有这个新加入的broker。

说明：每个SyncProducer实例化对象会建立一个socket连接

**特别注意:**

在ClientUtils.fetchTopicMetadata调用完成后，回到BrokerPartitionInfo.updateInfo继续执行，在其末尾，pool会根据上面取得的最新的metadata建立所有的SyncProducer，即Socket通道producerPool.updateProducer(topicsMetadata)  
在ProducerPool中，SyncProducer的数目是由该topic的partition数目控制的，即每一个SyncProducer对应一个broker，内部封了一个到该broker的socket连接。每次刷新时，会把已存在SyncProducer给close掉，即关闭socket连接，然后新建SyncProducer，即新建socket连接，去覆盖老的。  
如果不存在，则直接创建新的。

25）apache kafka性能优化架构分析

Apache kafka性能优化架构分析

![SouthEast 23][]

应用程序优化：数据压缩

![SouthEast 24][]

![SouthEast 25][]

![SouthEast 26][]

![SouthEast 27][]

consumer offset默认情况下是定时批量更新topics的partitions offset值

**26）apache kafka源码分析走读-server端网络架构分析**

笔者今天分析一下kafka网络架构，俗话说人无好的胫骨，就没有好的身体，建筑没有扎实可靠的结构框架，就不会屹立不倒。

同样的服务端程序没有好的网络架构，其性能就会受到极大影响，其他方面再怎么优化，也会受限于此，那kafka网络架构是怎样的呢，

它不是用的现今流行的netty，mina的高性能网络架构，而是自己基于java nio开发的。

kafka网络架构图如下：

![SouthEast 28][]

**27）apache kafka源码分析走读-ZookeeperConsumerConnector分析**

# 1.ZookeeperConsumer架构 #

ZookeeperConsumer类中consumer运行过程架构图：

> ![SouthEast 29][]

图1

过程分析：

[ConsumerGroupExample类][ConsumerGroupExample]

# 2.消费者线程(consumer thread),队列，拉取线程(fetch thread)三者之间关系 #

每一个topic至少需要创建一个consumer thread，如果有多个partitions，则可以创建多个consumer thread线程，

consumer thread>==partitions数量，否则会有consumer thread空闲。

部分代码示例如下：

> ConsumerConnector consumer
> 
> consumer = kafka.consumer.Consumer.createJavaConsumerConnector(
> 
>             createConsumerConfig());
> 
>  Map<String, Integer> topicCountMap = new HashMap<String, Integer>();
> 
>  topicCountMap.put("test-string-topic", new Integer(1));  //value表示consumer thread线程数量
> 
>  Map<String, List<KafkaStream<byte\[\], byte\[\]>>> consumerMap = consumer.createMessageStreams(topicCountMap);

具体说明一下三者关系：

(1).topic的partitions分布规则

paritions是安装kafka brokerId有序分配的。

例如现在有三个node安装了kafka broker服务端程序，brokerId分别设置为1,2,3，现在准备一个topic为test-string-topic，

并且分配12个partitons，此时partitions的kafka broker节点分布情况为 ，partitions索引编号为0,3,6,9等4个partitions在brokerId=1上，

1,4,7,10在brokerId=2上，2,5,8,11在brokerId=3上。

创建consumer thread

consumer thread数量与BlockingQueue一一对应。

a.当consumer thread count=1时

此时有一个blockingQueue1，三个fetch thread线程，该topic分布在几个node上就有几个fetch thread，

每个fetch thread会于kafka broker建立一个连接。3个fetch thread线程去拉取消息数据，最终放到blockingQueue1中，

等待consumer thread来消费。

消费者线程，缓冲队列，partitions分布列表如下

fetch thread与partitions分布列表如下

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0); border-collapse:collapse"> 
 <tbody> 
 <tr> 
 <td style="width:94px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> fetch线程 </td> 
 <td style="width:73px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> partitions </td> 
 </tr> 
 <tr> 
 <td style="width:94px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> fetch thread1 </td> 
 <td style="width:73px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> 0,3,6,9 </td> 
 </tr> 
 <tr> 
 <td style="width:94px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> fetch thread2 </td> 
 <td style="width:73px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> 1,4,7,10 </td> 
 </tr> 
 <tr> 
 <td style="width:94px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> fetch thread3 </td> 
 <td style="width:73px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> 2,5,8,11 </td> 
 </tr> 
 </tbody> 
</table>

b. 当consumer thread count=2时

此时有consumerThread1和consumerThread2分别对应2个队列blockingQueue1，

blockingQueue2,这2个消费者线程消费partitions依次为:0,1,2,3,4,5与6,7,8,9,10,11;消费者线程，缓冲队列，partitions分布列表如下

fetch thread与partitions分布列表如下

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0); border-collapse:collapse"> 
 <tbody> 
 <tr> 
 <td style="width:94px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> fetch线程 </td> 
 <td style="width:73px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> partitions </td> 
 </tr> 
 <tr> 
 <td style="width:94px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> fetch thread1 </td> 
 <td style="width:73px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> 0,3,6,9 </td> 
 </tr> 
 <tr> 
 <td style="width:94px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> fetch thread2 </td> 
 <td style="width:73px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> 1,4,7,10 </td> 
 </tr> 
 <tr> 
 <td style="width:94px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> fetch thread3 </td> 
 <td style="width:73px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> 2,5,8,11 </td> 
 </tr> 
 </tbody> 
</table>

c. 当consumer thread count=4时

消费者线程，缓冲队列，partitions分布列表如下

<table style="font-family:Arial; font-size:14.3999996185303px; line-height:26px; color:rgb(0,0,0); border-collapse:collapse"> 
 <tbody> 
 <tr> 
 <td style="width:100px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> consumer线程 </td> 
 <td style="width:97px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> Blocking Queue </td> 
 <td style="width:76px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> partitions </td> 
 </tr> 
 <tr> 
 <td style="width:100px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> consumer thread1 </td> 
 <td style="width:97px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> blockingQueue1 </td> 
 <td style="width:76px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> 0,1,2 </td> 
 </tr> 
 <tr> 
 <td style="width:100px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> consumer thread2 </td> 
 <td style="width:97px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> blockingQueue2 </td> 
 <td style="width:76px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> 3,4,5 </td> 
 </tr> 
 <tr> 
 <td style="width:100px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> consumer thread3 </td> 
 <td style="width:97px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> blockingQueue3 </td> 
 <td style="width:76px; height:13px; border:1px solid rgb(0,0,0); padding:4px"> 6,7,8 </td> 
 </tr> 
 <tr> 
 <td style="width:100px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> consumer thread4 </td> 
 <td style="width:97px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> blockingQueue4 </td> 
 <td style="width:76px; height:14px; border:1px solid rgb(0,0,0); padding:4px"> 9,10,11 </td> 
 </tr> 
 </tbody> 
</table>

fetch thread与partitions分布列表如下

同上

同理当消费线程consumer thread count=n,都是安装上述分布规则来处理的。

# 3.consumer消息线程以及队列创建逻辑 #

运用ZookeeperConsumerConnector类创建多线程并行消费测试类，ConsumerGroupExample类初始化，调用createMessageStreams方法，

实际是在consume方法处理的逻辑，创建KafkaStream,以及阻塞队列(LinkedBlockingQueue),KafkaStream与队列个数一一对应，消费者线程数量决定阻塞队列的个数。

registerConsumerInZK()方法：设置消费者组，注册消费者信息consumerIdString到zookeeper上。

consumerIdString产生规则部分代码如下:

**\[java\]**  [view plain][view plain 6] [copy][view plain 6] [![在CODE上查看代码片][CODE]][CODE_CODE 6] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 7]

1.  String consumerUuid = **null**;  
2.  **if**(config.consumerId!=**null** && config.consumerId)  
3.   consumerUuid = consumerId;  
4.  **else** \{   
5.   String uuid = UUID.randomUUID()  
6.     
7.    consumerUuid = "%s-%d-%s".format(  
8.      InetAddress.getLocalHost.getHostName, System.currentTimeMillis,  
9.      uuid.getMostSignificantBits().toHexString.substring(0,8));  
10. \}      
11. String consumerIdString =  config.groupId + "\_" + consumerUuid;

kafka zookeeper注册模型结构或存储结构如下：

[kafka在zookeeper中存储结构][kafka_zookeeper]

说明：目前把kafka中绝大部分存储模型都列表出来了，当前还有少量不常使用的，暂时还没有列举，后续会加上。

consumer初始化逻辑处理：

1.实例化并注册loadBalancerListener监听，ZKRebalancerListener监听consumerIdString状态变化

触发consumer reblance条件如下几个：

ZKRebalancerListener：当/kafka01/consumer/\[consumer-group\]/ids子节点变化时，会触发

ZKTopicPartitionChangeListener：当该topic的partitions发生变化时，会触发。

val topicPath = "/kafka01/brokers/topics" + "/" + "topic-1"  
      zkClient.subscribeDataChanges(topicPath, topicPartitionChangeListener)

consumer reblance逻辑

consumer offset更新机制

reblance计算规则：（有待补充）

**28）kafka的ZkUtils类的java版本部分代码**

**\[java\]**  [view plain][view plain 7] [copy][view plain 7] [![在CODE上查看代码片][CODE]][CODE_CODE 7] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 8]

1. /\*\* 
2.  \* Created with IntelliJ IDEA. 
3.  \* User: lizhitao 
4.  \* Date: 14-6-6 
5.  \* Time: 下午3:01 
6.  \* To change this template use File | Settings | File Templates. 
7.  \*/  
8. **public** **class** TestMafkaZkUtils \{  
9.     **private** **static** **final** Logger logger = Logger.getLogger(TestMafkaZkUtils.**class**);  
10.   
11.     /\*\*\*\*\*\*\*\*\*\*   kafka zk root conf   \*\*\*\*\*\*\*\*\*/  
12.     **public** **static** **final** String ConsumersPath = "/consumers";  
13.     **public** **static** **final** String BrokerIdsPath = "/brokers/ids";  
14.     **public** **static** **final** String BrokerTopicsPath = "/brokers/topics";  
15.     **public** **static** **final** String TopicConfigPath = "/config/topics";  
16.     **public** **final** String TopicConfigChangesPath = "/config/changes";  
17.     **public** **static** **final** String ControllerPath = "/controller";  
18.     **public** **static** **final** String ControllerEpochPath = "/controller\_epoch";  
19.     **public** **static** **final** String ReassignPartitionsPath = "/admin/reassign\_partitions";  
20.     **public** **static** **final** String DeleteTopicsPath = "/admin/delete\_topics";  
21.     **public** **static** **final** String PreferredReplicaLeaderElectionPath = "/admin/preferred\_replica\_election";  
22.   
23.     **public** **static** String getTopicPath(String topic) \{  
24.         **return**  BrokerTopicsPath + "/" + topic;  
25.     \}  
26.   
27.     **public** **static** String getTopicPartitionsPath(String topic) \{  
28.         **return**   getTopicPath(topic) +  "/partitions";  
29.     \}  
30.   
31.     **public** **static** String getTopicConfigPath(String topic) \{  
32.         **return**  TopicConfigPath + "/" + topic;  
33.     \}  
34.   
35.     **public** **static** String getDeleteTopicPath(String clusterName, String topic ) \{  
36.         **return**   DeleteTopicsPath + "/" + topic;  
37.     \}  
38.   
39.     **public** **static** String getBrokerIdsPath() \{  
40.         **return**  BrokerIdsPath;  
41.     \}  
42.   
43.   
44.     **public** **static** List<MafkaBroker> getAllBrokersInCluster(ZkClient zkClient, String clusterName) \{  
45.         **if** (!pathExists(zkClient, getBrokerIdsPath())) \{  
46.             **throw** **new** ZkNoNodeException(getBrokerIdsPath());  
47.         \}  
48.   
49.         List<String> brokerIds = getChildrenParentMayNotExist(zkClient, getBrokerIdsPath());  
50.         Collections.sort(brokerIds);  
51. //                List<String>     MafkaBroker getBrokerInfo(ZkClient zkClient, int brokerId)  
52.         List<MafkaBroker> retList = **new** ArrayList<MafkaBroker>();  
53.         **for** (String brokerIdStr : brokerIds) \{  
54.             MafkaBroker broker = getBrokerInfo(zkClient, Integer.valueOf(brokerIdStr));  
55.             **if** (broker!=**null**)  
56.                 retList.add(broker);  
57.   
58.         \}  
59.   
60.         **return** retList;  
61.     \}  
62.   
63.   
64.     **public** **static** String getMetadataBrokerList(ZkClient zkClient, String clusterName) \{  
65.         List<MafkaBroker> brokers = TestMafkaZkUtils.getAllBrokersInCluster(zkClient, clusterName);  
66.         StringBuffer sb = **new** StringBuffer();  
67.         **for** (MafkaBroker broker : brokers) \{  
68.             logger.info(broker);  
69.             **if** (sb.length() > 0)  
70.                 sb.append(",");  
71.             sb.append(broker.getHost()).append(":").append(broker.getPort());  
72.         \}  
73.   
74.         **return** sb.toString();  
75.     \}  
76.   
77.     /\*\* 
78.      \* get children nodes name 
79.      \* @param zkClient zkClient 
80.      \* @param path full path 
81.      \* @return children nodes name or null while path not exist 
82.      \*/  
83.     **public** **static** List<String> getChildrenParentMayNotExist(ZkClient zkClient, String path) \{  
84.         **try** \{  
85.             **return** zkClient.getChildren(path);  
86.         \} **catch** (ZkNoNodeException e) \{  
87.             **return** **null**;  
88.         \} **catch** (Exception ex) \{  
89.             logger.error("getChildrenParentMayNotExist invoke fail!",ex);  
90.             **return** **null**;  
91.         \}  
92.     \}  
93.   
94.     /\*\* 
95.      \* This API takes in a broker id, queries zookeeper for the broker metadata 
96.       and returns the metadata for that broker 
97.      \* or throws an exception if the broker dies before the query to zookeeper finishes 
98.      \* @param brokerId The broker id 
99.      \* @param zkClient The zookeeper client connection 
100.      \* @return An optional MafkaBroker object encapsulating the broker metadata 
101.      \*/  
102.     **public** **static** MafkaBroker getBrokerInfo(ZkClient zkClient, **int** brokerId) \{  
103. //        Pair<String, Stat>  
104.         String brokerInfoStr = readDataMaybeNull(zkClient, getBrokerIdsPath() + "/" + brokerId).getLeft();  
105.         **if** (StringUtils.isNotEmpty(brokerInfoStr)) \{  
106.             **return** MafkaBroker.createBroker(brokerId, brokerInfoStr);  
107.         \} **else**\{  
108.             **return** **null**;  
109.         \}  
110.     \}  
111.   
112.     **public** **static** Pair<String, Stat> readData(ZkClient client, String path) \{  
113.         Stat stat = **new** Stat();  
114.         String dataStr = client.readData(path, stat);  
115.         **return** Pair.of(dataStr, stat);  
116.     \}  
117.   
118.     **public** **static** Pair<String, Stat> readDataMaybeNull(ZkClient client, String path) \{  
119.         Stat stat = **new** Stat();  
120.         Pair<String, Stat> dataAndStat = **null**;  
121.         **try** \{  
122.             dataAndStat = Pair.of((String)client.readData(path, stat), stat);  
123.         \} **catch**(ZkNoNodeException nkex) \{  
124.             **return** Pair.of(**null**, stat);  
125.         \} **catch**(Exception ex) \{  
126.             logger.error(ex);  
127.         \}  
128.         **return** dataAndStat;  
129.     \}  
130.   
131.     /\*\* 
132.      \* Update the value of a persistent node with the given path and data. 
133.      \* create parrent directory if necessary. Never throw NodeExistException. 
134.      \*/  
135.     **public** **void** updateEphemeralPath(ZkClient client, String path, String data) \{  
136.         **try** \{  
137.             client.writeData(path, data);  
138.         \} **catch**(ZkNoNodeException zkex) \{  
139.             createParentPath(client, path);  
140.             client.createEphemeral(path, data);  
141.         \} **catch** (Exception ex) \{  
142.             logger.error(ex);  
143.         \}  
144.     \}  
145.   
146.     **public** **static** **boolean** deletePath(ZkClient client, String path) \{  
147.         **try** \{  
148.             **return** client.delete(path);  
149.         \} **catch**(ZkNoNodeException zkex) \{  
150.             // this can happen during a connection loss event, return normally  
151.             logger.info(path + " deleted during connection loss; this is ok");  
152.             **return** **false**;  
153.         \} **catch** (Exception ex) \{  
154.             logger.error(ex);  
155.         \}  
156.         **return** **false**;  
157.     \}  
158.   
159.     **public** **void** deletePathRecursive(ZkClient client, String path) \{  
160.         **try** \{  
161.             client.deleteRecursive(path);  
162.         \} **catch**(ZkNoNodeException zkex) \{  
163.             // this can happen during a connection loss event, return normally  
164.             logger.info(path + " deleted during connection loss; this is ok");  
165.         \} **catch** (Exception ex) \{  
166.             logger.error(ex);  
167.         \}  
168.     \}  
169.   
170.     **public** **void** maybeDeletePath(String zkUrl, String dir) \{  
171.         **try** \{  
172.             ZkClient zk = **new** ZkClient(zkUrl, 30\*1000, 30\*1000, **new** MafkaZKStrSerializer());  
173.             zk.deleteRecursive(dir);  
174.             zk.close();  
175.         \} **catch**(Exception ex) \{  
176.             logger.error(ex);  
177.         \}  
178.     \}  
179.   
180.     /\*\* 
181.      \*  make sure a persistent path exists in ZK. Create the path if not exist. 
182.      \*/  
183.     **public** **static** **void** makeSurePersistentPathExists(ZkClient client, String path) \{  
184.         **if** (!client.exists(path))  
185.             client.createPersistent(path, **true**); // won't throw NoNodeException or NodeExistsException  
186.     \}  
187.   
188.     /\*\* 
189.      \*  create the parent path 
190.      \*/  
191.     **private** **static** **void** createParentPath(ZkClient client, String path) \{  
192.         String parentDir = path.substring(0, path.lastIndexOf('/'));  
193.         **if** (parentDir.length() != 0)  
194.             client.createPersistent(parentDir, **true**);  
195.     \}  
196.   
197.     /\*\* 
198.      \* Create an ephemeral node with the given path and data. Create parents if necessary. 
199.      \*/  
200.     **private** **static** **void** createEphemeralPath(ZkClient client, String path, String data) \{  
201.         **try** \{  
202.             client.createEphemeral(path, data);  
203.         \} **catch**(ZkNoNodeException znex) \{  
204.             createParentPath(client, path);  
205.             client.createEphemeral(path, data);  
206.         \}  
207.     \}  
208.   
209.     /\*\* 
210.      \* Create an ephemeral node with the given path and data. 
211.      \* Throw NodeExistException if node already exists. 
212.      \*/  
213.     **public** **static** **void** createEphemeralPathExpectConflict(ZkClient client, String path, String data) \{  
214.         **try** \{  
215.             createEphemeralPath(client, path, data);  
216.         \} **catch**(ZkNodeExistsException zkex) \{  
217.             // this can happen when there is connection loss; 
218.                make sure the data is what we intend to write  
219.             String storedData = **null**;  
220.             **try** \{  
221.                 storedData = readData(client, path).getLeft();  
222.             \} **catch**(ZkNoNodeException znex) \{  
223.                 logger.error(znex);  
224.             \}  
225.             **if** (storedData == **null** || storedData != data) \{  
226.                 logger.info("conflict in " + path + " data: " + data + " stored data: " + storedData);  
227.                 **throw** zkex;  
228.             \} **else** \{  
229.                 // otherwise, the creation succeeded, return normally  
230.                 logger.info(path + " exists with value " + data + " during connection loss; this is ok");  
231.             \}  
232.         \}  
233.     \}  
234.   
235.   
236.     /\*\* 
237.      \* Create an persistent node with the given path and data. Create parents if necessary. 
238.      \*/  
239.     **public** **static** **void** createPersistentPath(ZkClient client, String path, String data) \{  
240.         **try** \{  
241.             client.createPersistent(path, data);  
242.         \} **catch**(ZkNoNodeException znex) \{  
243.             createParentPath(client, path);  
244.             client.createPersistent(path, data);  
245.         \}  
246.     \}  
247.   
248.     **public** String createSequentialPersistentPath(ZkClient client, String path, String data) \{  
249.         **return** client.createPersistentSequential(path, data);  
250.     \}  
251.   
252.   
253.     **public** **static** List<String> getAllPartitionsByTopic(ZkClient zkClient, String topic) \{  
254.         **return** getChildren(zkClient, getTopicPartitionsPath(topic));  
255.     \}  
256.   
257.     /\*\* 
258.      \* Check if the given path exists 
259.      \*/  
260.     **public** **static** **boolean** pathExists(ZkClient zkClient, String path) \{  
261.         logger.info("pathExists:" + path+ " zkClient:" + zkClient);  
262.         **return** zkClient.exists(path);  
263.     \}  
264.   
265.     /\*\* 
266.      \* 功能介绍：解析partitions列表数据,partitions以字符串方式存储，用逗号分隔。 
267.      \* @param zkClient 
268.      \* @return 
269.      \*/  
270.     **public** **static** String getAllPartitionsSepCommaByTopic(ZkClient zkClient,String topic) \{  
271.         logger.info("getTopicPartitionsPath(clusterName, topic):" + getTopicPartitionsPath(topic));  
272.         **if** (!pathExists(zkClient, getTopicPartitionsPath(topic))) \{  
273.             **throw** **new** ZkNoNodeException(getTopicPartitionsPath(topic));  
274.         \}  
275.   
276.         List<String> partitions = getChildren(zkClient, getTopicPartitionsPath(topic));  
277.         Collections.sort(partitions,**new** Comparator<String>() \{  
278.             @Override  
279.             **public** **int** compare(String o1, String o2) \{  
280.                 **final** **int** p1 = ( o1 == **null** ) ? 0 : Integer.parseInt(o1);  
281.                 **final** **int** p2 = ( o2 == **null** ) ? 0 : Integer.parseInt(o2);  
282.                 **return** NumberUtils.compare(p1, p2);  
283.             \}  
284.         \});  
285.   
286.         StringBuffer parts = **new** StringBuffer();  
287.         **for** ( String partition : partitions ) \{  
288.             **if** (parts.length() > 0)  
289.                 parts.append(",");  
290.             parts.append(partition);  
291.         \}  
292.         **return** parts.toString();  
293.     \}  
294.   
295.     **public** **static** List<String> getChildren(ZkClient client, String path) \{  
296.         **return** client.getChildren(path);  
297.     \}  
298.   
299.   
300.     **public** **static** List<MafkaBroker> getAllBrokersInCluster(ZkClient zkClient) \{  
301.         List<String> brokerIds = getChildrenParentMayNotExist(zkClient, getBrokerIdsPath());  
302.         Collections.sort(brokerIds);  
303. //                List<String>     MafkaBroker getBrokerInfo(ZkClient zkClient, int brokerId)  
304.         List<MafkaBroker> retList = **new** ArrayList<MafkaBroker>();  
305.         **for** (String brokerIdStr : brokerIds) \{  
306.             MafkaBroker broker = getBrokerInfo(zkClient, Integer.valueOf(brokerIdStr));  
307.             **if** (broker!=**null**)  
308.                 retList.add(broker);  
309.   
310.         \}  
311.   
312.         **return** retList;  
313.     \}  
314.   
315.   
316.     **public** **static** **void** main(String\[\] args) \{  
317.         ZkClient zkClient;  
318.         //kafka zk根节点  
319.         String zkConnect = 
320. "192.168.2.225:2181,192.168.2.225:2182,192.168.2.225:2183/config/mobile/mq/mafka01";  
321.         **int** zkSessionTimeoutMs = 5000;  
322.         **int** zkConnectionTimeoutMs = 5000;  
323.         zkClient = **new** ZkClient(zkConnect, zkSessionTimeoutMs, zkConnectionTimeoutMs,
324.  **new** MafkaZKStrSerializer());  
325.         //获取所有broker信息  
326.         System.out.println(getAllBrokersInCluster(zkClient));  
327.         //获取所有partitions信息  
328.         System.out.println(getAllPartitionsSepCommaByTopic(zkClient, "cluster-switch-topic"));  
329.     \}  
330.   
331. \}

**29）kafka & mafka client开发与实践**

请[单击这里下载][Link 2]（下载网址：http://download.csdn.net/detail/zhongwen7710/8173117）

**30)   kafka文件系统设计那些事**

# 1.文件系统说明 #

> 文件系统一般分为系统和用户2种类型，系统级文件系统:ext3,ext4,dfs,ntfs等等,，
> 
> 笔者并不会向大家介绍那种纷繁复杂的分布式或系统级文件系统，而是从kafka架构高性能角度考虑，
> 
> 深入剖析kafka文件系统存储结构设计。

#     #

# 2.kafka文件系统架构 #

## 2.1 文件系统数据流 ##

> 下面用图形表示介绍客户端处理几个过程如下：

> ![SouthEast 30][]  
>

** 图1**

*  当建立连接请求时，首先客户端向kafka broker发送连接请求，broker中由Acceptor thread线程接收并建立连接后，
 *  把client的socket以轮询方式转交给相应的processor thread。
 *  当client向broker发送数据请求，由processor thread处理并接收client数据放到request缓冲区中，
 *  以待IO thread进行逻辑处理和计算并把返回result放到response缓冲区中.  
    接着唤醒processor thread，processor thread抱住response队列循环发送所有response数据给client.

## 2.2 kafka文件系统存储结构 ##

> ![SouthEast 31][]  
>

**图2**

*  paritions分布规则，kafka集群由多个kafka broker组成，一个topic的partitions会分布在一个或多个broker上，
 *  topic的partitions在kafka集群上分配规则为，安装paritions索引编号依次有序分布在broker上，  
    当partitions数量 > brokers数量，会依次轮回再次迭代分配。
 *  partitions命名规则,paritions名称为:topic-name-index,  index分区索引编号，从0开始依次递增。
 *  producer，每个producer可以发送msg到topic任意一个或多个partitons。
 *  consumer，同一个Consumer Group中的Consumers，Kafka将相应Topic中的每个消息只发送给其中一个Consumer.

## 2.3 kafka的文件系统结构-目录 ##

> 目前假如kafka集群中只有一个broker，数据文件目录为message-folder，例如笔者创建一个topic名称为：report\_push,  partitions=4
> 
> 存储路径和目录规则为：
> 
> xxx/message-folder
> 
>                               |--report\_push-0
> 
>                               |--report\_push-1
> 
>                               |--report\_push-2
> 
>                               |--report\_push-3
> 
> 形象表示图如下：
> 
> ![SouthEast 32][]  
>

**图3**

## 2.4 kafka的文件系统结构-partiton文件存储方式 ##

> ![SouthEast 33][]  
>

**图4**

> 每个partition（topic-name-index)目录中存储海量msg消息，那它是怎么存储的呢？文件存储结构是怎样？
> 
> 这么多(海量)消息是存储在一个大文件中，类似DB那样存储，还是其他方式存储结构呢？笔者后续会像剥洋葱一样，
> 
> 给大家一层一层依次分解并分析。

*  数据库和kafka文件系统比较，相信大家都用过数据库，数据库底层文件系统相当复杂，因为数据库特点，需要按照关键字，id快速查询，
 *  修改，删除，日志，回滚等等。  
    所以数据库文件系统是分页存储的树形结构，需要支持大量随机事物操作。相比数据库支持查询，事物等等复杂文件，
 *  则kafka消息队列类型文件系统简单多了，kafka文件系统存储特点是，  
    只需要支持producer和consumer顺序生产和消息就够了，消息(msg)生命周期由consumer决定。
 *  partiton文件存储结构分析，每个partition就像如上图4，一个巨大文件消息数据被平均分配到多个文件大小相等的文件中。
 *  即相当于一个大文件被切成很多相等大小的文件段segment file  
    (消息数量不一定相等)。因为每个topic中消息生命周期由最后一个consumer决定，当某个或些消息被最后一个consumer(consumer group)消息后，就可以删除该消息。显然易见，

这样做的目的是broker能快速回收磁盘空间，而且小文件也能mmap全部到内存。主要目的就是提高磁盘利用率和消息处理性能。

## 2.5 kafka的文件系统结构-partiton文件存储segment file组成 ##

> 读者从2.4节了解到kafka文件系统partition存储方式，下面向大家介绍一下partion文件存储中segement file组成结构。
> 
> 一个商业化消息队列的性能好坏，
> 
> 其文件系统存储结构设计是衡量一个消息队列服务程序最关键指标之一，他也是消息队列中最核心且最能体现消息队列技术水平的部分。
> 
> 在本节中我们将走进segment file内部一探究竟。
> 
> segment file组成：由2大部分组成，分别为segment data file和segment index file，此2个文件一一对应，成对出现.
> 
> segment index file索引文件组成结构如下：
> 
>  **00000000000000000000.index       文件名称，文件串大小最大支持2^64bit**
> 
> <table> 
> <tbody> 
> <tr> 
> <td> 每次记录相应log文件记录的相对条数和物理偏移位置位置，共8bytes 4byte&nbsp;当前segment file offset - last seg file offset记录条数 &nbsp; &nbsp; &nbsp; offset 4byte对应segment file物理偏移地址 position ……… </td> 
> </tr> 
> </tbody> 
> </table>

segment data file索引文件组成结构如下：

00000000000000000000.log        **文件名称，文件串大小最大支持2^64bit，与index对应**

> **![SouthEast 34][]     **

**                     图5      **

> **参数说明：**
> 
> 4 byte CRC32：使用crc32算法计算除CRC32这4byte外的buffer。
> 
> 1 byte “magic"：表示数据文件协议版本号
> 
> 1 byte “attributes"：表示标识独立版本，标识压缩类型，编码类型。
> 
>  key data：可选，可以存储判断或表示这个消息块的元数据信息。
> 
> payload data：消息体，该消息体可能会存储多条消息记录，内部是按照序号有序存储的。

## 2.6 kafka文件系统-consumer读取流程 ##

> ![SouthEast 35][] 
> 
> **图6**  
>

> segment index file：
> 
> 稀疏索引方式，减少索引文件大小，这样可以直接内存操作，稀疏索引只为数据文件的每个存储块设一个键-指针对,它比稠密索引节省了更多的存储空间，但查找给定值的记录需更多的时间，通过二分查找快速找到segment data file物理位置，如果在index file没有找到data file具体位置，则data file相对位置继续顺序读取查找，直到找到为止。

## 2.7 kafka的文件系统结构-总体目录结构 ##

> ![SouthEast 36][]

> **图7**
> 
> 同一个topic下有不同分区，每个分区下面会划分为多个(段)文件，只有一个当前文件在写，其他文件只读。
> 
> 当写满一个文件（写满的意思是达到设定值）则切换文件，新建一个当前文件用来写，老的当前文件切换为只读。
> 
> 文件的命名以起始偏移量来命名。看一个例子，假设report\_push这个topic下的0-0分区可能有以下这些文件：
> 
>  • 00000000000000000000.index
> 
>  • 00000000000000000000.log 
> 
>  • 00000000000000368769.index 
> 
>  • 00000000000000368769.log 
> 
>  • 00000000000000737337.index 
> 
>  • 00000000000000737337.log
> 
>  • 00000000000001105814.index
> 
>  • 00000000000001105814.log
> 
>     ………………..
> 
> 其中 00000000000000000000.index表示最开始的文件，起始偏移量为0.第二个文件00000000000000368769.index的消息量起始偏移量为368769.同样，第三个文件00000000000000737337.index的起始偏移量为737337.
> 
> 以起始偏移量命名并排序这些文件，那么当消费者要拉取某个消息起始偏移量位置的数据变的相当简单，
> 
> 只要根据传上来的offset\*\*二分查找\*\*文件列表，定位到具体文件，
> 
> 然后将绝对offset减去文件的起始节点转化为相对offset，即可开始传输数据。例如，同样以上面的例子为例，
> 
> 假设消费者想抓取从第368969消息位置开始的数据，则根据368969二分查找，
> 
> 定位到00000000000000368769.log这个文件（368969在368769和737337之间），根据索引文件二分搜索可以确定读取数据最大大小。

## 2.8 kafka文件系统–实际效果 ##

>   
> 
> 
> ![SouthEast 37][]

>                                                     **图8**   
> 
> 基本不会有磁盘读的大量操作，都在内存进行，只有定期磁盘批量写操作。

# 3.总结 #

高效文件系统特点

*  一个大文件分成多个小文件段。
 *  多个小文件段，容易定时清除或删除已经消费完文件，减少磁盘占用。
 *  index全部映射到memory直接操作，避免segment file被交换到磁盘增加IO操作次数。
 *  根据索引信息，可以确定发送response到consumer的最大大小。
 *  索引文件元数据存储用的是相对前一个segment file的offset存储，节省空间大小。

**31）kafka的ZookeeperConsumer实现**

kafka的ZookeeperConsumer数据获取的步骤如下：

入口ZookeeperConsumerConnector def consume\[T\](topicCountMap: scala.collection.Map\[String,Int\], decoder: Decoder\[T\])  
: Map\[String,List\[KafkaStream\[T\]\]\] 方法  
客户端启动后会在消费者注册目录上添加子节点变化的监听ZKRebalancerListener，ZKRebalancerListener实例会在内部创建一个线程，这个线程定时检查监听的事件有没有执行（消费者发生变化）,如果没有变化则wait1秒钟，当发生了变化就调用 syncedRebalance 方法，去rebalance消费者。

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1.  **while** (!isShuttingDown.get) \{  
2.            **try** \{  
3.              lock.lock()  
4.              **try** \{  
5.                **if** (!isWatcherTriggered)  
6.                  cond.await(1000, TimeUnit.MILLISECONDS) // wake up periodically so that it can check the shutdown flag  
7.              \} **finally** \{  
8.                doRebalance = isWatcherTriggered  
9.                isWatcherTriggered = **false**  
10.               lock.unlock()  
11.             \}  
12.             **if** (doRebalance)  
13.               syncedRebalance  
14.           \} **catch** \{  
15.             **case** t => error("error during syncedRebalance", t)  
16.           \}

syncedRebalance方法在内部会调用def rebalance(cluster: Cluster): Boolean方法，去执行操作。  
这个方法的伪代码如下：

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

syncedRebalance方法在内部会调用def rebalance(cluster: Cluster): Boolean方法，去执行操作。  
这个方法的伪代码如下：

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1.  // 关闭所有的数据获取者  
2.  closeFetchers  
3.  // 解除分区的所有者  
4.  releasePartitionOwnership  
5.  // 按规则得到当前消费者拥有的分区信息并保存到topicRegistry中  
6.  topicRegistry=getCurrentConsumerPartitionInfo  
7.  // 修改并重启Fetchers  
8.  updateFetchers

updateFetcher是这样实现的。

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1. **private** def updateFetcher(cluster: Cluster) \{  
2.       // 遍历topicRegistry中保存的当前消费者的分区信息，修改Fetcher的partitions信息   
3.       var allPartitionInfos : List\[PartitionTopicInfo\] = Nil  
4.       **for** (partitionInfos <- topicRegistry.values)  
5.         **for** (partition <- partitionInfos.values)  
6.           allPartitionInfos ::= partition  
7.       info("Consumer " + consumerIdString + " selected partitions : " +  
8.         allPartitionInfos.sortWith((s,t) => s.partition < t.partition).map(\_.toString).mkString(","))  
9.   
10.       fetcher match \{  
11.         **case** Some(f) =>  
12.           // 调用fetcher的startConnections方法，初始化Fetcher并启动它  
13.           f.startConnections(allPartitionInfos, cluster)  
14.         **case** None =>  
15.       \}  
16.     \}

Fetcher在startConnections时，它先把topicInfo按brokerid去分组

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1. **for**(info <- topicInfos) \{  
2.       m.get(info.brokerId) match \{  
3.         **case** None => m.put(info.brokerId, List(info))  
4.         **case** Some(lst) => m.put(info.brokerId, info :: lst)  
5.       \}  
6.     \}

然后检查每组topicInfo对应的broker是否在当前集群中注册了

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1.  val brokers = ids.map \{ id =>  
2.        cluster.getBroker(id) match \{  
3.          **case** Some(broker) => broker  
4.          **case** None => **throw** **new** IllegalStateException("Broker " + id + " is unavailable, fetchers could not be started")  
5.        \}  
6.      \}

最后对每个broker创建一个FetcherRunnable线程，并启动它。这个线程负责从服务器上不断获取数据，把数据插入内部阻塞队列的操作。

// 对每个分区分别创建FetchRequest

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1. val fetches = partitionTopicInfos.map(info =>  
2.           **new** FetchRequest(info.topic, info.partition.partId, info.getFetchOffset, config.fetchSize))  
3. // 批量执行fetch操作  
4.         val response = simpleConsumer.multifetch(fetches : \_\*)  
5.   
6. ....  
7. // 遍历返回获取到的数据  
8. **for**((messages, infopti) <- response.zip(partitionTopicInfos)) \{  
9.           **try** \{  
10.             var done = **false**  
11. // 当zk中存放的offset值不在kafka机器上存在时，比如consumer好久没有启动，相应的offset的数据已经在kafka集群中被过期删除清理掉了  
12.             **if**(messages.getErrorCode == ErrorMapping.OffsetOutOfRangeCode) \{  
13.               info("offset for " + infopti + " out of range")  
14.               // see if we can fix this error  
15.               val resetOffset = resetConsumerOffsets(infopti.topic, infopti.partition)  
16.               **if**(resetOffset >= 0) \{  
17.                 infopti.resetFetchOffset(resetOffset)  
18.                 infopti.resetConsumeOffset(resetOffset)  
19.                 done = **true**  
20.               \}  
21.             \}  
22. // 如果成功了，把消息放到队列中，实际上是把当前分区信息、当前获取到的消息、当前获取使用的fetchoffset封装FetchedDataChunk对象，放到分区消息对象的内部队列中（chunkQueue.put(new FetchedDataChunk(messages, this, fetchOffset))）。  
23.             **if** (!done)  
24.               read += infopti.enqueue(messages, infopti.getFetchOffset)  
25.           \}

客户端用ConsumerIterator不断的从分区信息的内部队列中取数据。ConsumerIterator实现了IteratorTemplate的接口，

它的内部保存一个Iterator的属性current，每次调用makeNext时会检查它，如果有则从中取否则从队列中取。

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1.   **protected** def makeNext(): MessageAndMetadata\[T\] = \{  
2.     var currentDataChunk: FetchedDataChunk = **null**  
3.     // if we don't have an iterator, get one，从内部变量中取数据  
4.     var localCurrent = current.get()  
5.     **if**(localCurrent == **null** || !localCurrent.hasNext) \{  
6. // 内部变量中取不到值，检查timeout的值  
7.       **if** (consumerTimeoutMs < 0)  
8.         currentDataChunk = channel.take // 是负数(-1)，则表示永不过期，如果接下来无新数据可取，客户端线程会在channel.take阻塞住  
9.       **else** \{  
10. // 设置了过期时间，在没有新数据可用时，pool会在相应的时间返回，返回值为空，则说明没有取到新数据，抛出timeout的异常  
11.         currentDataChunk = channel.poll(consumerTimeoutMs, TimeUnit.MILLISECONDS)  
12.         **if** (currentDataChunk == **null**) \{  
13.           // reset state to make the iterator re-iterable  
14.           resetState()  
15.           **throw** **new** ConsumerTimeoutException  
16.         \}  
17.       \}  
18. // kafka把shutdown的命令也做为一个datachunk放到队列中，用这种方法来保证消息的顺序性  
19.       **if**(currentDataChunk eq ZookeeperConsumerConnector.shutdownCommand) \{  
20.         debug("Received the shutdown command")  
21.         channel.offer(currentDataChunk)  
22.         **return** allDone  
23.       \} **else** \{  
24.         currentTopicInfo = currentDataChunk.topicInfo  
25.         **if** (currentTopicInfo.getConsumeOffset != currentDataChunk.fetchOffset) \{  
26.           error("consumed offset: %d doesn't match fetch offset: %d for %s;\\n Consumer may lose data"  
27.                         .format(currentTopicInfo.getConsumeOffset, currentDataChunk.fetchOffset, currentTopicInfo))  
28.           currentTopicInfo.resetConsumeOffset(currentDataChunk.fetchOffset)  
29.         \}  
30. // 把取出chunk中的消息转化为iterator  
31.         localCurrent = **if** (enableShallowIterator) currentDataChunk.messages.shallowIterator  
32.                        **else** currentDataChunk.messages.iterator  
33. // 使用这个新的iterator初始化current，下次可直接从current中取数据  
34.         current.set(localCurrent)  
35.       \}  
36.     \}  
37. // 取出下一条数据，并用下一条数据的offset值设置consumedOffset  
38.     val item = localCurrent.next()  
39.     consumedOffset = item.offset  
40. // 解码消息，封装消息和它的topic信息到MessageAndMetadata对象，返回  
41.     **new** MessageAndMetadata(decoder.toEvent(item.message), currentTopicInfo.topic)  
42.   \}

ConsumerIterator的next方法

**\[java\]**  [view plain][view plain 8] [copy][view plain 8] [![在CODE上查看代码片][CODE]][CODE_CODE 8] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 9]

1.   override def next(): MessageAndMetadata\[T\] = \{  
2.     val item = **super**.next()  
3.     **if**(consumedOffset < 0)  
4.       **throw** **new** IllegalStateException("Offset returned by the message set is invalid %d".format(consumedOffset))  
5. // 使用makeNext方法设置的consumedOffset，去修改topicInfo的消费offset  
6.     currentTopicInfo.resetConsumeOffset(consumedOffset)  
7.     val topic = currentTopicInfo.topic  
8.     trace("Setting %s consumed offset to %d".format(topic, consumedOffset))  
9.     ConsumerTopicStat.getConsumerTopicStat(topic).recordMessagesPerTopic(1)  
10.     ConsumerTopicStat.getConsumerAllTopicStat().recordMessagesPerTopic(1)  
11. // 返回makeNext得到的item  
12.     item  
13.   \}

KafkaStream对ConsumerIterator做了进一步的封装，我们调用stream的next方法就可以取到数据了（内部通过调用ConsumerIterator的next方法实现）  
**注意：**

ConsumerIterator的实现可能会造成数据的重复发送（这要看生产者如何生产数据），

FetchedDataChunk是一个数据集合，它内部会包含很多数据块，一个数据块可能包含多条消息，

但同一个数据块中的消息只有一个offset，所以当一个消息块有多条数据，处理完部分数据发生异常时，

消费者重新去取数据，就会再次取得这个数据块，然后消费过的数据就会被重新消费。

这篇文章转载自田加国：http://www.tianjiaguo.com/system-architecture/kafka/kafka的zookeeperconsumer实现/

以上文章来自网络整理，可以参看：http://blog.csdn.net/lizhitao/article/details/39499283

[apache kafka]: http://blog.csdn.net/zhongwen7710/article/details/41252649
[http_kafka.apache.org_documentation.html]: http://kafka.apache.org/documentation.html#brokerconfigs
[SouthEast]: /images/20220731/0bdc97654dd546f9bf8068ec17552623.png
[SouthEast 1]: /images/20220731/70d3a0eaf8524b72a9db7fa54bb58207.png
[SouthEast 2]: /images/20220731/8ee32e498ddd4c1d945eb59827c4948c.png
[view plain]: http://blog.csdn.net/lizhitao/article/details/24490817#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/312267
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/312267/fork
[view plain 1]: http://blog.csdn.net/zhongwen7710/article/details/41252649#
[CODE_CODE 1]: https://code.csdn.net/snippets/524548
[ico_fork.svg 2]: https://code.csdn.net/snippets/524548/fork
[kafka_zookeeper]: http://blog.csdn.net/lizhitao/article/details/23744675
[20140504170822953]: /images/20220731/0218a174e731498b8d5470f014daa55d.png
[server.properties]: http://blog.csdn.net/lizhitao/article/details/25667831
[view plain 2]: http://blog.csdn.net/lizhitao/article/details/25667831#
[CODE_CODE 2]: https://code.csdn.net/snippets/341853
[ico_fork.svg 3]: https://code.csdn.net/snippets/341853/fork
[Center]: /images/20220731/6b0bfdb0d8e649a2a1c16711bc5623fe.png
[20140523114138265]: /images/20220731/8144a43105c34063af92020dd1a5aa90.png
[gradle]: http://blog.csdn.net/lizhitao/article/details/26875463
[apache kafka 1]: https://archive.apache.org/dist/kafka/0.8.1/kafka-0.8.1-src.tgz
[20140524232649546]: /images/20220731/075137fc0c164eaf9385aa8fb43526fa.png
[20140524233201312]: /images/20220731/70e915bac2824422a309007d3f2278f3.png
[20140524233527218]: /images/20220731/528ddaf6c08a44be89f8233a32ab1a70.png
[server.properties 1]: http://blog.csdn.net/lizhitao/article/details/24991799
[20140524233845781]: /images/20220731/f9e861e7e7bd4639bd5f0ffd44dd48a9.png
[20140524234413765]: /images/20220731/85501d39b82e4cbf869dd00bb0709a9b.png
[KafkaOffsetMonitor]: https://github.com/quantifind/KafkaOffsetMonitor/releases/download/v0.2.0/KafkaOffsetMonitor-assembly-0.2.0.jar
[KafkaOffsetMonitor 1]: http://pan.baidu.com/s/1kT5KeQ7
[SouthEast 3]: /images/20220731/31d7ff040a4d4f9b9e43217a9a1df8ee.png
[SouthEast 4]: /images/20220731/4b3aeee064c24a29bda39f93b93ed2dc.png
[SouthEast 5]: /images/20220731/f667fbed7bd04e0ea503f5527e07336a.png
[SouthEast 6]: /images/20220731/23d8bdefb57a42aaaf94d4a2cb7d0117.png
[SouthEast 7]: /images/20220731/73417276a5bb430e8f667e553119b557.png
[Kafka Web Console]: https://github.com/claudemamo/kafka-web-console/archive/master.zip
[SouthEast 8]: /images/20220731/f935c236d64042078f6170548bb4fcfc.png
[ivy2_jar]: http://pan.baidu.com/s/1gdgQqqB
[SouthEast 9]: /images/20220731/b2af29b7ab8c4ee1a7738c24c48ba0d3.png
[Link 1]: http://blog.csdn.net/lizhitao/article/details/37311565
[build.gradle]: http://pan.baidu.com/s/1pJM73QF
[kafka-perf_2.x.x-0.8.1.jar]: http://download.csdn.net/detail/lizhitao/7637693
[SouthEast 10]: /images/20220731/2899731023a4486ca76064af7884cbfd.png
[SouthEast 11]: /images/20220731/fa492ac107154e23925f7338c178f985.png
[SouthEast 12]: /images/20220731/7d38442299884d7581643cba78e56385.png
[SouthEast 13]: /images/20220731/0d41e9e7699743c28a2185d10dccdaf8.png
[SouthEast 14]: /images/20220731/26774cf651db497a89581965fb33202f.png
[SouthEast 15]: /images/20220731/34038b4d47e34931917969b83efbd42d.png
[SouthEast 16]: /images/20220731/7d8ef4423a1c45cd88d3cb30f8331e10.png
[view plain 3]: http://blog.csdn.net/lizhitao/article/details/37811291#
[CODE_CODE 3]: https://code.csdn.net/snippets/426922
[ico_fork.svg 4]: https://code.csdn.net/snippets/426922/fork
[SouthEast 17]: /images/20220731/cf228525650949c9b5fa9da3d7543791.png
[SouthEast 18]: /images/20220731/efbb5799dd9e41d1a694df9cdfc3cc4f.png
[SouthEast 19]: /images/20220731/3d5937d507b8407dbe3e96b5bf5312ce.png
[view plain 4]: http://blog.csdn.net/lizhitao/article/details/37911993#
[CODE_CODE 4]: https://code.csdn.net/snippets/441740
[ico_fork.svg 5]: https://code.csdn.net/snippets/441740/fork
[SouthEast 20]: /images/20220731/fe4fd1f622b74423871acece9db73109.png
[SouthEast 21]: /images/20220731/cb5616f61dfb4b4eb6933da653456a63.png
[SouthEast 22]: /images/20220731/e1561a0d80e44ec295a8243ad0b8a05e.png
[view plain 5]: http://blog.csdn.net/lizhitao/article/details/38438123#
[CODE_CODE 5]: https://code.csdn.net/snippets/445971
[ico_fork.svg 6]: https://code.csdn.net/snippets/445971/fork
[SouthEast 23]: /images/20220731/fa78845fad9f4b68b150f5e6aaac7df7.png
[SouthEast 24]: /images/20220731/7d768cc8905a4170a4da124cd6af9b2d.png
[SouthEast 25]: /images/20220731/f79ae7cfe6654dbe9ebe261e47ebde9f.png
[SouthEast 26]: /images/20220731/3ff05ab69241479eba9e465f4a4d45f3.png
[SouthEast 27]: /images/20220731/613acac7cca44a13b5758422683e797b.png
[SouthEast 28]: /images/20220731/4bd29719079546b1bb1f2bd04d5fd9ad.png
[SouthEast 29]: /images/20220731/b546ab09468247a98ca8e230dd19a900.png
[ConsumerGroupExample]: http://blog.csdn.net/lizhitao/article/details/37811291#t5
[view plain 6]: http://blog.csdn.net/lizhitao/article/details/38458631#
[CODE_CODE 6]: https://code.csdn.net/snippets/471073
[ico_fork.svg 7]: https://code.csdn.net/snippets/471073/fork
[view plain 7]: http://blog.csdn.net/lizhitao/article/details/38518527#
[CODE_CODE 7]: https://code.csdn.net/snippets/448747
[ico_fork.svg 8]: https://code.csdn.net/snippets/448747/fork
[Link 2]: http://download.csdn.net/detail/zhongwen7710/8173117
[SouthEast 30]: /images/20220731/7b411a4038c1445a828fc134adc39f7a.png
[SouthEast 31]: /images/20220731/289b3f2ba28e48899d0ce8c1928149f9.png
[SouthEast 32]: /images/20220731/ea2d171fcc3a4106a807938b640502a8.png
[SouthEast 33]: /images/20220731/3403f06c9e4a4b1cb5e5d3a6398f86db.png
[SouthEast 34]: /images/20220731/90d32a5ed11842818cd2a7e0cd2a427a.png
[SouthEast 35]: /images/20220731/4dabc0ddfd984ccabef8621affe95629.png
[SouthEast 36]: /images/20220731/749cd5e485b64ce1ae96830503f94746.png
[SouthEast 37]: /images/20220731/89a859ae02f443f28dd874782baafe7f.png
[view plain 8]: http://blog.csdn.net/lizhitao/article/details/40650989#
[CODE_CODE 8]: https://code.csdn.net/snippets/502981
[ico_fork.svg 9]: https://code.csdn.net/snippets/502981/fork