1. 程式人生 > >log4j的多logger記錄日誌的簡明使用

log4j的多logger記錄日誌的簡明使用

windows window 獲取 while 大數 lin ack %d 增加

日誌,應該是一個應用軟件的基礎功能之一。
使用java語言,必然會使用一個日誌庫,我使用的是log4j的日誌庫。網上不少文章都有介紹,但是結合logger的不同功能介紹以及示例介紹的清楚的不多,至少我也是翻了不少網頁,然後根據實驗才得出這些功能。

我覺得log4j中主要有2個概念:logger、appender。

  1. logger是日誌組件的主要概念,用於指定不同的包使用不同的日誌級別,或者指定一個logger組件,以便在使用的時候可以使用getLogger(組件名)的方式獲取該logger的定義。logger中主要指定一個日誌級別,以及數個具體的記錄器appender,這樣程序中就可以選用哪些記錄器進行記錄日誌,以及記錄什麽級別的日誌。
  2. appender是具體執行記錄日誌到文件或者終端的組件。

  • 多logger組件的使用方式
    getLogger(參數),如果參數可以在配置文件中找到對應的logger,則使用該logger,如果找不到,則使用rootlogger。

代碼使用方式很簡單,在java工程中引入如下庫

package logStudy;
import org.apache.log4j.Logger;
public class useLog4J {
       public static Logger logger1 = Logger.getLogger(useLog4J.class);
       public static Logger logger2 = Logger.getLogger("logStudy");
       public static void main(String[] args) {
              int i =100;
              while(i>0) {
               logger1.debug("這是一條測試log的數據,級別應該是debug");
               logger1.debug("這是一條測試log的數據,級別應該是debug");
               logger1.info("這是一條測試log的數據,級別info");
               logger1.info("這是一條測試log的數據,級別info");
               logger1.info("這是一條測試log的數據,級別info");
               logger1.debug("這是一條測試log的數據,級別應該是debug");
               logger1.warn("這是一條測試log的數據,級別應該是warn");
               i--;
              }

              logger2.debug("logger2 debug");
              logger2.info("logger2 info");
              logger2.warn("logger2 warn");
              logger2.fatal("logger2 fatal");
       }
}

以上代碼中,使用了兩個logger組件,主要是為了演示兩者的區別,logger1是使用的rootlogger的內容,而logger2使用的是名為logStudy的logger,這個logger使用的只是CONSOLE,以下配置會有介紹。
log4j的使用代碼很簡單明了,主要工作是在配置文件中,即log4j.properties中的配置,示例中的配置示例如下。

ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF
### 設置級別和目的地(這裏多個目的地) ###
log4j.rootLogger = INFO,CONSOLE,HelloLog,Hello2Log
### 第一個用處,默認這裏的logStudy是包,也就是在這個包記錄日誌時,是只記錄WARN及以上級別的日誌.  
### 第二個用處,可以在程序中任何地方,通過Logger.getLogger("logStudy")主動使用這個名為logStudy的logger。
log4j.logger.logStudy=WARN,CONSOLE
### 配置日誌信息輸出目的地Appender,此處第一個appender名為CONSOLE,使用的輸出方式為org.apache.log4j.ConsoleAppender,即輸出到控制臺
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 = %c %d{ABSOLUTE} %5p  %c{1}:%L - %m%n
#每天創建一個日誌
log4j.appender.HelloLog = org.apache.log4j.DailyRollingFileAppender
log4j.appender.HelloLog.File =.\\log\\debug.log
#log4j.appender.HelloLog.File =/var/log/debug.log
log4j.appender.HelloLog.Append = true
## 只輸出DEBUG級別以上的日誌
log4j.appender.HelloLog.Threshold = INFO
#‘.‘yyyy-MM-dd: 每天產生一個新的文件
log4j.appender.HelloLog.DatePattern = ‘.‘yyyy-MM-dd
log4j.appender.HelloLog.layout = org.apache.log4j.PatternLayout
log4j.appender.HelloLog.layout.ConversionPattern = %-d{yyyy-MM-dd  HH:mm:ss} [%t:%r] - [%p] [%c{1}:%L] [%M] %m%n
log4j.additivity.logStudy = false    #不繼承根rootLogger,這樣就不會把日誌輸出到rootLogger中指定的appender中。
#當文本文件為3KB大時新建一個文件
log4j.appender.Hello2Log = org.apache.log4j.RollingFileAppender
log4j.appender.Hello2Log.File =.\\log\\debug2.log
#log4j.appender.Hello2Log.File =/var/log/debug.log
log4j.appender.Hello2Log.Append = true
## 只輸出DEBUG級別以上的日誌
log4j.appender.Hello2Log.Threshold = INFO
log4j.appender.Hello2Log.MaxFileSize = 2KB
log4j.appender.Hello2Log.MaxBackupIndex = 5
#‘.‘yyyy-MM-dd: 每天產生一個新的文件
log4j.appender.Hello2Log.layout = org.apache.log4j.PatternLayout
log4j.appender.Hello2Log.layout.ConversionPattern = %-d{yyyy-MM-dd  HH:mm:ss} [%t:%r] - [%p] [%c{1}:%L] [%M] %m%n

以下內容為每個介紹:
1、log4j.rootLogger
log4j.rootLogger= [ level ] , appenderName, appenderName2,...
level:是log4j的日誌級別,優先級從高到低分別是FATAL、ERROR、WARN、INFO、DEBUG、ALL。appenderName:就是指定日誌信息輸出到哪個地方。

2、 配置日誌信息輸出目的地Appender,其語法為:
log4j.appender.appenderName = fully.qualified.name.of.appender.class

其中,Log4j提供的appender有以下幾種:
org.apache.log4j.ConsoleAppender(控制臺),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌文件),
org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件),
org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)

3、設置好appender後,針對appender的配置
也就是設置好要輸出到什麽地方後,其它配置選項,很多配置選項是相同的,每個appender類型有一些特別的選項
1.ConsoleAppender選項
Threshold=WARN:指定日誌消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂著所有的消息都會被立即輸出。
Target=System.err:默認情況下是:System.out,指定輸出控制臺
2.FileAppender 選項
File=log.txt:指定消息輸出到log.txt文件。
Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
3.DailyRollingFileAppender 選項
Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
DatePattern=’.’yyyy-ww:每周滾動一次文件,即每周產生一個新的文件。當然也可以指定按月、周、天、時和分。
4.RollingFileAppender 選項
MaxFileSize=100KB: 後綴可以是KB, MB 或者是 GB. 在日誌文件到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1文件
MaxBackupIndex=2:指定可以產生的滾動文件的最大數。

4.輸出格式介紹

日誌輸出格式,所用到的參數如下,按需添加:
%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字符,就從左邊交遠銷出的字符截掉。

log4j的多logger記錄日誌的簡明使用