记一次log4j配置

1 写在开头

前几天接手的一个接口程序报了异常，遂到服务器拉日志，然后发现，日志文件有
5个G…(╯’ - ')╯︵ ┻━┻
一个日志文件有5个G，说明日志配置没有按日分割，全部塞在一个日志文件中，日积月累攒了一大堆。别说在这一大堆日志中找异常信息，就是把这5个G的日志从服务器下载下来都难。
没办法，只能开始面向百度调整日志配置。

2 log4j配置

直接找到配置文件log4j.properties开整
原配置文件：

log4j.rootLogger=INFO, stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n

调整后的配置文件：

log4j.rootLogger=INFO, stdout, I

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n
log4j.appender.stdout.Encoding=GBK

### 输出INFO级别以上的日志 ###
log4j.logger.info = I
log4j.appender.I = org.apache.log4j.DailyRollingFileAppender
log4j.appender.I.datePattern = '.'yyyy-MM-dd'.log'
log4j.appender.I.File = logs/log.log
log4j.appender.I.layout = org.apache.log4j.PatternLayout
log4j.appender.I.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n
log4j.appender.I.Encoding = UTF-8

2.1 配置根Logger

log4j.rootLogger = [ level ] , appenderName, appenderName, ......

[ level ] 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。
比如在这里定义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。

appenderName 就是指日志信息输出到哪个地方，可以同时指定多个输出目的地。
这里新增了一个“I”，用于输出日志到文件。

2.2 配置Appender

log4j.appender.appenderName = fully.qualified.name.of.appender.class  
log4j.appender.appenderName.option1 = value1  
......
log4j.appender.appenderName.option = valueN

2.2.1 配置appender的种类

Log4j提供的appender有以下几种：

org.apache.log4j.ConsoleAppender 控制台
org.apache.log4j.FileAppender 文件
org.apache.log4j.DailyRollingFileAppender 每天产生一个日志文件
org.apache.log4j.RollingFileAppender 文件大小到达指定尺寸的时候产生一个新的文件
org.apache.log4j.WriterAppender 将日志信息以流格式发送到任意指定的地方

此处选用DailyRollingFileAppender，实现日志按日分割。

2.2.2 配置appender的其他属性

log4j.appender.I.File 指定输出文件地址
log4j.appender.I.layout 设置日志输出布局

Log4j提供的layout有：

org.apache.log4j.HTMLLayout 以HTML表格形式布局  
org.apache.log4j.PatternLayout 可以灵活地指定布局模式
org.apache.log4j.SimpleLayout 包含日志信息的级别和信息字符串
org.apache.log4j.TTCCLayout 包含日志产生的时间、线程、类别等等信息

Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：

%m 输出代码中指定的消息
%p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL  
%r 输出自应用启动到输出该log信息耗费的毫秒数  
%c 输出所属的类目，通常就是所在类的全名  
%t 输出产生该日志事件的线程名  
%n 输出一个回车换行符，Windows平台为“rn”，Unix平台为“n”  
%d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921  
%l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10)

3 使用log4j

配置完之后更新重启测试，发现对应日志文件空空如也。
再一查，原来代码根本没有使用log4j，全都是用System.out.println…(╯’ - ')╯︵ ┻━┻

3.1 获取日志记录器

使用Log4j，第一步就是获取日志记录器，这个记录器将负责控制日志信息：

private static Logger log = Logger.getLogger(XXXX.class);

3.2 插入日志信息

log.debug("......");//输出debug日志，不过由于配置文件设置了优先级为INFO，debug日志并不会输出
log.info("......");//输出info日志
log.war("......");//输出war日志
try {
    ......
} catch(Exception e) {
	......
    log.error(e.getMessage(), e);//输出error日志
}

4 一点补充

由于项目已经导入log4j.jar，也在web.xml配置了log4j，所以省略了对这些配置。
具体可以参照下面两篇文章
log4j.properties 详解与配置步骤：https://blog.csdn.net/manmanxiaohui/article/details/79922546
log4j的maven配置：https://blog.csdn.net/hqm12345qw/article/details/79804024