---
title: "一键诊断分析内存 - 敏捷诊断工具 V3.3.0 | OceanBase 文档中心"
description: 一键诊断分析内存 本文适用于独立部署 obdiag 的场景，使用 obdiag analyze memory 命令可对 OceanBase 集群的日志进行分析，基于日志中打印的内存信息生成内存分析报告。 如果是 obd 部署的集群，可直接通过 obd 侧诊断命令组对所选集群进行分析，详细命令可参考 诊断工具命令组 。…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*5ZXST55u540AAAAAAAAAAAAADiGDAQ/original) 敏捷诊断工具V 3.3.0

# 一键诊断分析内存

更新时间：2026-04-13 17:11:14

[编辑](https://github.com/oceanbase/odt-doc/edit/V3.3.0/zh-CN/450.analyze/507.analyze_memory.md)  

本文适用于独立部署 obdiag 的场景，使用 `obdiag analyze memory` 命令可对 OceanBase 集群的日志进行分析，基于日志中打印的内存信息生成内存分析报告。

如果是 obd 部署的集群，可直接通过 obd 侧诊断命令组对所选集群进行分析，详细命令可参考 [诊断工具命令组](https://www.oceanbase.com/docs/community-obd-cn-10000000002049483)。

## 使用说明

```shell
obdiag analyze memory [options]

```

使用该命令可以一键在线分析 OceanBase 集群的日志，基于日志中打印的内存信息生成内存分析报告。或者通过 `--files` 开启离线分析模式。

选项说明如下：

| 选项名 | 是否必选 | 数据类型 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --from | 否 | string | 默认为空 | 日志收集的开始时间，格式为: `yyyy-mm-dd hh:mm:ss`。   #### 说明    若使用的 obdiag 为 V2.0.0 之前版本，配置该选项时无需加引号，否则会报错。V2.0.0 及之后版本不再限制配置该选项时是否加引号。 |
| --to | 否 | string | 默认为空 | 日志收集的结束时间，格式为: `yyyy-mm-dd hh:mm:ss`。   #### 说明    若使用的 obdiag 为 V2.0.0 之前版本，配置该选项时无需加引号，否则会报错。V2.0.0 及之后版本不再限制配置该选项时是否加引号。 |
| --since | 否 | string | 默认为空 | 日志收集最近的某段时间，格式为: `<n> <m\|h\|d>`，其中，`n` 表示待输入的时间数字，`m` 表示分钟，`h` 表示小时，`d` 表示天，例如 `30m` 表示分析最近 30 分钟的日志。 |
| --store_dir | 否 | string | 默认为命令执行的当前路径 | 存储结果的本地路径。 |
| --temp_dir | 否 | string | `/tmp` | 远端节点在日志收集过程中产生的临时文件存储目录。 |
| --files | 否 | string | 默认为空 | `--files` 是离线分析日志文件模式，一旦指定 `--files` 则进入离线分析日志模式，需要传递本 OceanBase 集群日志或者日志路径，离线分析模式下 `--from`、`--to`、`--since` 设置将不需要设置，但需要指定 OceanBase 数据库版本（`--version`） |
| --version | 否 | string | 默认为空 | 当指定 `--files` 进行离线分析的时候需要传递 OceanBase 数据库的版本，在线分析的时候无需传递此参数 |
| -c | 否 | string | `~/.obdiag/config.yml` | 配置文件路径。 |
| --inner_config | 否 | string | 默认为空 | obdiag 自用的配置。 |
| --config | 否 | string | 默认为空 | 需被 obdiag 诊断的集群的配置，固定样式：`--config key1=value1 --config key2=value2`。   #### 说明    支持通过该选项配置的参数可参见 [obdiag 配置](https://www.oceanbase.com/docs/common-obdiag-cn-1000000002821464)。 |

#### 说明

- 本文所指的在线分析指的是 OceanBase 集群在线运行状态，日志分布在各个 OBServer 节点上。
 - 本文所指的离线分析模式是 `--files` 和 `--version` 参数传递下，可以分析已经收集到 obdiag 部署机器上的 OBServer 日志。

## 使用示例

### 方式一：无配置文件使用（开箱即用）

- 在线分析日志示例：

  ```shell
  obdiag analyze memory --from "2023-10-08 10:25:00" --to "2023-10-08 11:30:00" \
    --config obcluster.servers.nodes[0].ip=xx.xx.xx.1 \
    --config obcluster.servers.nodes[1].ip=xx.xx.xx.2 \
    --config obcluster.servers.global.ssh_username=test \
    --config obcluster.servers.global.ssh_password=****** \
    --config obcluster.servers.global.home_path=/home/admin/oceanbase

  ```
 - 快捷分析最近一段时间的日志：

  ```shell
  # 在线分析最近一小时的日志，该指令执行的时候会从远程主机上拉取最近一小时的日志进行分析
  obdiag analyze memory --since 1h \
    --config obcluster.servers.nodes[0].ip=xx.xx.xx.1 \
    --config obcluster.servers.nodes[1].ip=xx.xx.xx.2 \
    --config obcluster.servers.nodes[2].ip=xx.xx.xx.3 \
    --config obcluster.servers.global.home_path=/home/admin/oceanbase

  # 在线分析最近一小时的日志，该指令执行的时候会从远程主机上拉取最近一小时的日志进行内存分析
  # 提供 sys 租户的连接信息，让 obdiag 自动帮你获取集群各节点的 IP 地址
  obdiag analyze memory --since 1h \
    --config db_host=xx.xx.xx.xx \
    --config db_port=xxxx \
    --config tenant_sys.user=root@sys \
    --config tenant_sys.password=*** \
    --config obcluster.servers.global.ssh_username=test \
    --config obcluster.servers.global.ssh_password=****** \
    --config obcluster.servers.global.home_path=/home/admin/oceanbase

  # 在线分析最近 30 分钟的日志，生成内存分析报告
  # 提供 sys 租户的连接信息，让 obdiag 自动帮你获取集群各节点的 IP 地址
  obdiag analyze memory --since 30m \
    --config db_host=xx.xx.xx.xx \
    --config db_port=xxxx \
    --config tenant_sys.user=root@sys \
    --config tenant_sys.password=*** \
    --config obcluster.servers.global.ssh_username=test \
    --config obcluster.servers.global.ssh_password=****** \
    --config obcluster.servers.global.home_path=/home/admin/oceanbase

  ```
 - 离线分析日志示例

  ```shell
  $ ls -lh test/
  -rw-r--r--  1 admin  staff   256M Oct  8 17:24 observer.log.20231008104204260
  -rw-r--r--  1 admin  staff   256M Oct  8 17:24 observer.log.20231008111305072
  -rw-r--r--  1 admin  staff   256M Oct  8 17:24 observer.log.20231008114410668

  $ obdiag analyze memory --files test/ --version 4.2.0.0

  ```
 - 离线分析指定 observer 日志：

  ```shell
  obdiag analyze memory --files observer.log.20230831142211247 --version 4.2.2.0

  ```

### 方式二：有配置文件使用

需要确保已经在 obdiag 配置文件 `~/.obdiag/config.yml` 中配置好需要收集节点的登录信息。相关的详细配置介绍，参见 [obdiag 配置](https://www.oceanbase.com/docs/common-obdiag-cn-1000000002821464)。

  ```shell
  obdiag analyze memory --from "2023-10-08 10:25:00" --to "2023-10-08 11:30:00"

  ```shell
  # 在线分析最近一小时的日志，该指令执行的时候会从远程主机上拉取最近一小时的日志进行分析
  obdiag analyze memory --since 1h

  # 在线分析最近 30 分钟的日志，该指令执行的时候会从远程主机上拉取最近30分钟的日志进行分析
  obdiag analyze memory --since 30m

  ```
 - 离线分析指定 observer 日志：

  ```shell
  # 离线分析指定的日志文件
  obdiag analyze memory --files observer.log.20230831142211247

  ```

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