Skip to main content
Version: 2.4.x

Basic Concept of Raft Replication

In distributed systems, Raft is a consensus algorithm used to replicate logs to ensure agreement across multiple nodes. The nodes in Raft algorithm are classified as leaders, followers, and candidates.Raft算法中的节点分为领导者（leader）、跟随者（follower）和候选者（candidate）。

When a node operates as a leader, it is responsible for receiving requests from clients and copying these requests into the logs of other nodes for data replication and consistency.

The basic process of Raft replica replication​

  • Leadership election When the system starts or the current leader node loses contact, the candidates in the remaining nodes initiate a leadership election. Candidates send messages requesting votes to other nodes and wait for replies from other nodes within a certain period of time. If the candidate gains the support of the majority of nodes, it becomes the new leader.候选者会向其他节点发送请求投票的消息，并在一定的时间内等待其他节点的回复。如果候选者获得了大多数节点的支持，它就成为了新的领导者。

  • 日志复制 一旦选出了领导者，它就可以接收客户端的请求，并将这些请求追加到自己的日志中。然后，领导者会将这些日志条目发给其他节点，并等待大多数节点的确认。Log replication Once the leader is elected, it can receive requests from clients and append these requests to its own log. The leader will then send these log entries to the other nodes and wait for the confirmation of the majority of the nodes. Once the majority of nodes have acknowledged receiving and replicating these logs, the leader can apply the log entries to the local state machine to achieve data consistency.

  • Follower copy When the follower node receives the log entries sent by the leader, it appends these log entries to its own log and sends an acknowledgement message to the leader. Once the leader receives the acknowledgement message from the majority of nodes, it knows that these log entries have been replicated in the majority of nodes, ensuring consistency.一旦领导者接收到大多数节点的确认消息，它就知道这些日志条目已经复制到了大多数节点中，从而确保了一致性。

  • Failure handling If the leader node loses contact or some other failure occurs, the remaining nodes will re-elect a new leader. The newly elected leader will continue to replicate the logs and maintain data consistency.新选出的领导者会继续复制日志，并维护数据的一致性。

Through the above process, Raft algorithm realizes replica replication and consistency, and ensures data consistency and reliability in distributed system.

Raft in CnosDB​

Raft replication algorithm is introduced in CnosDB v2.4 version, each Replica Set is a Raft replication group, and the whole system runs in a Multi-Raft mode.

Data writing flow​

  • Determine which Bucket to write based on tenant, Database, and timestamp.
  • Hash according to the Series Key to determine which Replica Set to write, that is, which Raft replica group.
  • Check if the node receiving the request is the Leader if it is written directly, otherwise forward it to the Leader for processing.

Raf replica group management​

  • Replication group creation and destruction
  • Add a copy
  • Delete a copy
  • Move a copy