tiup-component-dm-display.md

title	summary
tiup dm display	tiup-dm 提供了 `tiup dm display` 命令来高效查看集群中每个组件的运行状态。命令语法为 `tiup dm display <cluster-name>`，可指定要查询的节点和角色。输出包括集群名称、版本、SSH 客户端类型，以及节点 ID、角色、IP、端口号、操作系统、状态、数据目录和部署目录等信息。

tiup dm display

如果想查看集群中每个组件的运行状态，逐一登录到各个机器上查看显然很低效。因此，tiup-dm 提供了 tiup dm display 命令来高效完成这件工作。

语法

tiup dm display <cluster-name> [flags]

<cluster-name> 为要操作的集群名字，如果忘记集群名字可查看集群列表。

选项

-N, --node（strings，默认为 []，表示所有节点）

指定要查询的节点，不指定则表示所有节点。该选项的值为以逗号分割的节点 ID 列表，如果不确定要查询节点的 ID，不指定此选项，输出会显示所有节点的 ID 和状态信息。

注意：

若同时指定了 -R, --role，那么将查询它们的交集中的服务状态。

-R, --role（strings，默认为 []，表示所有角色）

指定要查询的角色，不指定则表示所有角色。该选项的值为以逗号分割的节点角色列表，如果不确定要查询节点的角色，不指定此选项，输出会显示所有节点的角色和状态信息。

注意：

若同时指定了 -N, --node，那么将查询它们的交集中的服务状态。

-h, --help

• 输出帮助信息。
• 数据类型：BOOLEAN
• 该选项默认关闭，默认值为 false。在命令中添加该选项，并传入 true 值或不传值，均可开启此功能。

输出

• 集群名称
• 集群版本
• SSH 客户端类型
• 含有以下字段的表格：
  • ID：节点 ID，由 IP:PORT 构成
  • Role：该节点部署的服务角色（如 TiDB 和 TiKV 等）
  • Host：该节点对应的机器 IP
  • Ports：服务占用的端口号
  • OS/Arch：该节点的操作系统和机器架构
  • Status：该节点服务当前的状态
  • Data Dir：服务的数据目录，- 表示没有数据目录
  • Deploy Dir：服务的部署目录

<< 返回上一页 - TiUP DM 命令清单