# 配置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及之后版本）](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0267.html#mrs_01_0267__section1969012411217)。
 
#### 修改服务日志级别与日志文件大小
1. 登录MRS集群Manager界面。 
   登录集群Manager界面请参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。
   
   
2. 选择"集群 \> 服务"。
3. 单击服务列表中的某个服务，切换到"配置"页签。
4. 选择"全部配置"，左边菜单栏中展开角色实例的菜单，单击所需修改的角色所对应的"日志"。
5. 搜索各项参数，获取参数说明，在参数配置页面勾选所需的日志级别或修改日志文件大小。日志文件大小需填写单位"MB"。 
   - 系统会根据配置的日志大小自动清理日志，如果需要保存更多的信息请设置一个较大的数值。为确保日志文件的完整性，建议根据实际业务量大小，在日志文件基于规则清理前，手动将日志文件备份存储至其他文件夹中。
   
   - 个别服务不支持通过界面修改日志级别。
   
   - KrbServer，LdapServer以及DBService不支持修改服务日志级别与日志文件大小。
   
   
   
   
6. 单击"保存"，在"保存配置"单击"确定"。
7. 验证日志级别设置已生效，请下载日志并查看。
**验证操作：**
修改完成后，下载对应服务的日志文件并查看。若日志文件中输出的日志级别与所设置的级别一致（如设置为WARN后日志中不再出现INFO级别信息），则表示设置已生效。同时检查日志文件大小是否符合设定的归档阈值。
#### 常见问题
- **修改日志级别后日志量过大导致磁盘空间不足**
  将日志级别设置为DEBUG或TRACE后，系统会输出大量调试信息，日志文件增长速度远高于INFO级别，可能导致磁盘空间快速被占满。
  排障完成后，请及时将日志级别恢复为INFO或WARN。同时可以适当减小归档文件大小，加快过期日志的清理速度。如磁盘已满，请手动清理旧的归档日志文件释放空间。
  
- **日志级别修改未生效**
  修改服务日志级别后需要重启服务才能生效。若未执行重启操作，新配置仅保存在数据库中，运行时仍使用旧配置。个别服务不支持通过界面修改日志级别。
  请确认在保存配置后已执行服务重启操作。
  
 
#### 相关文档
- 了解如何下载MRS集群日志，请参考[下载MRS集群日志](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0267.html)。
- 了解如何同步MRS集群配置，请参考[同步MRS集群配置](https://support.huaweicloud.com/usermanual-mrs/mrs_01_300121.html)。
- 了解如何查看MRS集群告警，请参考[查看MRS集群告警](https://support.huaweicloud.com/usermanual-mrs/zh-cn_topic_0040980162.html)。