kafka 配置文件參數(shù)詳解

kafka的配置分為 broker、producter匹摇、consumer三個不同的配置

一 BROKER 的全局配置

最為核心的三個配置 broker.id瞻润、log.dir、zookeeper.connect 艰躺。


------------------------------------------- 系統(tǒng) 相關(guān) -------------------------------------------

##每一個broker在集群中的唯一標(biāo)示,要求是正數(shù)眨八。在改變IP地址腺兴,不改變broker.id的話不會影響consumers

broker.id =1


##kafka數(shù)據(jù)的存放地址,多個地址的話用逗號分割 /tmp/kafka-logs-1廉侧,/tmp/kafka-logs-2

log.dirs = /tmp/kafka-logs


##提供給客戶端響應(yīng)的端口

port =6667


##消息體的最大大小页响,單位是字節(jié)

message.max.bytes =1000000


## broker 處理消息的最大線程數(shù),一般情況下不需要去修改

num.network.threads =3


## broker處理磁盤IO 的線程數(shù) 段誊,數(shù)值應(yīng)該大于你的硬盤數(shù)

num.io.threads =8


## 一些后臺任務(wù)處理的線程數(shù)闰蚕,例如過期消息文件的刪除等,一般情況下不需要去做修改

background.threads =4


## 等待IO線程處理的請求隊(duì)列最大數(shù)连舍,若是等待IO的請求超過這個數(shù)值没陡,那么會停止接受外部消息,算是一種自我保護(hù)機(jī)制

queued.max.requests =500


##broker的主機(jī)地址,若是設(shè)置了盼玄,那么會綁定到這個地址上染簇,若是沒有,會綁定到所有的接口上强岸,并將其中之一發(fā)送到ZK,一般不設(shè)置

host.name


## 打廣告的地址砾赔,若是設(shè)置的話蝌箍,會提供給producers, consumers,其他broker連接,具體如何使用還未深究

advertised.host.name


## 廣告地址端口暴心,必須不同于port中的設(shè)置

advertised.port


## socket的發(fā)送緩沖區(qū)妓盲,socket的調(diào)優(yōu)參數(shù)SO_SNDBUFF

socket.send.buffer.bytes =100*1024


## socket的接受緩沖區(qū),socket的調(diào)優(yōu)參數(shù)SO_RCVBUFF

socket.receive.buffer.bytes =100*1024


## socket請求的最大數(shù)值专普,防止serverOOM悯衬,message.max.bytes必然要小于socket.request.max.bytes,會被topic創(chuàng)建時的指定參數(shù)覆蓋

socket.request.max.bytes =100*1024*1024


------------------------------------------- LOG 相關(guān) -------------------------------------------

## topic的分區(qū)是以一堆segment文件存儲的檀夹,這個控制每個segment的大小筋粗,會被topic創(chuàng)建時的指定參數(shù)覆蓋

log.segment.bytes =1024*1024*1024


## 這個參數(shù)會在日志segment沒有達(dá)到log.segment.bytes設(shè)置的大小,也會強(qiáng)制新建一個segment 會被 topic創(chuàng)建時的指定參數(shù)覆蓋

log.roll.hours =24*7


## 日志清理策略 選擇有:delete和compact 主要針對過期數(shù)據(jù)的處理炸渡,或是日志文件達(dá)到限制的額度娜亿,會被 topic創(chuàng)建時的指定參數(shù)覆蓋

log.cleanup.policy = delete


## 數(shù)據(jù)存儲的最大時間 超過這個時間 會根據(jù)log.cleanup.policy設(shè)置的策略處理數(shù)據(jù),也就是消費(fèi)端能夠多久去消費(fèi)數(shù)據(jù)

## log.retention.bytes和log.retention.minutes任意一個達(dá)到要求蚌堵,都會執(zhí)行刪除买决,會被topic創(chuàng)建時的指定參數(shù)覆蓋

log.retention.minutes=7days

指定日志每隔多久檢查看是否可以被刪除,默認(rèn)1分鐘

log.cleanup.interval.mins=1



## topic每個分區(qū)的最大文件大小吼畏,一個topic的大小限制 = 分區(qū)數(shù)*log.retention.bytes 督赤。-1沒有大小限制

## log.retention.bytes和log.retention.minutes任意一個達(dá)到要求,都會執(zhí)行刪除泻蚊,會被topic創(chuàng)建時的指定參數(shù)覆蓋

log.retention.bytes=-1


## 文件大小檢查的周期時間躲舌,是否處罰 log.cleanup.policy中設(shè)置的策略

log.retention.check.interval.ms=5minutes


## 是否開啟日志壓縮

log.cleaner.enable=false


## 日志壓縮運(yùn)行的線程數(shù)

log.cleaner.threads =1


## 日志壓縮時候處理的最大大小

log.cleaner.io.max.bytes.per.second=None


## 日志壓縮去重時候的緩存空間 ,在空間允許的情況下性雄,越大越好

log.cleaner.dedupe.buffer.size=500*1024*1024


## 日志清理時候用到的IO塊大小 一般不需要修改

log.cleaner.io.buffer.size=512*1024


## 日志清理中hash表的擴(kuò)大因子 一般不需要修改

log.cleaner.io.buffer.load.factor =0.9


## 檢查是否處罰日志清理的間隔

log.cleaner.backoff.ms =15000


## 日志清理的頻率控制孽糖,越大意味著更高效的清理,同時會存在一些空間上的浪費(fèi)毅贮,會被topic創(chuàng)建時的指定參數(shù)覆蓋

log.cleaner.min.cleanable.ratio=0.5


## 對于壓縮的日志保留的最長時間办悟,也是客戶端消費(fèi)消息的最長時間,同log.retention.minutes的區(qū)別在于一個控制未壓縮數(shù)據(jù)滩褥,一個控制壓縮后的數(shù)據(jù)病蛉。會被topic創(chuàng)建時的指定參數(shù)覆蓋

log.cleaner.delete.retention.ms =1day


## 對于segment日志的索引文件大小限制,會被topic創(chuàng)建時的指定參數(shù)覆蓋

log.index.size.max.bytes =10*1024*1024


## 當(dāng)執(zhí)行一個fetch操作后,需要一定的空間來掃描最近的offset大小铺然,設(shè)置越大俗孝,代表掃描速度越快,但是也更好內(nèi)存魄健,一般情況下不需要搭理這個參數(shù)

log.index.interval.bytes =4096


## log文件"sync"到磁盤之前累積的消息條數(shù)

## 因?yàn)榇疟PIO操作是一個慢操作,但又是一個"數(shù)據(jù)可靠性"的必要手段

## 所以此參數(shù)的設(shè)置,需要在"數(shù)據(jù)可靠性"與"性能"之間做必要的權(quán)衡.

## 如果此值過大,將會導(dǎo)致每次"fsync"的時間較長(IO阻塞)

## 如果此值過小,將會導(dǎo)致"fsync"的次數(shù)較多,這也意味著整體的client請求有一定的延遲.

## 物理server故障,將會導(dǎo)致沒有fsync的消息丟失.

log.flush.interval.messages=None


## 檢查是否需要固化到硬盤的時間間隔

log.flush.scheduler.interval.ms =3000


## 僅僅通過interval來控制消息的磁盤寫入時機(jī),是不足的.

## 此參數(shù)用于控制"fsync"的時間間隔,如果消息量始終沒有達(dá)到閥值,但是離上一次磁盤同步的時間間隔

## 達(dá)到閥值,也將觸發(fā).

log.flush.interval.ms = None


## 文件在索引中清除后保留的時間 一般不需要去修改

log.delete.delay.ms =60000


## 控制上次固化硬盤的時間點(diǎn)赋铝,以便于數(shù)據(jù)恢復(fù) 一般不需要去修改

log.flush.offset.checkpoint.interval.ms =60000


------------------------------------------- TOPIC 相關(guān) -------------------------------------------

## 是否允許自動創(chuàng)建topic ,若是false沽瘦,就需要通過命令創(chuàng)建topic

auto.create.topics.enable =true


## 一個topic 革骨,默認(rèn)分區(qū)的replication個數(shù) ,不得大于集群中broker的個數(shù)

default.replication.factor =1


## 每個topic的分區(qū)個數(shù)析恋,若是在topic創(chuàng)建時候沒有指定的話 會被topic創(chuàng)建時的指定參數(shù)覆蓋

num.partitions =1


實(shí)例 --replication-factor3--partitions1--topic replicated-topic :名稱replicated-topic有一個分區(qū)良哲,分區(qū)被復(fù)制到三個broker上。


----------------------------------復(fù)制(Leader助隧、replicas) 相關(guān) ----------------------------------

## partition?leader與replicas之間通訊時,socket的超時時間

controller.socket.timeout.ms =30000


## partition?leader與replicas數(shù)據(jù)同步時,消息的隊(duì)列尺寸

controller.message.queue.size=10


## replicas響應(yīng)partition?leader的最長等待時間筑凫,若是超過這個時間,就將replicas列入ISR(in-sync replicas)并村,并認(rèn)為它是死的巍实,不會再加入管理中

replica.lag.time.max.ms =10000


## 如果follower落后與leader太多,將會認(rèn)為此follower[或者說partition?relicas]已經(jīng)失效

## 通常,在follower與leader通訊時,因?yàn)榫W(wǎng)絡(luò)延遲或者鏈接斷開,總會導(dǎo)致replicas中消息同步滯后

## 如果消息之后太多,leader將認(rèn)為此follower網(wǎng)絡(luò)延遲較大或者消息吞吐能力有限,將會把此replicas遷移

## 到其他follower中.

## 在broker數(shù)量較少,或者網(wǎng)絡(luò)不足的環(huán)境中,建議提高此值.

replica.lag.max.messages =4000


##follower與leader之間的socket超時時間

replica.socket.timeout.ms=30*1000


## leader復(fù)制時候的socket緩存大小

replica.socket.receive.buffer.bytes=64*1024


## replicas每次獲取數(shù)據(jù)的最大大小

replica.fetch.max.bytes =1024*1024


## replicas同leader之間通信的最大等待時間,失敗了會重試

replica.fetch.wait.max.ms =500


## fetch的最小數(shù)據(jù)尺寸,如果leader中尚未同步的數(shù)據(jù)不足此值,將會阻塞,直到滿足條件

replica.fetch.min.bytes =1


## leader 進(jìn)行復(fù)制的線程數(shù)哩牍,增大這個數(shù)值會增加follower的IO

num.replica.fetchers=1


## 每個replica檢查是否將最高水位進(jìn)行固化的頻率

replica.high.watermark.checkpoint.interval.ms =5000


## 是否允許控制器關(guān)閉broker ,若是設(shè)置為true,會關(guān)閉所有在這個broker上的leader蔫浆,并轉(zhuǎn)移到其他broker

controlled.shutdown.enable =false


## 控制器關(guān)閉的嘗試次數(shù)

controlled.shutdown.max.retries =3


## 每次關(guān)閉嘗試的時間間隔

controlled.shutdown.retry.backoff.ms =5000


## 是否自動平衡broker之間的分配策略

auto.leader.rebalance.enable =false


## leader的不平衡比例,若是超過這個數(shù)值姐叁,會對分區(qū)進(jìn)行重新的平衡

leader.imbalance.per.broker.percentage =10


## 檢查leader是否不平衡的時間間隔

leader.imbalance.check.interval.seconds =300


## 客戶端保留offset信息的最大空間大小

offset.metadata.max.bytes


----------------------------------ZooKeeper 相關(guān)----------------------------------

##zookeeper集群的地址瓦盛,可以是多個,多個之間用逗號分割 hostname1:port1,hostname2:port2,hostname3:port3

zookeeper.connect = localhost:2181


## ZooKeeper的最大超時時間外潜,就是心跳的間隔原环,若是沒有反映,那么認(rèn)為已經(jīng)死了处窥,不易過大

zookeeper.session.timeout.ms=6000


## ZooKeeper的連接超時時間

zookeeper.connection.timeout.ms =6000


## ZooKeeper集群中l(wèi)eader和follower之間的同步實(shí)際那

zookeeper.sync.time.ms =2000

配置的修改

其中一部分配置是可以被每個topic自身的配置所代替嘱吗,例如

新增配置

bin/kafka-topics.sh --zookeeper localhost:2181--create --topic my-topic --partitions1--replication-factor1--config max.message.bytes=64000--config flush.messages=1


修改配置

bin/kafka-topics.sh --zookeeper localhost:2181--alter --topic my-topic --config max.message.bytes=128000


刪除配置 :

bin/kafka-topics.sh --zookeeper localhost:2181--alter --topic my-topic --deleteConfig max.message.bytes

二 CONSUMER 配置

最為核心的配置是group.id、zookeeper.connect

## Consumer歸屬的組ID滔驾,broker是根據(jù)group.id來判斷是隊(duì)列模式還是發(fā)布訂閱模式谒麦,非常重要

?group.id


## 消費(fèi)者的ID,若是沒有設(shè)置的話哆致,會自增

?consumer.id


## 一個用于跟蹤調(diào)查的ID 绕德,最好同group.id相同

?client.id = group id value


## 對于zookeeper集群的指定,可以是多個 hostname1:port1,hostname2:port2,hostname3:port3 必須和broker使用同樣的zk配置

?zookeeper.connect=localhost:2182


## zookeeper的心跳超時時間摊阀,查過這個時間就認(rèn)為是dead消費(fèi)者

?zookeeper.session.timeout.ms =6000


## zookeeper的等待連接時間

?zookeeper.connection.timeout.ms =6000


## zookeeper的follower同leader的同步時間

?zookeeper.sync.time.ms =2000


## 當(dāng)zookeeper中沒有初始的offset時候的處理方式 耻蛇。smallest :重置為最小值 largest:重置為最大值 anythingelse:拋出異常

?auto.offset.reset = largest


## socket的超時時間踪蹬,實(shí)際的超時時間是:max.fetch.wait + socket.timeout.ms.

?socket.timeout.ms=30*1000


## socket的接受緩存空間大小

?socket.receive.buffer.bytes=64*1024


##從每個分區(qū)獲取的消息大小限制

?fetch.message.max.bytes =1024*1024


## 是否在消費(fèi)消息后將offset同步到zookeeper,當(dāng)Consumer失敗后就能從zookeeper獲取最新的offset

?auto.commit.enable =true


## 自動提交的時間間隔

?auto.commit.interval.ms =60*1000


## 用來處理消費(fèi)消息的塊臣咖,每個塊可以等同于fetch.message.max.bytes中數(shù)值

?queued.max.message.chunks =10


## 當(dāng)有新的consumer加入到group時,將會reblance,此后將會有partitions的消費(fèi)端遷移到新

## 的consumer上,如果一個consumer獲得了某個partition的消費(fèi)權(quán)限,那么它將會向zk注冊

##"Partition?Owner?registry"節(jié)點(diǎn)信息,但是有可能此時舊的consumer尚沒有釋放此節(jié)點(diǎn),

## 此值用于控制,注冊節(jié)點(diǎn)的重試次數(shù).

?rebalance.max.retries =4


## 每次再平衡的時間間隔

?rebalance.backoff.ms =2000


## 每次重新選舉leader的時間

?refresh.leader.backoff.ms


## server發(fā)送到消費(fèi)端的最小數(shù)據(jù)跃捣,若是不滿足這個數(shù)值則會等待,知道滿足數(shù)值要求

?fetch.min.bytes =1


## 若是不滿足最小大小(fetch.min.bytes)的話夺蛇,等待消費(fèi)端請求的最長等待時間

?fetch.wait.max.ms =100


## 指定時間內(nèi)沒有消息到達(dá)就拋出異常疚漆,一般不需要改

?consumer.timeout.ms = -1


三 PRODUCER 的配置

比較核心的配置:metadata.broker.list、request.required.acks刁赦、producer.type娶聘、serializer.class

## 消費(fèi)者獲取消息元信息(topics, partitions and replicas)的地址,配置格式是:host1:port1,host2:port2,也可以在外面設(shè)置一個vip

?metadata.broker.list


##消息的確認(rèn)模式

?##0:不保證消息的到達(dá)確認(rèn)截型,只管發(fā)送,低延遲但是會出現(xiàn)消息的丟失儒溉,在某個server失敗的情況下宦焦,有點(diǎn)像TCP

?##1:發(fā)送消息,并會等待leader 收到確認(rèn)后顿涣,一定的可靠性

?## -1:發(fā)送消息波闹,等待leader收到確認(rèn),并進(jìn)行復(fù)制操作后涛碑,才返回精堕,最高的可靠性

?request.required.acks =0


## 消息發(fā)送的最長等待時間

?request.timeout.ms =10000


## socket的緩存大小

?send.buffer.bytes=100*1024


## key的序列化方式,若是沒有設(shè)置蒲障,同serializer.class

?key.serializer.class


## 分區(qū)的策略歹篓,默認(rèn)是取模

?partitioner.class=kafka.producer.DefaultPartitioner


## 消息的壓縮模式,默認(rèn)是none揉阎,可以有g(shù)zip和snappy

?compression.codec = none


## 可以針對默寫特定的topic進(jìn)行壓縮

?compressed.topics=null


## 消息發(fā)送失敗后的重試次數(shù)

?message.send.max.retries =3


## 每次失敗后的間隔時間

?retry.backoff.ms =100


## 生產(chǎn)者定時更新topic元信息的時間間隔 庄撮,若是設(shè)置為0,那么會在每個消息發(fā)送后都去更新數(shù)據(jù)

?topic.metadata.refresh.interval.ms =600*1000


## 用戶隨意指定毙籽,但是不能重復(fù)洞斯,主要用于跟蹤記錄消息

?client.id=""


------------------------------------------- 消息模式 相關(guān) -------------------------------------------

?## 生產(chǎn)者的類型 async:異步執(zhí)行消息的發(fā)送 sync:同步執(zhí)行消息的發(fā)送

?producer.type=sync


## 異步模式下,那么就會在設(shè)置的時間緩存消息坑赡,并一次性發(fā)送

?queue.buffering.max.ms =5000


## 異步的模式下 最長等待的消息數(shù)

?queue.buffering.max.messages =10000


## 異步模式下烙如,進(jìn)入隊(duì)列的等待時間 若是設(shè)置為0,那么要么進(jìn)入隊(duì)列毅否,要么直接拋棄

?queue.enqueue.timeout.ms = -1


## 異步模式下亚铁,每次發(fā)送的最大消息數(shù),前提是觸發(fā)了queue.buffering.max.messages或是queue.buffering.max.ms的限制

?batch.num.messages=200


## 消息體的系列化處理類 螟加,轉(zhuǎn)化為字節(jié)流進(jìn)行傳輸

?serializer.class= kafka.serializer.DefaultEncoder

轉(zhuǎn)載:原文地址? https://blog.csdn.net/wackycrazy/article/details/47810741

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末刀闷,一起剝皮案震驚了整個濱河市熊泵,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌甸昏,老刑警劉巖顽分,帶你破解...
    沈念sama閱讀 222,252評論 6 516
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異施蜜,居然都是意外死亡卒蘸,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,886評論 3 399
  • 文/潘曉璐 我一進(jìn)店門翻默,熙熙樓的掌柜王于貴愁眉苦臉地迎上來缸沃,“玉大人,你說我怎么就攤上這事修械≈耗粒” “怎么了?”我有些...
    開封第一講書人閱讀 168,814評論 0 361
  • 文/不壞的土叔 我叫張陵肯污,是天一觀的道長翘单。 經(jīng)常有香客問我,道長蹦渣,這世上最難降的妖魔是什么哄芜? 我笑而不...
    開封第一講書人閱讀 59,869評論 1 299
  • 正文 為了忘掉前任,我火速辦了婚禮柬唯,結(jié)果婚禮上认臊,老公的妹妹穿的比我還像新娘。我一直安慰自己锄奢,他們只是感情好失晴,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,888評論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著拘央,像睡著了一般师坎。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上堪滨,一...
    開封第一講書人閱讀 52,475評論 1 312
  • 那天胯陋,我揣著相機(jī)與錄音,去河邊找鬼袱箱。 笑死遏乔,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的发笔。 我是一名探鬼主播盟萨,決...
    沈念sama閱讀 41,010評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼了讨!你這毒婦竟也來了捻激?” 一聲冷哼從身側(cè)響起制轰,我...
    開封第一講書人閱讀 39,924評論 0 277
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎胞谭,沒想到半個月后垃杖,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,469評論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡丈屹,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,552評論 3 342
  • 正文 我和宋清朗相戀三年调俘,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,680評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖瑟啃,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情骇钦,我是刑警寧澤,帶...
    沈念sama閱讀 36,362評論 5 351
  • 正文 年R本政府宣布竞漾,位于F島的核電站眯搭,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏畴蹭。R本人自食惡果不足惜坦仍,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,037評論 3 335
  • 文/蒙蒙 一鳍烁、第九天 我趴在偏房一處隱蔽的房頂上張望叨襟。 院中可真熱鬧,春花似錦幔荒、人聲如沸糊闽。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,519評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽右犹。三九已至,卻和暖如春姚垃,著一層夾襖步出監(jiān)牢的瞬間念链,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,621評論 1 274
  • 我被黑心中介騙來泰國打工积糯, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留掂墓,地道東北人。 一個月前我還...
    沈念sama閱讀 49,099評論 3 378
  • 正文 我出身青樓看成,卻偏偏與公主長得像君编,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子川慌,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,691評論 2 361

推薦閱讀更多精彩內(nèi)容