Radostin Emanuilov
03/26/2026, 10:19 AMahn heesuk
03/26/2026, 2:42 PMahn heesuk
03/26/2026, 2:44 PMahn heesuk
03/26/2026, 2:44 PMRocky
03/26/2026, 2:45 PMreplicas field in your StarRocks cluster configuration.
Why FE doesn't support autoscaling:
FE nodes are responsible for managing metadata and cluster state. Scaling FE nodes (especially Followers) involves maintaining a quorum (an odd number of followers is required for High Availability), which makes them unsuitable for the rapid, automated scaling typical of Horizontal Pod Autoscalers (HPA).
How to scale FE nodes (Manual):
You can scale FE nodes manually by patching the StarRocksCluster resource:
bash
kubectl -n starrocks patch starrockscluster <cluster_name> --type='merge' -p '{"spec":{"starRocksFeSpec":{"replicas":3}}}'
For comparison:
* CN Nodes: Support autoScalingPolicy using HPA (Horizontal Pod Autoscaler) based on CPU or memory utilization.
* BE Nodes: Support manual scaling. Similar to FE, they are not typically autoscaled automatically because scaling in requires data redistribution (decommissioning) to ensure data safety.
If you are looking to scale your cluster dynamically based on query load, it is highly recommended to use CN (Compute Nodes), as they are designed to be stateless and fully support the Operator's autoscaling features.
References
• deployment/sr_operator.md
• administration/management/Scale_up_down.md
• administration/management/FE_configuration.md
• quick_start/helm.mdRadostin Emanuilov
03/26/2026, 2:45 PMahn heesuk
03/26/2026, 2:46 PMRadostin Emanuilov
03/26/2026, 2:47 PMRadostin Emanuilov
03/26/2026, 2:48 PMahn heesuk
03/26/2026, 2:52 PMtemplates/ and register them as observers to the FE Leader.
FE Observers are not part of the quorum but can still handle queries. you could then apply an HPA to the observer group.ahn heesuk
03/26/2026, 2:53 PMRadostin Emanuilov
03/26/2026, 2:55 PMRocky
03/26/2026, 2:55 PMsql
-- Replace <fe_address> with the IP of the new node
-- and <edit_log_port> with its edit_log_port (default is 9010).
ALTER SYSTEM ADD OBSERVER "<fe_address>:9010";
2. Prepare the New Node
On the new server where you want to run the Observer FE:
1. Extract the StarRocks package and navigate to the FE directory.
2. Configure fe/conf/fe.conf:
* Ensure priority_networks is set correctly to the node's network (e.g., priority_networks = 192.168.1.0/24).
* Ensure the meta_dir points to a valid directory for metadata storage.
3. Create the metadata directory:
bash
mkdir -p /path/to/your/meta_dir
3. Start the Observer Node
Start the FE process by pointing it to the existing Leader FE as a helper. This is required for the new node to synchronize the initial metadata.
bash
# Navigate to the FE bin directory
cd fe/bin
# Start the node (replace <leader_ip> and <leader_edit_log_port> with the Leader's info)
./start_fe.sh --helper <leader_ip>:9010 --daemon
Note: You only need the4. Verify the Status Back in your MySQL client, check if the new node has joined successfully:flag the first time you start the node. Subsequent restarts do not require it.--helper
sql
SHOW PROC '/frontends'\G
Look for the row corresponding to your new node's IP. You should see:
* Role: OBSERVER
* Alive: true
* Join: true
Why use an Observer?
Observers are used to scale out the querying capacity of the FE layer. Unlike Followers, they do not participate in the BDBJE voting process (election), meaning they don't add overhead to metadata writes but can handle many read-only requests.
References
• deployment/deploy_manually.md
• sql-reference/sql-statements/cluster-management/nodes_processes/ALTER_SYSTEM.md
• faq/operation_maintenance_faq.md
• administration/Meta_recovery.mdRadostin Emanuilov
03/26/2026, 2:58 PMahn heesuk
03/26/2026, 3:03 PMKevin Cai
03/27/2026, 12:05 PMRadostin Emanuilov
03/27/2026, 1:11 PMRadostin Emanuilov
03/30/2026, 9:26 AM