文档首页/ MapReduce服务 MRS/ 用户指南/ MRS集群运维/ 查看MRS集群日志/ 配置MRS组件默认日志级别与归档文件大小
更新时间：2026-08-18 GMT+08:00
查看PDF
分享

配置MRS组件默认日志级别与归档文件大小

在MRS集群运维和问题排查中，管理员需要通过查看组件日志来定位故障和分析问题。默认的日志级别可能产生大量冗余信息，导致关键错误被淹没在海量日志中，同时日志文件持续增长可能占用过多磁盘空间，影响集群正常运行。通过调整日志级别，管理员可以控制日志输出的详细程度，在排障时启用DEBUG级别获取详细信息，在正常运行时使用INFO级别减少日志量。通过配置日志归档文件大小，可以控制日志文件占用的磁盘空间，防止磁盘空间不足导致日志无法保存。本文介绍如何修改Manager和各服务组件的日志级别与归档文件大小。

  • 日志级别：控制日志输出详细程度的参数，优先级从高到低为FATAL、ERROR、WARN、INFO、DEBUG、TRACE。程序会输出高于或等于所设置级别的日志，设置的级别越低，输出的日志越多。例如设置为WARN时，只输出WARN、ERROR和FATAL级别的日志；设置为DEBUG时，输出DEBUG及以上所有级别的日志。
  • 归档文件大小：单个日志文件的最大大小。当日志文件达到设定大小时，系统会自动进行日志轮转，将当前日志文件归档并创建新的日志文件。通过合理设置归档文件大小，可以控制日志占用的磁盘空间总量。

日志级别的原理是：

各组件的日志框架根据配置的级别参数，对每条日志消息进行级别判断，仅输出级别大于或等于设定值的日志消息。归档文件大小的原理是：日志框架监控当前日志文件的大小，当文件大小达到设定的阈值时，将当前文件重命名为归档文件并创建新文件继续写入，系统会根据配置自动清理过期的归档日志。

约束与限制

  • 本章节操作仅支持MRS 3.x及之后的版本。
  • 个别服务不支持通过界面修改日志级别，具体以实际界面为准。

对系统的影响

  • 保存新的配置需要重启服务，此时对应的服务不可用。
  • 将日志级别设置为DEBUG或TRACE会产生大量日志，可能影响系统性能和磁盘空间，请在排障完成后及时恢复为INFO级别。

修改Manager日志级别

  1. 以root用户登录主管理节点。

    执行以下命令切换到omm用户。

    su - omm
  2. 执行以下命令，切换路径。 
    cd ${BIGDATA_HOME}/om-server/om/sbin
  3. 执行以下命令，修改日志级别。 
    ./setLogLevel.sh “日志级别参数”

    日志级别参数如下，优先级从高到低分别是FATAL、ERROR、WARN、INFO、DEBUG，程序会打印高于或等于所设置级别的日志，设置的日志等级越高，打印出来的日志就越少：

    • “DEFAULT”：设置后恢复到默认日志级别。
    • “FATAL”：严重错误日志级别，设置后日志只会打印输出“FATAL”信息。
    • “ERROR”：错误日志级别，设置后日志打印输出“ERROR”和“FATAL”信息。
    • “WARN”：警告日志级别，设置后日志打印输出“WARN”、“ERROR”和“FATAL”信息。
    • “INFO”（默认）：提示信息日志级别，设置后日志打印输出“INFO”、“WARN”、“ERROR”和“FATAL”信息。
    • “DEBUG”：调试日志级别，设置后日志打印输出“DEBUG”、“INFO”、“WARN”、“ERROR”和“FATAL”信息。
    • “TRACE”：跟踪日志级别，设置后日志打印输出“TRACE”、“DEBUG”、“INFO”、“WARN”、“ERROR”和“FATAL”信息。

    由于开源中定义的不同，组件的日志级别定义略有差异。

  4. 验证日志级别设置已生效，请下载日志并查看。请参见下载MRS集群日志（MRS 3.x及之后版本）。

修改服务日志级别与日志文件大小

  1. 登录MRS集群Manager界面。

    登录集群Manager界面请参考访问MRS集群Manager。

  2. 选择“集群 > 服务”。
  3. 单击服务列表中的某个服务，切换到“配置”页签。
  4. 选择“全部配置”，左边菜单栏中展开角色实例的菜单，单击所需修改的角色所对应的“日志”。
  5. 搜索各项参数，获取参数说明，在参数配置页面勾选所需的日志级别或修改日志文件大小。日志文件大小需填写单位“MB”。

    • 系统会根据配置的日志大小自动清理日志，如果需要保存更多的信息请设置一个较大的数值。为确保日志文件的完整性，建议根据实际业务量大小，在日志文件基于规则清理前，手动将日志文件备份存储至其他文件夹中。
    • 个别服务不支持通过界面修改日志级别。
    • KrbServer，LdapServer以及DBService不支持修改服务日志级别与日志文件大小。

  6. 单击“保存”，在“保存配置”单击“确定”。
  7. 验证日志级别设置已生效，请下载日志并查看。

验证操作：

修改完成后，下载对应服务的日志文件并查看。若日志文件中输出的日志级别与所设置的级别一致（如设置为WARN后日志中不再出现INFO级别信息），则表示设置已生效。同时检查日志文件大小是否符合设定的归档阈值。

常见问题

  • 修改日志级别后日志量过大导致磁盘空间不足

    将日志级别设置为DEBUG或TRACE后，系统会输出大量调试信息，日志文件增长速度远高于INFO级别，可能导致磁盘空间快速被占满。

    排障完成后，请及时将日志级别恢复为INFO或WARN。同时可以适当减小归档文件大小，加快过期日志的清理速度。如磁盘已满，请手动清理旧的归档日志文件释放空间。

  • 日志级别修改未生效

    修改服务日志级别后需要重启服务才能生效。若未执行重启操作，新配置仅保存在数据库中，运行时仍使用旧配置。个别服务不支持通过界面修改日志级别。

    请确认在保存配置后已执行服务重启操作。

相关文档

父主题： 查看MRS集群日志

相关文档