Skip to main content

Documentation Index

Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt

Use this file to discover all available pages before exploring further.

In modern, read-heavy environments, offloading queries from your primary Consul cluster can dramatically boost throughput and resilience. Consul Enterprise introduces read replicas—non-voting members dedicated to serving read requests. This feature allows you to scale out read operations without impacting the write performance or election process of your primary servers.

​
What Are Read Replicas?

Read replicas in Consul Enterprise are special server agents that:
  • Serve read-only traffic: Respond to queries without handling writes.
  • Stay in sync via replication: Receive updates from the primary cluster.
  • Do not vote: Excluded from leader elections, ensuring election integrity.
By directing read clients to these replicas, you preserve the performance of your voting servers and optimize overall cluster capacity.
Read replicas always reflect the latest cluster state but cannot process acl replication up or write-related API calls.

​
Primary Cluster vs. Read Replicas

ComponentRoleVotingHandles WritesHandles Reads
Primary ServersCore clusterYesYesYes
Read ReplicasAuxiliary nodesNoNoYes

​
Architecture Overview

A typical enhanced-read deployment includes:
  1. Primary Consul Servers
    • Usually 3 voting nodes
    • Manage leader elections, writes, and replication
  2. Read Replica Nodes
    • Deployed alongside or in separate datacenters
    • Subscribe to the Raft log for updates
    • Serve only read requests
When read demand increases, simply provision more read replicas and update your service configurations or DNS entries to point read-only clients to these replicas. All write operations continue on your primary cluster, while replicas keep up-to-date via streaming replication.
The image illustrates a system architecture for scaling performance, showing voting members for read/write operations and non-voting members for read operations, with icons representing each component.
The image illustrates a system architecture for scaling performance, showing voting members for read/write operations and non-voting members for read operations, with cluster replication.
Ensure your network allows bidirectional communication between primary servers and read replicas. Replication requires stable connectivity to avoid replication lag.

​
Best Practices

  • Deploy at least three voting servers for high availability.
  • Spread read replicas across failure domains or datacenters.
  • Monitor replication lag via the Consul telemetry API.
  • Use DNS split-horizon or service mesh routing to direct read traffic.

Watch Video