阿里文档地址:https://help.aliyun.com/document_detail/43460.html
自定义日志配置
消息队列 RocketMQ 的客户端支持用户自定义日志保存路径、日志级别以及保存历史日志文件的最大个数。考虑到日志传输以及阅读的便利性,消息队列 RocketMQ 暂不允许自定义单个日志文件大小,保持默认的 64 MB。
各参数的配置说明如下:
- 日志保存路径:请确保应用进程有对该路径写的权限,否则日志不会打印。
- 保存历史日志文件的最大个数:支持 1 到 100 之前的数值;若输入的值超出该范围或格式错误,则系统默认保存 10 个。
- 日志级别:支持 ERROR、WARN、INFO、DEBUG 中任何一种,不匹配默认 INFO。
默认配置
客户端启动后,会按照如下的默认配置生成日志文件:
- 日志保存路径:
/{user.home}/logs/ons.log
,其中{user.home}
是指启动当前 Java 进程的用户的根目录 - 保存历史日志文件的最大个数:10 个
- 日志级别:INFO
- 单个日志文件大小:64 MB
自定义配置
注意:若要自定义客户端的日志配置,请升级到 Java SDK 1.2.5 版本及以上。
在 Java SDK 中自定义客户端日志配置,请设置如下系统参数:
- ons.client.logRoot :日志保存路径
- ons.client.logFileMaxIndex :保存历史日志文件的最大个数
- ons.client.logLevel :日志级别
示例
您可在启动脚本中或者 IDE 的 VM options 中添加如下系统参数:
-Dons.client.logRoot=/home/admin/logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20