1. 程式人生 > >Log4j 配置詳細介紹

Log4j 配置詳細介紹

 

Log4J的配置檔案(Configuration File)就是用來設定記錄器的級別、存放器和佈局的,它可接key=value格式的設定或xml格式的設定資訊。通過配置,可以創建出Log4J的執行環境。
 

1. 配置檔案
Log4J配置檔案的基本格式如下:

#配置根Logger
log4j.rootLogger  =   [ level ]   ,  appenderName1 ,  appenderName2 ,  …

#配置日誌資訊輸出目的地Appender
log4j.appender.appenderName  =  fully.qualified.name.of.appender.class 
  log4j.appender.appenderName.option1  =  value1 
  … 
  log4j.appender.appenderName.optionN  =  valueN 

#配置日誌資訊的格式(佈局)
log4j.appender.appenderName.layout  =  fully.qualified.name.of.layout.class 
  log4j.appender.appenderName.layout.option1  =  value1 
  … 
  log4j.appender.appenderName.layout.optionN  =  valueN 


其中 [level] 是日誌輸出級別,共有5種:

FATAL      
ERROR      
WARN       
INFO       
DEBUG     

Appender 為日誌輸出目的地,Log4j提供的appender有以下幾種:

org.apache.log4j.ConsoleAppender(控制檯),
org.apache.log4j.FileAppender(檔案),
org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌檔案),
org.apache.log4j.RollingFileAppender(檔案大小到達指定尺寸的時候產生一個新的檔案),
org.apache.log4j.WriterAppender(將日誌資訊以流格式傳送到任意指定的地方)


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平臺為“\r\n”,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 ) 


2. 為不同的 Appender 設定日誌輸出級別:


當除錯系統時,我們往往注意的只是異常級別的日誌輸出,但是通常所有級別的輸出都是放在一個檔案裡的,如果日誌輸出的級別是BUG!?那就慢慢去找吧。
這時我們也許會想要是能把異常資訊單獨輸出到一個檔案裡該多好啊。當然可以,Log4j已經提供了這樣的功能,我們只需要在配置中修改AppenderThreshold 就能實現,比如下面的例子:

[配置檔案]

### loggers ###
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


3、我們使用的通用配置

###loggers###
log4j.rootLogger=DEBUG,detail,console

###consoleAppender###
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} [%t]-[%c:%L]-[%-5p] %m%n
#log4j.appender.console.layout.ConversionPattern=%d{HH:mm:ss,SSS}[%t][%.30c:%L][%p]-%m%n

###detailAppender###
log4j.appender.detail=org.apache.log4j.DailyRollingFileAppender
log4j.appender.detail.Threshold=DEBUG
log4j.appender.detail.Append=true
log4j.appender.detail.File=log/xx.log
log4j.appender.detail.DatePattern='.'yyyy-MM-dd
log4j.appender.detail.layout=org.apache.log4j.PatternLayout
log4j.appender.detail.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t]-[%c:%L]-[%-5p] %m%n

 

參考文章:http://www.blogjava.net/zJun/archive/2006/06/28/55511.html