Debian系统中,HBase日志的默认存储路径为/var/log/hbase/
(若通过包管理器安装,路径可能遵循系统规范)。其中:
hbase-<username>-<process_name>-<hostname>.log
(如hbase-user-master-debian.log
),记录HBase Master/RegionServer的启动、运行及异常信息;hbase-<username>-<process_name>-<hostname>.out
,记录进程启动时的JVM参数、环境变量等;<process_name>-<username>-<DATE>-<PID>-gc.log
(如master-user-20250930-1234-gc.log
),记录垃圾回收详情,用于分析内存问题;checkServiceDetail.log
,记录服务健康检查结果;hbase.log
,记录健康检查及告警脚本的执行结果;hbase-audit-<process_name>.log
(如hbase-audit-master.log
),记录安全相关操作(如表创建、删除)。tail -f
命令跟踪最新日志,例如查看Master运行日志:tail -f /var/log/hbase/hbase-user-master-debian.log
.out
文件排查JVM参数问题:cat /var/log/hbase/hbase-user-master-debian.out
less
或tail
命令:less /var/log/hbase/master-user-20250930-1234-gc.log
http://<master-host>:60010
)查看集群健康状态,快速定位问题节点。HBase使用Log4j框架管理日志级别,优先级从高到低为:FATAL
(致命错误)、ERROR
(错误)、WARN
(警告)、INFO
(信息)、DEBUG
(调试)、TRACE
(最详细)。
$HBASE_HOME/conf/log4j.properties
文件,找到log4j.rootLogger
配置项,修改日志级别及输出目标(如控制台console
或文件A1
):# 设置根日志级别为DEBUG,输出到控制台
log4j.rootLogger=DEBUG, console
# 控制台appender配置
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{ISO8601} %p %c: %m%n
若需调整特定组件的日志级别(如RegionServer),可添加:log4j.logger.org.apache.hadoop.hbase.regionserver=DEBUG
stop-hbase.sh
→ start-hbase.sh
),使配置生效。HBase默认开启自动压缩归档功能:
<原日志名>-<yyyy-mm-dd_hh-mm-ss>.zip
格式;hbase-site.xml
),添加以下参数:<property>
<name>hbase.log.roll.size</name>
<value>50MB</value> <!-- 日志滚动大小,单位字节 -->
</property>
<property>
<name>hbase.log.max.archived.files</name>
<value>30</value> <!-- 最大保留压缩文件数 -->
</property>
修改后需重启HBase服务生效。logrotate
工具或脚本定期清理过期日志,避免占用过多磁盘空间;ERROR
、FATAL
),及时触发告警;INFO
或WARN
,减少不必要的日志输出,提升性能。