OMS 日志排查 | OceanBase 文档中心

OMS 日志排查

更新时间：2026-04-14 15:35:51

OMS 日志的默认目录为 /home/admin/logs/。本文为您介绍 OMS 各组件的日志。

说明

如果您需要查看 OMS 的日志，则必须登录至部署 OMS 的机器，然后进入 OMS 的容器。执行以下命令，进入部署 OMS 的容器：

docker exec -it <oms_container_name> bash

Console 组件日志

Console 组件日志的默认目录为 /home/admin/logs/ghana/Ghana。Console 组件日志分类见下表：

日志类型	描述	日志保留策略
`common-default.log`	`INFO`、`WARNING` 和 `ERROR` 级别日志。	按天归档后压缩，保留 15 天
`common-error.log`	`ERROR` 级别日志。如果 OMS 报错，在此日志搜索报错时间，定位报错原因。	按天归档后压缩，保留 15 天
`oms-scheduler.log`	后台调度日志。	按天归档后压缩，保留 6 天
`oms-step.log`	迁移同步任务步骤执行日志。	按天归档后压缩，保留 6 天
`oms-api.log`	外部 API 调用日志。	按天归档后压缩，保留 6 天
`database.log`	数据库调用日志。	按天归档后压缩，保留 6 天
`oms-web.log`	外部访问 Console 日志，主要包括 URL、请求路径、执行耗时和接口响应结果。	按天归档后压缩，保留 6 天
`oms-alarm.log`	告警相关日志。	按天归档后压缩，保留 6 天
`dbcat.log`	结构迁移组件 DBCat 的日志。 SQL 查询报错时，在此日志中筛选 `ERROR` 关键字即可获得对应错误原因。	按天归档后压缩，保留 3 天
`oms-ha.log`	服务高可用相关日志。	按天归档后压缩，保留 6 天

CM 组件日志

CM 组件日志的默认目录为 /home/admin/logs/cm/log。CM 组件日志分类见下表：

日志类型	描述	日志保留策略
`cm-scheduler.log`	后台调度日志	按小时归档后压缩，保留最近 72 个日志文件，删除超过 3 天未修改的日志文件
`error-details.log`	错误码信息日志	按小时归档后压缩，保留最近 72 个日志文件，删除超过 3 天未修改的日志文件
`meta-db.log`	数据库调用日志	按小时归档后压缩，保留最近 72 个日志文件，删除超过 3 天未修改的日志文件
`service.log`	服务层执行日志	每 12 个小时归档一次后压缩，保留最近 14 个日志文件，删除超过 7 天未修改的日志文件
`common-error.log`	ERROR 级别日志如果 OMS 报错，在该日志中搜索报错时间，定位报错原因。	每 12 个小时归档一次后压缩，保留最近 14 个日志文件，删除超过 7 天未修改的日志文件
`common-default.log`	INFO、WARNING 和 ERROR 级别日志	每 12 个小时归档一次后压缩，保留最近 14 个日志文件，删除超过 7 天未修改的日志文件
`controller.log`	外部 API 调用日志	每 12 个小时归档一次后压缩，保留最近 14 个日志文件，删除超过 7 天未修改的日志文件
`cm-api.log`	Jetty 的 HTTP 请求信息日志	不压缩，每 24 个小时归档一次，保留 3 天日志文件

Store 组件日志

Store 组件日志的默认目录为 /home/ds/store/store{storeport}/log。您也可以在 OMS 控制台查看 Store 组件日志。步骤如下：

登录 OMS 控制台。
在左侧导航栏，单击 数据同步。
在 数据同步 页面，单击目标数据同步任务的名称，进入详情页面。
单击页面右上角的 查看组件监控，查看相应的 Store 组件 ID，在组件 ID 中可以获取端口信息。

您可以进入 OMS 控制台，通过以下两种方式查看 Store 组件的日志。
- 进入 查看组件监控 页面，单击目标组件后的 查看日志。
- 进入 运维监控 > 组件 > Store 页面，单击目标 Store 后的 查看日志。

Store 组件日志分类见下表：

日志类型	描述	日志保留策略
`store.log`	Store 组件的标准输出和标准错误输出会重定向到该日志。如果您在其他日志文件中找不到有效错误信息，可以检查此日志。	无压缩，保留 1 个文件
`congo.log`	此日志记录启动 Store 上的 Reader（事务日志抓取任务）时的相关的配置项。MySQL Reader 将 Binlog 拉取和解析相关的日志也记录在此日志中。定位 MySQL Reader 的问题时，您可以在此日志文件中搜索 `ERROR` 日志。如果找不到有效信息，您可以从数据目录下的 `meta.log` 文件中查找。Store 组件的数据目录名由配置文件 `conf/crawler.conf` 中的 `subTopic` 和 `subId` 两个配置项组成，格式为 `${subTopic}.${subId}`。	无压缩，单个文件 256 MB，最多保留 12 个文件（即 3 GB）
`liboblog.log`/`libobcdc.log`	此日志记录 OceanBase Reader 启动后的拉取和解析相关的日志，定位 OceanBase Reader 问题时查看此日志。 OceanBase Store V2.x 和 V3.x 的日志名称为 `liboblog.log`，V4.x 的日志名称为 `libobcdc.log`。	无压缩，单个文件 256 MB，默认保留 40 个文件（大小为 10 GB）
`connector.log`	此日志记录 Oracle、DB2 LUW 和 PostgreSQL 的 Reader 在启动后的拉取和解析相关的日志。定位以上数据源的 Reader 相关问题时查看此日志。	按小时归档后压缩，最多保留 7 天或 2 GB

Full-Import/Incr-Sync 组件日志

Full-Import/Incr-Sync 组件日志的默认目录为 /home/ds/run/{name}/logs。您也可以在 OMS 控制台查看 Full-Import/Incr-Sync 组件日志。步骤如下：

登录 OMS 控制台。
在左侧导航栏，单击 数据迁移。
在 数据迁移 页面，单击目标数据迁移任务的名称，进入详情页面。
单击页面右上角的 查看组件监控，查看相应的 Full-Import/Incr-Sync 组件 ID。

您可以进入 OMS 控制台，通过以下两种方式查看 Full-Import/Incr-Sync 组件的日志。
- 进入 查看组件监控 页面，单击目标组件后的 查看日志。
- 进入 运维监控 > 组件 > Full-Import/Incr-Sync 页面，单击目标 Full-Import/Incr-Sync 后的更多 > 查看日志。

Full-Import/Incr-Sync 组件日志分类见下表：

日志类型	描述	日志保留策略
`链路根目录下链路标识.out`	任务启动日志。	不归档，永久保留
`logs/connector.log`	运行时 info 级别的日志。	按小时归档后压缩，保留 7 天
`logs/error.log`	运行时 error 级别的日志，任务中的错误日志。	按小时归档后压缩，保留 7 天
`logs/trace.log`	针对 RecordBatch 进行的抽样采集的 trace 日志。	按小时归档后压缩，保留 7 天
`logs/msg/connector_filter_msg.log`	ETL 过滤消息的日志。	按小时归档后压缩，保留 7 天
`logs/msg/connector_sink_msg.log`	成功写入目标端消息日志。	按小时归档后压缩，保留 7 天
`logs/msg/connector_source_msg.log`	成功读取到源端消息日志。	按小时归档后压缩，保留 7 天
`logs/msg/ddl_msg.log`	DDL 相关日志，会打印全部 DDL。	按小时归档后压缩，保留 7 天
`logs/msg/metrics.log`	metrics 指标日志。	按天归档后压缩，保留 7 天
`logs/msg/sql_msg.log`	慢执行的 DML 语句（执行时间超过 15ms）。	按小时归档后压缩，保留 7 天
`logs/msg/manual_table.log`	增加特殊列和索引的表记录。这些表进行反向迁移前，您需要手动删除对应的特殊列和索引。	不归档，永久保留

Full-Verification 组件日志

Full-Verification 组件日志的目录为 /home/ds/run/{name}/logs。您也可以在 OMS 控制台查看 Full-Verification 组件日志。步骤如下：

登录 OMS 控制台。
在左侧导航栏，单击 数据迁移。
在 数据迁移 页面，单击目标数据迁移任务的名称，进入详情页面。
单击页面右上角的 查看组件监控，查看相应的 Full-Verification 组件 ID。

您可以进入 OMS 控制台，通过以下两种方式查看 Full-Verification 组件的日志。
- 进入 查看组件监控 页面，单击目标组件后的 查看日志。
- 进入 运维监控 > 组件 > Full-Verification 页面，单击目标 Full-Verification 后的 查看日志。

Full-Verification 组件日志分类见下表：

日志类型	描述	日志保留策略
`error.log`	任务的错误日志	按小时归档后压缩，保留 72 小时
`metrics.log`	任务的指标监控	按天归档后压缩，保留 7 天
`task.log`	任务的运行日志	按小时归档后压缩，保留 72 小时
`warn.log`	任务的警告日志	按小时归档后压缩，保留 72 小时
`inmode.log`	判断表是否使用 inmode 的结果日志	按小时归档后压缩，保留 72 小时
`sql_msg.log`	任务执行的 SQL 日志	按小时归档后压缩，保留 168 小时

重要文件日志：

说明

下述日志路径中的 {subid} 对应 OMS 自动传入的 task.subId 配置。

/home/ds/run/{taskname}/[migrate|verify]/{subid}/heartbeat
/home/ds/run/{taskname}/[migrate|verify]/{subid}/overview-running
/home/ds/run/{taskname}/[migrate|verify]/{subid}/overview-done
/home/ds/run/{taskname}/[migrate|verify]/{subid}/overview-failed

校验结果文件：

/home/ds/run/{taskname}/[migrate|verify]/{subid}/{schema}/diff/{tablename}.diff

订正 SQL 文件：

/home/ds/run/{taskname}/[migrate|verify]/{subid}/{schema}/sql/{tablename}.sql

Supervisor 组件日志

请根据 /home/ds/supervisor/config/drc.properties 文件中 logging.path 项找到 Supervisor 组件日志所在位置。OMS 企业版环境中，通常 Supervisor 组件日志的目录为 /home/admin/logs/supervisor/。

您只需要关注以下日志文件。

日志类型	描述	日志保留策略
`error.log`	打印所有 ERROR 级别的日志。	无压缩，按天归档，保留 7 天
`legacy.log`	记录 OMS 控制台和 Agent 等组件对 CM 组件的接口、请求参数、结果和时间等。	无压缩，按天归档，保留 7 天
`routine.log`	打印 Supervisor 组件中，各种定时调度任务相关的日志。心跳采集汇报相关日志。指标、资源、错误采集汇报相关日志。 Supervisor 组件后台任务相关日志。	无压缩，按天归档，保留 7 天
`supervisor.log`	打印全部 Supervisor 日志。	无压缩，按天归档，保留 7 天