log4j配置檔案詳解及手動載入的方式
阿新 • • 發佈:2019-02-14
一、配置檔案說明:
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
其中第二部分就是能夠動態修改log4j.properties的關鍵,容器會每60秒掃描log4j的配置檔案 。對 於log4j的配置檔案如何寫,這就不多說了,大家可以去google,有一點就是我們如果用RollingFileAppender或者 FileAppender時,可以通過${webapp.root}來定位到伺服器的釋出的該專案下,這是spring把web目錄的路徑壓入到了 webapp.root的系統變數。然後,在log4j.properties 裡就可以這樣定義logfile位置
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位置