[Kafka] Kafka Broker 설정(server.properties) 꼼꼼히 들여다보기

 

 

0. server.properties 원본

...
############################# Server Basics #############################

# The id of the broker. This must be set to a unique integer for each broker.
broker.id=0

############################# Socket Server Settings #############################

# The address the socket server listens on. It will get the value returned from
# java.net.InetAddress.getCanonicalHostName() if not configured.
#   FORMAT:
#     listeners = listener_name://host_name:port
#   EXAMPLE:
#     listeners = PLAINTEXT://your.host.name:9092
#listeners=PLAINTEXT://:9092

# Hostname and port the broker will advertise to producers and consumers. If not set,
# it uses the value for "listeners" if configured.  Otherwise, it will use the value
# returned from java.net.InetAddress.getCanonicalHostName().
#advertised.listeners=PLAINTEXT://your.host.name:9092

# Maps listener names to security protocols, the default is for them to be the same. See the config documentation for more details
#listener.security.protocol.map=PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL

# The number of threads that the server uses for receiving requests from the network and sending responses to the network
num.network.threads=3

# The number of threads that the server uses for processing requests, which may include disk I/O
num.io.threads=8

# The send buffer (SO_SNDBUF) used by the socket server
socket.send.buffer.bytes=102400

# The receive buffer (SO_RCVBUF) used by the socket server
socket.receive.buffer.bytes=102400

# The maximum size of a request that the socket server will accept (protection against OOM)
socket.request.max.bytes=104857600


############################# Log Basics #############################

# A comma separated list of directories under which to store log files
log.dirs=/tmp/kafka-logs

# The default number of log partitions per topic. More partitions allow greater
# parallelism for consumption, but this will also result in more files across
# the brokers.
num.partitions=1

# The number of threads per data directory to be used for log recovery at startup and flushing at shutdown.
# This value is recommended to be increased for installations with data dirs located in RAID array.
num.recovery.threads.per.data.dir=1

############################# Internal Topic Settings  #############################
# The replication factor for the group metadata internal topics "__consumer_offsets" and "__transaction_state"
# For anything other than development testing, a value greater than 1 is recommended to ensure availability such as 3.
offsets.topic.replication.factor=1
transaction.state.log.replication.factor=1
transaction.state.log.min.isr=1

############################# Log Flush Policy #############################

# Messages are immediately written to the filesystem but by default we only fsync() to sync
# the OS cache lazily. The following configurations control the flush of data to disk.
# There are a few important trade-offs here:
#    1. Durability: Unflushed data may be lost if you are not using replication.
#    2. Latency: Very large flush intervals may lead to latency spikes when the flush does occur as there will be a lot of data to flush.
#    3. Throughput: The flush is generally the most expensive operation, and a small flush interval may lead to excessive seeks.
# The settings below allow one to configure the flush policy to flush data after a period of time or
# every N messages (or both). This can be done globally and overridden on a per-topic basis.

# The number of messages to accept before forcing a flush of data to disk
#log.flush.interval.messages=10000

# The maximum amount of time a message can sit in a log before we force a flush
#log.flush.interval.ms=1000

############################# Log Retention Policy #############################

# The following configurations control the disposal of log segments. The policy can
# be set to delete segments after a period of time, or after a given size has accumulated.
# A segment will be deleted whenever *either* of these criteria are met. Deletion always happens
# from the end of the log.

# The minimum age of a log file to be eligible for deletion due to age
log.retention.hours=168

# A size-based retention policy for logs. Segments are pruned from the log unless the remaining
# segments drop below log.retention.bytes. Functions independently of log.retention.hours.
#log.retention.bytes=1073741824

# The maximum size of a log segment file. When this size is reached a new log segment will be created.
log.segment.bytes=1073741824

# The interval at which log segments are checked to see if they can be deleted according
# to the retention policies
log.retention.check.interval.ms=300000

############################# Zookeeper #############################

# Zookeeper connection string (see zookeeper docs for details).
# This is a comma separated host:port pairs, each corresponding to a zk
# server. e.g. "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".
# You can also append an optional chroot string to the urls to specify the
# root directory for all kafka znodes.
zookeeper.connect=localhost:2181

# Timeout in ms for connecting to zookeeper
zookeeper.connection.timeout.ms=18000


############################# Group Coordinator Settings #############################

# The following configuration specifies the time, in milliseconds, that the GroupCoordinator will delay the initial consumer rebalance.
# The rebalance will be further delayed by the value of group.initial.rebalance.delay.ms as new members join the group, up to a maximum of max.poll.interval.ms.
# The default value for this is 3 seconds.
# We override this to 0 here as it makes for a better out-of-the-box experience for development and testing.
# However, in production environments the default value of 3 seconds is more suitable as this will help to avoid unnecessary, and potentially expensive, rebalances during application startup.
group.initial.rebalance.delay.ms=0

1. server.properties 설정 분석

##### Server Basics #####

• broker.id=0
  • 브로커(카프카 서버)의 고유 id 값. 브로커 마다 유니크한 id를 가져야 함

 

##### Socket Server Settings #####

• listeners=PLAINTEXT://:9092
  • 브로커가 참조하는 end point

• advertised.listeners=PLAINTEXT://your.host.name:9092
  • 프로듀서, 컨슈머가 참조하는 end point (브로커의 접속 정보)
  • advertised.listeners 값을 설정하지 않는다면 listeners의 값을 사용하게 된다
  • listeners와 advertised.listeners를 나눈 이유는 내부/외부 트래픽을 나누기 위함
• num.network.threads=3
  • 브로커가 요청을 받거나(receiving), 보내는 데(sending) 사용하는 스레드의 수
• num.io.threads=8
  • 브로커가 요청을 처리하는데 사용하는 스레드의 수

 

##### Log Basics #####

• log.dirs=/tmp/kafka-logs
  • 브로커가 로그를 저장하는 디렉토리 위치
  • 실제 운영할 땐 /tmp/kafka-logs 대신 적당한 위치를 설정한다
• num.partitions=1
  • 토픽의 파티션 개수를 지정하지 않았을 때 사용될 기본 값

 

##### Log Flush Policy #####

• 설정 파일 원문의 설명을 제대로 읽어볼 필요가 있다
• 카프카에 전달된 Message들은 fsync()라는 메서드를 통해 디스크에 저장된다. 하지만 이 작업에 대해 고려해야할 중요한 trade-off가 있다.
  1. Durability : replication을 사용하지 않을 경우 flush 되지 않은 데이터는 유실된다
  2. Latency : flush의 간격(interval)이 너무 길어 누적된 메시지가 많다면 부담을 줄 수 있다
  3. Throughput : 플러시는 일반적으로 가장 비용이 많이 드는 작업이다. 그리고 작은 플러시 간격은 과도한 시크(excessive seeks)로 성능 저하로 이어질 수 있다. *seek: 데이터 저장 장치(예: 디스크)에서 특정 위치로 데이터를 읽거나 쓰기 위해 디스크 헤드가 이동하는 동작을 가리킴.
• log.flush.interval.messages=10000
  • 메시지를 디스크에 쓰기(flush) 전에 몇 개 까지 누적할 것인지 설정
• log.flush.interval.ms=1000
  • flush를 시간 간격으로 지정
  • 기본 값은 1초(1000ms)

 

##### Log Retention Policy #####

• 원문 해석 로그 세그먼트의 삭제에 대한 설정. 일정 기간이 지난 후 세그먼트를 삭제하거나 특정 크기가 축적된 후에 삭제할 수 있도록 설정할 수 있다. 이 기준 중 어느 하나라도 충족될 때마다 세그먼트가 삭제된다. 삭제는 항상 로그의 끝에서 발생한다.
• log.retention.hours=168
  • 로그 파일이 연령에 따라 삭제될 수 있는 최소 시간
• log.retention.bytes=1073741824 (1기가)
  • 로그에 대한 크기 기반 보존 정책.
  • 세그먼트가 log.retention.bytes 값 아래로 떨어질 때까지 로그에서 제거됩니다.
  • log.retention.hours와 독립적으로 기능합니다.
• log.segment.bytes=1073741824 (1기가)
  • 로그 세그먼트 파일의 최대 크기입니다.
  • 이 크기에 도달하면 새로운 로그 세그먼트가 생성됩니다.
• log.retention.check.interval.ms=300000 (5분)
  • 보존 정책(Retention policy)에 따라 로그 세그먼트가 삭제될 수 있는지 확인하는 간격.

 

##### Zookeeper #####

• zookeeper.connect=localhost:2181
  • 이 설정은 Kafka가 Zookeeper 클러스터에 연결하는 데 사용할 호스트(ip) 및 포트 정보를 설정.
  • 주키퍼는 일반적으로 2181 포트를 사용함

 

3. server.properties에 기본적으로 없는 옵션

• auio.create.topics.enable
  • 토픽을 자동 생성할 것인지 설정
  • 기본값은 true
• compression.type
  • 브로커가 메시지를 저장할 때 압축하는 타입(확장자인 듯)
  • 브로커는 프로듀서로부터 메시지를 받으면 압축해서 저장하고, 컨슈머가 메시지를 가져갈 때도 압축한 것을 그대로 보낸다. 그 후 컨슈머가 메시지를 받아와 압축을 해제하는 방식.
• delete.topic.enable
  • 토픽 삭제를 가능하게 할 것인지 설정
  • 기본값은 true
• message.max.bytes
  • 브로커가 허용할 메시지의 크기(record batch size)를 설정
  • 압축이 활성화 되어 있다면 압축된 크기가 기준
• replica.lag.time.max.ms
  • replica.lag.time.max.ms 초 만큼 팔로워가 리더에게 fetch request를 보내지 않거나, 팔로워가 리더의 로그를 consume하지 않는다면 리더는 ISR에서 팔로워를 제거한다
  • 기본값은 30초