java lock example

场景

等待条件发生

比如,有这样一个场景,在 spring boot 工程里面,有一个 controller,他会接受数据并把数据写入 kafka,然后返回写入 kafka 的结果。在调用 send 方法后,会得到一个 ListenableFuture 对象,这个对象可以传入 callback 对象,这是一个异步的过程,需要等待回调执行后,才能将结果返回给客户端。

我们就需要一种机制等待回调事件,这里用的模式如下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Object mutex = new Object();

onSuccess/onFailure[callback] {
synchronized (mutex) {
// 发送消息成功后, 唤醒在等待的线程
mutex.notify();
}
}

// 程序会先走到这里, 并等待 mutex 唤醒
synchronized (mutex) {
mutex.wait();
}

return ...;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
@Controller
@RequestMapping("kafka")
public class KafkaController {
static class Keeper {
String result;
}

@Resource
KafkaTemplate<String, String> template;

@RequestMapping(value = "put", method = RequestMethod.POST,
produces = MediaType.APPLICATION_JSON_VALUE)
@ResponseBody
public ResponseEntity<String> check(@RequestBody Message message) throws InterruptedException {
ListenableFuture<SendResult<String, String>> f = template.send("example", message.getKey(), message.getMessage());
Object mutex = new Object();
final Keeper keeper = new Keeper();
keeper.result = "unknown";
f.addCallback(new ListenableFutureCallback<SendResult<String, String>>() {
@Override
public void onFailure(@SuppressWarnings("NullableProblems") Throwable throwable) {
keeper.result = "send message failed";
synchronized (mutex) {
mutex.notify();
}
}

@Override
public void onSuccess(SendResult<String, String> stringStringSendResult) {
keeper.result = "send message success";
synchronized (mutex) {
mutex.notify();
} }
});

synchronized (mutex) {
mutex.wait();
}

return ResponseEntity.ok(keeper.result);
}
}

kafka attentions

  • 传输大文件
  • 每个partition的一个消息只能被一个consumer group中的一个consumer消费
  • consumer group 中的一个consumer可以消费多个partition
  • 一个consumer group 中的cunsomer processes必须小于partition的数量
  • each message is delivered exactly to one consumer from a group (with a same group id)

kafka commend line tools

[toc]

list consumer groups

1
2
# 列出所有 consumer group
./bin/kafka-consumer-groups.sh --bootstrap-server $bootstrap_servers --list

list topic

1
2
3
4
5
6
7
8
9
10
$ ./bin/kafka-topics.sh --list --zookeeper server.zk
__consumer_offsets
demo_kafka_topic_1
model_diff_update_111
model_diff_update_156
model_diff_update_785
model_diff_update_802

# 示例
$ ./bin/kafka-topics.sh --list --zookeeper 127.0.0.1:2181

清空 topic

1
kafka-configs.sh --zookeeper <zkhost>:2181 --alter --entity-type topics --entity-name <topic name> --add-config retention.ms=1000

查看 topic 信息

1
2
3
$ ./bin/kafka-topics.sh --zookeeper c3cloudsrv.zk.hadoop.srv:11000/kafka/c3cloudsrv-feeds --describe --topic model_diff_update_111
Topic:model_diff_update_111 PartitionCount:1 ReplicationFactor:1 Configs:retention.ms=300000
Topic: model_diff_update_111 Partition: 0 Leader: 1 Replicas: 1 Isr: 1
1
$ kafka-topics --zookeeper 127.0.0.1:2181 --describe --topic <topic-name>

消费

1
2
3
4
5
$ ./bin/kafka-console-consumer.sh --bootstrap-server 127.0.0.1:9092 --topic <topic> --from-beginning
$ ./bin/kafka-console-consumer.sh --bootstrap-server 127.0.0.1:9092 --topic <topic> # 默认最新消息开始消费

# oom 异常, 设置 KAFKA_HEAP_OPTS="-Xms512m -Xmx1g"
$ env KAFKA_HEAP_OPTS="-Xms512m -Xmx1g" ./bin/kafka-console-consumer.sh --bootstrap-server <bootstrap-servers> --topic <topic> --from-beginning

指定配置文件

kafka-auth.properties

1
2
3
4
5
security.protocol        = "ssl"
ssl.ca.location = "ca_cert.pem"
ssl.certificate.location = "client_cert.pem"
ssl.key.location = "client_cert_key.pem"
ssl.key.password = "password"
1
2
3
4
5
# 指定配置文件
## consumer
... --consumer.config kafka-auth.properties
## producer
... --producer.config kafka-auth.properties

参考

环境变量指定认证

1
2
3
4
5
6
7
8
9
10
CONNECT_CONSUMER_SECURITY_PROTOCOL: SASL_SSL
CONNECT_CONSUMER_SASL_KERBEROS_SERVICE_NAME: "kafka"
CONNECT_CONSUMER_SASL_JAAS_CONFIG: com.sun.security.auth.module.Krb5LoginModule required \
useKeyTab=true \
storeKey=true \
keyTab="/etc/kafka-connect/secrets/kafka-connect.keytab" \
principal="<principal>;
CONNECT_CONSUMER_SASL_MECHANISM: GSSAPI
CONNECT_CONSUMER_SSL_TRUSTSTORE_LOCATION: <path_to_truststore.jks>
CONNECT_CONSUMER_SSL_TRUSTSTORE_PASSWORD: <PWD>

发送消息

1
$ /bin/kafka-console-producer.sh --broker-list localhost:9092 --topic <topic>

删除 topic

1
$ ./bin/kafka-topics --delete --zookeeper 127.0.0.1:2181 --topic <topic-name>

kafka notes

基础

  • 架构

    • 介绍
    • Rebalance
      • Why
        • 是Kafka集群的一个保护设置,用于剔除掉无法消费或过慢的消费者
        • 负载均衡
      • When
        • new consumer
        • consumer offline / exit / dead / unsubscribe
        • 消费者订阅的topic出现分区数量变化
      • 影响
        • 重复消费
        • Rebalance扩散到整个ConsumerGroup,一个Consumer的退出,导致Group进行Rebalance,影响面大
        • 频繁的Rebalance导致重复消费及Rebalance占用大量时间
        • 数据不能及时消费,会累计lag(消费滞后),在Kafka的TTL之后会丢弃数据
      • improve
        • 关闭 auto commit,手动管理offset和心跳
      • Rebalance Listener
      • more
  • 名词

    • Broker
      • 消息中间件处理节点
      • 一个Kafka节点就是一个broker
      • 一个或多个Kafka节点组成Kafka集群
    • Topic
      • Kafka根据Topic对消息进行归类
      • 发布到Kafka集群的每条消息都需要指定一个topic
    • Producer
      • 参数
        • Topic
        • Partition(Optional)
        • Key(Optional)
        • Value
    • Consumer
      • 一个Consumer可以消费一个或多个partition
    • ConsumerGroup
      • 每个Consumer属于一个特定的ConsumerGroup
      • 一条消息可以发送到多个不同的ConsumerGroup
      • 一个ConsumerGroup中的一条消息只被一个Consumer处理
      • 仅是用来对消费者进行分组来消费topic的消息
    • Partition
      • 物理上的概念
      • 一个topic的信息可以划分到多个partition
      • 每个partition内部是有序的
      • 每个partition在存储层面是append log文件
      • 顺序写磁盘,效率非常高,这是Kafka高吞吐量的重要保证
      • partition是broker属性,不影响producer
    • Segment
      • partition细分的物理概念
      • 包括:
        • .index文件
        • .log文件
      • Ref
    • Offset
      • 发布到partition的消息被追加到log文件的尾部
      • 每条消息在partition文件中的位置成为offset
      • offset是一个整形数字,唯一标记一条消息
    • Leader & Follower
      • 为了提高消息可靠性,Kafka为每个topic的partition设置N个副本
      • N 副本中的一个选举为Leader,其他为Follower
      • Leader处理partition的所有读写请求,follower定期复制leader上的数据
      • 负责维护和跟踪ISR(副本同步队列)中所有follower滞后的状态
      • producer发送一条消息到broker后,leader写入消息并复制到所有follower
  • 如何提高可靠性

    • 通过request.required.acks参数设置数据可靠性级别
      • 1:producer接受到leader成功收到数据并得到确认后发送下一条数据
        • 如果leader宕机,消息未同步到follower,可能会造成数据丢失
      • 0:producer无需等待来自broker的确认而继续发送下一条消息,可靠性最低
      • -1:producer等待ISR中所有follower都确认接收到数据才算一次发送成功,可靠性最高
        • 如果设置副本为1,也就是说只有leader,此时和设置request.required.acks等效,如果leader宕机,也会发生数据丢失
    • 保证高可靠性
      • topic的配置:replication.factor>=3,即副本数至少是个;2<=min.insync.replicas<=replication.factor
      • broker的配置:leader的选举条件unclean.leader.election.enable=false
      • producer的配置:request.required.acks=-1(all),producer.type=sync
  • 应用

    • 日志收集
    • 业务数据收集
    • page view
  • Ref

读取消息示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
val props = new Properties()
props.setProperty("group.id", "-")
props.setProperty("bootstrap.servers", "-")
props.setProperty("auto.offset.reset", "-")
props.put("key.deserializer", classOf[StringDeserializer])
props.put("value.deserializer", classOf[StringDeserializer])
props.put("partition.assignment.strategy", "org.apache.kafka.clients.consumer.RangeAssignor")
val consumer = new KafkaConsumer[String, String](props)
consumer.subscribe(List(topic))
while (true) {
val results = consumer.poll(2000)
for (record <- results.iterator()) {
print(s"${record.key()} - ${record.value()}")
}
}

kafka offset

定义

偏移量是,在一个分区内下一条需要发送给消费者的消息位置。Kafka包括两种类型的offset:

  • Current offset
    • 当前偏移量是指向Kafka在最近一次轮询中已发送给消费者的最后一条记录的指针。所以Current Offset消费者不会获取到相同的记录
  • Committed offset
    • Commited Offset 是消费者已确认处理的位置

总结

  • Current offset:Send Records:用来避免向同一个消费者发送相同的数据
  • Committed offset:Processed Records:避免在分区平衡的状况下,向新的消费者发送相同的记录

Commited Offset在分区平衡的情况下至关重要。分区平衡的情况下,新的消费者被分配到新的分区时,Committed Offset可以解决从哪里开始、哪些记录已经被消费的问题。

Commit an offset

Current offset 和 committed offset由Kafka管理。提交一个offset的方式有两种:

  • Auto commit
  • Manual-commit

Auto commit

通过两个属性来控制Auto-Commit:

  • enable.auto.commit
    • 默认为true,所有 auto-commit 默认开启
  • auto.commit.interval.ms
    • 定义auto-commit时间间隔

auto-commit的一个问题是,在提交之前,数据可能会被其他消费者处理。这种情况下,没办法彻底避免消息被重复处理。

Manual commit

可以使用manual-commit的方式解决auto-commit的问题。manual-commit由两种方式:

  • Commit Sync
  • Commit Async

一个简单示例。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
import java.util.*;
import java.io.*;
import org.apache.kafka.clients.consumer.KafkaConsumer;
import org.apache.kafka.clients.consumer.ConsumerRecords;
import org.apache.kafka.clients.consumer.ConsumerRecord;

public class ManualConsumer{

public static void main(String[] args) throws Exception{

String topicName = "SupplierTopic";
String groupName = "SupplierTopicGroup";

Properties props = new Properties();
props.put("bootstrap.servers", "localhost:9092,localhost:9093");
props.put("group.id", groupName);
props.put("key.deserializer", "org.apache.kafka.common.serialization.StringDeserializer");
props.put("value.deserializer", "SupplierDeserializer");
props.put("enable.auto.commit", "false");

KafkaConsumer<String, Supplier> consumer = null;

try {
consumer = new KafkaConsumer<>(props);
consumer.subscribe(Arrays.asList(topicName));

while (true){
ConsumerRecords<String, Supplier> records = consumer.poll(100);
for (ConsumerRecord<String, Supplier>record : records){
System.out.println("Supplier id= " + String.valueOf(record.value().getID()) +
" Supplier Name = " + record.value().getName() +
" Supplier Start Date = " + record.value().getStartDate().toString());
}
consumer.commitAsync();
}
}catch(Exception ex){
ex.printStackTrace();
}finally{
consumer.commitSync();
consumer.close();
}
}
}

这里:

  • 使用异步提交
  • 当出现异常或退出时,使用同步提交

Offset backend storage

Offset记录位置是根据Kafka broker版本和Kafka client版本决定。

Kafka version\Kafka deriver version <0.9 >=0.9
<0.9 Offset Storage: Zookeeper Offset Storage: Zookeeper
>=0.9 Offset Storage: Zookeeper Offset Storage: Kafka

如果Broker存储Offset,处理方式:

  • Kafka把Offset作为Message存储在topic __consumer_offsets
  • 每个consumer定期向这个topic 提交Message,Message包括
    • current offset
    • consumer group
    • partition number
    • topic

在kafka 0.11.x 版本配合 cppkafka client,可以断定,offset 后端存储是kafka broker进行管理,依据:

  • 可以查询到 __consumer_offsets 主题,且有offsets信息
1
2
3
$ ./kafka-console-consumer.sh --consumer.config /tmp/consumer.config --formatter "kafka.coordinator.group.GroupMetadataManager\$OffsetsMessageFormatter" --topic __consumer_offsets --zookeeper *:2181/feeds/infra/feeds-kafka-srv --from-beginning
[consumer,test,0]::[OffsetMetadata[332,NO_METADATA],CommitTime 1537347025096,ExpirationTime 1537433425096]
...
  • 对应zookeeper节点中没有对应offsets信息
    • 路径格式:/consumers/{CONSUMER_GROUP_ID}/offsets/{TOPIC_NAME}/{PARTITION_NUMBER}

Ref

参考

kafka QA

  • consumer 和 consumer group的关系?
    • 一个用户属于一个 consumer group
  • consumer group 和 topic 的关系?
    • consumer group保存自己的offset
    • 不同consumer group消费同一topic时,会消费同样的内容,各个group保存自己的offset
  • topic 和 partition 的关系?
    • topic 和 partition 不在一个抽象层次
    • 一个 topic 的消息会被划分到多个partition(如果partion数量被设定 > 1)
  • consumer group 和 partition 的关系?
    • 同样,consumer group 和 partition 也不在一个抽象层次
  • partition 和 replication 的关系?
    • 没关系
  • 怎么指定partition?
    • 不允许使用 producer api 设置partition数量
    • 每个topic的partition数量根据配置文件中的num.partitioins 指定

kafka release notes

v2

  • 支持前缀ACLs

  • 添加认证框架(authenticate framework)

  • 支持主机名认证

  • 动态更新SSL信任库

  • 改进复制协议避免leader和follower间日志差异

  • 减少消息转换占用内存,提升broker弹性

  • 减少消息分块内存使用,避免broker的OutOfMemory错误

  • 在应用限流之前通知客户端,使得客户端在超过限额时,可以区分是网络错误还是限流

  • 增加消费者配置选项,避免无限阻塞

  • 放弃Java7

  • Kafka Connect改进

    • 改进transformations异常处理方式
    • 日志包含更多信息
    • 增加密钥从连接器配置中移除扩展
  • 增加Scala wrapper API

  • 支持消息头信息添加读取

  • Kafka Streams中的窗口聚合性能有大的提升

v1.1

  • Kafka Controller有大的改善

    • 加速controlled shutdown
    • 改善zookeeper会话过期处理
    • 允许单个集群支持更多分区
    • 引入了增量提取请求,当分区数量很大时提供更高效的复制
  • 增加对日志目录副本移动支持,以便于JBOD实现数据平衡

  • 动态更新某些broker配置

  • 增加代理令牌身份验证,以支持大量客户端导致的其他身份验证服务器过载

  • Kafka Connect功能更新

    • Connect REST接口中支持Header
    • SSL和kafka集群标识符
    • 连接器名称验证
    • 支持接收器主题正则表达式
    • 默认最大堆大小增加到2GB
  • Kafka Streams API改进

    • 减少重新分区主题占用的分区空间
    • 异常处理可定制
    • 增强broker弹性

v1.0

  • Streams API改进
    • 增加API在运行时公开活动任务的状态
    • 新的cogroup API可以更轻松地处理代码中包含更少StateStore和更少移动部件的分区聚合
  • 改进集群可监控性
  • 支持Java9
  • 区分身份验证错误和代理失败
  • 更好得容忍磁盘故障

0.11.0.0

  • 支持 Exactly-once 语义。为了支持幂等producer和EOS,增加一些与事务相关的字段,使得单个record数据结构体积增加。但因为优化了RecordBatch使得整个batch所占体积反而减少,进一步降低了网络IO开销。
  • 优化了对Snappy压缩的支持之前由于源代码中硬编码了blocksize
  • 消息增加头部信息(Header)Record增加了Header,每个header是一个KV存储
  • 空消费者组延时rebalance为了缩短多consumer首次rebalance的时间,增加了“group.initial.rebalance.delay.ms”用于设置group开启rebalance的延时时间。这段延时期间允许更多的consumer加入组,避免不必要的JoinGroup与SyncGroup之间的切换。当然凡事都是trade-off,引入这个必然带来消费延时。
  • 新的分配算法:StickyAssignor比range和round-robin更加平衡的分配算法。
  • 重构了controller,采用了单线程+基于事件队列的方式。

0.10.x

  • 内置了机架感知以便隔离副本,使得Kafka保证副本可以跨越到多个机架或者是可用区域,显著提高了Kafka的弹性和可用性

  • 所有Kafka中的消息都包含了时间戳字段,这个时间就是这条消息产生的时间。这使得Kafka Streams能够处理基于事件时间的流处理;而且那些通过时间寻找消息以及那些基于事件时间戳的垃圾回收特性能为可能。

  • Apache Kafka 0.9.0.0版本引入了新的安全特性,包括通过SASL支持Kerberos。Apache Kafka 0.10.0.0现在支持更多的SASL特性,包括外部授权服务器,在一台服务器上支持多种类型的SASL认证以及其他的改进。

  • Kafka Connect得到了持续提升。在此之前,用户需要监控日志以便看到各个connectors以及他们task的状态,现在Kafka已经支持了获取的状态API这样使得监控变得更简单。同时也添加了控制相关的API,这使得用户可以在进行维护的时候停止一个connector;或者手动地重启那些失败的task。这些能够直观的在用户界面展示和管理connector目前可以在控制中心(Control Center)看到。

  • Kafka Consumer Max Records,在Kafka 0.9.0.0,开发者们在新consumer上使用poll()函数的时候是几乎无法控制返回消息的条数。不过值得高兴的是,此版本的Kafka引入了max.poll.records参数,允许开发者控制返回消息的条数

  • 协议版本改进,Kafka brokers现在支持返回所有支持的协议版本的请求API,这个特点的好处就是以后将允许一个客户端支持多个broker版本。

kafka 架构

概念

基础

  • broker
  • topic
  • partition
  • segment
  • replication
  • consumer
    • consumer
    • consumer group
    • consumer instance
    • offset
  • producer

broker

broker 是一个 kafka 进程,多个 broker 组成了一个 kafka 集群。在 conumer 和 producer 中,使用如下方式指定多个 broker。

1
2
Properties props = new Properties();
props.put("bootstrap.servers", "localhost:9092,localhost:9093");

topics

主题,标识了一个消息队列。producer 产生数据时需要指定,consumer 消费时也需要指定,两者指定的 topic 匹配来达到数据的流通。

producer

生产者,产生消息的实例。producer 需要指定 topic,可选地将消息写入哪个 partition,通过指定 partitioner.class 选项实现。

1
2
3
4
5
6
7
8
9
10
11
Properties props = new Properties();
props.put("bootstrap.servers", "localhost:9092");
props.put("acks", "all");
props.put("retries", 0);
props.put("batch.size", 16384);
props.put("linger.ms", 1);
props.put("partitioner.class", "com.example.MyPartitioner");
props.put("buffer.memory", 33554432);
props.put("key.serializer", "org.apache.kafka.common.serialization.StringSerializer");
props.put("value.serializer", "org.apache.kafka.common.serialization.StringSerializer");
Producer<String, String> producer = new KafkaProducer<>(props);

consumer

consumer

消费者,逻辑概念,指从消息队列获取消息的实例。consumer 必须指定 topic,可选地指定 partition。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Properties props = new Properties();
props.setProperty("bootstrap.servers", "localhost:9092");
props.setProperty("group.id", "test-group");
props.setProperty("enable.auto.commit", "false");
props.setProperty("key.deserializer", "org.apache.kafka.common.serialization.StringDeserializer");
props.setProperty("value.deserializer", "org.apache.kafka.common.serialization.StringDeserializer");

KafkaConsumer<String, String> consumer = new KafkaConsumer<>(props);
//don't call consumer#subscribe()
//assigning partition-id=1
consumer.assign(Collections.singleton(new TopicPartition("topic", 1)));
while (true) {
ConsumerRecords<String, String> records = consumer.poll(Duration.ofSeconds(2));
for (ConsumerRecord<String, String> record : records) {
// todo sth.
}
consumer.commitSync(); // enable.auto.commit 设置为 false 时必须
}

consumer instance

consumer instance 是一个消费实例,具体地是某个程序的某个进程/线程。

consumer group

consumer group 是一个逻辑概念,由一个或多个 consumer instance 组成,这种组成是通过 consumer instance 消费时指定 cosumer group 来隐式加入的。

offset

offset 标记了一个 consumer group 消费消息的偏移量。偏移量信息保存在 zookeeper 中,保存的信息有过期时间,默认的过期时间在 kafka 的配置文件中,配置项为 offsets.retention.minutes,下面是一个示例。

1
2
# file: kafka/config/server.properties
offsets.retention.minutes=1440

默认的过期时间是 1440 分钟,即 24 小时。

partition

分区(partition)是物理概念,topic 是逻辑概念,一个 topic 有至少一个 partition,每个 partition 会对应某个 broker 磁盘上的一些区域(更具体地,对应一个文件夹)。

可以将 topic 划分为多个分区,根据分区规则把消息存储到某个分区,如果分区规则能将消息均匀地分散到各 partition,这个过程就可以看做负载均衡和水平扩展。

同时,consumer 可以从一个或者多个 partition 中消费消息。

img

segment

segment 是 partition细分的物理概念,包括.index文件(索引文件)和.log文件(数据文件)。

replication

可以通过为 topic 设置多个 replication,来保证数据可靠性,多个 replication 是主从关系,主挂后,从从中选举新的主。

Kafka Stream

流处理拓扑

  • 流(Stream)代表一个无边界的、持续更新的数据集,是有序的、可重放的、不可变数据记录的容错序列,数据记录是一个键值对
  • 流处理应用(Stream Processing Application)是任何使用 Kafka Stream Library 的程序,通过一个或多个处理拓扑(Processor Topologies)定义计算逻辑,一个计算拓扑是一个流处理器(节点)的图,通过流(边)来连接
  • 流处理器(Stream Processor)是处理拓扑中的一个节点,表示一个数据转换的处理步骤,通过从拓扑中的上游节点接受一个输入记录,应用操作到记录,可能产生一个或多个记录到它的下游节点

拓扑中有两种特殊的处理器。

  • 源处理器(Source Processor),没有上游处理器,通过消费一个或多个 Kafka Topic ,向它所在的拓扑中构造一个输入流,将记录传递给下游节点
  • SinK 处理器(Sink Processor),没有下游处理器,发送所有从上游节点接受到的记录到指定的 Kafka Topic 内

在普通的处理器内,可以访问其他远程系统。

img

架构

Apache Kafka Architecture - Component Overview

参考

kafka for c++

  • reset offset

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    class ExampleRebalanceCb : public RdKafka::RebalanceCb {
    public:
    void rebalance_cb (RdKafka::KafkaConsumer *consumer,
    RdKafka::ErrorCode err,
    std::vector<RdKafka::TopicPartition*> &partitions) {
    if (err == RdKafka::ERR__ASSIGN_PARTITIONS) {
    RdKafka::TopicPartition *part;
    // find the partition, through std::find() or other means
    ...
    if (part)
    part->set_offset(1234);
    consumer->assign(partitions);
    } else {
    consumer->unassign();
    }
    }
    };