Updated on 2025-07-29 GMT+08:00

Planning Node Types and Specifications

This topic describes the application scenarios and configuration suggestions for each type of cluster nodes, including data nodes, master nodes, client nodes, and cold data nodes. The aim is to help you properly select and configure nodes for your cluster based on service requirements. It also provides suggestions on selecting node specifications and configuring the node storage type, storage capacity, and node quantity, helping you properly plan the capacities of your cluster.

Planning Node Types

Before creating a cluster, determine the types of nodes to use based on service requirements, query load, data growth patterns, and performance goals.

For each cluster, data nodes are mandatory, while master, client, and cold data nodes are optional. Choose whether to enable the latter three based on your service needs and performance requirements.
Table 1 Introduction to different node types

Node Type

Suggestions on Node Selection

Data node (ESS)

Data nodes are primarily used to store the cluster's data. The functions of the data nodes vary depending on the node types enabled for the cluster.
  • If Master node and Client node are both selected, data nodes will be used for data storage only.
  • If Master node and Client node are both unselected, data nodes will be used for all of the following purposes: cluster management, data storage, cluster access, and data analysis. To ensure reliability, a cluster should have a least three nodes.
  • If Master node is selected but Client node is not, data nodes will be used for data storage, cluster access, and data analysis.
  • If Master node is unselected but Client node is selected, data nodes will be used for data storage and cluster management.

Master node (ess-master)

Master nodes manage cluster-wide operations, including metadata, indexes, and shard allocation. For large-scale deployments, using dedicated master nodes enhances cluster stability, service availability, and centralized control.
  • Large-scale cluster: For a cluster that has more than 10 nodes, you are advised to add dedicated master nodes to effectively manage the cluster status and metadata.
  • Large quantities of indexes and index shards: If the number of indexes or shards exceeds 10,000, master nodes will have better performance handling complex cluster management tasks, avoiding impact on the performance of data nodes.
  • Better management of cluster nodes: Master nodes maintain the cluster metadata, including index mapping, settings, and aliases. For a complex cluster structure, dedicated master nodes offer better management, including node joining, exiting, and fault detection. Master nodes play a critical role in cluster node management.
  • Improved cluster stability and reliability: Dedicated master nodes improve cluster stability and reliability by taking over cluster management responsibilities from data storage and query nodes.
  • Optimized performance for data nodes: By offloading cluster management tasks from data nodes to master nodes, you can allow data nodes to focus on data processing, which leads to improved performance.

Client node (ess-client)

Client nodes route and coordinate search and index requests, offloading processing from data nodes for enhanced query performance and cluster scalability when there are heavy loads.
  • High queries per second (QPS): In the face of a high QPS, a dedicated client node can evenly distribute query requests, reducing the load of data nodes and improving the overall query performance.
  • Complex aggregation queries: For complex, compute-intensive aggregation queries, a client node can dedicate to the handling of aggregation results, thus improving the efficiency and response speed of such queries.
  • Large number of shards: In a cluster with a large number of shards, a client node can effectively coordinate and manage query requests to each shard, improving efficiency in request forwarding and processing.
  • Reducing the load of data nodes: A client node parses search requests, determines the locations of index shards, and coordinates different nodes to execute searches. This reduces the load of data nodes by allowing them to focus on data storage and indexing.
  • Improved cluster scalability: The use of client nodes allows for better cluster scalability and flexibility, enabling support for large datasets and more complex query requirements.

Cold data node (ess-cold)

Cold data nodes are used to store and query latency-insensitive data in large quantities. They offer an effective way to manage large datasets while cutting storage costs.
  • Storage of historical data in large quantities: Cold data nodes offer a more cost-effective solution for storing large quantities of historical data that are infrequently accessed but useful for analytical purposes.
  • Optimizing hot data performance: By migrating cold data to cold data nodes, you reduce the storage load of hot data nodes, thereby optimizing their query and write performance.
  • Insensitivity to query latency: Cold data nodes are a better option for storing data that is insensitive to a high query latency.
  • Cost-effectiveness: Cold data nodes usually use large-capacity disks that offer inexpensive storage.
CAUTION:

If no cold data nodes were enabled during cluster creation, they cannot be added later, so you have to determine whether to use cold data nodes while creating a cluster.

Suggestions on Data Node Configuration

Table 2 Data node configuration

Parameter

Configuration Suggestions

Node Specifications

In the node flavor list, vCPUs | Memory indicate the number of vCPUs and memory capacity available for each flavor, and Recommended Storage indicates the supported storage capacity range. We recommend that you select node specifications based on service needs, such as the data volumes, performance requirements, and your spending budget.

Node Specifications describes the application scenarios and core features of different node specifications. It can help you properly plan your cluster.

For more information about different node specifications, see ECS Types.

Node Storage Type and Capacity

  • If the selected node flavor uses EVS disks, you need to further select Node Storage Type and Capacity based on service requirements.
    • For more on EVS disk performance, see Disk Types and Performance.
    • The value range of node storage capacity is determined by the node flavor you select. The value must be divisible by 20. For how to calculate the required node storage capacity, see Recommended Node Storage Capacity.
    • Node storage capacity cannot be reduced once the cluster is created. Evaluate your long-term data needs and select an appropriate size.
  • If the selected node flavor uses local disks, there is no need to select the node storage type, and the node storage capacity is a fixed value. Both of them are determined by the local disk specifications.

Nodes

  • If master nodes are configured, the number of data nodes ranges from 1 to 200.
  • If no master nodes are configured, the number of data nodes ranges from 1 to 32.
  • To ensure cluster availability, you should configure at least three data nodes. For how to calculate the number of nodes needed, see Recommended Node Quantity.

If the number of data nodes in your cluster is not evenly divisible by the number of AZs, data distribution may become unbalanced across nodes. This will negatively impact both query and write performance.

Suggestions on Master Node Configuration

Table 4 Master node configuration

Parameter

Configuration Suggestions

Node Specifications

In the node flavor list, vCPUs | Memory indicate the number of vCPUs and memory capacity available for each flavor, and Recommended Storage indicates the supported storage capacity range.

For a large-scale cluster with a large number of index shards, use large-capacity nodes as master nodes.

Master nodes support EVS disks only. For more information about different node specifications, see ECS Types.

Node Storage Type and Capacity

Select an appropriate storage type and capacity for master nodes.

Nodes

The number of master nodes can be 3, 5, 7, or 9.

For split-brain protection, the number of master nodes must be an odd number. For the recommended master node quantity, see Recommended Master Node Quantity.

Suggestions on Client Node Configuration

Table 6 Client node configuration

Parameter

Configuration Suggestions

Node Specifications

In the node flavor list, vCPUs | Memory indicate the number of vCPUs and memory capacity available for each flavor, and Recommended Storage indicates the supported storage capacity range.

For a cluster with heavy read and write traffic, use large-capacity nodes as client nodes.

Client nodes support EVS disks only. For more information about different node specifications, see ECS Types.

Node Storage Type and Capacity

Select an appropriate storage type and capacity for client nodes.

Nodes

The number of client nodes ranges from 1 to 32.

For the recommended client node quantity, see Recommended Client Node Quantity.

Suggestions on Cold Data Node Configuration

Table 8 Cold data node configuration

Parameter

Configuration Suggestions

Node Specifications

In the node flavor list, vCPUs | Memory indicate the number of vCPUs and memory capacity available for each flavor, and Recommended Storage indicates the supported storage capacity range. We recommend that you select node specifications based on service needs, such as the data volumes, performance requirements, and your spending budget.

Node Specifications describes the application scenarios and core features of different node specifications. It can help you properly plan your cluster.

For more information about different node specifications, see ECS Types.

Node Storage Type and Capacity

  • If the selected node flavor uses EVS disks, you need to further select Node Storage Type and Capacity based on service requirements.
    • For more on EVS disk performance, see Disk Types and Performance.
    • The value range of node storage capacity is determined by the node flavor you select. The value must be divisible by 20. For how to calculate the required node storage capacity, see Recommended Node Storage Capacity.
    • Node storage capacity cannot be reduced once the cluster is created. Evaluate your long-term data needs and select an appropriate size.
  • If the selected node flavor uses local disks, there is no need to select the node storage type, and the node storage capacity is a fixed value. Both of them are determined by the local disk specifications.

Nodes

The value range for cold data nodes is 1 to 32.

For how to calculate the number of nodes needed, see Recommended Node Quantity.

If the number of cold data nodes in your cluster is not evenly divisible by the number of AZs, data distribution may become unbalanced across nodes. This will negatively impact both query and write performance.