Log4j由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式。日志信息的优先级从高到低有FATAL、ERROR、WARN、INFO、DEBUG,分别用来指定这条日志信息的重要程度;日志信息的输出目的地指定了日志将打印到控制台还是文件中;而输出格式则控制了日志信息的显示内容。
2.1. 日志信息的优先级
分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的级别。
Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。
假如在一个级别为q的Logger中发生一个级别为p的日志请求,如果p>=q,那么请求将被启用。这是Log4j的核心原则。
比如在这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来;
2.2. 输出源的使用
有选择的能用或者禁用日志请求仅仅是Log4j的一部分功能。Log4j允许日志请求被输出到多个输出源。用Log4j的话说,一个输出源被称做一个Appender。
Appender包括console(控制台), files(文件), GUI components(图形的组件), remote socket servers(socket 服务), JMS(java信息服务), NT Event Loggers(NT的事件日志), and remote UNIX Syslog daemons(远程UNIX的后台日志服务)。它也可以做到异步记录。
一个logger可以设置超过一个的appender。
用addAppender 方法添加一个appender到一个给定的logger。对于一个给定的logger它每个生效的日志请求都被转发到该logger所有的appender上和该logger的父辈logger的appender上。
2.2.1. ConsoleAppender
如果使用ConsoleAppender,那么log信息将写到Console。效果等同于直接把信息打印到System.out上了。
2.2.2. FileAppender
使用FileAppender,那么log信息将写到指定的文件中。这应该是比较经常使用到的情况。
相应地,在配置文件中应该指定log输出的文件名。如下配置指定了log文件名为dglog.txt
log4j.appender.A2.File=dglog.txt
注意将A2替换为具体配置中Appender的别名。
2.2.3. DailyRollingAppender
使用FileAppender可以将log信息输出到文件中,但是如果文件太大了读起来就不方便了。这时就可以使用DailyRollingAppender。DailyRollingAppender可以把Log信息输出到按照日期来区分的文件中。配置文件就会每天产生一个log文件,每个log文件只记录当天的log信息:
log4j.appender.A2=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A2.file=dglog
log4j.appender.A2.DatePattern='.'yyyy-MM-dd
log4j.appender.A2.layout=org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern= %5r %-5p %c{2} - %m%n
2.2.4. org.apache.log4j.RollingFileAppender
文件大小到达指定尺寸的时候产生一个新的文件。
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File= ../logslog.log
# Control the maximum log file size
log4j.appender.R.MaxFileSize=100KB
# Archive log files (one backup file here)
log4j.appender.R.MaxBackupIndex=1
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
这个配置文件指定了输出源R,是一个轮转日志文件。最大的文件是100KB,当一个日志文件达到最大尺寸时,Log4J会自动把example.log重命名为dglog.log.1,然后重建一个新的dglog.log文件,依次轮转。
以下是例子:
# # Must be one of ("trace", "debug", "info", "warn", "error", or "fatal").
log4j.rootLogger=ERROR,Console
log4j.logger.org.apache=ERROR,Console
log4j.logger.com.opensymphony=INFO,Console
log4j.logger.com.uniware=DEBUG,Console
log4j.logger.java.sql=DEBUG,Console
#log4j.appender.Console.Encoding=UTF-8
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}]:[%-5p] %m%n
log4j.rootLogger=ERROR,BUSINESS_LOG
log4j.logger.org.apache=ERROR,BUSINESS_LOG
log4j.logger.com.opensymphony=INFO,BUSINESS_LOG
log4j.logger.com.uniware=DEBUG,BUSINESS_LOG
log4j.logger.java.sql=DEBUG,SQL_LOG
#SQL_LOG Appender
log4j.appender.SQL_LOG=org.apache.log4j.DailyRollingFileAppender
log4j.appender.SQL_LOG.File=${catalina.base}/logs/uniware_sql.log
log4j.appender.SQL_LOG.layout=org.apache.log4j.PatternLayout
log4j.appender.SQL_LOG.DatePattern='.'yyyy-MM-dd
log4j.appender.SQL_LOG.layout.ConversionPattern=%-d{yyyy-MM-dd HH\:mm\:ss}[%F %M]-[%p] %m%n
#BUSINESS_LOG Appender
log4j.appender.BUSINESS_LOG=org.apache.log4j.DailyRollingFileAppender
log4j.appender.BUSINESS_LOG.File=${catalina.base}/logs/uniware_business.log
log4j.appender.BUSINESS_LOG.layout=org.apache.log4j.PatternLayout
log4j.appender.BUSINESS_LOG.DatePattern='.'yyyy-MM-dd
log4j.appender.BUSINESS_LOG.layout.ConversionPattern=%-d{yyyy-MM-dd HH\:mm\:ss}[%F %M]-[%p] %m%n
log4j.additivity.com.uniware=false
log4j.additivity.org.apache=false
log4j.additivity.com.opensymphony=false
log4j.additivity.java.sql=false
同时当代码中try' catch捕获的异常想要保存到日志中,需要自己构建实体类
package com.uniware.common.service;
import java.io.PrintWriter;
import java.io.StringWriter;
import org.apache.log4j.Logger;
public class LogInfo {
Logger logger = Logger.getLogger(LogInfo.class.getName());
public void addException(Object object) {
logger.info(object);
}
public void addExceptionStackTrace(Throwable t) {
StringWriter stringWriter= new StringWriter();
PrintWriter writer= new PrintWriter(stringWriter);
t.printStackTrace(writer);
StringBuffer buffer= stringWriter.getBuffer();
logger.info(buffer.toString());
}
}
并在相应的catch处调用相应方法:
catch (Exception e) {
LogInfo logInfo = new LogInfo();
logInfo.addExceptionStackTrace(e);
}
2.1. 日志信息的优先级
分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的级别。
Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。
假如在一个级别为q的Logger中发生一个级别为p的日志请求,如果p>=q,那么请求将被启用。这是Log4j的核心原则。
比如在这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来;
2.2. 输出源的使用
有选择的能用或者禁用日志请求仅仅是Log4j的一部分功能。Log4j允许日志请求被输出到多个输出源。用Log4j的话说,一个输出源被称做一个Appender。
Appender包括console(控制台), files(文件), GUI components(图形的组件), remote socket servers(socket 服务), JMS(java信息服务), NT Event Loggers(NT的事件日志), and remote UNIX Syslog daemons(远程UNIX的后台日志服务)。它也可以做到异步记录。
一个logger可以设置超过一个的appender。
用addAppender 方法添加一个appender到一个给定的logger。对于一个给定的logger它每个生效的日志请求都被转发到该logger所有的appender上和该logger的父辈logger的appender上。
2.2.1. ConsoleAppender
如果使用ConsoleAppender,那么log信息将写到Console。效果等同于直接把信息打印到System.out上了。
2.2.2. FileAppender
使用FileAppender,那么log信息将写到指定的文件中。这应该是比较经常使用到的情况。
相应地,在配置文件中应该指定log输出的文件名。如下配置指定了log文件名为dglog.txt
log4j.appender.A2.File=dglog.txt
注意将A2替换为具体配置中Appender的别名。
2.2.3. DailyRollingAppender
使用FileAppender可以将log信息输出到文件中,但是如果文件太大了读起来就不方便了。这时就可以使用DailyRollingAppender。DailyRollingAppender可以把Log信息输出到按照日期来区分的文件中。配置文件就会每天产生一个log文件,每个log文件只记录当天的log信息:
log4j.appender.A2=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A2.file=dglog
log4j.appender.A2.DatePattern='.'yyyy-MM-dd
log4j.appender.A2.layout=org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern= %5r %-5p %c{2} - %m%n
2.2.4. org.apache.log4j.RollingFileAppender
文件大小到达指定尺寸的时候产生一个新的文件。
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File= ../logslog.log
# Control the maximum log file size
log4j.appender.R.MaxFileSize=100KB
# Archive log files (one backup file here)
log4j.appender.R.MaxBackupIndex=1
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
这个配置文件指定了输出源R,是一个轮转日志文件。最大的文件是100KB,当一个日志文件达到最大尺寸时,Log4J会自动把example.log重命名为dglog.log.1,然后重建一个新的dglog.log文件,依次轮转。
以下是例子:
# # Must be one of ("trace", "debug", "info", "warn", "error", or "fatal").
log4j.rootLogger=ERROR,Console
log4j.logger.org.apache=ERROR,Console
log4j.logger.com.opensymphony=INFO,Console
log4j.logger.com.uniware=DEBUG,Console
log4j.logger.java.sql=DEBUG,Console
#log4j.appender.Console.Encoding=UTF-8
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}]:[%-5p] %m%n
log4j.rootLogger=ERROR,BUSINESS_LOG
log4j.logger.org.apache=ERROR,BUSINESS_LOG
log4j.logger.com.opensymphony=INFO,BUSINESS_LOG
log4j.logger.com.uniware=DEBUG,BUSINESS_LOG
log4j.logger.java.sql=DEBUG,SQL_LOG
#SQL_LOG Appender
log4j.appender.SQL_LOG=org.apache.log4j.DailyRollingFileAppender
log4j.appender.SQL_LOG.File=${catalina.base}/logs/uniware_sql.log
log4j.appender.SQL_LOG.layout=org.apache.log4j.PatternLayout
log4j.appender.SQL_LOG.DatePattern='.'yyyy-MM-dd
log4j.appender.SQL_LOG.layout.ConversionPattern=%-d{yyyy-MM-dd HH\:mm\:ss}[%F %M]-[%p] %m%n
#BUSINESS_LOG Appender
log4j.appender.BUSINESS_LOG=org.apache.log4j.DailyRollingFileAppender
log4j.appender.BUSINESS_LOG.File=${catalina.base}/logs/uniware_business.log
log4j.appender.BUSINESS_LOG.layout=org.apache.log4j.PatternLayout
log4j.appender.BUSINESS_LOG.DatePattern='.'yyyy-MM-dd
log4j.appender.BUSINESS_LOG.layout.ConversionPattern=%-d{yyyy-MM-dd HH\:mm\:ss}[%F %M]-[%p] %m%n
log4j.additivity.com.uniware=false
log4j.additivity.org.apache=false
log4j.additivity.com.opensymphony=false
log4j.additivity.java.sql=false
同时当代码中try' catch捕获的异常想要保存到日志中,需要自己构建实体类
package com.uniware.common.service;
import java.io.PrintWriter;
import java.io.StringWriter;
import org.apache.log4j.Logger;
public class LogInfo {
Logger logger = Logger.getLogger(LogInfo.class.getName());
public void addException(Object object) {
logger.info(object);
}
public void addExceptionStackTrace(Throwable t) {
StringWriter stringWriter= new StringWriter();
PrintWriter writer= new PrintWriter(stringWriter);
t.printStackTrace(writer);
StringBuffer buffer= stringWriter.getBuffer();
logger.info(buffer.toString());
}
}
并在相应的catch处调用相应方法:
catch (Exception e) {
LogInfo logInfo = new LogInfo();
logInfo.addExceptionStackTrace(e);
}