Skip to main content
Version: Candidate-4.1

SHOW FRONTENDS

SHOW FRONTENDS views the information of all FE nodes in the cluster, including their IP addresses, ports, roles, and status.

tip

Only users with the SYSTEM-level OPERATE privilege or the cluster_admin role can perform this operation.

Syntax​

SHOW FRONTENDS

Return​

+------+------------------------------+-----------+-------------+----------+-----------+---------+--------+-----------+------+-------+-------------------+---------------------+----------+--------+---------------------+---------------+
| Id | Name | IP | EditLogPort | HttpPort | QueryPort | RpcPort | Role | ClusterId | Join | Alive | ReplayedJournalId | LastHeartbeat | IsHelper | ErrMsg | StartTime | Version |
+------+------------------------------+-----------+-------------+----------+-----------+---------+--------+-----------+------+-------+-------------------+---------------------+----------+--------+---------------------+---------------+

The following table describes the parameters returned by this statement.

ParameterDescription
IdThe unique ID of the FE node.
NameThe name of the FE node in BDBJE (typically IP_EditLogPort_Timestamp).
IPThe IP address of the FE node.
EditLogPortThe port used for BDBJE communication (default: 9010).
HttpPortThe HTTP server port of the FE node (default: 8030). Used for accessing the FE web UI.
QueryPortThe MySQL protocol port (default: 9030). Used by MySQL clients to connect to StarRocks.
RpcPortThe Thrift server port (default: 9020). Used for internal RPC communication.
RoleThe role of the FE node.
  • LEADER: The master node, handles metadata writes.
  • FOLLOWER: Participates in elections and metadata syncing.
  • OBSERVER: Syncs metadata but does not participate in elections.
ClusterIdThe unique ID of the cluster. All nodes in the same cluster must have the same ClusterId.
JoinWhether the node has joined the BDBJE group.
  • true: Joined.
  • false: Not joined (note: a node might be removed but still show true temporarily).
AliveWhether the node is alive and responding.
  • true: Alive.
  • false: Not alive.
ReplayedJournalIdThe maximum metadata journal ID that the node has currently replayed. Used to check if the node is in sync with the Leader.
LastHeartbeatThe timestamp of the last heartbeat received.
IsHelperWhether the node is a Helper node (specified during cluster startup to help other nodes join).
ErrMsgError message displayed if the heartbeat fails
StartTimeThe time when this FE process was started.
VersionThe StarRocks version running on this FE node.

Example​

View the information of all FE nodes in the cluster.

mysql> SHOW FRONTENDS\G;
*************************** 1. row ***************************
Id: 1
Name: 127.0.0.1_9010_1766983864084
IP: 127.0.0.1
EditLogPort: 9010
HttpPort: 8030
QueryPort: 9030
RpcPort: 9020
Role: LEADER
ClusterId: 391198626
Join: true
Alive: true
ReplayedJournalId: 59720
LastHeartbeat: 2026-01-21 13:24:20
IsHelper: true
ErrMsg:
StartTime: 2026-01-20 12:58:48
Version: 4.0.2-1f1aa9c
1 row in set (0.01 sec)
Rocky the happy otterStarRocks Assistant

AI generated answers are based on docs and other sources. Please test answers in non-production environments.