DAX cluster components
An Amazon DynamoDB Accelerator (DAX) cluster consists of AWS infrastructure components. This section describes these components and how they work together.
Topics
Nodes
A node is the smallest building block of a DAX cluster. Each node runs an instance of the DAX software, and maintains a single replica of the cached data.
You can scale your DAX cluster in one of two ways:
-
By adding more nodes to the cluster. This increases the overall read throughput of the cluster.
-
By using a larger node type. Larger node types provide more capacity and can increase throughput. (You must create a new cluster with the new node type.)
Every node within a cluster is of the same node type and runs the same DAX caching
software. For a list of available node types, see Amazon DynamoDB pricing
Clusters
A cluster is a logical grouping of one or more nodes that DAX manages as a unit. One of the nodes in the cluster is designated as the primary node, and the other nodes (if any) are read replicas.
The primary node is responsible for the following:
-
Fulfilling application requests for cached data.
-
Handling write operations to DynamoDB.
-
Evicting data from the cache according to the cluster's eviction policy.
When changes are made to cached data on the primary node, DAX propagates the changes to all of the read replica nodes using replication logs. After the confirmation is received from all read replicas, DynamoDB deletes the replication logs from the primary node.
Read replicas are responsible for the following:
-
Fulfilling application requests for cached data.
-
Evicting data from the cache according to the cluster's eviction policy.
However, unlike the primary node, read replicas don't write to DynamoDB.
Read replicas serve two additional purposes:
-
Scalability. If you have a large number of application clients that need to access DAX concurrently, you can add more replicas for read-scaling. DAX spreads the load evenly across all the nodes in the cluster. (Another way to increase throughput is to use larger cache node types.)
-
High availability. In the event of a primary node failure, DAX automatically fails over to a read replica and designates it as the new primary. If a replica node fails, other nodes in the DAX cluster can still serve requests until the failed node can be recovered. For maximum fault tolerance, you should deploy read replicas in separate Availability Zones. This configuration ensures that your DAX cluster can continue to function, even if an entire Availability Zone becomes unavailable.
A DAX cluster can support up to 11 nodes per cluster (the primary node plus a maximum of 10 read replicas).
Important
For production usage, we strongly recommend using DAX with at least three nodes, where each node is placed in different Availability Zones. Three nodes are required for a DAX cluster to be fault-tolerant.
A DAX cluster can be deployed with one or two nodes for development or test workloads. One- and two-node clusters are not fault-tolerant, and we don't recommend using fewer than three nodes for production use. If a one- or two-node cluster encounters software or hardware errors, the cluster can become unavailable or lose cached data.
Regions and availability zones
A DAX cluster in an AWS Region can only interact with DynamoDB tables that are in the same Region. For this reason, ensure that you launch your DAX cluster in the correct Region. If you have DynamoDB tables in other Regions, you must launch DAX clusters in those Regions too.
Each Region is designed to be completely isolated from the other Regions. Within each Region are multiple Availability Zones. By launching your nodes in different Availability Zones, you can achieve the greatest possible fault tolerance.
Important
Don't place all of your cluster's nodes in a single Availability Zone. In this configuration, your DAX cluster becomes unavailable if there is an Availability Zone failure.
For production usage, we strongly recommend using DAX with at least three nodes, where each node is placed in different Availability Zones. Three nodes are required for a DAX cluster to be fault-tolerant.
A DAX cluster can be deployed with one or two nodes for development or test workloads. One- and two-node clusters are not fault-tolerant, and we don't recommend using fewer than three nodes for production use. If a one- or two-node cluster encounters software or hardware errors, the cluster can become unavailable or lose cached data.
Parameter groups
Parameter groups are used to manage runtime settings for DAX clusters. DAX has several parameters that you can use to optimize performance (such as defining a TTL policy for cached data). A parameter group is a named set of parameters that you can apply to a cluster. You can thereby ensure that all the nodes in that cluster are configured in exactly the same way.
Security groups
A DAX cluster runs in an Amazon Virtual Private Cloud (Amazon VPC) environment. This environment is a virtual network that is dedicated to your AWS account and is isolated from other VPCs. A security group acts as a virtual firewall for your VPC, allowing you to control inbound and outbound network traffic.
When you launch a cluster in your VPC, you add an ingress rule to your security group to allow incoming network traffic. The ingress rule specifies the protocol (TCP) and port number (8111) for your cluster. After you add this rule to your security group, the applications that are running within your VPC can access the DAX cluster.
Cluster ARN
Every DAX cluster is assigned an Amazon Resource Name (ARN). The ARN format is as follows.
arn:aws:dax:
region
:accountID
:cache/clusterName
You use the cluster ARN in an IAM policy to define permissions for DAX API operations. For more information, see DAX access control.
Cluster endpoint
Every DAX cluster provides a cluster endpoint for use by your application. By accessing the cluster using its endpoint, your application does not need to know the hostnames and port numbers of individual nodes in the cluster. Your application automatically "knows" all the nodes in the cluster, even if you add or remove read replicas.
The following is an example of a cluster endpoint in the us-east-1 region that is not configured to use encryption in transit.
dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
The following is an example of a cluster endpoint in the same region that is configured to use encryption in transit.
daxs://my-encrypted-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
Node endpoints
Each of the individual nodes in a DAX cluster has its own hostname and port number. The following is an example of a node endpoint.
myDAXcluster-a.2cmrwl.clustercfg.dax.use1.cache.amazonaws.com:8111
Your application can access a node directly by using its endpoint. However, we recommend that you treat the DAX cluster as a single unit and access it using the cluster endpoint instead. The cluster endpoint insulates your application from having to maintain a list of nodes and keep that list up to date when you add or remove nodes from the cluster.
Subnet groups
Access to DAX cluster nodes is restricted to applications running on Amazon EC2 instances within an Amazon VPC environment. You can use subnet groups to grant cluster access from Amazon EC2 instances running on specific subnets. A subnet group is a collection of subnets (typically private) that you can designate for your clusters running in an Amazon VPC environment.
When you create a DAX cluster, you must specify a subnet group. DAX uses that subnet group to select a subnet and IP addresses within that subnet to associate with your nodes.
Events
DAX records significant events within your clusters, such as a failure to add a
node, success in adding a node, or changes to security groups. By monitoring key events,
you can know the current state of your clusters and, depending upon the event, be able
to take corrective action. You can access these events using the AWS Management Console or the
DescribeEvents
action in the DAX management API.
You can also request that notifications be sent to a specific Amazon Simple Notification Service (Amazon SNS) topic. Then you will know immediately when an event occurs in your DAX cluster.
Maintenance window
Every cluster has a weekly maintenance window to apply system changes. As changes are applied sequentially, an existing node is replaced and a new node with the applied changes is added to the cluster. During this period, your application might observe transient errors or throttles. Therefore, we recommend that you schedule the maintenance window during your lowest usage time and adjust this schedule periodically as needed. You can specify a time range of up to 24 hours in duration during which any maintenance activities that you request should occur.
If you don't specify a preferred maintenance window when you create or modify a cache cluster, DAX assigns a 60-minute maintenance window on a random weekday. This 60-minute maintenance window is randomly selected from an 8-hour block of time for each AWS Region. The following table lists the time blocks for each Region from which the default maintenance windows are assigned.
Region code | Region name | Maintenance window |
---|---|---|
ap-northeast-1 | Asia Pacific (Tokyo) Region | 13:00–21:00 UTC |
ap-southeast-1 | Asia Pacific (Singapore) Region | 14:00–22:00 UTC |
ap-southeast-2 | Asia Pacific (Sydney) Region | 12:00–20:00 UTC |
ap-south-1 | Asia Pacific (Mumbai) Region | 17:30–1:30 UTC |
cn-northwest-1 | China (Ningxia) Region | 23:00–07:00 UTC |
cn-north-1 | China (Beijing) Region | 14:00–22:00 UTC |
eu-central-1 | Europe (Frankfurt) Region | 23:00–07:00 UTC |
eu-north-1 | Europe (Stockholm) Region | 01:00–09:00 UTC |
eu-south-2 | Europe (Spain) Region | 21:00–05:00 UTC |
eu-west-1 | Europe (Ireland) Region | 22:00–06:00 UTC |
eu-west-2 | Europe (London) Region | 23:00–07:00 UTC |
eu-west-3 | Europe (Paris) Region | 23:00–07:00 UTC |
sa-east-1 | South America (São Paulo) Region | 01:00–09:00 UTC |
us-east-1 | US East (N. Virginia) Region | 03:00–11:00 UTC |
us-east-2 | US East (Ohio) Region | 23:00–07:00 UTC |
us-west-1 | US West (N. California) Region | 06:00–14:00 UTC |
us-west-2 | US West (Oregon) Region | 06:00–14:00 UTC |