1. 程式人生 > >log4j配置檔案詳解及手動載入的方式

log4j配置檔案詳解及手動載入的方式

一、配置檔案說明
1、log4j.rootLogger=INFO, stdout, R
   將等級為INFO的日誌資訊使用stdout和R進行輸出,這裡可以自己命名;
    等級可分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL,OFF是關閉,不輸出任何資訊,其他級別按這個順序依次降低,如果指定一個級別,如INFO,則比該級別高的資訊都會輸出,此時會輸出FATAL、ERROR、WARN、INFO級別的資訊。

2、log4j.appender.stdout=org.apache.log4j.ConsoleAppender
   log4j.appender.stdout.option1=value1
   定義stdout的輸出端型別,以及屬性選項配置,可以有下面幾種型別:
   org.apache.log4j.ConsoleAppender(輸出在控制檯)
   org.apache.log4j.FileAppender(輸出到檔案)   
   org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌檔案)   
   org.apache.log4j.RollingFileAppender(檔案大小到達指定尺寸的時候產生一個新的檔案),可通過log4j.appender.R.MaxFileSize=100KB設定檔案大小,還可通過log4j.appender.R.MaxBackupIndex=1設定為儲存一個備份檔案   
   org.apache.log4j.WriterAppender(將日誌資訊以流格式傳送到任意指定的地方)

   輸出端共同選項:
   Threshold=WARN:指定日誌訊息的輸出最低層次。
   ImmediateFlush=true:預設值是true,意謂著所有的訊息都會被立即輸出。

   ConsoleAppender選項:
   Target=System.err:預設情況下是:System.out,指定輸出控制檯
  
   檔案輸出端共同選項:
   File=mylog.txt:指定訊息輸出到mylog.txt檔案。
   Append=false:預設值是true,即將訊息增加到指定檔案中,false指將訊息覆蓋指定的檔案內容。
 
   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: 每分鐘

   RollingFileAppender 選項:
   MaxFileSize=100KB: 字尾可以是KB, MB 或者是 GB. 在日誌檔案到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1檔案。
   MaxBackupIndex=2:指定可以產生的滾動檔案的最大數。

3、log4j.appender.stdout.layout=org.apache.log4j.PatternLayout 
   定義stdout的輸出端的layout是型別,可以有下面幾種型別:
   org.apache.log4j.HTMLLayout(以HTML表格形式佈局),
 org.apache.log4j.PatternLayout(可以靈活地指定佈局模式),   
   org.apache.log4j.SimpleLayout(包含日誌資訊的級別和資訊字串),   
   org.apache.log4j.TTCCLayout(包含日誌產生的時間、執行緒、類別等等資訊)

4、log4j.appender.stdout.layout.ConversionPattern= [APPName] %p [%t] %C.%M(%L) | %m%n
   如果使用pattern佈局就要指定的列印資訊的具體格式ConversionPattern,具體引數:
   %m 輸出程式碼中指定的訊息
 %p 輸出優先順序,即DEBUG,INFO,WARN,ERROR,FATAL
 %r 輸出自應用啟動到輸出該log資訊耗費的毫秒數
 %c 輸出所屬的類目,通常就是所在類的全名 
 %t 輸出產生該日誌事件的執行緒名
 %n 輸出一個回車換行符,Windows平臺為"rn”,Unix平臺為"n”
 %d 輸出日誌時間點的日期或時間,預設格式為ISO8601,也可以在其後指定格式,比如:%d{yyyy MM dd HH:mm:ss,SSS},輸出類似:2002年10月18日 22:10:28,921   %l 輸出日誌事件的發生位置,包括類目名、發生的執行緒,以及在程式碼中的行數。
   %x: 輸出和當前執行緒相關聯的NDC(巢狀診斷環境),尤其用到像java servlets這樣的多客戶多執行緒的應用中。
   %%: 輸出一個”%”字元
   %F: 輸出日誌訊息產生時所在的檔名稱
   %M: 輸出執行方法
   %L: 輸出程式碼中的行號
   可以在%與模式字元之間加上修飾符來控制其最小寬度、最大寬度、和文字的對齊方式。如:
   1) c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,預設的情況下右對齊。
   2)%-20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,”-”號指定左對齊。
   3)%.30c:指定輸出category的名稱,最大的寬度是30,如果category的名稱大於30的話,就會將左邊多出的字元截掉,但小於30的話也不會有空格。
   4) .30c:如果category的名稱小於20就補空格,並且右對齊,如果其名稱長於30字元,就從左邊交遠銷出的字元截掉。
   [APPName]是log資訊的開頭,可以為任意字元,一般為專案簡稱。

5、log4j.appender.R=org.apache.log4j.DailyRollingFileAppender

6、log4j.appender.R.File=D:\\logs\\APPName.log
   定義R的輸出端的檔名D:\\logs\\APPName.log,該名稱可以自行修改。

7、log4j.appender.R.layout=org.apache.log4j.PatternLayout

8、log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n

9、log4j.logger.com.johnny=DEBUG

   自定義各個包中日誌級別,指定com.johnny包下的所有類的等級為DEBUG。

二、載入自己的配置檔案
  log4j預設載入類路徑下的log4j.properties檔案,如果自定義其他名稱的properties檔案的時候,就需要使用DOMConfigurator.configure("E:/study/log4j/log4j.xml");//載入.xml檔案
       //PropertyConfigurator.configure("E:/study/log4j/log4j.properties");//載入.properties檔案來載入配置檔案,

這裡要注意一下配置檔案的路徑:
針對java專案:
   1、絕對路徑 --  F:\\test\\log4j.properties;
   這個就不用多說了,如果不是web專案的話,寫絕對路徑那就是硬碟上的全路徑了
   2、相對路徑 --  src/youFileName.properties
   log4j預設的當前路徑工程下面,即跟src同級目錄,瞭解這點相信相對路徑大家都手到擒來了,或者類載入器獲得路徑也可以;

針對web專案:
    getRealPath獲得路徑加上檔名

三 :動態的改變記錄級別和策略及在web中的載入,即修改log4j.properties,不需要重啟Web應用,這需要在web.xml中設定一下。
1 把log檔案定在 /WEB-INF/logs/ 而不需要寫絕對路徑。
2. 可以把log4j.properties和其他properties一起放在/WEB-INF/ ,而不是Class-Path。

首先我們在web.xml中需要設定一下

<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>WEB-INF/log4j.properties</param-value>
</context-param>

<context-param>
<param-name>log4jRefreshInterval</param-name>
<param-value>60000</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener> 


其中第二部分就是能夠動態修改log4j.properties的關鍵,容器會每60秒掃描log4j的配置檔案 。對 於log4j的配置檔案如何寫,這就不多說了,大家可以去google,有一點就是我們如果用RollingFileAppender或者 FileAppender時,可以通過${webapp.root}來定位到伺服器的釋出的該專案下,這是spring把web目錄的路徑壓入到了 webapp.root的系統變數。然後,在log4j.properties 裡就可以這樣定義logfile位置