前提条件

集群已经启动。

操作步骤

1. 以omm用户身份登录GaussDB 100所在的任意服务器。
2. 使用如下命令查询集群状态。

   gs_om -t status

   集群状态显示结果的参数说明请参见状态说明。
   

状态说明

• 集群状态详解

  集群状态如表1所示。

  表1 集群状态说明

  字段	字段含义	字段值
  az_state	az状态	fine：正常状态。 cm_stopped:表示cm没有启动无法写入az状态。 split_brain：脑裂状态，主备AZ断网，其他正常。 single_az_down：主或备站点不可用。 static_first：仲裁站点不可用。 single_az：仅主站点可用。 unknown：表示出现未知错误。
  cluster_state	集群状态	Normal：表示集群可用，CN、DN主全部在线。 Unavailable：表示集群不可用，某Group的DN无主，CN全部掉线；或者某Group中online的节点个数小于等于该Group节点总数的一半（节点总数不包含Passive节点）。 Degraded：表示集群可用，但数据没有冗余备份，某Group的DN裸奔（Group只有一个主运行，备全部停止运行且无法启动）/CN裸奔（CN仅有一台online）。 Abnormal：表示集群中CN、DN中某台机器状态不是online。
  balanced	显示是否有集群实例发生过主备切换。	true：集群DN分布与load/reload时保持一致。 false：不一致。

• AZ Status状态详解

  每一行表示一个AZ状态，每个AZ状态包含3个字段：AZ，ROLE，STATUS

  表2 AZ状态说明

  字段	字段含义	字段值
  AZ	站点名称	配置文件中的命名。
  ROLE	站点角色	分为3种角色：主、备、仲裁，对应primary，standby，quorum。
  STATUS	站点状态	ONLINE：站点中至少有一个主机在线。 OFFLINE：站点上所有主机掉线。

• Host Status状态详解

  每一行表示一个Host状态，每个Host包含HOST、AZ、STATUS、IP信息。

  表3 Host状态说明

  字段	字段含义	字段值
  HOST	主机名称	配置文件中的命名，一般是主机名。
  AZ	站点名称	配置文件中的命名，主机所在的站点名。
  STATUS	主机状态	ONLINE：主机在线。 OFFLINE：主机掉线。 STOPPED：实例从未上线或者用户手动停止该实例。
  IP	主机IP	主机的IP。

• 实例详解

  实例包含CM/ETCD/CN/DN/GTS。

  其中静态信息：INSTANCE，ID，HOST，PORT，DataDir，字段值含义针对不同实例基本相同。

  动态信息：STATUS，ROLE，字段值含义针对不同实例有所区别。

  

  当配置文件不配置GTS实例时，可以正常安装集群，只是集群状态中不会显示GTS的实例信息。

  表4 实例静态信息说明

  字段	字段含义	字段值
  INSTANCE	实例名称	配置文件中的实例命令。
  ID	实例ID	实例ID。
  HOST	主机名称	实例所在的主机名。
  PORT	端口	CM不涉及端口，所以不显示； ETCD显示的是Client Port； CN、DB Group显示提供服务的端口。
  DataDir	各实例存储数据的目录	CM不存储本地信息，不涉及，所以不显示。

  表5 CM动态信息说明

  字段	字段含义	字段值
  STATUS	实例状态	ONLINE：实例在线。 OFFLINE：实例掉线。 STOPPED：实例从未上线或者用户手动停止该实例。
  ROLE	实例角色	primary：主CM。 slave：备CM。 空：表示所有CM都不在线，无人抢主。

  表6 ETCD动态信息说明

  字段	字段含义	字段值
  STATUS	实例状态	ONLINE：实例在线。 OFFLINE：实例掉线。 STOPPED：实例从未上线或者用户手动停止该实例。
  ROLE	实例角色	leader：主etcd。 follower：从etcd。 backup：不在etcd集群中，备用。

  表7 CN动态信息说明

  字段	字段含义	字段值
  STATUS	实例状态	ONLINE：实例在线。 OFFLINE：实例掉线。 STOPPED：实例从未上线或者用户手动停止该实例。 NEED_REPAIR：出现故障需要修复。 DELETED：实例由于出现故障被隔离。 UNSTABLE：CN在某种不稳定状态，比如磁盘满、连接满等。 ROUTE_CONFLICT：实例的路由表sys_data_nodes信息与查询出来的集群状态不一致（如主备关系，实例个数，端口号，IP等）。正常情况下，该状态属于中间态，可自动恢复为其他正常状态。
  ROLE	实例角色	no role：CN不分主备，所以没有角色。

  表8 DN(DB Group)动态信息说明

  字段	字段含义	字段值
  STATUS	实例状态	ONLINE：实例在线。 OFFLINE：实例掉线。 STOPPED：实例从未上线或者用户手动停止该实例。 DISCONNECTED：备机与主机失联。 QUERYTIMEOUT：查询状态超时。 NEED_REPAIR：出现故障需要修复。 BUILDING：正在building。 UNSTABLE：DB在某种不稳定状态，比如磁盘满、连接满等。 ROUTE_CONFLICT：实例的路由表sys_data_nodes信息与查询出来的集群状态不一致（如主备关系，实例个数，端口号，IP等）。正常情况下，该状态属于中间态，可自动恢复为其他正常状态。 InitStatus：实例初始状态。
  ROLE	实例角色	primary：主DB。 standby：备DB。 passive：passiveDB。

  表9 GTS动态信息说明

  字段	字段含义	字段值
  STATUS	实例状态	ONLINE：实例在线。 OFFLINE：实例掉线。 STOPPED：实例从未上线或者用户手动停止该实例。 DISCONNECTED：备机与主机失联。 NEED_REPAIR：出现故障需要修复。 UNSTABLE：GTS在某种不稳定状态，比如磁盘满、连接数满等。 ROUTE_CONFLICT：实例的路由表sys_data_nodes信息与查询出来的集群状态不一致（如主备关系，实例个数，端口号，IP等）。正常情况下，该状态属于中间态，可自动恢复为其他正常状态。
  ROLE	实例角色	primary：主GTS。 slave：备GTS。

• 管理IP详解

  每一行表示一个主机上配置的管理IP，管理平面通过管理IP登录主机。

  表10 管理IP信息说明

  字段	字段含义	字段值
  HOST	主机名称	配置文件中的命名，一般是主机名。
  IP	管理平面登录主机所使用的IP	配置文件中innerManageIp1的参数值。如果未配置该参数，则使用backIP。一个主机上可配置多个管理IP。

• 查询信息说明

  记录了用户在执行查询集群状态命令时的执行主机和查询时间。

  表11 查询信息说明

  字段	字段含义	字段值
  HOSTNAME	主机名称	执行查询命令的主机名。
  TIME	当前时间	执行查询命令的当前时间。

• 浮动IP详解

  每一行表示一个主DN上配置的浮动IP。

  表12 浮动IP信息说明

  字段	字段含义	字段值
  HOST	主机名称	配置文件中已配置浮动IP的主DN所在主机的名称。
  主DN名称:主DN所在主机IP	主DN名称：主DN所在主机IP，例如，DB1_1:10.10.0.11。	配置文件中已配置浮动IP的主DN的名称：主DN所在主机IP。
  IP	主DN的浮动IP值	配置文件中主DN的floatIp值。

示例

查看集群详细状态信息，含实例状态信息。

omm@plat1:~> gs_om -t status
Set output to terminal.
--------------------------------------------------------------------Cluster Status--------------------------------------------------------------------
az_state :      fine
cluster_state : Normal
balanced :      true
----------------------------------------------------------------------AZ Status-----------------------------------------------------------------------
AZ:AZ1                ROLE:primary            STATUS:ONLINE      
AZ:AZ2                ROLE:standby            STATUS:ONLINE      
AZ:AZ3                ROLE:quorum             STATUS:ONLINE      
---------------------------------------------------------------------Host Status----------------------------------------------------------------------
HOST:plat1    AZ:AZ1                  STATUS:ONLINE       IP:10.10.0.11
HOST:plat2    AZ:AZ2                  STATUS:ONLINE       IP:10.10.0.12
HOST:plat3    AZ:AZ3                  STATUS:ONLINE       IP:10.10.0.13
----------------------------------------------------------------Cluster Manager Status----------------------------------------------------------------
INSTANCE:CM1          ROLE:primary            STATUS:ONLINE       HOST:plat1    ID:1
INSTANCE:CM2          ROLE:slave              STATUS:ONLINE       HOST:plat2    ID:2
INSTANCE:CM3          ROLE:slave              STATUS:ONLINE       HOST:plat3    ID:3
---------------------------------------------------------------------ETCD Status----------------------------------------------------------------------
INSTANCE:ETCD1        ROLE:follower           STATUS:ONLINE       HOST:plat1    ID:7001     PORT:22231        DataDir:/guassdb/data/data_etcd
INSTANCE:ETCD2        ROLE:follower           STATUS:ONLINE       HOST:plat2    ID:7002     PORT:22231        DataDir:/guassdb/data/data_etcd
INSTANCE:ETCD3        ROLE:leader             STATUS:ONLINE       HOST:plat3    ID:7003     PORT:22231        DataDir:/guassdb/data/data_etcd
----------------------------------------------------------------------CN Status-----------------------------------------------------------------------
INSTANCE:cn_5001      ROLE:no role            STATUS:ONLINE       HOST:plat1    ID:5001     PORT:9079         DataDir:/gaussdb/data/data_cn1
----------------------------------------------------------Instances Status in Group (group1)----------------------------------------------------------
INSTANCE:DB1_1        ROLE:primary            STATUS:ONLINE       HOST:plat1    ID:6001     PORT:15431        DataDir:/gaussdb/data/data_dn
INSTANCE:DB2_1        ROLE:standby            STATUS:ONLINE       HOST:plat2    ID:6002     PORT:15431        DataDir:/gaussdb/data/data_dn
---------------------------------------------------------------------Manage IP------------------------------------------------------------------------
HOST:plat3            IP:10.10.0.19
HOST:plat2            IP:10.10.0.22
HOST:plat1            IP:10.10.0.24
-------------------------------------------------------------------Query Action Info------------------------------------------------------------------
HOSTNAME: plat1       TIME: 2019-09-11 14:16:09.804124
------------------------------------------------------------------------Float Ip------------------------------------------------------------------
HOST:plat1            DB1_1:10.10.0.11    IP:10.10.0.25