配置文件搜索策略:
- 通过
Thread.getContextClassLoader().getResource()
来定位配置文件根目录下的log4j.properties 或者 log4j.xml
;
PropertyConfigurator.configure(Thread.currentThread().getContextClassLoader().getResourceAsStream("log4j-kmsaudit.properties"));
例如:PropertyConfigurator.configure("D:/Code/conf/log4j.properties");
- log4j并没提供默认的配置文件方式对日志进行输出
依赖包:
1. 单独使用:log4j包
`org.apache.log4j.Logger`和`org.apache.log4j.PropertyConfigurator`
测试代码
其中配置项,采用了下面的log4j.properties
public static void main(String[] args) {
PropertyConfigurator.configure("D:\\log4j\\log4j.properties");
Logger logger = Logger.getLogger(TestLog4j.class);
logger.debug("这是debug信息。。。");
logger.info("这是info信息。。。");
logger.error("这是error信息。。。");
}
运行后,在项目根目录下的log4j文件中可看到log.log日志
2. 使用:log4j包
种类:
log4j进行的系统属性检测
- log4j.debug
true,输出debug信息到控制台 - log4j.defaultInitOverride
true,在第一次日志请求中,只检查log4j.properties 或 log4j.xml,而不进行默认初始化 - log4j.configuration
默认初始化配置文件的URL - log4j.configurationClass
需要进行默认初始化的类的配置项 - log4j.ignoreTCL
true,当装载类时,线程类的装载将被忽略
日志级别
从低到高
"trace", "debug", "info", "warn", "error" and "fatal"
配置项
log4j.xml
<?xml version="1.0" encoding="UTF-8"?>
<!--TODO 待测试和完善-->
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/"
debug="false">
<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{dd/MM/yy hh:mm:ss:sss z}] %5p %c{2}: %m%n"/>
</layout>
</appender>
<appender name="ASYNC" class="org.apache.log4j.AsyncAppender">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</appender>
<appender name="FILE" class="org.apache.log4j.FileAppender">
<param name="File" value="log4j_hn.log"/>
<param name="MaxBackupIndex" value="100"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{dd/MM/yy hh:mm:ss:sss z}] %5p %c{2}: %m%n"/>
</layout>
</appender>
<category name="java.sql">
<priority value="debug"/>
</category>
<root>
<priority value="INFO"/>
<appender-ref ref="FILE"/>
</root>
</log4j:configuration>
log4j.properties
### 根目录 ###
log4j.rootLogger = debug,stdout,D
###输出位置###
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
java代码
public class TestLog4j {
public static void main(String[] args) {
PropertyConfigurator.configure("D:/Code/conf/log4j.properties");
Logger logger = Logger.getLogger(TestLog4j. class );
logger.debug( " debug " );
logger.error( " error " );
}
}
生产的日志文件在项目的根目录之下/logs/error.log
其中,并不能生产log.log文件
配置文件中的DEBUG作为全局级别,其中其他输出文件方式级别,比这低,就不会输出了
说明
配置日志的输出目的地
log4j.appender.appenderName =
- org.apache.log4j.ConsoleAppender,控制台
- org.apache.log4j.FileAppender,文件
- org.apache.log4j.DailyRollingFileAppender,每天产生一个日志文件
- org.apache.log4j.RollingFileAppender,文件到达指定大小时生成新文件
- org.apache.log4j.WriterAppender,以流的形式发送到指定地方
ConsoleAppender
ConsoleAppender | 值 | 说明 |
---|---|---|
Threshold | DEBUG | 指定日志消息的输出最低层次 |
ImmediateFlush | true | 默认值是true,意谓着所有的消息都会被立即输出 |
Target | System.err | 默认情况下是:System.out,指定输出控制台 |
FileAppender
FileAppender | 值 | 说明 |
---|---|---|
Threshold | DEBUG | 指定日志消息的输出最低层次 |
ImmediateFlush | true | 默认值是true,意谓着所有的消息都会被立即输出 |
File | mylog.txt | 指定消息输出到mylog.txt文件 |
Append | false | 默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容 |
DailyRollingFileAppender
DailyRollingFileAppender | 值 | 说明 |
---|---|---|
Threshold | DEBUG | 指定日志消息的输出最低层次 |
File | mylog.txt | 指定消息输出到mylog.txt文件 |
Target | System.err | 默认情况下是:System.out,指定输出控制台 |
RollingFileAppender
FileAppender | 值 | 说明 |
---|---|---|
Threshold | DEBUG | 指定日志消息的输出最低层次 |
ImmediateFlush | true | 默认值是true,意谓着所有的消息都会被立即输出 |
File | mylog.txt | 指定消息输出到mylog.txt文件 |
Append | false | 默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容 |
MaxFileSize | 100KB | 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件 |
MaxBackupIndex | 2 | 指定可以产生的滚动文件的最大数 |
WriterAppender
待补
配置日志的输出格式
log4j.appender.appenderName.layout =
- org.apache.log4j.HTMLLayout,html表格布局
- org.apache.log4j.PatternLayout,指定的格式
- org.apache.log4j.SimpleLayout,日志级别和信息字符串
- org.apache.log4j.TTCCLayout,时间,线程,类别
指定日志的输出布局
log4j.appender.E.layout.ConversionPattern =%-d{MM-dd HH:mm} [%t] %c{6} (%F:%L) %m%n
符号 | 含义 |
---|---|
-x: | 该信息输出时左对齐 |
%p: | 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL |
%d: | 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyy MMM dd HH:mm:ss,SSS} |
%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"输出日志信息换行 |