Log4j
Log4j是Apache一个用于控制日志输出的开源项目。使用Log4j可以将日志输出到控制台或者文件中。
Log4j的使用
1.log4j配置文件
# Root logger option
log4j.rootLogger=DEBUG, stdout, file
# Redirect log messages to console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
# Redirect log messages to a log file
log4j.appender.file=org.apache.log4j.RollingFileAppender
#outputs to Tomcat home
log4j.appender.file.File=${catalina.home}/logs/myapp.log
log4j.appender.file.MaxFileSize=5MB
log4j.appender.file.MaxBackupIndex=10
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
2.加载log4j文件
在web.xml中加入如下配置
<context-param>
<param-name>log4jConfig</param-name>
<param-value>/WEB-INF/classes/log4j.properties</param-value>
</context-param>
注:如果出现配置文件找不到的情况,很有可能就是这里配置错误的原因。
3.导入log4j包
添加maven包依赖
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
4.使用Logger
private static final Logger LOGGER = Logger.getLogger ( MyService.class );
LOGGER.info ( "----------log4j running ----------" );
Log4j配置文件详解
Log4j的配置文件主要有三部分组成,
1. 日志信息优先级
2. 日志信息输出目的地
3. 日志信息输出格式
- 日志信息优先级
Log4j的优先级ERROR>WARN> INFO>DEBUG,等级高的不会输出等级低的,例如设置了INFO的优先级,则DEBUG级别的信息则不会输出。
优先级 | 使用环境 |
---|---|
ERROR | 为严重错误 主要是程序的错误 |
WARN | 为一般警告,比如session丢失 |
INFO | 为一般要显示的信息,比如登录登出 |
DEBUG | 为程序的调试信息 |
在配置文件中是通过Threshold属性类设定的。
#将优先级设置为BEBUG级别
log4j.appender.stdout.Threshold=DEBUG
- 日志信息输出目的地
- org.apache.log4j.ConsoleAppender(控制台)
- org.apache.log4j.FileAppender(文件)
- org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
- org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
- org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
使用如下配置
log4j.appender.appenderName = fully.qualified.name.of.appender.class
#将日志以文件大小达到指定尺寸的时候产生一个新的文件
log4j.appender.logfile=org.apache.log4j.RollingFileAppender
- 日志信息输出格式
- org.apache.log4j.HTMLLayout(以HTML表格形式布局),
- org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
- org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
- org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
日志信息格式中几个符号所代表的含义:
-X号: X信息输出时左对齐;
%p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL,
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%r: 输出自应用启动到输出该log信息耗费的毫秒数
%c: 输出日志信息所属的类目,通常就是所在类的全名
%t: 输出产生该日志事件的线程名
%l: 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main (TestLog4.java:10)
%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
%%: 输出一个”%”字符
%F: 输出日志消息产生时所在的文件名称
%L: 输出代码中的行号
%m: 输出代码中指定的消息,产生的日志具体信息
%n: 输出一个回车换行符,Windows平台为”/r/n”,Unix平台为”/n”输出日志信息换行
可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
1)%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,”-“号指定左对齐。
3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
4)%20.30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边较远输出的字符截掉。
完整的Log4j.properties
# Root logger option
#全局为DEBUG等级
log4j.rootLogger=DEBUG, stdout ,logfile
#控制台输出
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
log4j.appender.stdout.Threshold=DEBUG
#保存为文件的形式
log4j.appender.logfile=org.apache.log4j.RollingFileAppender
#文件位置
log4j.appender.logfile.File=${catalina.home}/logs/nester.log
#设置最大的自动滚动大小
log4j.appender.logfile.MaxFileSize=5MB
#指定可以产生的滚动文件的最大数。
log4j.appender.logfile.MaxBackupIndex=2
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n