## 必配置屬性
每個kafka broker中配置文件server.properties默認必須配置的屬性如下：
```
broker.id=0
num.network.threads=2
num.io.threads=8
socket.send.buffer.bytes=1048576
socket.receive.buffer.bytes=1048576
socket.request.max.bytes=104857600
log.dirs=/tmp/kafka-logs
num.partitions=2
log.retention.hours=168
log.segment.bytes=536870912
log.retention.check.interval.ms=60000
log.cleaner.enable=false
zookeeper.connect=localhost:2181
zookeeper.connection.timeout.ms=1000000
```
## 參數說明
|參數|說明|
|----|----|
|broker.id =0|每一個broker在集群中的唯一表示，要求是正數。當該服務器的IP地址發生改變時，broker.id沒有變化，則不會影響consumers的消息情況|
|log.dirs=/data/kafka-logs|kafka數據的存放地址，多個地址的話用逗號分割,多個目錄分布在不同磁盤上可以提高讀寫性能 /data/kafka-logs-1，/data/kafka-logs-2|
|port =9092|broker server服務端口|
|message.max.bytes =6525000|表示消息體的最大大小，單位是字節|
|num.network.threads =4|broker處理消息的最大線程數，一般情況下數量為cpu核數|
|num.io.threads =8|broker處理磁盤IO的線程數，數值為cpu核數2倍|
|background.threads =4|一些后臺任務處理的線程數，例如過期消息文件的刪除等，一般情況下不需要去做修改|
|queued.max.requests =500|等待IO線程處理的請求隊列最大數，若是等待IO的請求超過這個數值，那么會停止接受外部消息，應該是一種自我保護機制。|
|host.name|broker的主機地址，若是設置了，那么會綁定到這個地址上，若是沒有，會綁定到所有的接口上，并將其中之一發送到ZK，一般不設置|
|socket.send.buffer.bytes=100*1024|socket的發送緩沖區，socket的調優參數SO_SNDBUFF|
|socket.receive.buffer.bytes =100*1024|socket的接受緩沖區，socket的調優參數SO_RCVBUFF|
|socket.request.max.bytes =100*1024*1024|socket請求的最大數值，防止serverOOM，message.max.bytes必然要小于socket.request.max.bytes，會被topic創建時的指定參數覆蓋|
|log.segment.bytes =1024*1024*1024|topic的分區是以一堆segment文件存儲的，這個控制每個segment的大小，會被topic創建時的指定參數覆蓋|
|log.roll.hours =24*7|這個參數會在日志segment沒有達到log.segment.bytes設置的大小，也會強制新建一個segment會被 topic創建時的指定參數覆蓋|
|log.cleanup.policy = delete|日志清理策略選擇有：delete和compact主要針對過期數據的處理，或是日志文件達到限制的額度，會被 topic創建時的指定參數覆蓋|
|log.retention.minutes=300 或 log.retention.hours=24|數據文件保留多長時間， 存儲的最大時間超過這個時間會根據log.cleanup.policy設置數據清除策略log.retention.bytes和log.retention.minutes或log.retention.hours任意一個達到要求，都會執行刪除有2刪除數據文件方式：按照文件大小刪除：log.retention.bytes，按照2中不同時間粒度刪除：分別為分鐘，小時|
|log.retention.bytes=-1|topic每個分區的最大文件大小，一個topic的大小限制 = 分區數*log.retention.bytes。-1沒有大小限log.retention.bytes和log.retention.minutes任意一個達到要求，都會執行刪除，會被topic創建時的指定參數覆蓋|
|log.retention.check.interval.ms=5minutes|文件大小檢查的周期時間，是否處罰 log.cleanup.policy中設置的策略|
|log.cleaner.enable=false|是否開啟日志清理|
|log.cleaner.threads = 2|日志清理運行的線程數|
|log.cleaner.io.max.bytes.per.second=None|日志清理時候處理的最大大小|
|log.cleaner.dedupe.buffer.size=500*1024*1024|日志清理去重時候的緩存空間，在空間允許的情況下，越大越好|
|log.cleaner.io.buffer.size=512*1024|日志清理時候用到的IO塊大小一般不需要修改|
|log.cleaner.io.buffer.load.factor =0.9|日志清理中hash表的擴大因子一般不需要修改|
|log.cleaner.backoff.ms =15000|檢查是否處罰日志清理的間隔|
|log.cleaner.min.cleanable.ratio=0.5|日志清理的頻率控制，越大意味著更高效的清理，同時會存在一些空間上的浪費，會被topic創建時的指定參數覆蓋|
|log.cleaner.delete.retention.ms =1day|對于壓縮的日志保留的最長時間，也是客戶端消費消息的最長時間，同log.retention.minutes的區別在于一個控制未壓縮數據，一個控制壓縮后的數據。會被topic創建時的指定參數覆蓋|
|log.index.size.max.bytes =10*1024*1024|對于segment日志的索引文件大小限制，會被topic創建時的指定參數覆蓋|
|log.index.interval.bytes=4096|當執行一個fetch操作后,需要一定的空間來掃描最近的offset大小，設置越大，代表掃描速度越快，但是也更好內存，一般情況下不需要搭理這個參數|
|log.flush.interval.messages=None|例如log.flush.interval.messages=1000表示每當消息記錄數達到1000時flush一次數據到磁盤，log文件”sync”到磁盤之前累積的消息條數,因為磁盤IO操作是一個慢操作,但又是一個”數據可靠性"的必要手段,所以此參數的設置,需要在"數據可靠性"與"性能"之間做必要的權衡.如果此值過大,將會導致每次"fsync"的時間較長(IO阻塞),如果此值過小,將會導致"fsync"的次數較多,這也意味著整體的client請求有一定的延遲.物理server故障,將會導致沒有fsync的消息丟失|
|log.flush.scheduler.interval.ms =3000|檢查是否需要固化到硬盤的時間間隔|
|log.flush.interval.ms = None|例如：log.flush.interval.ms=1000,表示每間隔1000毫秒flush一次數據到磁盤僅僅通過interval來控制消息的磁盤寫入時機,是不足的.此參數用于控制"fsync"的時間間隔,如果消息量始終沒有達到閥值,但是離上一次磁盤同步的時間間隔達到閥值,也將觸發.|
|log.delete.delay.ms =60000|文件在索引中清除后保留的時間一般不需要去修改|
|log.flush.offset.checkpoint.interval.ms =60000|控制上次固化硬盤的時間點，以便于數據恢復一般不需要去修改|
|auto.create.topics.enable =true|是否允許自動創建topic，若是false，就需要通過命令創建topic|
|default.replication.factor =1|是否允許自動創建topic，若是false，就需要通過命令創建topic|
|num.partitions =1|每個topic的分區個數，若是在topic創建時候沒有指定的話會被topic創建時的指定參數覆蓋|
## kafka中Leader,replicas配置參數
|參數|說明|
|-|-|
|controller.socket.timeout.ms =30000|partition leader與replicas之間通訊時,socket的超時時間|
|controller.message.queue.size=10|partition leader與replicas數據同步時,消息的隊列尺寸|
|replica.lag.time.max.ms =10000|replicas響應partition leader的最長等待時間，若是超過這個時間，就將replicas列入ISR(in-sync replicas)，并認為它是死的，不會再加入管理中|
|replica.lag.max.messages =4000|如果follower落后與leader太多,將會認為此follower[或者說partition relicas]已經失效.##通常,在follower與leader通訊時,因為網絡延遲或者鏈接斷開,總會導致replicas中消息同步滯后##如果消息之后太多,leader將認為此follower網絡延遲較大或者消息吞吐能力有限,將會把此replicas遷移到其他follower中.##在broker數量較少,或者網絡不足的環境中,建議提高此值.|
|replica.socket.timeout.ms=30*1000|follower與leader之間的socket超時時間|
|replica.socket.receive.buffer.bytes=64*1024|leader復制時候的socket緩存大小|
|replica.fetch.max.bytes =1024*1024|replicas每次獲取數據的最大大小|
|replica.fetch.wait.max.ms =500|replicas同leader之間通信的最大等待時間，失敗了會重試|
|replica.fetch.min.bytes =1|fetch的最小數據尺寸,如果leader中尚未同步的數據不足此值,將會阻塞,直到滿足條件|
|num.replica.fetchers=1|leader進行復制的線程數，增大這個數值會增加follower的IO|
|replica.high.watermark.checkpoint.interval.ms =5000|每個replica檢查是否將最高水位進行固化的頻率|
|controlled.shutdown.enable =false|是否允許控制器關閉broker ,若是設置為true,會關閉所有在這個broker上的leader，并轉移到其他broker|
|controlled.shutdown.max.retries =3|控制器關閉的嘗試次數|
|controlled.shutdown.retry.backoff.ms =5000|每次關閉嘗試的時間間隔|
|leader.imbalance.per.broker.percentage =10|leader的不平衡比例，若是超過這個數值，會對分區進行重新的平衡|
|leader.imbalance.check.interval.seconds =300|檢查leader是否不平衡的時間間隔|
|offset.metadata.max.bytes|客戶端保留offset信息的最大空間大小|
## kafka中zookeeper參數配置
|參數|說明|
|-|-|
|zookeeper.connect = localhost:2181|zookeeper集群的地址，可以是多個，多個之間用逗號分割hostname1:port1,hostname2:port2,hostname3:port3|
|zookeeper.session.timeout.ms=6000|ZooKeeper的最大超時時間，就是心跳的間隔，若是沒有反映，那么認為已經死了，不易過大|
|zookeeper.connection.timeout.ms =6000|ZooKeeper的連接超時時間|
|zookeeper.sync.time.ms =2000|ZooKeeper集群中leader和follower之間的同步時間|
