查看状态

背景信息

openGauss支持查看整个openGauss的状态，通过查询结果确认openGauss或者单个主机的运行状态是否正常。

前提条件

openGauss已经启动。

操作步骤

  1. 以操作系统用户omm登录数据库主节点。
  2. 使用如下命令查询openGauss状态：

1. gs_om -t status --detail

openGauss状态显示结果的参数说明请参见表1。

若要查询某主机上的实例状态，请在命令中增加“-h”项。示例如下：

1. gs_om -t status -h plat2

其中，plat2为待查询主机的名称。

参数说明

表 1 节点角色说明

字段 字段含义 字段值
cluster_state openGauss状态。显示整个openGauss是否运行正常。 - Normal：表示openGauss可用，且数据有冗余备份。所有进程都在运行，主备关系正常。 - Unavailable：表示openGauss不可用。 - Degraded：表示openGauss可用，但存在故障的数据库节点、数据库主节点实例。
node 主机名称 表示该实例所在的主机名称。多AZ时会显示AZ编号。
node_ip 主机IP 表示该实例所在的主机IP。
instance 实例ID 表示该实例的ID。
state 实例角色 - Normal：表示单主机实例。 - Primary：表示实例为主实例。 - Standby：表示实例为备实例。 - Cascade Standby：表示实例为级联备实例。 - Pending：表示该实例在仲裁阶段。 - Unknown：表示实例状态未知。 - Down：表示实例处于宕机状态。 - Abnormal：表示节点处于异常状态。 - Manually stopped：表示节点已经被手动停止。

每个角色也存在不同的状态，例如启动、连接等，其各个状态说明如下：

表 2 节点状态说明

状态 字段含义
Normal 表示节点启动正常
Need repair 当前节点需要修复
Starting 节点正在启动中
Wait promoting 节点正等待升级中，例如备机向主机发送升级请求后，正在等待主机回应时的状态
Promoting 备节点正在升级为主节点的状态
Demoting 节点正在降级中，如主机正在降为备机中
Building 备机启动失败，需要重建
Catchup 备节点正在追赶主节点
Coredump 节点程序崩溃
Unknown 节点状态未知

当节点出现Need repair状态时，可能需要对该节点进行重建使其恢复正常。通常情况下，节点重建原因说明如下：

表 3 节点重建原因说明

状态 字段含义
Normal 表示节点启动正常
WAL segment removed 主机日志/WAL日志不存在，或者备机日志比主机日志新
Disconnect 备机不能连接主机
Version not matched 主备二进制版本不一致
Mode not matched 主备角色不匹配，例如两个备机互联
System id not matched 主备数据库系统id不一致，主备双机要求System ID必须一致
Timeline not matched 日志时间线不一致
Unknown 其他原因

示例

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

1. gs_om -t status --detail
2. [   Cluster State   ]

4. cluster_state   : Normal
5. redistributing  : No
6. current_az      : AZ_ALL

8. [  Datanode State   ]
9. node                           node_ip           port                           instance                                   state
10. ----------------------------------------------------------------------------------------------------------------
11. 1  pekpopgsci00235  10.244.62.204    5432      6001 /opt/gaussdb/cluster/data/dn1   P Primary Normal
12. 2  pekpopgsci00238  10.244.61.81      5432      6002 /opt/gaussdb/cluster/data/dn1   S Standby Normal