轉載： kafka 配置文件詳細說明

轉載地址： https://blog.csdn.net/wackycrazy/article/details/47810741

 

 

kafka的配置分爲 broker、producter、consumer三個不一樣的配置

一 BROKER 的全局配置

最爲核心的三個配置 broker.id、log.dir、zookeeper.connect 。

 

 

------------------------------------------- 系統 相關 -------------------------------------------

##每個broker在集羣中的惟一標示，要求是正數。在改變IP地址，不改變broker.id的話不會影響consumers

broker.id = 1

 

##kafka數據的存放地址，多個地址的話用逗號分割 /tmp/kafka-logs- 1 ，/tmp/kafka-logs- 2

log.dirs = /tmp/kafka-logs

 

##提供給客戶端響應的端口

port = 6667

 

##消息體的最大大小，單位是字節

message.max.bytes = 1000000

 

## broker 處理消息的最大線程數，通常狀況下不須要去修改

num.network.threads = 3

 

## broker處理磁盤IO 的線程數 ，數值應該大於你的硬盤數

num.io.threads = 8

 

## 一些後臺任務處理的線程數，例如過時消息文件的刪除等，通常狀況下不須要去作修改

background.threads = 4

 

## 等待IO線程處理的請求隊列最大數，如果等待IO的請求超過這個數值，那麼會中止接受外部消息，算是一種自我保護機制

queued.max.requests = 500

 

##broker的主機地址，如果設置了，那麼會綁定到這個地址上，如果沒有，會綁定到全部的接口上，並將其中之一發送到ZK，通常不設置

host.name

 

## 打廣告的地址，如果設置的話，會提供給producers, consumers,其餘broker鏈接，具體如何使用還未深究

advertised.host.name

 

## 廣告地址端口，必須不一樣於port中的設置

advertised.port

 

## socket的發送緩衝區，socket的調優參數SO_SNDBUFF

socket.send.buffer.bytes = 100 * 1024

 

## socket的接受緩衝區，socket的調優參數SO_RCVBUFF

socket.receive.buffer.bytes = 100 * 1024

 

## socket請求的最大數值，防止serverOOM，message.max.bytes必然要小於socket.request.max.bytes，會被topic建立時的指定參數覆蓋

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

 

------------------------------------------- LOG 相關 -------------------------------------------

## topic的分區是以一堆segment文件存儲的，這個控制每一個segment的大小，會被topic建立時的指定參數覆蓋

log.segment.bytes = 1024 * 1024 * 1024

 

## 這個參數會在日誌segment沒有達到log.segment.bytes設置的大小，也會強制新建一個segment 會被 topic建立時的指定參數覆蓋

log.roll.hours = 24 * 7

 

## 日誌清理策略 選擇有：delete和compact 主要針對過時數據的處理，或是日誌文件達到限制的額度，會被 topic建立時的指定參數覆蓋

log.cleanup.policy = delete

 

## 數據存儲的最大時間 超過這個時間 會根據log.cleanup.policy設置的策略處理數據，也就是消費端可以多久去消費數據

## log.retention.bytes和log.retention.minutes任意一個達到要求，都會執行刪除，會被topic建立時的指定參數覆蓋

log.retention.minutes= 7 days

指定日誌每隔多久檢查看是否能夠被刪除，默認1分鐘


log.cleanup.interval.mins=1

 

 

## topic每一個分區的最大文件大小，一個topic的大小限制 = 分區數*log.retention.bytes 。- 1 沒有大小限制

## log.retention.bytes和log.retention.minutes任意一個達到要求，都會執行刪除，會被topic建立時的指定參數覆蓋

log.retention.bytes=- 1

 

## 文件大小檢查的週期時間，是否處罰 log.cleanup.policy中設置的策略

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

 

## 是否開啓日誌壓縮

log.cleaner.enable= false

 

## 日誌壓縮運行的線程數

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表的擴大因子 通常不須要修改

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

 

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

log.cleaner.backoff.ms = 15000

 

## 日誌清理的頻率控制，越大意味着更高效的清理，同時會存在一些空間上的浪費，會被topic建立時的指定參數覆蓋

log.cleaner.min.cleanable.ratio= 0.5

 

## 對於壓縮的日誌保留的最長時間，也是客戶端消費消息的最長時間，同log.retention.minutes的區別在於一個控制未壓縮數據，一個控制壓縮後的數據。會被topic建立時的指定參數覆蓋

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

 

## 對於segment日誌的索引文件大小限制，會被topic建立時的指定參數覆蓋

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

 

## 當執行一個fetch操做後，須要必定的空間來掃描最近的offset大小，設置越大，表明掃描速度越快，可是也更好內存，通常狀況下不須要搭理這個參數

log.index.interval.bytes = 4096

 

## log文件 "sync" 到磁盤以前累積的消息條數

## 由於磁盤IO操做是一個慢操做,但又是一個 "數據可靠性" 的必要手段

## 因此此參數的設置,須要在 "數據可靠性" 與 "性能" 之間作必要的權衡.

## 若是此值過大,將會致使每次 "fsync" 的時間較長(IO阻塞)

## 若是此值太小,將會致使 "fsync" 的次數較多,這也意味着總體的client請求有必定的延遲.

## 物理server故障,將會致使沒有fsync的消息丟失.

log.flush.interval.messages=None

 

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

log.flush.scheduler.interval.ms = 3000

 

## 僅僅經過interval來控制消息的磁盤寫入時機,是不足的.

## 此參數用於控制 "fsync" 的時間間隔,若是消息量始終沒有達到閥值,可是離上一次磁盤同步的時間間隔

## 達到閥值,也將觸發.

log.flush.interval.ms = None

 

## 文件在索引中清除後保留的時間 通常不須要去修改

log.delete.delay.ms = 60000

 

## 控制上次固化硬盤的時間點，以便於數據恢復 通常不須要去修改

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

 

------------------------------------------- TOPIC 相關 -------------------------------------------

## 是否容許自動建立topic ，如果 false ，就須要經過命令建立topic

auto.create.topics.enable = true

 

## 一個topic ，默認分區的replication個數 ，不得大於集羣中broker的個數

default .replication.factor = 1

 

## 每一個topic的分區個數，如果在topic建立時候沒有指定的話 會被topic建立時的指定參數覆蓋

num.partitions = 1

 

實例 --replication-factor 3 --partitions 1 --topic replicated-topic ：名稱replicated-topic有一個分區，分區被複制到三個broker上。

 

----------------------------------複製(Leader、replicas) 相關 ----------------------------------

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

controller.socket.timeout.ms = 30000

 

## partition leader與replicas數據同步時,消息的隊列尺寸

controller.message.queue.size= 10

 

## replicas響應partition leader的最長等待時間，如果超過這個時間，就將replicas列入ISR(in-sync replicas)，並認爲它是死的，不會再加入管理中

replica.lag.time.max.ms = 10000

 

## 若是follower落後與leader太多,將會認爲此follower[或者說partition relicas]已經失效

## 一般,在follower與leader通信時,由於網絡延遲或者連接斷開,總會致使replicas中消息同步滯後

## 若是消息以後太多,leader將認爲此follower網絡延遲較大或者消息吞吐能力有限,將會把此replicas遷移

## 到其餘follower中.

## 在broker數量較少,或者網絡不足的環境中,建議提升此值.

replica.lag.max.messages = 4000

 

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

replica.socket.timeout.ms= 30 * 1000

 

## leader複製時候的socket緩存大小

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

 

## replicas每次獲取數據的最大大小

replica.fetch.max.bytes = 1024 * 1024

 

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

replica.fetch.wait.max.ms = 500

 

## fetch的最小數據尺寸,若是leader中還沒有同步的數據不足此值,將會阻塞,直到知足條件

replica.fetch.min.bytes = 1

 

## leader 進行復制的線程數，增大這個數值會增長follower的IO

num.replica.fetchers= 1

 

## 每一個replica檢查是否將最高水位進行固化的頻率

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

 

## 是否容許控制器關閉broker ,如果設置爲 true ,會關閉全部在這個broker上的leader，並轉移到其餘broker

controlled.shutdown.enable = false

 

## 控制器關閉的嘗試次數

controlled.shutdown.max.retries = 3

 

## 每次關閉嘗試的時間間隔

controlled.shutdown.retry.backoff.ms = 5000

 

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

auto.leader.rebalance.enable = false

 

## leader的不平衡比例，如果超過這個數值，會對分區進行從新的平衡

leader.imbalance.per.broker.percentage = 10

 

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

leader.imbalance.check.interval.seconds = 300

 

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

offset.metadata.max.bytes

 

----------------------------------ZooKeeper 相關----------------------------------

##zookeeper集羣的地址，能夠是多個，多個之間用逗號分割 hostname1:port1,hostname2:port2,hostname3:port3

zookeeper.connect = localhost: 2181

 

## ZooKeeper的最大超時時間，就是心跳的間隔，如果沒有反映，那麼認爲已經死了，不易過大

zookeeper.session.timeout.ms= 6000

 

## ZooKeeper的鏈接超時時間

zookeeper.connection.timeout.ms = 6000

 

## ZooKeeper集羣中leader和follower之間的同步實際那

zookeeper.sync.time.ms = 2000

配置的修改

其中一部分配置是能夠被每一個topic自身的配置所代替，例如

新增配置

bin/kafka-topics.sh --zookeeper localhost: 2181 --create --topic my-topic --partitions 1 --replication-factor 1 --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是根據group.id來判斷是隊列模式仍是發佈訂閱模式，很是重要

  group.id

 

## 消費者的ID，如果沒有設置的話，會自增

  consumer.id

 

## 一個用於跟蹤調查的ID ，最好同group.id相同

  client.id = group id value

 

## 對於zookeeper集羣的指定，能夠是多個 hostname1:port1,hostname2:port2,hostname3:port3 必須和broker使用一樣的zk配置

  zookeeper.connect=localhost: 2182

 

## zookeeper的心跳超時時間，查過這個時間就認爲是dead消費者

  zookeeper.session.timeout.ms = 6000

 

## zookeeper的等待鏈接時間

  zookeeper.connection.timeout.ms = 6000

 

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

  zookeeper.sync.time.ms = 2000

 

## 當zookeeper中沒有初始的offset時候的處理方式 。smallest ：重置爲最小值 largest:重置爲最大值 anything else ：拋出異常

  auto.offset.reset = largest

 

## socket的超時時間，實際的超時時間是：max.fetch.wait + socket.timeout.ms.

  socket.timeout.ms= 30 * 1000

 

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

  socket.receive.buffer.bytes= 64 * 1024

 

##從每一個分區獲取的消息大小限制

  fetch.message.max.bytes = 1024 * 1024

 

## 是否在消費消息後將offset同步到zookeeper，當Consumer失敗後就能從zookeeper獲取最新的offset

  auto.commit.enable = true

 

## 自動提交的時間間隔

  auto.commit.interval.ms = 60 * 1000

 

## 用來處理消費消息的塊，每一個塊能夠等同於fetch.message.max.bytes中數值

  queued.max.message.chunks = 10

 

## 當有新的consumer加入到group時,將會reblance,此後將會有partitions的消費端遷移到新

## 的consumer上,若是一個consumer得到了某個partition的消費權限,那麼它將會向zk註冊

## "Partition Owner registry" 節點信息,可是有可能此時舊的consumer尚沒有釋放此節點,

## 此值用於控制,註冊節點的重試次數.

  rebalance.max.retries = 4

 

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

  rebalance.backoff.ms = 2000

 

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

  refresh.leader.backoff.ms

 

## server發送到消費端的最小數據，如果不知足這個數值則會等待，知道知足數值要求

  fetch.min.bytes = 1

 

## 如果不知足最小大小(fetch.min.bytes)的話，等待消費端請求的最長等待時間

  fetch.wait.max.ms = 100

 

## 指定時間內沒有消息到達就拋出異常，通常不須要改

  consumer.timeout.ms = - 1

 

三 PRODUCER 的配置

 

比較核心的配置：metadata.broker.list、request.required.acks、producer.type、serializer.class

## 消費者獲取消息元信息(topics, partitions and replicas)的地址,配置格式是：host1:port1,host2:port2，也能夠在外面設置一個vip

  metadata.broker.list

 

##消息的確認模式

  ## 0 ：不保證消息的到達確認，只管發送，低延遲可是會出現消息的丟失，在某個server失敗的狀況下，有點像TCP

  ## 1 ：發送消息，並會等待leader 收到確認後，必定的可靠性

  ## - 1 ：發送消息，等待leader收到確認，並進行復制操做後，才返回，最高的可靠性

  request.required.acks = 0

 

## 消息發送的最長等待時間

  request.timeout.ms = 10000

 

## socket的緩存大小

  send.buffer.bytes= 100 * 1024

 

## key的序列化方式，如果沒有設置，同serializer. class

  key.serializer. class

 

## 分區的策略，默認是取模

  partitioner. class =kafka.producer.DefaultPartitioner

 

## 消息的壓縮模式，默認是none，能夠有gzip和snappy

  compression.codec = none

 

## 能夠針對默寫特定的topic進行壓縮

  compressed.topics= null

 

## 消息發送失敗後的重試次數

  message.send.max.retries = 3

 

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

  retry.backoff.ms = 100

 

## 生產者定時更新topic元信息的時間間隔 ，如果設置爲 0 ，那麼會在每一個消息發送後都去更新數據

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

 

## 用戶隨意指定，可是不能重複，主要用於跟蹤記錄消息

  client.id= ""

 

------------------------------------------- 消息模式 相關 -------------------------------------------

  ## 生產者的類型 async:異步執行消息的發送 sync：同步執行消息的發送

  producer.type=sync

 

## 異步模式下，那麼就會在設置的時間緩存消息，並一次性發送

  queue.buffering.max.ms = 5000

 

## 異步的模式下 最長等待的消息數

  queue.buffering.max.messages = 10000

 

## 異步模式下，進入隊列的等待時間 如果設置爲 0 ，那麼要麼進入隊列，要麼直接拋棄

  queue.enqueue.timeout.ms = - 1

 

## 異步模式下，每次發送的最大消息數，前提是觸發了queue.buffering.max.messages或是queue.buffering.max.ms的限制

  batch.num.messages= 200

 

## 消息體的系列化處理類 ，轉化爲字節流進行傳輸

  serializer. class = kafka.serializer.DefaultEncoder