1 日志等级
log4j 日志等级分为五级:
等级 | 说明 |
---|---|
DEBUG | 调试(细粒度)。 |
INFO | 应用程序的运行过程(粗粒度)。 |
WARN | 可能存在潜在错误。 |
ERROR | 发生错误事件,但不影响系统运行。 |
FATAL | 发生严重错误事件,导致系统退出。 |
一般只使用到前四种。
2 目标
我们希望这样管理日志:
1、日志放在 logs/web/ 下。
2、日志文件分为 debug.log、info.log 以及 error.log。
3、每小时生成一份日志文件。
4、debug.log 包含所有级别日志。
5、info.log 包含除 debug 之外的所有级别日志。
6、error.log 包含 ERROR、FATAL 日志。
3 配置
配置文件 xxx.xml,放置在 classes/
:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>
<!-- 控制台日志-->
<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%p]:[%c][%M] \
[%l] [%m] %n"/>
</layout>
</appender>
<!-- DEBUG 级别日志-->
<appender name="debugAppender" class="org.apache.log4j.DailyRollingFileAppender">
<!-- 日志输出路径-->
<param name="File" value="${catalina.base}/logs/web/debug.log"/>
<!-- 每小时生成一个新日志-->
<param name="DatePattern" value="'.'yyyy-MM-dd-HH'.log'"/>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<!-- 最低级别-->
<param name="levelMin" value="DEBUG"/>
</filter>
<!-- 日志输出格式-->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%p]: [%c][%M][%l] [%m] %n"/>
</layout>
</appender>
<!-- INFO 级别日志-->
<appender name="infoAppender" class="org.apache.log4j.DailyRollingFileAppender">
<!-- 日志输出路径-->
<param name="File" value="${catalina.base}/logs/web/info.log"/>
<!-- 每小时生成一个新日志-->
<param name="DatePattern" value="'.'yyyy-MM-dd-HH'.log'"/>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<!-- 最低级别-->
<param name="levelMin" value="INFO"/>
</filter>
<!-- 日志输出格式-->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%p]: [%c][%M][%l] [%m] %n"/>
</layout>
</appender>
<!-- Error 级别日志-->
<appender name="errorAppender" class="org.apache.log4j.DailyRollingFileAppender">
<!-- 日志输出路径-->
<param name="File" value="${catalina.base}/logs/web/error.log"/>
<!-- 每小时生成一个新日志-->
<param name="DatePattern" value="'.'yyyy-MM-dd-HH'.log'"/>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<!-- 最低级别-->
<param name="levelMin" value="ERROR"/>
</filter>
<!-- 日志输出格式-->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%p]: [%c][%M][%l] [%m] %n"/>
</layout>
</appender>
<root>
<priority value="debug"/>
<appender-ref ref="ConsoleAppender"/>
<appender-ref ref="debugAppender"/>
<appender-ref ref="infoAppender"/>
<appender-ref ref="errorAppender"/>
</root>
</log4j:configuration>
4 输出器
输出器 | 说明 |
---|---|
ConsoleAppender | 控制台。 |
FileAppender | 文件。 |
RollingFileAppender | 文件,当文件大小达到一定阈值时,自动备份。 |
DailyRollingFileAppender | 文件,可设置定期备份策略。 |
WriterAppender | 将日志信息以流格式发送到指定位置。 |
5 输出格式
格式 | 说明 |
---|---|
%c | 输出日志信息所属的类的全名 |
%d | 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy-MM-dd HH:mm:ss },输出类似:2002-10-18- 22:10:28 |
%f | 输出日志信息所属的类的类名 |
%l | 输出日志事件的发生位置,即输出日志信息的语句处于它所在的类的第几行 |
%m | 输出代码中指定的信息,如log(message)中的message |
%n | 输出一个回车换行符,Windows平台为“/r/n”,Unix平台为“/n” |
%p | 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL。如果是调用debug()输出的,则为DEBUG,依此类推 |
%r | 输出自应用启动到输出该日志信息所耗费的毫秒数 |
%t | 输出产生该日志事件的线程名 |
6 DatePattern
DailyRollingFileAppender 中可以设置日志生成的时间频度(DatePattern),格式如下:
时间频度 | 格式 |
---|---|
每月 | yyyy-MM |
每周 | yyyy-ww |
每天 | yyyy-MM-dd |
每半天 | yyyy-MM-dd-a |
每小时 | yyyy-MM-dd-HH |
每分钟 | yyyy-MM-dd-HH-mm |
形如:
<param name="DatePattern" value="'.'yyyy-MM-dd-HH'.log'"/>
注意:
1、不在表中的字符,必须写在''
之间。
2、必须遵循操作系统文件夹的命名规范。
如果不遵守这些规则,可是会静默失败的哦O(∩_∩)O~
7 LevelRangeFilter
每一个 appender,都可以配置一个 LevelRangeFilter(日志等级过滤器),来指定需要输出的日志范围。
参数 | 说明 |
---|---|
levelMin | 最低等级 |
levelMax | 最高等级 |
等级可选值为:OFF、FATAL、ERROR、WARN、、INFO、DEBUG、TRACE、ALL。
8 日志输出路径
可以使用 ${catalina.base}
来指定 Tomcat 的根目录。