log4j - 設定檔

標籤：

Log4J的設定檔(Configuration File)就是用來設定記錄器的層級、存放器和布局的，它可接key=value格式的設定或xml格式的設定資訊。

通過配置，可以建立出Log4J的運行環境。  

 

1. 設定檔  Log4J設定檔的基本格式如下：

代碼如下:

 1   #配置根Logger  2  3      log4j.rootLogger = [ level ] , appenderName1 , appenderName2 , …   4  
 5   #配置日誌資訊輸出目的地Appender 6
 7      log4j.appender.appenderName = fully.qualified.name.of.appender.class 8  
 9      log4j.appender.appenderName.option1 = value1  　　…  　　 10
 11     log4j.appender.appenderName.optionN = valueN 12
 13  #配置日誌資訊的格式（布局） 14
 15     log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class  　　 16
 17     log4j.appender.appenderName.layout.option1 = value1  　　…  　 18
 19     log4j.appender.appenderName.layout.optionN = valueN  

 

 

其中 [level] 是日誌輸出層級，共有5級：  代碼如下:

1   FATAL 0  ERROR 3  WARN 4  INFO 6  DEBUG 7  

 

Appender 為日誌輸出目的地，Log4j提供的appender有以下幾種：   代碼如下:

1   org.apache.log4j.ConsoleAppender（控制台），2 3   org.apache.log4j.FileAppender（檔案），4 5   org.apache.log4j.DailyRollingFileAppender（每天產生一個記錄檔），6 7   org.apache.log4j.RollingFileAppender（檔案大小到達指定尺寸的時候產生一個新的檔案），8 9   org.apache.log4j.WriterAppender（將日誌資訊以流格式發送到任意指定的地方）

 

 Layout：日誌輸出格式，Log4j提供的layout有以下幾種：

 

1   org.apache.log4j.HTMLLayout（以HTML表格形式布局），2 3   org.apache.log4j.PatternLayout（可以靈活地指定配置模式），4 5   org.apache.log4j.SimpleLayout（包含日誌資訊的層級和資訊字串），6 7   org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等資訊）

 

 列印參數: Log4J採用類似C語言中的printf函數的列印格式格式化日誌資訊，如下:

 1   %m 輸出代碼中指定的訊息  　 2  3 　%p 輸出優先順序，即DEBUG，INFO，WARN，ERROR，FATAL  　 4  5 　%r 輸出自應用啟動到輸出該log資訊耗費的毫秒數  　 6  7 　%c 輸出所屬的類目，通常就是所在類的全名  　 8  9 　%t 輸出產生該日誌事件的線程名  　10 11 　%n 輸出一個斷行符號分行符號，Windows平台為“\r\n”，Unix平台為“\n”  　12 13 　%d 輸出日誌時間點的日期或時間，預設格式為ISO8601，也可以在其後指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，輸出類似：2002年10月18日 22 ： 10 ： 28 ， 921  　14 15 　%l 輸出日誌事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlog4.main(TestLog4.java: 10 )

 

  2. 在代碼中初始化Logger:

 1）在程式中調用BasicConfigurator.configure()方法：給根記錄器增加一個ConsoleAppender，輸出格式通過PatternLayout設為"%-4r [%t] %-5p %c %x - %m%n"，還有根記錄器的預設層級是Level.DEBUG.

 2）配置放在檔案裡，通過命令列參數傳遞檔案名稱字，通過PropertyConfigurator.configure(args[x])解析並配置；

 3）配置放在檔案裡，通過環境變數傳遞檔案名稱等資訊，利用log4j預設的初始化過程解析並配置；

 4）配置放在檔案裡，通過應用伺服器配置傳遞檔案名稱等資訊，利用一個特殊的servlet來完成配置。

 

 3. 為不同的 Appender 設定日誌輸出層級：  當調試系統時，我們往往注意的只是異常層級的日誌輸出，但是通常所有層級的輸出都是放在一個檔案裡的，如果日誌輸出的層級是BUG！？那就慢慢去找吧。  這時我們也許會想要是能把異常資訊單獨輸出到一個檔案裡該多好啊。當然可以，Log4j已經提供了這樣的功能，我們只需要在配置中修改Appender的Threshold 就能實現,比如下面的例子：  

[設定檔]   代碼如下:

 1 ### set log levels ### 2  3  log4j.rootLogger = debug , stdout , D , E 4  5 ### 輸出到控制台 ### 6  7  log4j.appender.stdout = org.apache.log4j.ConsoleAppender 8  9  log4j.appender.stdout.Target = System.out10 11  log4j.appender.stdout.layout = org.apache.log4j.PatternLayout12 13  log4j.appender.stdout.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{ 1 }:%L - %m%n14 15 ### 輸出到記錄檔 ###16 17  log4j.appender.D = org.apache.log4j.DailyRollingFileAppender18 19  log4j.appender.D.File = logs/log.log20 21  log4j.appender.D.Append = true22 23  log4j.appender.D.Threshold = DEBUG24 25 ## 輸出DEBUG層級以上的日誌26 27  log4j.appender.D.layout = org.apache.log4j.PatternLayout28 29  log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n30 31 ### 儲存異常資訊到單獨檔案 ###32 33  log4j.appender.D = org.apache.log4j.DailyRollingFileAppender34 35  log4j.appender.D.File = logs/error.log36 37 ## 異常記錄檔名38 39  log4j.appender.D.Append = true40 41  log4j.appender.D.Threshold = ERROR42 43 ## 只輸出ERROR層級以上的日誌44 45  log4j.appender.D.layout = org.apache.log4j.PatternLayout46 47  log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

 

 1  public class TestLog4j { 2  3      public static void main(String[] args) { 4  5          PropertyConfigurator.configure( " D:/Code/conf/log4j.properties " ); 6  7          Logger logger = Logger.getLogger(TestLog4j. class ); 8   9          logger.debug( " debug " );10   11          logger.error( " error " );12 13      }14 15  }

 

 運行一下，看看異常資訊是不是儲存在了一個單獨的檔案error.log中

log4j - 設定檔