Important

You are viewing the archived documentation of TiDB, which no longer receives updates. It is recommended that you use the latest LTS version of the TiDB database.

tiup cluster display

If you want to see the operation status of each component in the cluster, it is obviously inefficient to log in to each machine one by one. Therefore, tiup-cluster provides the tiup cluster display command to efficiently complete this task.

Syntax

tiup cluster display <cluster-name> [flags]

<cluster-name>: the name of the cluster to operate on. If you forget the cluster name, you can check it with the cluster list command.

Options

--dashboard

By default, all node information of the entire cluster is displayed. With the --dashboard option, only dashboard information is displayed.
Data type: BOOLEAN
This option is disabled by default and its default value is false. To enable this option, you can add this option to the command, and pass the true value or do not pass any value.

-N, --node

Specifies the node to display. If this option is not specified, all nodes are displayed. The value of this option is a comma-separated list of node IDs. If you are not sure about the ID of a node, you can skip this option in the command to show the IDs and status of all nodes in the output.
Data type: STRINGS
If this option is not specified in the command, all nodes are checked by default.

Note

If the -R, --role option is specified at the same time, only the service nodes that match both the specifications of -N, --node and -R, --role are checked.

-R, --role

Specifies the role to display. If it is not specified, all roles are displayed. The value of this option is a comma-separated list of node roles. If you are not sure about the role deployed on a node, you can skip this option in the command to show the roles and status of all nodes in the output.
Data type: STRINGS
If this option is not specified in the command, all roles are displayed by default.

Note

If the -N, --node option is specified at the same time, only the service nodes that match both the specifications of -N, --node and -R, --role are displayed.

-h, --help

Prints the help information.
Data type: BOOLEAN
This option is disabled by default and its default value is false. To enable this option, you can add this option to the command, and pass the true value or do not pass any value.

Outputs

The cluster name
The cluster version
SSH Client Type
Dashboard address
The table with the following fields:
- ID: the node ID, composed of IP:PORT
- Role: the service role deployed on this node (such as TiDB, TiKV)
- Host: the IP of the machine corresponding to the node
- Ports: the port number occupied by the service
- OS/Arch: the operating system and the machine architecture of this node
- Status: the current status of the node service
- Data Dir: the data directory of the service. - means no data directory.
- Deploy Dir: the deployment directory of the service

Node service status

A node service can run in one of the following statuses:

Up: The node service is running normaly.
Down or Unreachable: The node service is not running or a network problem exists on the corresponding host.
Tombstone: The data on the node service has been completely migrated out and the scaling-in is complete. This status exists only on TiKV or TiFlash.
Pending Offline: The data on the node service is being migrated out and the scaling-in is in process. This status exists only on TiKV or TiFlash.
Unknown: The running status of the node service is unknown.

Note

Pending Offline in TiUP, Offline returned by PD API, and Leaving in TiDB Dashboard indicate the same status.

Node service status derives from the PD scheduling information. For more details, see Information collection.

<< Back to the previous page - TiUP Cluster command list