1. Log4j说明

  Log4J的配置文件(Configuration File)就是用来设置记录器的级别、存放器和布局的,它可接properties格式的设置或xml格式的设置信息。通过配置,可以创建出Log4J的运行环境。

1.1. properties配置文件

标准示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
### 配置输出位置 ###
log4j.rootLogger=debug, console, fileAppender, dailyRollingFile, ROLLING_FILE, MAIL, DATABASE
## 表示Debug级别的日志会输出console, fileAppender, dailyRollingFile, ROLLING_FILE, MAIL, DATABASE
log4j.rootCategory=debug, console, fileAppender, dailyRollingFile, ROLLING_FILE, MAIL, DATABASE
## 表示级别等于和高于Debug的日志会输出console, fileAppender, dailyRollingFile, ROLLING_FILE, MAIL, DATABASE

### 配置输出到控制台 ###
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{ 1 }:%L - %m%n

### 配置输出到文件 ###
log4j.appender.fileAppender = org.apache.log4j.FileAppender
log4j.appender.fileAppender.File = ./logs/log.log
log4j.appender.fileAppender.Append = true
log4j.appender.fileAppender.Threshold = DEBUG
log4j.appender.fileAppender.layout = org.apache.log4j.PatternLayout
log4j.appender.fileAppender.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

### 配置输出到文件,并且每天都创建一个文件 ###
log4j.appender.dailyRollingFile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.dailyRollingFile.File = ./logs/log.log
log4j.appender.dailyRollingFile.Append = true
log4j.appender.dailyRollingFile.Threshold = DEBUG
log4j.appender.dailyRollingFile.layout = org.apache.log4j.PatternLayout
log4j.appender.dailyRollingFile.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

### 配置输出到文件,且大小到达指定尺寸的时候产生一个新的文件 ###
log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
## 产生错误的时候会记录到一个特别的文件中
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=10KB
log4j.appender.ROLLING_FILE.MaxBackupIndex=1
log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

### 配置输出到邮件 ###
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=chenyl@yeqiangwei.com
log4j.appender.MAIL.SMTPHost=mail.hollycrm.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=chenyl@yeqiangwei.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

### 配置输出到数据库 ###
log4j.appender.DATABASE = org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL = jdbc:oracle:thin:@ 210.51 . 173.94 : 1521 :YDB
log4j.appender.DATABASE.driver = oracle.jdbc.driver.OracleDriver
log4j.appender.DATABASE.user = ydbuser
log4j.appender.DATABASE.password = ydbuser
log4j.appender.DATABASE.sql = INSERT INTO A1 (TITLE3) VALUES ('%d - %c %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout = org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern =%d - %c -%-4r [%t] %-5p %c %x - %m%n
##数据库的链接会有问题,可以重写 org.apache.log4j.jdbc.JDBCAppender 的 getConnection() 使用数据库链接池去获取链接,可以避免 insert 一条就链接一次数据库

### 设置输出的级别,其中logger后面的内容全部为jar包中所包含的包名 ###
log4j.logger.org.apache=debug
log4j.logger.java.sql.Connection=debug
log4j.logger.java.sql.Statement=debug
log4j.logger.java.sql.PreparedStatement=debug
log4j.logger.java.sql.ResultSet=debug

解释说明

日志级别

  默认优先级:ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF

输出目的地

   Log4j提供5个输出位置:

  1. org.apache.log4j.ConsoleAppender(控制台)

    Target=System.err:默认情况下是:System.out,指定输出控制台

  2. org.apache.log4j.FileAppender(文件)

    File=mylog.txt:指定消息输出到mylog.txt文件。
    Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。

  3. org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)

    DatePattern=”.”yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。
    当然也可以指定按月、周、天、时和分。即对应的格式如下:
    1)”.”yyyy-MM: 每月
    2)”.”yyyy-ww: 每周
    3)”.”yyyy-MM-dd: 每天
    4)”.”yyyy-MM-dd-a: 每天两次
    5)”.”yyyy-MM-dd-HH: 每小时
    6)”.”yyyy-MM-dd-HH-mm: 每分钟

  4. org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)

    MaxFileSize=100KB:后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。
    MaxBackupIndex=2:指定可以产生的滚动文件的最大数。

  5. org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

说明:

Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

日志信息格式中几个符号所代表的含义:

-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字符,就从左边多出的字符截掉