Kafka Topic Configuration: Minimum In-Sync Replicas
Learn about min.insync.replicas and how it works with the Kafka Topic configuration parameter, acks, to improve message safety.
We have learned about a Kafka producer configuration parameter called
acks which is the number of brokers who need to acknowledge receiving the message before it is considered a successful write. We use another Kafka configuration
min.insync.replicas along with this producer configuration.
Kafka producers only write data to the current leader broker for a partition.
Kafka producers must also specify a level of acknowledgment
acks to specify if the message must be written to a minimum number of replicas before being considered a successful write.
if using Kafka < v3.0,
if using Kafka >= v3.0,
acks=0 producers consider messages as "written successfully" the moment the message was sent without waiting for the broker to accept it at all.
If the broker goes offline or an exception happens, we won’t know and will lose data. This is useful for data where it’s okay to potentially lose messages, such as metrics collection, and produces the highest throughput setting because the network overhead is minimized.
acks=1 , producers consider messages as "written successfully" when the message was acknowledged by only the leader.
Leader response is requested, but replication is not a guarantee as it happens in the background. If an ack is not received, the producer may retry the request. If the leader broker goes offline unexpectedly but replicas haven’t replicated the data yet, we have a data loss.
acks = all
acks=all, producers consider messages as "written successfully" when the message is accepted by all in-sync replicas (ISR).
The lead replica for a partition checks to see if there are enough in-sync replicas for safely writing the message (controlled by the broker setting
min.insync.replicas). The request will be stored in a buffer until the leader observes that the follower replicas replicated the message, at which point a successful acknowledgement is sent back to the client.
min.insync.replicas can be configured both at the topic and the broker-level. The data is considered committed when it is written to all in-sync replicas -
min.insync.replicas. A value of 2 implies that at least 2 brokers that are ISR (including leader) must respond that they have the data.
If you would like to be sure that committed data is written to more than one replica, you need to set the minimum number of in-sync replicas to a higher value. If a topic has three replicas and you set
2, then you can only write to a partition in the topic if at least two out of the three replicas are in-sync. When all three replicas are in-sync, everything proceeds normally. This is also true if one of the replicas becomes unavailable. However, if two out of three replicas are not available, the brokers will no longer accept produce requests. Instead, producers that attempt to send data will receive
For a topic replication factor of 3, topic data durability can withstand 2 brokers loss. As a general rule, for a replication factor of
N, you can permanently lose up to
N-1 brokers and still recover your data.
Regarding availability, it is a little bit more complicated... To illustrate, let's consider a replication factor of 3:
Reads: As long as one partition is up and considered an ISR, the topic will be available for reads
acks=1: as long as one partition is up and considered an ISR, the topic will be available for writes.
min.insync.replicas=1(default): the topic must have at least 1 partition up as an ISR (that includes the reader) and so we can tolerate two brokers being down.
min.insync.replicas=2: the topic must have at least 2 ISR up, and therefore we can tolerate at most one broker being down (in the case of replication factor of 3), and we have the guarantee that for every write, the data will be at least written twice.
min.insync.replicas=3: this wouldn't make much sense for a corresponding replication factor of 3 and we couldn't tolerate any broker going down.
in summary, when
min.insync.replicas=Mwe can tolerate
N-Mbrokers going down for topic availability purposes.
min.insync.replicas=2 is the most popular option for data durability and availability and allows you to withstand at most the loss of one Kafka broker
Let's see how to change the configuration
min.insync.replicas of a topic using the CLI tool
kafka-configs. The default value of this configuration at the broker level is
1. As we mentioned before, a typical value for this configuration is the replication factor minus 1. This means with a replication factor of 3,
min.insync.replicas should be 2.
Use CLI commands with appropriate extensions for your platform, e.g.,
kafka-configs.bat for windows,
kafka-configs.sh for Linux
Before running Kafka CLIs make sure that you have started Kafka successfully.
First, create a topic named configured-topic with 3 partitions and a replication factor of 1, using Kafka topics CLI,
Describe the topic to check if there are any configuration override set for this topic.
There is no configuration override set.
min.insync.replicas value for the topic
configured-topic to 2
And describe the topic again
Now, you can see there is a topic configuration override set (at the right side of the output) -
You can delete the configuration override by passing
--delete-config in place of the
Describe the topic to make sure the configuration override has been removed.
Through a configuration file change
The default value of this configuration is
1. However, this can be changed at the broker level. Open the broker configuration file
config/server.properties and append the following at the end of the file.
kafka-configs which can change configuration while the broker is running, this, however, requires a broker restart for the configuration change to take effect.
Dynamic Kafka Broker configuration change using the kafka-configs CLI
kafka-configs CLI can also update broker configuration (on top of topic configuration) dynamically without requiring a broker restart. Here is how:
And then if we describe the dynamically updated configurations for our brokers
We can delete the dynamic configuration as well:
Conduktor & Kafka Min Insync Replicas
Now that you have seen how to perform all these tasks using the Kafka Configs CLI, you may wonder how you can achieve this using a graphical UI tool.
Using Conduktor you can configure your topics without a lot of effort, documentation included!