应用日志

服务日志

每个 Ozone 服务（Ozone Manager、Storage Container Manager、Datanode、S3 Gateway 和 Recon）都会生成各自的日志文件。这些日志包含服务运行的详细信息，包括错误和警告。

默认情况下，日志文件存储在 $OZONE_LOG_DIR 目录中，该目录通常设置为 Ozone 安装目录下的 logs 目录。日志文件名针对每个服务各不相同，例如：

• Ozone Manager 的日志为 ozone-om-....log
• Storage Container Manager 的日志为 ozone-scm-....log
• Datanode 的日志为 ozone-datanode-....log

每个服务的日志行为由其 log4j.properties 文件控制，该文件位于服务的 $OZONE_CONF_DIR 目录中，通常为 etc/hadoop。你可以修改此文件来更改日志级别、日志输出方式及其他日志参数。

Datanode 容器日志

除主服务日志外，Datanode 还会生成针对容器的日志，用于跟踪容器副本级别的事件。这些日志记录了容器状态变更（打开、关闭中、已关闭、不健康）、复制事件、重建、一致性协调、容器迁移以及其他容器生命周期事件的简要信息。

容器日志通过 dn-container-log4j2.properties 进行配置，并以 dn-container-${hostName}.log 的形式存储在 $OZONE_LOG_DIR 目录中。

示例

2026-02-01 16:08:59,261 | INFO  | ID=2 | Index=0 | BCSID=0 | State=OPEN | Volume=/hadoop-ozone/datanode/data/hdds | DataChecksum=0 |
2026-02-03 12:49:36,139 | INFO  | ID=2 | Index=0 | BCSID=1172 | State=CLOSING | Volume=/hadoop-ozone/datanode/data/hdds | DataChecksum=0 |
2026-02-03 12:49:37,443 | INFO  | ID=2 | Index=0 | BCSID=1172 | State=CLOSED | Volume=/hadoop-ozone/datanode/data/hdds | DataChecksum=4117a7a2 |
2026-02-03 13:31:17,149 | INFO  | ID=2018 | Index=0 | BCSID=159 | State=CLOSING | Volume=/mnt/dummy_disk1/hadoop-ozone/datanode/data/hdds | DataChecksum=0 |
2026-02-03 13:31:17,205 | WARN  | ID=2018 | Index=0 | BCSID=159 | State=QUASI_CLOSED | Volume=/mnt/dummy_disk1/hadoop-ozone/datanode/data/hdds | DataChecksum=2a21d155 | Ratis group removed. Group id: group-82AA09A3DA8C |

调试

为了便于调试，你可以提高服务和命令行工具的日志详细程度。

为服务启用调试日志

要为某个服务启用调试日志，你需要修改其 log4j.properties 文件，将目标 logger 的日志级别从 INFO 改为 DEBUG。例如，要为 Ozone Manager 启用调试日志，你需要编辑其 log4j.properties 文件，并修改下面这行：

rootLogger.level = info

到

rootLogger.level = debug

保存文件并重启服务后，服务将开始记录更详细的调试信息。

为 CLI 工具启用调试日志

要为 Ozone CLI 工具（例如 ozone sh volume create）启用调试日志，可以将 OZONE_ROOT_LOGGER 环境变量设置为 debug：

export OZONE_ROOT_LOGGER=DEBUG,console
ozone sh volume create /vol1

或者，你也可以在 Ozone 命令中使用 --loglevel 选项：

ozone --loglevel debug sh volume create /vol1