You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
add AZ_AFFINITY_REPLICAS_AND_PRIMARY read strategy example and diagram (#236)
### Description
Adding documentation for the new read strategy
AzAffinityReplicasAndPrimary
relates to issues valkey-io/valkey-glide#2792
and valkey-io/valkey-glide#3085
<!-- Describe what this change achieves-->
### Issues Resolved
<!-- List any issues this PR will resolve. -->
<!-- Example: closes #1234 -->
### Check List
- [x] Commits are signed per the DCO using `--signoff`
By submitting this pull request, I confirm that my contribution is made
under the terms of the BSD-3-Clause License.
---------
Signed-off-by: Muhammad Awawdi <[email protected]>
Muhammad is a software engineer at AWS ElastiCache, building Valkey GLIDE and large-scale distributed systems. When he’s not building faster tech, he’s lifting weights, grilling barbecue, or geeking out over the latest innovations.
Copy file name to clipboardExpand all lines: content/blog/2024-12-22-az-affinity-strategy.md
+21-3Lines changed: 21 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title= "Reducing application latency and lowering Cloud bill by setting up your client library"
3
3
date= 2025-01-08 01:01:01
4
4
description= "By implementing AZ affinity routing in Valkey and using GLIDE, you can achieve lower latency and cost savings by routing requests to replicas in the same AZ as the client."
How can adjusting your client library help you reduce Cloud costs and improve latency?
8
8
@@ -28,8 +28,9 @@ GLIDE provides flexible options tailored to your application’s needs:
28
28
*```PRIMARY```: Always read from the primary to ensure the freshness of data.
29
29
*```PREFER_REPLICA```: Distribute requests among all replicas in a round-robin manner. If no replica is available, fallback to the primary.
30
30
*```AZ_AFFINITY```: Prioritize replicas in the same AZ as the client. If no replicas are available in the zone, fallback to other replicas or the primary if needed.
31
+
*```AZ_AFFINITY_REPLICAS_AND_PRIMARY```: Prioritize replicas in the same AZ as the client. If no replicas are available in the zone, fallback to the primary in the same AZ. If neither are available, fallback to other replicas or the primary in other zones.
31
32
32
-
In Valkey 8, ```availability-zone``` configuration was introduced, allowing clients to specify the AZ for each Valkey server. GLIDE leverages this new configuration to empower its users with the ability to use AZ Affinity routing. At the time of writing, GLIDE is the only Valkey client library supporting the AZ Affinity strategy, offering a unique advantage.
33
+
In Valkey 8, ```availability-zone``` configuration was introduced, allowing clients to specify the AZ for each Valkey server. GLIDE leverages this new configuration to empower its users with the ability to use AZ Affinity routing. At the time of writing, GLIDE is the only Valkey client library supporting the AZ Affinity strategies, offering a unique advantage.
33
34
34
35
## AZ Affinity routing advantages
35
36
@@ -40,7 +41,7 @@ In Valkey 8, ```availability-zone``` configuration was introduced, allowing cli
40
41
41
42
2.**Minimize Latency** Distance between AZs within the same region— for example, in AWS, is typically up to 60 miles (100 kilometers)—adds extra roundtrip latency, usually in the range of 500µs to 1000µs. By ensuring requests remain within the same AZ, you can reduce latency and improve the responsiveness of your application.
42
43
43
-
**Example:**
44
+
**Example 1:**
44
45
Consider a cluster with three nodes, one primary and two replicas. Each node is located in a different availability zone. The client located in az-2 along with replica-1.
45
46
46
47
**With ```PREFER_REPLICA``` strategy**:
@@ -53,6 +54,20 @@ In Valkey 8, ```availability-zone``` configuration was introduced, allowing cli
53
54
In this case, the client will read commands from a replica in the same client's AZ and the average latency is, for example, about 300 microseconds.
Consider a cluster with three nodes, one primary and two replicas. Each node is located in a different availability zone. The client located in az-2 along with the primary node. The replicas are located in az-1 and az-3.
60
+
61
+
**With ```AZ_AFFINITY``` strategy**:
62
+
In this case, the client attempts to read from a replica in the same AZ. Since none are available in az-2, it falls back to a replica in another AZ, such as az-1 or az-3.
63
+
and the average latency is, for example, about 800 microseconds.
In this case, the client first attempts to read from a replica in the same AZ. Since no local replica exists, it reads from the primary located in az-2. The average latency is, for example, about 300 microseconds.
@@ -152,6 +167,9 @@ Setting up AZ affinity routing in GLIDE is simple, allowing you to leverage its
152
167
## Conclusion
153
168
By implementing AZ affinity routing in Valkey and using GLIDE, you can achieve lower latency and cost savings by routing requests to replicas in the same AZas the client.
154
169
170
+
---
171
+
*Updated May 2025 to cover the `AZ_AFFINITY_REPLICAS_AND_PRIMARY` strategy and a corresponding example.*
0 commit comments