log4j.properties詳解與例子

軍說網事發表於2016-01-27

 

在專案中的classes 中新建立一個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:指定日誌訊息的輸出最低層次。
                      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=myapp file: 預設值是 Log4J LogMessages.
                     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 ] ERRORcom.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一條就連結一次資料庫

 

 

 

 

 

相關文章