log4j 入門(2)

在實際編程時,要使Log4j真正在系統中運行事先還要對配置文件進行定義。定義步驟就是對Logger、Appender及Layout的分 別使用。Log4j支持兩種配置文件格式,一種是XML格式的文件,一種是java properties(key=value)【Java特性文件(鍵=值)】。(這裏只說明properties文件)

一、配置根Logger

        其語法爲:
        log4j.rootLogger = [ level ] , appenderName1, appenderName2, …
        level : 是日誌記錄的優先級,分爲OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定義的級別。Log4j建議只使用四個級別,優 先級從高到低分別是ERROR、WARN、INFO、DEBUG。經過在這裏定義的級別,您能夠控制到應用程序中相應級別的日誌信息的開關。好比在這裏定 義了INFO級別,則應用程序中全部DEBUG級別的日誌信息將不被打印出來。appenderName:就是指定日誌信息輸出到哪一個地方。您能夠同時指 定多個輸出目的地。
       例如:log4j.rootLogger=info,A1,B2,C3

二、配置日誌信息輸出目的地

        其語法爲:
        log4j.appender.appenderName = fully.qualified.name.of.appender.class    //
        "fully.qualified.name.of.appender.class" 能夠指定下面五個目的地中的一個:

            1.org.apache.log4j.ConsoleAppender(控制檯)
            2.org.apache.log4j.FileAppender(文件)
            3.org.apache.log4j.DailyRollingFileAppender(天天產生一個日誌文件)
            4.org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件)
            5.org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)

               1.ConsoleAppender選項
                      Threshold=WARN:指定日誌消息的輸出最低層次。
                      ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
                      Target=System.err:默認狀況下是:System.out,指定輸出控制檯
                2.FileAppender 選項
                      Threshold=WARN:指定日誌消息的輸出最低層次。
                      ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
                      File=mylog.txt:指定消息輸出到mylog.txt文件。
                      Append=false:默認值是true,即將消息增長到指定文件中,false指將消息覆蓋指定的文件內容。
              3.DailyRollingFileAppender 選項
                      Threshold=WARN:指定日誌消息的輸出最低層次。
                      ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
                      File=mylog.txt:指定消息輸出到mylog.txt文件。
                      Append=false:默認值是true,即將消息增長到指定文件中,false指將消息覆蓋指定的文件內容。
                      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: 每分鐘
              4.RollingFileAppender 選項
                      Threshold=WARN:指定日誌消息的輸出最低層次。
                      ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
                      File=mylog.txt:指定消息輸出到mylog.txt文件。
                      Append=false:默認值是true,即將消息增長到指定文件中,false指將消息覆蓋指定的文件內容。
                      MaxFileSize=100KB: 後綴能夠是KB, MB 或者是 GB. 在日誌文件到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1文件。
                      MaxBackupIndex=2:指定能夠產生的滾動文件的最大數。

三、配置日誌信息的格式

          其語法爲:
  1). log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
                "fully.qualified.name.of.layout.class" 能夠指定下面4個格式中的一個:
                 1.org.apache.log4j.HTMLLayout(以HTML表格形式佈局),
           2.org.apache.log4j.PatternLayout(能夠靈活地指定佈局模式),
           3.org.apache.log4j.SimpleLayout(包含日誌信息的級別和信息字符串),
           4.org.apache.log4j.TTCCLayout(包含日誌產生的時間、線程、類別等等信息)
                     1.HTMLLayout 選項
                        LocationInfo=true:默認值是false,輸出java文件名稱和行號
                        Title=my app file: 默認值是 Log4J Log Messages.
                     2.PatternLayout 選項
                        ConversionPattern=%m%n :指定怎樣格式化指定的消息。
                     3.XMLLayout    選項
                        LocationInfo=true:默認值是false,輸出java文件和行號
          2). log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
             這裏須要說明的就是日誌信息格式中幾個符號所表明的含義:
             -X號: X信息輸出時左對齊;
                     %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平臺爲"
",Unix平臺爲"
"輸出日誌信息換行
              能夠在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如:
                       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字符,就從左邊交遠銷出的字符截掉html

 

 

 

比較詳細的例子java

 

log4j.rootLogger=INFO,consoleAppender,logfile,MAIL
log4j.addivity.org.apache=truesql

#ConsoleAppender,控制檯輸出
#FileAppender,文件日誌輸出
#SMTPAppender,發郵件輸出日誌
#SocketAppender,Socket日誌
#NTEventLogAppender,Window NT日誌
#SyslogAppender,
#JMSAppender,
#AsyncAppender,
#NullAppender數據庫

#文件輸出:RollingFileAppender
#log4j.rootLogger = INFO,logfile
log4j.appender.logfile = org.apache.log4j.RollingFileAppender
log4j.appender.logfile.Threshold = INFO  
# 輸出以上的INFO信息
log4j.appender.logfile.File = INFO_log.html    
#保存log文件路徑
log4j.appender.logfile.Append = true   
# 默認爲true,添加到末尾,false在每次啓動時進行覆蓋
log4j.appender.logfile.MaxFileSize = 1MB
# 一個log文件的大小,超過這個大小就又會生成1個日誌 # KB ,MB,GB
log4j.appender.logfile.MaxBackupIndex = 3  
# 最多保存3個文件備份
log4j.appender.logfile.layout = org.apache.log4j.HTMLLayout
# 輸出文件的格式
log4j.appender.logfile.layout.LocationInfo = true
#是否顯示類名和行數
log4j.appender.logfile.layout.Title =title:\u63d0\u9192\u60a8\uff1a\u7cfb\u7edf\u53d1\u751f\u4e86\u4e25\u91cd\u9519\u8bef
#html頁面的 < title >
############################## SampleLayout ####################################
# log4j.appender.logfile.layout = org.apache.log4j.SampleLayout
############################## PatternLayout ###################################
# log4j.appender.logfile.layout = org.apache.log4j.PatternLayout
# log4j.appender.logfile.layout.ConversionPattern =% d % p [ % c] -   % m % n % d
############################## XMLLayout #######################################
# log4j.appender.logfile.layout = org.apache.log4j.XMLLayout
# log4j.appender.logfile.layout.LocationInfo = true #是否顯示類名和行數
############################## TTCCLayout ######################################
# log4j.appender.logfile.layout = org.apache.log4j.TTCCLayout
# log4j.appender.logfile.layout.DateFormat = ISO8601
#NULL, RELATIVE, ABSOLUTE, DATE or ISO8601.
# log4j.appender.logfile.layout.TimeZoneID = GMT - 8 : 00
# log4j.appender.logfile.layout.CategoryPrefixing = false ##默認爲true 打印類別名
# log4j.appender.logfile.layout.ContextPrinting = false ##默認爲true 打印上下文信息
# log4j.appender.logfile.layout.ThreadPrinting = false ##默認爲true 打印線程名
# 打印信息以下:
#2007 - 09 - 13   14 : 45 : 39 , 765 [http - 8080 - 1 ] ERROR com.poxool.test.test - error成功關閉連接
###############################################################################
#天天文件的輸出:DailyRollingFileAppender
#log4j.rootLogger = INFO,errorlogfile
log4j.appender.errorlogfile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.errorlogfile.Threshold = ERROR
log4j.appender.errorlogfile.File = ../logs/ERROR_log
log4j.appender.errorlogfile.Append = true
#默認爲true,添加到末尾,false在每次啓動時進行覆蓋
log4j.appender.errorlogfile.ImmediateFlush = true  
#直接輸出,不進行緩存
# ' . ' yyyy - MM: 每月更新一個log日誌
# ' . ' yyyy - ww: 每一個星期更新一個log日誌
# ' . ' yyyy - MM - dd: 天天更新一個log日誌
# ' . ' yyyy - MM - dd - a: 天天的午夜和正午更新一個log日誌
# ' . ' yyyy - MM - dd - HH: 每小時更新一個log日誌
# ' . ' yyyy - MM - dd - HH - mm: 每分鐘更新一個log日誌
log4j.appender.errorlogfile.DatePattern = ' . ' yyyy - MM - dd ' .log '
#文件名稱的格式
log4j.appender.errorlogfile.layout = org.apache.log4j.PatternLayout
log4j.appender.errorlogfile.layout.ConversionPattern =%d %p [ %c] -   %m %n %dapache

#控制檯輸出:
#log4j.rootLogger = INFO,consoleAppender
log4j.appender.consoleAppender = org.apache.log4j.ConsoleAppender
log4j.appender.consoleAppender.Threshold = ERROR
log4j.appender.consoleAppender.layout = org.apache.log4j.PatternLayout
log4j.appender.consoleAppender.layout.ConversionPattern =%d %-5p %m %n
log4j.appender.consoleAppender.ImmediateFlush = true編程

# 直接輸出,不進行緩存
log4j.appender.consoleAppender.Target = System.err
# 默認是System.out方式輸出

#發送郵件:SMTPAppender
#log4j.rootLogger = INFO,MAIL
log4j.appender.MAIL = org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold = INFO
log4j.appender.MAIL.BufferSize = 10
log4j.appender.MAIL.SMTPHost = smtp.gmail.com
log4j.appender.MAIL.Subject = Log4J Message
log4j.appender.MAIL.layout = org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern =%d - %c -%-4r [%t] %-5p %c %x - %m %n緩存

#數據庫:JDBCAppender
log4j.appender.DATABASE = org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL = jdbc:oracle:thin:@ 210.51 . 173.94 : 1521 :YDB
log4j.appender.DATABASE.driver = oracle.jdbc.driver.OracleDriver
log4j.appender.DATABASE.user = ydbuser
log4j.appender.DATABASE.password = ydbuser
log4j.appender.DATABASE.sql = INSERT INTO A1 (TITLE3) VALUES ( ' %d - %c %-5p %c %x - %m%n ' )
log4j.appender.DATABASE.layout = org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern =% d -   % c -%- 4r [ % t] %- 5p % c % x -   % m % n
#數據庫的連接會有問題,能夠重寫org.apache.log4j.jdbc.JDBCAppender的getConnection() 使用數據庫連接池去得連接,能夠避免insert一條就連接一次數據庫多線程