Cluster, node, and shard architecture in Elasticsearch - Mini Project: Build & Apply

Cluster, node, and shard architecture

📖 Scenario: You are setting up a simple Elasticsearch environment to understand how clusters, nodes, and shards work together to store and manage data efficiently.

🎯 Goal: You will create a basic Elasticsearch cluster configuration with nodes and shards, then query the cluster to see shard allocation.

📋 What You'll Learn

Create a cluster configuration with two nodes

Assign 3 primary shards and 1 replica shard to the index

Query the cluster to display shard allocation

💡 Why This Matters

🌍 Real World

Understanding cluster, node, and shard architecture helps in designing scalable and fault-tolerant search systems.

💼 Career

Knowledge of Elasticsearch architecture is essential for roles like DevOps engineers, backend developers, and data engineers working with search and analytics.

1

Create cluster and node settings

Create a dictionary called cluster_settings with the following keys and values: "cluster.name" set to "my_cluster", and "node.name" set to "node_1".

Elasticsearch

# Create cluster_settings dictionary with cluster.name and node.name
# Your code here

Hint

Use a Python dictionary with keys as strings and values as strings.

2

Add index shard configuration

Create a dictionary called index_settings with "number_of_shards" set to 3 and "number_of_replicas" set to 1.

Elasticsearch

cluster_settings = {
    "cluster.name": "my_cluster",
    "node.name": "node_1"
}
# Create index_settings dictionary with number_of_shards and number_of_replicas
# Your code here

Hint

Use integers for shard and replica counts.

3

Simulate shard allocation

Create a list called shard_allocation that contains dictionaries for each shard. Each dictionary should have keys "shard_id" (values 0 to 2) and "node" set to "node_1" for primary shards, and one dictionary with "shard_id" 0 and "node" set to "node_2" for the replica shard.

Elasticsearch

cluster_settings = {
    "cluster.name": "my_cluster",
    "node.name": "node_1"
}

index_settings = {
    "number_of_shards": 3,
    "number_of_replicas": 1
}
# Create shard_allocation list with primary and replica shards
# Your code here

Hint

Use a list of dictionaries to represent shards and their assigned nodes.

4

Display shard allocation

Write a print statement to display the shard_allocation list.

Elasticsearch

cluster_settings = {
    "cluster.name": "my_cluster",
    "node.name": "node_1"
}

index_settings = {
    "number_of_shards": 3,
    "number_of_replicas": 1
}

shard_allocation = [
    {"shard_id": 0, "node": "node_1"},
    {"shard_id": 1, "node": "node_1"},
    {"shard_id": 2, "node": "node_1"},
    {"shard_id": 0, "node": "node_2"}
]
# Print the shard_allocation list
# Your code here

Hint

Use print(shard_allocation) to show the list.

Practice

1. What is a node in Elasticsearch cluster architecture?

easy

A. A single machine that is part of the cluster

B. A group of machines working together

C. A piece of data stored in the index

D. A backup copy of data

Solution

1. Step 1: Understand the definition of a node

   A node is one machine or server that joins the Elasticsearch cluster to share work.

2. Step 2: Differentiate node from cluster and shard

   A cluster is many nodes working together; shards are parts of data inside nodes.

3. Final Answer:

   A single machine that is part of the cluster -> Option A

4. Quick Check:

   Node = single machine [OK]

Hint: Node means one machine in the cluster [OK]

Common Mistakes:

• Confusing node with cluster
• Thinking node is a data piece
• Mixing node with shard

2. Which of the following is the correct way to describe a shard in Elasticsearch?

easy

A. A part of an index that stores data

B. A node in the cluster

C. A full copy of the entire index

D. A cluster of nodes

Solution

1. Step 1: Define what a shard is

   A shard is a smaller piece or partition of an index that holds part of the data.

2. Step 2: Compare with other options

   It is not a full copy (that's a replica), not a node or cluster.

3. Final Answer:

   A part of an index that stores data -> Option A

4. Quick Check:

   Shard = index part [OK]

Hint: Shard means a data part of an index [OK]

Common Mistakes:

• Thinking shard is a full index copy
• Confusing shard with node
• Mixing shard with cluster

3. Consider an Elasticsearch cluster with 3 nodes and an index configured with 5 primary shards and 1 replica per shard. How many total shards will be in the cluster?

medium

A. 5 shards

B. 10 shards

C. 6 shards

D. 15 shards

Solution

1. Step 1: Calculate total shards per primary and replica

   Each primary shard has 1 replica, so total shards = primary shards + replicas = 5 + 5 = 10 shards.

2. Step 2: Understand shard distribution across nodes

   Since there are 3 nodes, shards are distributed but total shards remain 10. However, the question asks total shards in cluster, including replicas.

3. Step 3: Re-check options

   15 shards says 15 shards, which is incorrect. The correct total is 10 shards.

4. Final Answer:

   10 shards -> Option B

5. Quick Check:

   Total shards = primary + replica = 5 + 5 = 10 [OK]

Hint: Total shards = primary shards x (1 + replicas) [OK]

Common Mistakes:

• Counting only primary shards
• Adding nodes to shard count incorrectly
• Confusing replicas with nodes

4. You have an Elasticsearch cluster with 2 nodes and an index with 4 primary shards and 1 replica. You try to assign 2 replicas per shard. What is the problem with this configuration?

medium

A. Replicas must be zero for cluster to work

B. Primary shards must be equal to replica shards

C. Number of nodes must be equal to number of shards

D. You cannot have more replicas than nodes minus one

Solution

1. Step 1: Understand replica shard limits

   Replicas cannot exceed the number of nodes minus one because replicas cannot be on the same node as primary.

2. Step 2: Apply to given cluster

   With 2 nodes, max replicas per shard = 1 (2 - 1). Trying 2 replicas is invalid.

3. Final Answer:

   You cannot have more replicas than nodes minus one -> Option D

4. Quick Check:

   Replicas ≤ nodes - 1 [OK]

Hint: Replicas max = nodes minus one [OK]

Common Mistakes:

• Setting replicas more than nodes - 1
• Confusing primary and replica counts
• Assuming replicas can be zero always

5. You want to design an Elasticsearch cluster for high availability with 4 nodes. You plan to create an index with 6 primary shards and 2 replicas per shard. What is the best shard and replica configuration to avoid shard allocation errors?

hard

A. 6 primary shards and 3 replicas per shard, total 24 shards

B. 6 primary shards and 2 replicas per shard, total 18 shards

C. 6 primary shards and 1 replica per shard, total 12 shards

D. 4 primary shards and 2 replicas per shard, total 12 shards

Solution

1. Step 1: Check replica limit based on nodes

   With 4 nodes, max replicas per shard = nodes - 1 = 3. So 2 replicas is allowed.

2. Step 2: Consider shard allocation rules

   Each shard copy must be on a different node. 6 primary shards + 2 replicas = 18 shards total, but 18 shards on 4 nodes means some nodes hold multiple shards.

3. Step 3: Avoid allocation errors by balancing shards

   Too many shards per node can cause performance issues. 1 replica (total 12 shards) is safer and avoids errors.

4. Final Answer:

   6 primary shards and 1 replica per shard, total 12 shards -> Option C

5. Quick Check:

   Replicas ≤ nodes - 1 and balanced shards [OK]

Hint: Replicas max = nodes - 1; balance shards per node [OK]

Common Mistakes:

• Setting replicas more than nodes - 1
• Ignoring shard distribution limits
• Choosing fewer shards than needed