---
title: "DOOBA | OceanBase 文档中心"
description: DOOBA DOOBA 是 OceanBase 数据库内部的一个运维脚本，用于性能监控，使用 Python 语言开发，且仅支持 Python 2.7。本文将详细介绍如何使用 DOOBA 对 OceanBase 数据库性能进行监控。 使用方法 DOOBA 的原理是使用 MySQL 命令连接到 OceanBase 的 S…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# DOOBA

更新时间：2024-06-06 15:15:22

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.4/zh-CN/1800.supporting-tools/700.dooba.md)  

DOOBA 是 OceanBase 数据库内部的一个运维脚本，用于性能监控，使用 Python 语言开发，且仅支持 Python 2.7。本文将详细介绍如何使用 DOOBA 对 OceanBase 数据库性能进行监控。

## 使用方法

DOOBA 的原理是使用 MySQL 命令连接到 OceanBase 的 SYS 租户中，实时展示租户 SQL 的 QPS（包括 select、update、insert、delete、commit）以及相应 SQL 的平均延时（RT）。同时还可以展示各个节点的 SQL 的 QPS 以及 RT 等。

DOOBA 工具的脚本文件 [dooba.py](https://github.com/oceanbase/oceanbase/blob/master/script/dooba/dooba)，可以在 OceanBase 数据库开源社区中查看。

运行 DOOBA 需要使用 MySQL 客户端，若您没有 MySQL 客户端，需要安装一个。

> **说明**
>
>  
>
> 早期的 OBPROXY（版本低于 2.0.0）可能不完全兼容 MySQL 8.0 的连接协议，因此，您需尽量安装版本为 5.5/5.6/5.7 的 MySQL 客户端。

DOOBA 使用命令如下：

```sql
python dooba.py -h OBPROXY地址 -u root@sys#集群名 -P OBPROXY端口 -p密码

// 例如：
python dooba.py -h 172.20.249.54 -u root@sys#obce-3zones -P 2883 -pxxxxxx

```

登录后常用的快捷键如下：

- `c`：选择租户，一般是观察业务租户的性能。
 - `1`：查看快捷键。

  > **注意**
  >
  >  
  >
  > 快捷键界面中没有提到的快捷键尽量不要使用，我们不保证其功能正确。
 - `2`：查看租户性能概览。
 - `3`：查看租户各个节点的性能概览，但如果节点很多则会显示不全。
 - `tab`：在各个 widget 之间跳转。
 - `d`：删除 tab 焦点所在的 widget。
 - `R`：恢复当前界面所有的 widget 布局（包括被删除的）。

> **说明**
>
>  
>
> 脚本 DOOBA 的源码可以直接编辑查看，您可使用命令 `vim dooba.py` 进行查看。工具中各个缩写对应的含义在源码里都能找到解释。

## 租户性能概览

使用快捷键 `2` 可查看租户性能概览，主要是查看租户层面的 SQL 语句的 QPS、RT 以及内存、IO 等实时信息。

DOOBA 的性能数据取自 SYS 租户的内部视图 `gv$sysstat`。DOOBA 的监控信息均可使用 SQL 语句直接查看，可以参考 DOOBA 做类似的监控产品。

```unknow
# 取 QPS 和 RT 信息
SELECT t1.con_id tenant_id,t2.zone, t1.svr_ip,t1.svr_port , t1.stat_id, t1.name, t1.value
FROM gv$sysstat t1 JOIN  __all_server t2 ON (t1.svr_ip=t2.svr_ip and t1.svr_port=t2.svr_port) JOIN __all_resource_pool t3 ON (t1.con_id=t3.tenant_id) JOIN __all_unit_config t4 ON (t3.unit_config_id=t4.unit_config_id)
WHERE  t1.con_id IN (1001)
and stat_id in (10000,10004,10005,10006,30007,30008,30009,40000,40001,40002,40003,40004,40005,40006,40007,40008,40009,40010,40011,40012,40013,50000,50001,50002,50003,50004,50005,50006,50007,50008,50009,50010,50011,60000,60002,60003,60005,130000,130001,130002,130004)
ORDER BY t1.con_id, t2.zone, t1.svr_ip, t1.svr_port;

```

使用该 SQL 语句可以取出所有节点的性能数据，汇总就是整个租户的性能数据。

![租户性能图](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/8508588361/p365164.png)

这个界面主要关注点：

- `SQL COUNT`

  QPS 信息，包括各类 SQL 语句的每秒执行次数。 SQL 类型分别为 select、insert、update、 delete、replace、commit、rollback。

  其中，前四类 SQL 总数和 commit 的比值大致可以推出事务的平均语句数。rollback 是回滚的信息，如果太高，很有可能是数据库有问题或者业务设计有问题。
 - `SQL RT`

  SQL 每次平均执行耗时，包括各类 SQL 语句的每次平均执行耗时，单位为毫秒（ms）。SQL 类型分别为 select、insert、update、 delete、replace、commit。

  其中，前四类可以看出 SQL 正常情况下的执行耗时水平。如果有大幅变动，可能是因为数据量突增、有 SQL 缺乏索引、有锁等待或 CPU 瓶颈等等，具体分析需要结合 SQL 审视视图 `gv$sql_audit` 验证。

  commit 的平均执行耗时也可以反映事务的大小。OceanBase 数据库的 commit 会同步事务所有的事务日志（clog）到多数派节点（包括自身），这个时间会反映在 commit 的耗时里，即 commit 耗时包含多数派同步事务日志的时间。如果这个值突然增长很大，说明可能有突发的大事务。当节点网络性能下降时或者时间同步误差变大时，都可能导致 commit 耗时增长。
 - `RPC`

  反馈网络信息，后续待完善，您暂时可不用关注。
 - `Memory`

  Memstore 内存的实时监控。默认情况下，租户可用内存的一半用于 Memstore 的内存，用于存放业务写操作带来的变化的数据。

  OceanBase 数据库的特色之一就是只记录数据的变化部分，并且数据会尽可能的维持在内存里不落盘，直到增量内存利用率达到阈值（参数 `freeze_trigger_percentage`）后触发转储或合并才将数据落盘并释放内存。

  下面介绍一下转储和合并的概念：

     - 转储是内存中增量数据直接写到磁盘暂存。类似与传统数据库的 `checkpoint`，对租户性能影响很小并且可以调优。
     - 合并是内存中增量数据跟磁盘中基线数据在内存中合并为最新的数据块（`sstable`）再写回到数据文件中。合并对租户性能影响稍大一些并且也是可以调优的。

  通常会建议尽量发起转储，等凌晨低峰期时再发起合并操作。合并可以定时触发，也可以手动触发。当转储次数（参数 `minor_freeze_times` ）用尽时也会自动触发合并。

  Memory 显示的就是增量内存的变化量、累积量和增量内存使用水位。监控结果结合视图 `gv$mem_store` 基本上可以定位所有的增量内存不足问题。

     - 当内存水位增长到参数 `freeze_trigger_percentage` 的值就会触发转储。
     - 当水位继续增长到租户限速阈值（租户参数 `writing_throttling_trigger_percentage` ）会触发租户写入限速。
     - 当水位增长到接近 100% 的时候，租户内存耗尽，业务写会大量报错（`Over tenant memory limit1`）。

  调优参数 `freeze_trigger_percentage` 和转储内部并发数可以将租户的内存水位控制在一个合理的安全的范围内。
 - `IOPS`

  磁盘 IO 的实时监控。

     - `SESS`：会话数，仅供参考，量大的时候可能会不准。
     - `IOR`：读 IOPS。
     - `IOR-SZ`：读 IO 吞吐量，当第一次读入数据或者数据不在内存中就会有读物理 IO。读物理 IO 如果非常高，会导致 SQL 的平均延时水平很高，说明内存不足，对 IO 依赖性变大，很可能导致 IO 触达瓶颈。
     - `IOW`：写 IOPS。
     - `IOW-SZ`：写吞吐量，平时很少有写 IO，因为 OceanBase 数据库的写都在内存里，只有转储和合并的时候能获取到短暂的密集的写 IO。

## 租户节点性能概览

使用快捷键 `3` 可查看租户各个节点的性能概览，主要查看租户在各个节点使用 SQL 语句的 QPS、RT 以及一些缓存命中率等。

```unknow
# 取节点 CPU
SELECT t1.con_id tenant_id,t2.zone, t1.svr_ip,t1.svr_port , round(t1.value/(100*t4.max_cpu), 3) cpu_usage
FROM gv$sysstat t1 JOIN  __all_server t2 ON (t1.svr_ip=t2.svr_ip and t1.svr_port=t2.svr_port) JOIN __all_resource_pool t3 ON (t1.con_id=t3.tenant_id) JOIN __all_unit_config t4 ON (t3.unit_config_id=t4.unit_config_id)
WHERE  t1.con_id IN (1001) and t1.stat_id=140006  
ORDER BY t1.con_id, t2.zone, t1.svr_ip, t1.svr_port;

```

![租户节点性能图](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/8508588361/p365165.png)

这个界面主要关注点有：

- 活跃会话数

  仅供参考，不是严格精准。
 - CPU 利用率

  这里显示的是 OceanBase 数据库内部统计的各个节点的 CPU 利用率，不是 OS 里看到的 CPU 利用率（OceanBase 是单进程软件）。
 - 各个缓存的命中率

  这里有 `Cache Block` 以及 `Cache Block Index` 的缓存命中率。主要关注前者（即 `Cache Block`），理想情况是 99% 或者 100%。当初次读入大量数据、或者内存有瓶颈、或者合并后，这个利用率会低于 99%，甚至低于 90%。如果长期低于 80%，则说明内存瓶颈问题很严重。其他行缓存命中率则不需要太过关注。
 - 物理 IO 读写

  这里是各个节点的物理 IO 信息，具有很大参考意义。
 - SQL 的 QPS 以及 RT 信息

  各个节点的 QPS 可以看出租户请求在各个节点的流量比例关系，相应的 RT 可以看出各个节点的性能状况。

  其中，最后两个 SLC 和 SRC 表示节点上的本地 SQL 和远程 SQL 执行次数信息。通常本地 SQL 的性能会比远程 SQL 性能好，所以这里需要留意远程 SQL 的比例。

  如果比例很高，这个节点的 CPU 利用率、SQL 的 RT 均值都会比较高。这种情况下就需要分析原因。可能是租户 `PRIMARY_ZONE` 不适合打散或者表结构设计不合理，可以考虑使用表分组、调整 `PRIMARY_ZONE` 或 `UNIT_NUM` 等等。

 上一篇 下一篇 ![有帮助](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) 咨询热线