프로퍼티 

설명 

 metadata.broker.list

메타데이터를 받아 올 Kafka broker 리스트. 호스트1:포트1,호스트2:포트2,호스트3:포트3의 형태로 명시한다.
예) kafka-test-001.epicdevs.com:9092,kafka-test-002.epicdevs.com:9092,kafka-test-003.epicdevs.com:9092

여기서 명시하는 broker는 메타데이터를 받아오는 데만 사용하고, 실제 메시지를 전송할 때에는 메타데이터를 기반으로 새로운 connection을 맺은 다음 메시지를 전송한다. 따라서 이 리스트에는 전체 broker 중 일부만 명시해도 무관하다.

 프로퍼티

 기본 값 

설명 

 serializer.class

 kafka.serializer.DefaultEncoder

메시지를 serialize할 때 사용하는 인코더.DefaultEncoder는 byte[]를 받아서 그대로 전달한다.

 key.serializer.class

 serializer.class의 값과 동일

메시지 키를 serialize할 때 사용하는 인코더.

 partitioner.class

 kafka.producer.DefaultPartitioner

메시지를 어떤 partition에 전송할지 결정하는 클래스. DefaultPartitioner는 메시지 키의 해시 코드를 기반으로 메시지를 전송할 partition을 결정한다. 메시지 키를 명시하지 않았거나 null 값을 키로 전달할 경우 사용자가 명시한 partitioner.class를 무시하고 임의의 partition에 메시지를 보내게 된다. 이 때문에 특정 상황에서 전체 partition에 메시지가 제대로 분산되지 않는 현상이 발생할 수 있다. 이에 대한 자세한 사항은 Kafka FAQ의 Why is data not evenly distributed among partitions when a partitioning key is not specified?를 참조하길 바란다.

 request.required.acks

 0

Producer가 전송한 메시지가 몇 개의 replica에 commit되어야 ack처리(성공적으로 전송된 것으로 간주)를 하는지 결정하는 기준.

• 0: producer는 broker로부터 ack를 기다리지 않고 메시지 전송이 끝나자마자 성공된 것으로 간주한다. 응답 시간은 가장 빠르지만 broker에서 오류가 발생할 경우 메시지가 유실된다.
• 1: leader를 맡고있는 replica에 메시지가 commit되면 ack처리를 한다.
• N: N개의 replica에 메시지가 commit되면 ack처리를 한다.
• -1: 모든 replica에 메시지가 commit되면 ack처리를 한다.

 compression.codec

 none

메시지를 압축할 때 사용할 코덱. none, gzip,snappy 중 하나를 선택할 수 있다. none을 선택하면 메시지를 압축하지 않는다.

 producer.type

 sync

Producer가 메시지를 동기적으로 전송할지 비동기적으로 전송할지에 대한 설정. 동기적으로 전송하려면 sync로 명시하고 비동기적으로 전송하려면async로 명시한다. 비동기 producer를 사용할 경우 메시지를 일정 시간 큐에 쌓아 두었다가 한 번에 전송하므로 producer의 메시지 처리량을 향상시킬 수 있다. 단, 장애가 발생할 경우 전송하지 않고 쌓아 둔 메시지가 유실될 우려가 있다.

 queue.buffering.max.ms

 5000

비동기 producer를 사용할 경우 몇 ms동안 메시지를 모아둘지 결정하는 값. 비동기 producer는queue.buffering.max.ms 값에 도달하거나batch.num.messages 값에 도달할 경우 쌓아두었던 메시지를 전송한다.

 batch.num.messages

 200

비동기 producer를 사용할 경우 최대 몇 개의 메시지를 모아둘지 결정하는 값. 비동기 producer는queue.buffering.max.ms 값에 도달하거나batch.num.messages 값에 도달할 경우 쌓아두었던 메시지를 전송한다.

 프로퍼티 

설명 

 group.id

Consumer가 속한 consumer group의 ID. Zookeeper에서는 각 consumer group의 메시지 offset을 관리하는데, 이 때 이 ID가 키로써 사용된다. 따라서 consumer group ID가 같으면 모두 같은 consumer group에 속한 것으로 간주되며 메시지 offset 값 또한 공유된다.

Zookeeper 인스턴스 리스트. 호스트1:포트1,호스트2:포트2,호스트3:포트3의 형태로 명시한다.
예) kafka-test-001.epicdevs.com:2181,kafka-test-002.epicdevs.com:2181,kafka-test-003.epicdevs.com:2181

 프로퍼티

 기본 값 

설명 

Consumer가 메시지를 전달받은 뒤 자동으로 offset 값을 commit할지 결정하는 플래그. 메시지가 성공적으로 처리되었을 때만 offset이 commit되도록 하려면 이 값을 false로 설정해야 한다. 이 값이 true일 경우auto.commit.interval.ms 값마다 주기적으로 offset을 commit하며,false일 경우 ConsumerConnector의 commitOffsets 메소드를 직접 호출해야 offset이 commit된다

auto.commit.enable이 true일 때 offset을 자동으로 commit하는 주기. 이 값을 길게 잡으면 메시지 처리 중에 장애가 발생할 경우 실제로 처리된 메시지 offset과 commit된 offset 간의 격차가 커져서 fail over 후 중복으로 처리되는 메시지의 수가 많아질 가능성이 높으며, 짧게 잡을 경우 잦은 Zookeeper 업데이트로 인한 오버헤드가 발생할 수 있다.

Consumer가 속한 consumer group의 offset 값이 존재하지 않거나 범위를 벗어나는 값을 전달받았을 경우 어떻게 동작할지를 정하는 값.

• smallest: 가장 작은 offset의 메시지부터 소비한다.
• largest: 가장 큰 offset의 메시지 이후부터 소비한다. (즉, 새롭게 전송되는 메시지부터 소비한다.)