Kafka 学习笔记

原创编写：王宇
2016-10-24

Kafka 笔记
消息系统(Messaging System)
Kafka 结构
集群结构（Cluster Architecture）
WorkFlow
安装步骤
Kafka 基本操作
Simple Producer Example
Simple Consumer Example
参考

消息系统(Messaging System)

Point to Point Messaging System
Publish-Subscribe Messaging System

两者最主要的区别是 Publish-Subscribe 模式支持多 Receiver

Kafka 结构

Components Description

Topics	A stream of messages belonging to a particular category is called a topic. Data is stored in topics.Topics are split into partitions. For each topic, Kafka keeps a mini-mum of one partition. Each such partition contains messages in an immutable ordered sequence. A partition is implemented as a set of segment files of equal sizes.
Partition	Topics may have many partitions, so it can handle an arbitrary amount of data.
Partition offset	Each partitioned message has a unique sequence id called as offset.
Replicas of partition	Replicas are nothing but backups of a partition. Replicas are never read or write data. They are used to prevent data loss.
Brokers	Brokers are simple system responsible for maintaining the pub-lished data. Each broker may have zero or more partitions per topic. Assume, if there are N partitions in a topic and N number of brokers, each broker will have one partition.Assume if there are N partitions in a topic and more than N brokers (n + m), the first N broker will have one partition and the next M broker will not have any partition for that particular topic.Assume if there are N partitions in a topic and less than N brokers (n-m), each broker will have one or more partition sharing among them. This scenario is not recommended due to unequal load distri-bution among the broker.
Kafka cluster	Kafka’s having more than one broker are called as Kafka cluster. A Kafka cluster can be expanded without downtime. These clusters are used to manage the persistence and replication of message data.
Producers	Producers are the publisher of messages to one or more Kafka topics. Producers send data to Kafka brokers. Every time a producer pub-lishes a message to a broker, the broker simply appends the message to the last segment file. Actually, the message will be appended to a partition. Producer can also send messages to a partition of their choice.
Consumers	Consumers read data from brokers. Consumers subscribes to one or more topics and consume published messages by pulling data from the brokers.
Leader	Leader is the node responsible for all reads and writes for the given partition. Every partition has one server acting as a leader.
Follower	Node which follows leader instructions are called as follower. If the leader fails, one of the follower will automatically become the new leader.A follower acts as normal consumer, pulls messages and up-dates its own data store.

集群结构（Cluster Architecture）

Components Description

Broker	Kafka cluster typically consists of multiple brokers to maintain load balance. Kafka brokers are stateless, so they use ZooKeeper for maintaining their cluster state. One Kafka broker instance can handle hundreds of thousands of reads and writes per second and each bro-ker can handle TB of messages without performance impact. Kafka broker leader election can be done by ZooKeeper.
ZooKeeper	ZooKeeper is used for managing and coordinating Kafka broker. ZooKeeper service is mainly used to notify producer and consumer about the presence of any new broker in the Kafka system or failure of the broker in the Kafka system. As per the notification received by the Zookeeper regarding presence or failure of the broker then pro-ducer and consumer takes decision and starts coordinating their task with some other broker.
Producers	Producers push data to brokers. When the new broker is started, all the producers search it and automatically sends a message to that new broker. Kafka producer doesn’t wait for acknowledgements from the broker and sends messages as fast as the broker can handle.
Consumers	Since Kafka brokers are stateless, which means that the consumer has to maintain how many messages have been consumed by using partition offset. If the consumer acknowledges a particular message offset, it implies that the consumer has consumed all prior messages. The consumer issues an asynchronous pull request to the broker to have a buffer of bytes ready to consume. The consumers can rewind or skip to any point in a partition simply by supplying an offset value. Consumer offset value is notified by ZooKeeper.

WorkFlow

Kafka 是一个通过topics分割到一个或多个partitions的collection. 一个Kafka partition 是一个线性有序的messages, 每一个message通过索引标识

Workflow of Pub-Sub Messaging
- Producers send message to a topic at regular intervals.
- Kafka broker stores all messages in the partitions configured for that particular topic. It ensures the messages are equally shared between partitions. If the producer sends two messages and there are two partitions, Kafka will store one message in the first partition and the second message in the second partition.
- Consumer subscribes to a specific topic.
- Once the consumer subscribes to a topic, Kafka will provide the current offset of the topic to the consumer and also saves the offset in the Zookeeper ensemble.
- Consumer will request the Kafka in a regular interval (like 100 Ms) for new messages.
- Once Kafka receives the messages from producers, it forwards these messages to the consumers.
- Consumer will receive the message and process it.
- Once the messages are processed, consumer will send an acknowledgement to the Kafka broker.
- Once Kafka receives an acknowledgement , it changes the offset to the new value and updates it in the Zookeeper. Since offsets are maintained in the Zookeeper, the consumer can read next message correctly even during server outrages.
- This above flow will repeat until the consumer stops the request.
- Consumer has the option to rewind/skip to the desired offset of a topic at any time and read all the subsequent messages.
Workflow of Queue Messaging / Consumer Group
一个consumers组有相同的Group ID 去 Subscribe 一个Topic.
- Producers send message to a topic in a regular interval.
- Kafka stores all messages in the partitions configured for that particular topic similar to the earlier scenario.
- A single consumer subscribes to a specific topic, assume Topic-01 with Group ID as Group-1.
- Kafka interacts with the consumer in the same way as Pub-Sub Messaging until new consumer subscribes the same topic, Topic-01 with the same Group ID as Group-1.
- Once the new consumer arrives, Kafka switches its operation to share mode and shares the data between the two consumers. This sharing will go on until the number of con-sumers reach the number of partition configured for that particular topic.
- Once the number of consumer exceeds the number of partitions, the new consumer will not receive any further message until any one of the existing consumer unsubscribes. This scenario arises because each consumer in Kafka will be assigned a minimum of one partition and once all the partitions are assigned to the existing consumers, the new consumers will have to wait.
- This feature is also called as Consumer Group. In the same way, Kafka will provide the best of both the systems in a very simple and efficient manner.
Role of ZooKeeper
A critical dependency of Apache Kafka is Apache Zookeeper, which is a distributed configuration and synchronization service. Zookeeper serves as the coordination interface between the Kafka brokers and consumers. The Kafka servers share information via a Zookeeper cluster. Kafka stores basic metadata in Zookeeper such as information about topics, brokers, consumer offsets (queue readers) and so on.

安装步骤

步骤一：安装JDK 并配置环境变量 JAVA_HOME CLASSPATH
步骤二 : 安装ZooKeeper

下载ZooKeeper
解包
1. $ tar xzvf zookeeper-3.5.2-alpha.tar.gz
2. $ mv ./zookeeper-3.5.2-alpha /opt/zookeepter
3. $ cd /opt/zookeeper
4. $ mkdir data
创建配置文件
1. $ cd /opt/zookeeper
2. $ vim conf/zoo.cfg
4. tickTime=2000
5. dataDir=/opt/zookeeper/data
6. clientPort=2181
7. initLimit=5
8. syncLimit=2
启动ZooKeeper Seve
1. $ bin/zkServer.sh start
步骤三安装 SLF4J
下载 SL4J : slf4j-1.7.21.tar.gz www.slf4j.org
解包并配置CLASSPATH
1. $ tar xvzf ./slf4j-17.21.tar.gz
2. $ mv ./slf4j-17.21/op/slf4j
3. vim ~/.bashrc
4. export CLASSPATH = ${CLASSPATH}:/opt/slf4j/*
步骤四：安装 Kafka
下载 Kafka
解包
1. $ tar xzvf kafka_2.11-0.10.1.0.tgz
2. $ mv ./kafka_2.11-0.10.1.0/opt/kafka
3. $ cd /opt/kafka
启动服务
1. $ ./bin/kafka-server-start.sh config/server.properties
步骤五：停止服务
1. $ ./bin/kafka-server-stop.sh config/server.properties

Kafka 基本操作

启动 ZooKeeper 和 Kafka

$ ./bin/zkServer.sh start
$ ./bin/kafka-server-start.sh config/server.properties

单节点Broker 配置
- 创建一个 Kafka Topic
  1. 语法：
  2. $ ./bin/kafka-topics.sh --create --zookeeper localhost:2181--replication-fator 1--partitions 1--topic topic-name
  3. 例子：
  4. $./bin/kafka-topics.sh --create --zookeeper localhost:2181--replication-factor 1--partitions 1--topic Hello-Kafka
  5. 输出：
  6. Created topic "Hello-Kafka"
- List of Topics
  1. 语法：
  2. $ ./bin/kafka-topics.sh --list --zookeeper localhost:2181
  3. 输出：
  4. Hello-Kafka
- 启动 Producer 去发 Messages
  1. 语法：
  2. $ ./bin/kafka-console-producer.sh --broker-list localhost:9092--topic topic-name
  3. 例子：
  4. $./bin/kafka-console-producer.sh --broker-list localhost:9092--topic Hello-Kafka
  5. 命令行下手动输入如下信息：
  6. Hello
  7. My first message
  8. My second message
- 启动 Consumer 去接受 Messages
  1. 语法：
  2. $ ./bin/kafka-console-consumer.sh --zookeeper localhost:2181--topic topic-name --from-beginning
  3. 例子：
  4. $ ./bin/kafka-console-consumer.sh --zookeeper localhost:2181--topic Hello-Kafka--from-beginning
  5. 输出：
  6. Hello
  7. My first message
  8. My second message
多节点Broker配置
待续
基本Topic 操作
- 修改 Topic
  1. 语法：
  2. $ ./bin/kafka-topics.sh --zookeeper localhost:2181--alter --topic topic-name --parti-tions count
  3. 例子：
  4. $ ./bin/kafka-topics.sh --zookeeper localhost:2181--alter --topic Hello-kafka --parti-tions 2
  5. 输出：
  6. WARNING:If partitions are increased for a topic that has a key, the partition logic or ordering of the messages will be affectedAdding partitions succeeded!
- 删除 Topic
  1. 语法：
  2. $ ./bin/kafka-topics.sh --zookeeper localhost:2181--delete--topic topic-name
  3. 例子：
  4. $ ./bin/kafka-topics.sh --zookeeper localhost:2181--delete--topic Hello-kafka
  5. 输出：
  6. TopicHello-kafka marked for deletion
- 删除数据
  1. Stop the ApacheKafka daemon
  2. Delete the topic data folder: rm -rf /tmp/kafka-logs/MyTopic-0

Simple Producer Example

Kafka Producer API
- KafkaProducer class provides send method to send messages asynchronously to a topic. The signature of send() is as follows
  1. producer.send(newProducerRecord<byte[],byte[]>(topic, partition, key1, value1), callback);
- ProducerRecord − The producer manages a buffer of records waiting to be sent.
- Callback − A user-supplied callback to execute when the record has been acknowl-edged by the server (null indicates no callback).
- KafkaProducer class provides a flush method to ensure all previously sent messages have been actually completed. Syntax of the flush method is as follows −
  1. publicvoid flush()
- KafkaProducer class provides partitionFor method, which helps in getting the partition metadata for a given topic. This can be used for custom partitioning. The signature of this method is as follows −
  1. publicMap metrics()
  2. It returns the map of internal metrics maintained by the producer.
- public void close() − KafkaProducer class provides close method blocks until all previously sent requests are completed.
Producer API
- Send
  1. publicvoid send(KeyedMessaget<k,v> message)- sends the data to a single topic,par-titioned by key using either sync or async producer.
  2. publicvoid send(List<KeyedMessage<k,v>>messages)- sends data to multiple topics.
  3. Properties prop =newProperties();
  4. prop.put(producer.type,”async”)
  5. ProducerConfig config =newProducerConfig(prop);
  6. There are two types of producers –SyncandAsync.
- Close
  public void close()
  Producer class provides close method to close the producer pool connections to all Kafka bro-kers.
Configuration Settings

name Description

client.id	identifies producer application
producer.type	either sync or async
acks	The acks config controls the criteria under producer requests are con-sidered complete.
retries	If producer request fails, then automatically retry with specific value.
bootstrap.servers	bootstrapping list of brokers.
linger.ms	if you want to reduce the number of requests you can set linger.ms to something greater than some value.
key.serializer	Key for the serializer interface.
value.serializer	value for the serializer interface
batch.size	Buffer size.
buffer.memory	controls the total amount of memory available to the producer for buff-ering.

ProducerRecord API
public ProducerRecord (string topic, int partition, k key, v value)

Topic − user defined topic name that will appended to record.

Partition − partition count

Key − The key that will be included in the record.

Value − Record contents

public ProducerRecord (string topic, k key, v value)
ProducerRecord class constructor is used to create a record with key, value pairs and without partition.

Topic − Create a topic to assign record.

Key − key for the record.

Value − record contents.

public ProducerRecord (string topic, v value)
ProducerRecord class creates a record without partition and key.

Topic − create a topic.

Value − record contents.

Class Method Description

public string topic()	Topic will append to the record.
public K key()	Key that will be included in the record. If no such key, null will be re-turned here.
public V value()	Record contents.
partition()	Partition count for the record

SimpleProducer 应用实例
- 在创建SimpleProducer之前，采用Kafka的命令创建Topic
  2. //import util.properties packages
  3. import java.util.Properties;
  5. //import simple producer packages
  6. import org.apache.kafka.clients.producer.Producer;
  8. //import KafkaProducer packages
  9. import org.apache.kafka.clients.producer.KafkaProducer;
  11. //import ProducerRecord packages
  12. import org.apache.kafka.clients.producer.ProducerRecord;
  14. //Create java class named “SimpleProducer”
  15. publicclassSimpleProducer{
  17. publicstaticvoid main(String[] args)throwsException{
  19. // Check arguments length value
  20. if(args.length ==0){
  21. System.out.println("Enter topic name");
  22. return;
  23. }
  25. //Assign topicName to string variable
  26. String topicName = args[0].toString();
  28. // create instance for properties to access producer configs
  29. Properties props =newProperties();
  31. //Assign localhost id
  32. props.put("bootstrap.servers","localhost:9092");
  34. //Set acknowledgements for producer requests.
  35. props.put("acks","all");
  37. //If the request fails, the producer can automatically retry,
  38. props.put("retries",0);
  40. //Specify buffer size in config
  41. props.put("batch.size",16384);
  43. //Reduce the no of requests less than 0
  44. props.put("linger.ms",1);
  46. //The buffer.memory controls the total amount of memory available to the producer for buffering.
  47. props.put("buffer.memory",33554432);
  49. props.put("key.serializer",
  50. "org.apache.kafka.common.serialization.StringSerializer");
  52. props.put("value.serializer",
  53. "org.apache.kafka.common.serialization.StringSerializer");
  55. Producer<String,String> producer =newKafkaProducer<String,String>(props);
  57. for(int i =0; i <10; i++)
  58. producer.send(newProducerRecord<String,String>(topicName,
  59. Integer.toString(i),Integer.toString(i)));
  61. System.out.println("Message sent successfully");
  62. producer.close();
  63. }
  64. }
- 编译
  1. $ javac SimpleProducer
- 执行
  1. $ java SimpleProducer<topic-name>
- 输出结果
  1. Message sent successuflly
  2. 执行下列语句，接收数据
  3. $ ./bin/kafka-console-consumer.sh --zookeeper localhost:2181-topic <topic-name>--from-beginning

Simple Consumer Example

KafkaConsumer class
ConsumerRecordAPI
ConsumerRecords API
Conifguration Settings
SimpleConsumer 应用实例
- 接收Topic数据代码
  1. import java.util.Properties;
  2. import java.util.Arrays;
  3. import org.apache.kafka.clients.consumer.KafkaConsumer;
  4. import org.apache.kafka.clients.consumer.ConsumerRecords;
  5. import org.apache.kafka.clients.consumer.ConsumerRecord;
  7. publicclassSimpleConsumer{
  8. publicstaticvoid main(String[] args)throwsException{
  9. if(args.length ==0){
  10. System.out.println("Enter topic name");
  11. return;
  12. }
  13. //Kafka consumer configuration settings
  14. String topicName = args[0].toString();
  15. Properties props =newProperties();
  17. props.put("bootstrap.servers","localhost:9092");
  18. props.put("group.id","test");
  19. props.put("enable.auto.commit","true");
  20. props.put("auto.commit.interval.ms","1000");
  21. props.put("session.timeout.ms","30000");
  22. props.put("key.deserializer","org.apache.kafka.common.serialization.StringDeserializer");
  23. props.put("value.deserializer","org.apache.kafka.common.serialization.StringDeserializer");
  24. KafkaConsumer<String,String> consumer =newKafkaConsumer<String,String>(props);
  26. //Kafka Consumer subscribes list of topics here.
  27. consumer.subscribe(Arrays.asList(topicName));
  29. //print the topic name
  30. System.out.println("Subscribed to topic "+ topicName);
  31. int i =0;
  33. while(true){
  34. ConsumerRecords<String,String> records = consumer.poll(100);
  36. for(ConsumerRecord<String,String> record : records)
  38. // print the offset,key and value for the consumer records.
  39. System.out.printf("offset = %d, key = %s, value = %s\n",
  40. record.offset(), record.key(), record.value());
  41. }
  42. }
  43. }
- 编译
  1. $ javac SimpleConsumer
- 执行
  1. $ java SimpleConsumer<topic-name>
- 输出结果
  1. Subscribed to topic Hello-Kafka
  2. offset =3, key =null, value =HelloConsumer

参考

Useful Links on Apache Kafka
Apache Kafka Official Website − Official Website for Apache Kafka
http://kafka.apache.org/
Apache Kafka Wiki − Wikipedia Reference for Apache Kafka
https://en.wikipedia.org/wiki/Apache_Kafka