---
title: "查看集群信息 | OceanBase 文档中心"
description: "查看集群信息 OceanBase 集群架构包括集群信息、可用区(Zone)、节点等，可以通过命令行查看集群视图或 OCP 管理平台来查看，下面分别对这两种方式进行介绍。 通过命令行查看集群信息 使用 root 用户登录数据库的 sys 租户。 [root@xxxx ~]# obclient -h10.10.10.1 …"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.2.4 企业版 LTS

# 查看集群信息

更新时间：2026-05-29 18:00:34

OceanBase 集群架构包括集群信息、可用区(Zone)、节点等，可以通过命令行查看集群视图或 OCP 管理平台来查看，下面分别对这两种方式进行介绍。

## 通过命令行查看集群信息

1. 使用 `root` 用户登录数据库的 `sys` 租户。

   ```bash
   [root@xxxx ~]# obclient -h10.10.10.1 -P2881 -uroot@sys -p -A
   Enter password:
   Welcome to the OceanBase monitor.  Commands end with ; or \g.
   Your OceanBase connection id is 3221487637

   ```
 2. 进入 `oceanbase` 数据库。

   ```sql
   obclient> use oceanbase;
   Database changed

   ```
 3. 通过视图查看集群相关信息。

      - 通过视图 [v$ob_cluster](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945272) 查看集群 id、集群名字和创建时间等信息。

       ```sql
       obclient> SELECT * FROM v$ob_cluster\G
       *************************** 1. row ***************************
                       cluster_id: 14
                     cluster_name: test3232
                          created: 2022-09-08 14:43:27.254167
                     cluster_role: PRIMARY
                   cluster_status: VALID
                      switchover#: 0
                switchover_status: NOT ALLOWED
                  switchover_info: NONE SYNCED STANDBY CLUSTER
                      current_scn: 1662620251109247
       standby_became_primary_scn: 0
               primary_cluster_id: NULL
                  protection_mode: MAXIMUM PERFORMANCE
                 protection_level: MAXIMUM PERFORMANCE
           redo_transport_options: ASYNC NET_TIMEOUT = 30000000
       1 row in set

       ```
      - 通过视图 `__all_zone` 查看集群中所有的 Zone 信息。

       ```sql
       obclient> SELECT * FROM __all_zone WHERE name='idc';
       +----------------------------+----------------------------+-------+------+-------+------+
       | gmt_create                 | gmt_modified               | zone  | name | value | info |
       +----------------------------+----------------------------+-------+------+-------+------+
       | 2022-09-08 14:43:39.940623 | 2022-09-08 14:44:04.161923 | zone1 | idc  |     0 | HZ0  |
       | 2022-09-08 14:43:39.942688 | 2022-09-08 14:44:04.169328 | zone2 | idc  |     0 | HZ0  |
       | 2022-09-08 14:43:39.943735 | 2022-09-08 14:44:04.175624 | zone3 | idc  |     0 | HZ0  |
       +----------------------------+----------------------------+-------+------+-------+------+
       3 rows in set

       ```

       字段说明：

       | 字段名称 | 描述 |
       | --- | --- |
       | gmt_create | 创建时间 |
       | gmt_modified | 更新时间 |
       | zone | zone 名称 |
       | name | 信息名称 |
       | value | 信息值 |
       | info | 信息值字符串表示 |
      - 通过查看 `__all_server` 视图，可以了解集群中所有的节点的 ip，对外提供的服务端口，内部通信端口，所属可用区，状态等信息。

       ```sql
       obclient> SELECT id,svr_ip,svr_port,zone,inner_port,with_rootserver,status,start_service_time,last_offline_time
             FROM  __all_server;
       +----+----------------+----------+-------+------------+-----------------+--------+--------------------+-------------------+
       | id | svr_ip         | svr_port | zone  | inner_port | with_rootserver | status | start_service_time | last_offline_time |
       +----+----------------+----------+-------+------------+-----------------+--------+--------------------+-------------------+
       |  1 | 10.10.10.1 |     2882 | zone3 |       2881 |               1 | active |   1662619523361997 |                 0 |
       |  2 | 10.10.10.2 |     2882 | zone2 |       2881 |               0 | active |   1662619523371177 |                 0 |
       |  3 | 10.10.10.3 |     2882 | zone1 |       2881 |               0 | active |   1662619523366233 |                 0 |
       +----+----------------+----------+-------+------------+-----------------+--------+--------------------+-------------------+
       3 rows in set

       ```

       字段说明：

       | 字段名称 | 描述 |
       | --- | --- |
       | id | 服务器 ID |
       | svr_ip | IP 地址 |
       | svr_port | 端口 |
       | zone | zone 名称 |
       | inner_port | sql 执行端口 |
       | with_rootserver | 是否RS 所在服务器 |
       | status | observer 状态。 有以下取值：      - active：server 运行正常。     - inactive：server 异常。     - deleting：delete server 进行中。 |
       | start_service_time | 开始服务的时间 |
       | last_offline_time | 最近下线时间 |
      - 通过 `__all_virtual_server_stat` 查看集群资源使用情况。

       ```sql
       obclient> SELECT
           zone,
           concat(svr_ip, ':', svr_port) observer,
           cpu_capacity,
           cpu_total,
           cpu_assigned,
           cpu_assigned_percent,
           mem_capacity,
           mem_total,
           mem_assigned,
           mem_assigned_percent,
           unit_Num,
           round(`load`, 2) `load`,
           round(cpu_weight, 2) cpu_weight,
           round(memory_weight, 2) mem_weight,
           leader_count
           FROM __all_virtual_server_stat
           ORDER BY zone,svr_ip;
       +-------+---------------------+--------------+-----------+--------------+----------------------+--------------+-------------+--------------+----------------------+----------+------+------------+------------+--------------+
       | zone  | observer            | cpu_capacity | cpu_total | cpu_assigned | cpu_assigned_percent | mem_capacity | mem_total   | mem_assigned | mem_assigned_percent | unit_Num | load | cpu_weight | mem_weight | leader_count |
       +-------+---------------------+--------------+-----------+--------------+----------------------+--------------+-------------+--------------+----------------------+----------+------+------------+------------+--------------+
       | zone1 | 10.10.10.1:2882 |           62 |        62 |          5.5 |                    8 |  53687091200 | 53687091200 |  25769803776 |                   48 |        3 | 0.42 |       0.16 |       0.84 |         1585 |
       | zone2 | 10.10.10.2:2882 |           62 |        62 |          5.5 |                    8 |  53687091200 | 53687091200 |  25769803776 |                   48 |        3 | 0.42 |       0.16 |       0.84 |            0 |
       | zone3 | 10.10.10.3:2882 |           62 |        62 |          5.5 |                    8 |  53687091200 | 53687091200 |  25769803776 |                   48 |        3 | 0.42 |       0.16 |       0.84 |            0 |
       +-------+---------------------+--------------+-----------+--------------+----------------------+--------------+-------------+--------------+----------------------+----------+------+------------+------------+--------------+
       3 rows in set

       ```

## 使用 OCP 进行查看集群拓扑图

OCP 提供了集群的拓扑图功能，您可以查看集群和租户中各 Zone 与 OBServer 节点之间的逻辑关系。

登录 OCP 后，在 **集群** 页面的 **集群列表** 区域，选择待操作的集群并单击其集群名。

![集群列表](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/%E9%9B%86%E7%BE%A4%E5%88%97%E8%A1%A8.png)

然后在总览页面的左侧导航栏上，单击 **拓扑图**，即可进入集群拓扑图页面。

![总览拓扑图](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/%E6%80%BB%E8%A7%88%E6%8B%93%E6%89%91%E5%9B%BE.png)

集群的拓扑图上主要包含以下信息：

- 页面左上角展示保护模式信息。
 - 如果该集群为备集群，则备集群上方会显示同步状态。
 - 页面右上角提供了一些功能按钮，您可以通过这些按钮来调整拓扑图的大小或刷新当前拓扑图。

集群拓扑图从上到下主要分为集群、Zone、Server 三层，可通过单击 Zone 下方的 **+** 来展开显示该 Zone 下的所有 Server。

![1主备集群](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/1%E4%B8%BB%E5%A4%87%E9%9B%86%E7%BE%A4.png)

### 集群

集群图标上展示了 OB 集群的 ID、集群类型（主或备）以及集群当前的状态。

备集群图标上方还会展示当前的备库延迟时间。

同时，拓扑图上还提供了集群的管理入口。

对于主集群，您可以对其执行新建备集群、新增 Zone、添加 OBServer、升级版本、修改密码、重启集群、停止集群以及删除集群等操作。

![2主集群1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/2%E4%B8%BB%E9%9B%86%E7%BE%A41.png)

对于备集群，您可以对其执行切为主集群、查看集群等操作。

![3备集群2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/3.%E4%B8%BB%E9%9B%86%E7%BE%A42.png)

### Zone

Zone 图标上展示了 Zone 名称、以及 Zone 当前的状态。

将鼠标悬停在 Zone 图标上，还可以查看当前 Zone下的运行信息，包括 QPS、连接数和 Unit 数。

![拓扑图截图_zone1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/%E6%8B%93%E6%89%91%E5%9B%BE%E6%88%AA%E5%9B%BE_zone1.png)

同时，拓扑图上还提供了 Zone 的管理入口，您可以对 Zone 执行添加 OBServer、重启、停止及删除 Zone 等操作。

![拓扑图截图_zone2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/%E6%8B%93%E6%89%91%E5%9B%BE%E6%88%AA%E5%9B%BE_zone2.png)

### Server

Server 图标上展示了 Server 的 IP 地址以及 Server 当前的状态。

将鼠标悬停在 Server 图标上，还可以查看当前 Server 下的运行信息，包括 QPS、连接数和 SQL 端口。

![6server1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/6.server1.png)

同时，拓扑图上还提供了 Server 的管理入口，您可以对 Server 执行重启、停止服务、停止进程等操作。

![7server2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V3.2.3/zh-CN/2.user-guide/5.basic-database-management/1.manage-clusters/7.server2.png)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
