LOG4J配置详解

LOG4J 配置

新建 JAVA 项目

导入 JAR 包

在项目中导入 log4j-1.2.14.jar 包就可以了

基本配置文件

在 project 根目录下,新建 log4j.properties。

1
2
3
4
5
6
7
8
9
10
11
##error > warn > info > debug
log4j.rootLogger=debug, stdout, logfile

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.err
log4j.appender.stdout.layout=org.apache.log4j.SimpleLayout

log4j.appender.logfile=org.apache.log4j.FileAppender
log4j.appender.logfile.File=d:/review.log
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss} %l %F %p %m%n

加载配置文件

1
PropertyConfigurator.configure("log4j.properties");

使用代码的方法配置参数

1
2
3
4
5
6
7
8
private static void initLog4j() {
Properties prop = new Properties();
prop.setProperty("log4j.rootLogger", "DEBUG, CONSOLE");
prop.setProperty("log4j.appender.CONSOLE", "org.apache.log4j.ConsoleAppender");
prop.setProperty("log4j.appender.CONSOLE.layout", "org.apache.log4j.PatternLayout");
prop.setProperty("log4j.appender.CONSOLE.layout.ConversionPattern", "%d{HH:mm:ss,SSS} [%t] %-5p %C{1} : %m%n");
PropertyConfigurator.configure(prop);
}

log4J 参数说明

日志级别

1
2
3
4
5
6
ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF,不区分大小写
FATAL 0
ERROR 3
WARN 4
INFO 6
DEBUG 7

注意

1. 需在控制台输入,只需将其中一个 appender 定义为 stdout 即可

2. rootLogger 默认是对整个工程生效

3.如果只想对某些包操作, 那么:log4j.logger.com.q18idc=info, stdout,表示该日志对 package com.q18idc 生效

4. 这样做可以区分 dev/线上,也可以减小性能影响:

1
2
3
if(log.isDebugEnabled()){
log.debug();
}

5. 级别越大显示信息越多,即 DEBUG 会打印所有内容

Appender 为日志输出目的地,Log4j 提供的 appender 有以下几种:

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

Layout:日志输出格式,Log4j 提供的 layout 有以下几种:

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

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

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

代码使用

1
2
3
4
5
6
7
8
public class Log4jTest {
public static void main(String[] args) {
PropertyConfigurator.configure("log4j.properties");
Logger logger = Logger.getLogger(Log4jTest.class );
logger.debug("debug");
logger.error("error");
}
}

常用配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
### set log levels ###
log4j.rootLogger = debug , stdout , D , E

### 输出到控制台 ###
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{ABSOLUTE} %5p %c{ 1 }:%L - %m%n

### 输出到日志文件 ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG ## 输出DEBUG级别以上的日志
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

### 保存异常信息到单独文件 ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = logs/error.log ## 异常日志文件名
log4j.appender.D.Append = true
log4j.appender.D.Threshold = ERROR ## 只输出ERROR级别以上的日志!!!
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

常见问题

  1. 如果读取不到配置文件
1
PropertyConfigurator.configure(ClassLoader.getSystemResource("log4j.properties"));

本文标题:LOG4J配置详解

文章作者:q18idc.com

发布时间:2018年07月18日 - 00:07

最后更新:2018年12月06日 - 22:12

原始链接:https://q18idc.com/2018/07/18/java/log4j-properties.html

许可协议: 署名-非商业性使用-禁止演绎 4.0 国际 转载请保留原文链接及作者。

坚持原创技术分享,您的支持将鼓励我继续创作!