当前访客身份:游客 [ 登录  | 注册加入尚学堂]
直播

我来了!

拥有积分:3962
尚学堂雄起!!威武。。。

博客分类

笔记中心

课题中心

提问中心

答题中心

解答题中心

Kafka broker配置介绍

我来了! 发表于 2年前 (2014-11-10 17:12:45)  |  评论(0)  |  阅读次数(442)| 0 人收藏此文章,   我要收藏   

这部分内容对了解系统和提高软件性能都有很大的帮助,kafka官网上也给出了比较详细的配置详单,但是我们还是直接从代码来看broker到底有哪些配置需要我们去了解的,配置都有英文注释,所以每一部分是干什么的就不翻译了,都能看懂:

001 /**
002  * Licensed to the Apache Software Foundation (ASF) under one or more
003  * contributor license agreements.  See the NOTICE file distributed with
004  * this work for additional information regarding copyright ownership.
005  * The ASF licenses this file to You under the Apache License, Version 2.0
006  * (the "License"); you may not use this file except in compliance with
007  * the License.  You may obtain a copy of the License at
008  *
009  *    http://www.apache.org/licenses/LICENSE-2.0
010  *
011  * Unless required by applicable law or agreed to in writing, software
012  * distributed under the License is distributed on an "AS IS" BASIS,
013  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014  * See the License for the specific language governing permissions and
015  * limitations under the License.
016  */
017  
018 package kafka.server
019  
020 import java.util.Properties
021 import kafka.utils.{Utils, ZKConfig}
022 import kafka.message.Message
023  
024 /**
025  * Configuration settings for the kafka server
026  */
027 class KafkaConfig(props: Properties) extends ZKConfig(props) {
028   /* the port to listen and accept connections on */
029   val port: Int = Utils.getInt(props, "port", 6667)
030  
031   /* hostname of broker. If not set, will pick up from the value returned from getLocalHost. If there are multiple interfaces getLocalHost may not be what you want. */
032   val hostName: String = Utils.getString(props, "hostname", null)
033  
034   /* the broker id for this server */
035   val brokerId: Int = Utils.getInt(props, "brokerid")
036    
037   /* the SO_SNDBUFF buffer of the socket sever sockets */
038   val socketSendBuffer: Int = Utils.getInt(props, "socket.send.buffer", 100*1024)
039    
040   /* the SO_RCVBUFF buffer of the socket sever sockets */
041   val socketReceiveBuffer: Int = Utils.getInt(props, "socket.receive.buffer", 100*1024)
042    
043   /* the maximum number of bytes in a socket request */
044   val maxSocketRequestSize: Int = Utils.getIntInRange(props, "max.socket.request.bytes", 100*1024*1024, (1, Int.MaxValue))
045  
046   /* the maximum size of message that the server can receive */
047   val maxMessageSize = Utils.getIntInRange(props, "max.message.size", 1000000, (0, Int.MaxValue))
048  
049   /* the number of worker threads that the server uses for handling all client requests*/
050   val numThreads = Utils.getIntInRange(props, "num.threads", Runtime.getRuntime().availableProcessors, (1, Int.MaxValue))
051    
052   /* the interval in which to measure performance statistics */
053   val monitoringPeriodSecs = Utils.getIntInRange(props, "monitoring.period.secs", 600, (1, Int.MaxValue))
054    
055   /* the default number of log partitions per topic */
056   val numPartitions = Utils.getIntInRange(props, "num.partitions", 1, (1, Int.MaxValue))
057    
058   /* the directory in which the log data is kept */
059   val logDir = Utils.getString(props, "log.dir")
060    
061   /* the maximum size of a single log file */
062   val logFileSize = Utils.getIntInRange(props, "log.file.size", 1*1024*1024*1024, (Message.MinHeaderSize, Int.MaxValue))
063  
064   /* the maximum size of a single log file for some specific topic */
065   val logFileSizeMap = Utils.getTopicFileSize(Utils.getString(props, "topic.log.file.size", ""))
066  
067   /* the maximum time before a new log segment is rolled out */
068   val logRollHours = Utils.getIntInRange(props, "log.roll.hours", 24*7, (1, Int.MaxValue))
069  
070   /* the number of hours before rolling out a new log segment for some specific topic */
071   val logRollHoursMap = Utils.getTopicRollHours(Utils.getString(props, "topic.log.roll.hours", ""))
072  
073   /* the number of hours to keep a log file before deleting it */
074   val logRetentionHours = Utils.getIntInRange(props, "log.retention.hours", 24*7, (1, Int.MaxValue))
075  
076   /* the number of hours to keep a log file before deleting it for some specific topic*/
077   val logRetentionHoursMap = Utils.getTopicRetentionHours(Utils.getString(props, "topic.log.retention.hours", ""))
078    
079   /* the maximum size of the log before deleting it */
080   val logRetentionSize = Utils.getLong(props, "log.retention.size", -1)
081  
082   /* the maximum size of the log for some specific topic before deleting it */
083   val logRetentionSizeMap = Utils.getTopicRetentionSize(Utils.getString(props, "topic.log.retention.size", ""))
084  
085   /* the frequency in minutes that the log cleaner checks whether any log is eligible for deletion */
086   val logCleanupIntervalMinutes = Utils.getIntInRange(props, "log.cleanup.interval.mins", 10, (1, Int.MaxValue))
087    
088   /* enable zookeeper registration in the server */
089   val enableZookeeper = Utils.getBoolean(props, "enable.zookeeper", true)
090  
091   /* the number of messages accumulated on a log partition before messages are flushed to disk */
092   val flushInterval = Utils.getIntInRange(props, "log.flush.interval", 500, (1, Int.MaxValue))
093  
094   /* the maximum time in ms that a message in selected topics is kept in memory before flushed to disk, e.g., topic1:3000,topic2: 6000  */
095   val flushIntervalMap = Utils.getTopicFlushIntervals(Utils.getString(props, "topic.flush.intervals.ms", ""))
096  
097   /* the frequency in ms that the log flusher checks whether any log needs to be flushed to disk */
098   val flushSchedulerThreadRate = Utils.getInt(props, "log.default.flush.scheduler.interval.ms",  3000)
099  
100   /* the maximum time in ms that a message in any topic is kept in memory before flushed to disk */
101   val defaultFlushIntervalMs = Utils.getInt(props, "log.default.flush.interval.ms", flushSchedulerThreadRate)
102  
103    /* the number of partitions for selected topics, e.g., topic1:8,topic2:16 */
104   val topicPartitionsMap = Utils.getTopicPartitions(Utils.getString(props, "topic.partition.count.map", ""))
105  
106   /* the maximum length of topic name*/
107   val maxTopicNameLength = Utils.getIntInRange(props, "max.topic.name.length", 255, (1, Int.MaxValue))
108 }

上面这段代码来自kafka.server包下的KafkaConfig类,之前我们就说过,broker就是kafka中的server,所以讲配置放在这个包中也不奇怪。这里我们顺着代码往下读,也顺便看看scala的语法。和java一样也要import相关的包,kafka将同一包内的两个类写在大括号中:

1 import kafka.utils.{Utils, ZKConfig}

然后我们看类的写法:

1 class KafkaConfig(props: Properties) extends ZKConfig(props)

我们看到在加载kafkaConfig的时候会加载一个properties对象,同时也会加载有关zookeeperproperties,这个时候我们可以回忆一下,之前我们启动kafka broker的命令:

1.  启动zookeeper server bin/zookeeper-server-start.sh ../config/zookeeper.properties  & (&是为了能退出命令行)

2.  启动kafka server:  bin/kafka-server-start.sh ../config/server.properties  &

所以你能明白,初始化kafka broker的时候程序一定是去加载位于config文件夹下的properties,这个和java都一样没有区别。当然properties我们也可以通过程序来给出,这个我们后面再说,继续看我们的代码。既然找到了对应的properties文件,我们就结合代码和properties一起来看。

Kafka brokerproperties中,将配置分为以下六类:

l  Server Basics:关于brokeridhostname等配置

l  Socket Server Settings:关于传输的配置,端口、buffer的区间等。

l  Log Basics:配置log的位置和partition的数量。

l  Log Flush Policy:这部分是kafka配置中最重要的部分,决定了数据flushdisk的策略。

l  Log Retention Policy:这部分主要配置日志处理时的策略。

l  Zookeeper:配置zookeeper的相关信息。

在文件properties中的配置均出现在kafkaConfig这个类中,我们再看看kafkaConfig中的代码:

1 /* the broker id for this server */
2   val brokerId: Int = Utils.getInt(props, "brokerid")
3    
4   /* the SO_SNDBUFF buffer of the socket sever sockets */
5   val socketSendBuffer: Int = Utils.getInt(props, "socket.send.buffer", 100*1024)

凡是参数中有三个的,最后一个是default,而参数只有两个的则要求你一定要配置,否则的话则报错。当然在这么多参数中肯定是有一些经验参数的,至于这些参数怎么配置我确实没有一个特别的推荐,需要在不断的测试中才能磨合出来。

当然你也可以将配置写在程序里,然后通过程序去启动broker,这样kafka的配置就可以像下面一样写:

1 Properties props = new Properties();
2 props.setProperty("port","9093");
3 props.setProperty("log.dir","/home/kafka/data1");

我倒是觉得配置还是直接写在配置文件中比较好,如果需要修改也不会影响正在运行的服务,写在内存中,总是会有些不方便的地方。所以还是建议大家都写配置好了,后面讲到的producerconsumer都一样。

这里再提两个参数一个是brokerid,每个broker的id必须要区分;第二个参数是hostname,这个是broker和producer、consumer联系的关键,这里记住一定要改成你的地址和端口,否则永远连得都是localhost。

--------------------------------------------------------

下一篇将写producer和consumer的配置了,涉及到这部分就要开始编程了,写着写着又往源码里看进去了,下篇会先讲如何搭建开发环境,然后再写两个简单那的例子去熟悉配置。


分享到:0
关注微信,跟着我们扩展技术视野。每天推送IT新技术文章,每周聚焦一门新技术。微信二维码如下:
微信公众账号:尚学堂(微信号:bjsxt-java)
声明:博客文章版权属于原创作者,受法律保护。如果侵犯了您的权利,请联系管理员,我们将及时删除!
(邮箱:webmaster#sxt.cn(#换为@))
北京总部地址:北京市海淀区西三旗桥东建材城西路85号神州科技园B座三层尚学堂 咨询电话:400-009-1906 010-56233821
Copyright 2007-2015 北京尚学堂科技有限公司 京ICP备13018289号-1 京公网安备11010802015183