log4j.properties詳解與例子


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

1、配置根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

2、配置日志信息輸出目的地

        其語法為:
        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:指定日志消息的輸出最低層次。 (ps:所有的
Threshold配置的級別不能低於根Logger設置的級別,否則不生效

                      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:指定可以產生的滾動文件的最大數。

3、配置日志信息的格式

          其語法為:
  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字符,就從左邊交遠銷出的字符截掉

 

 

 

比較詳細的例子

 

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

#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 %d

#控制台輸出:
#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.From = yourmail@gmail.com
log4j.appender.MAIL.SMTPHost = smtp.gmail.com
log4j.appender.MAIL.Subject = Log4J Message
log4j.appender.MAIL.To = yourmail@gmail.com
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一條就鏈接一次數據庫



免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM