log4j配置文件說明

log4j配置文件說明

Log4j有三個主要的組件：Loggers(記錄器)，Appenders(輸出源)和Layouts(佈局)。Log4j支持兩種配置文件格式，一種是XML格式的文件，一種是properties屬性文件。

一、Loggers

Loggers組件在此係統中被分爲五個級別：DEBUG、INFO、WARN、ERROR和FATAL。這五個級別是有順序的，DEBUG < INFO < WARN < ERROR < FATAL。Log4j有一個規則：只輸出級別不低於設定級別的日誌信息。

log4j.additivity.org.apache=false
表示Logger不會在父Logger的appender裏輸出，默認爲true。
log4j.rootLogger = [ level ] , appenderName1, appenderName2, …
level：設定日誌記錄的最低級別； appenderName：就是指定日誌信息要輸出到哪裏。能夠同時指定多個輸出目的地，用逗號隔開。

log4j.rootLogger＝INFO,A1,B2,C3

二、Appenders

容許把日誌輸出到不一樣的地方，如控制檯（Console）、文件（Files）等。
配置模式：
log4j.appender.appenderName = className
log4j.appender.appenderName.Option1 = value1

常使用的類以下：

org.apache.log4j.ConsoleAppender（控制檯）

Threshold=WARN：指定日誌信息的最低輸出級別，默認爲DEBUG。
ImmediateFlush=true：表示全部消息都會被當即輸出，設爲false則不輸出，默認值是true。
Target=System.err：默認值是System.out。

org.apache.log4j.FileAppender（文件）
Threshold=WARN：指定日誌信息的最低輸出級別，默認爲DEBUG。
ImmediateFlush=true：表示全部消息都會被當即輸出，設爲false則不輸出，默認值是true。
Append=false：true表示消息增長到指定文件中，false則將消息覆蓋指定的文件內容，默認值是true。
File=D:/logs/logging.log4j：指定消息輸出到logging.log4j文件中。

org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件）
Threshold=WARN：指定日誌信息的最低輸出級別，默認爲DEBUG。
ImmediateFlush=true：表示全部消息都會被當即輸出，設爲false則不輸出，默認值是true。
Append=false：true表示消息增長到指定文件中，false則將消息覆蓋指定的文件內容，默認值是true。
File=D:/logs/logging.log4j：指定當前消息輸出到logging.log4j文件中。
DatePattern='.'yyyy-MM：每個月滾動一第二天志文件，即每個月產生一個新的日誌文件。當前月的日誌文件名爲logging.log4j，前一個月的日誌文件名爲logging.log4j.yyyy-MM。 另外，也能夠指定按周、天、時、分等來滾動日誌文件，對應的格式以下：
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：每分鐘

org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件）
Threshold=WARN：指定日誌信息的最低輸出級別，默認爲DEBUG。
ImmediateFlush=true：表示全部消息都會被當即輸出，設爲false則不輸出，默認值是true。
Append=false：true表示消息增長到指定文件中，false則將消息覆蓋指定的文件內容，默認值是true。
File=D:/logs/logging.log4j：指定消息輸出到logging.log4j文件中。
MaxFileSize=100KB：後綴能夠是KB, MB
或者GB。在日誌文件到達該大小時，將會自動滾動，即將原來的內容移到logging.log4j.1文件中。
MaxBackupIndex=2：指定能夠產生的滾動文件的最大數，例如，設爲2則能夠產生logging.log4j.1，logging.log4j.2兩個滾動文件和一個logging.log4j文件。

org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）

三、Layouts

根據本身的喜愛格式化本身的日誌輸出，Log4j能夠在Appenders的後面附加Layouts來完成這個功能。
Layouts提供四種日誌輸出樣式，如根據HTML樣式、自由指定樣式、包含日誌級別與信息的樣式和包含日誌時間、線程、類別等信息的樣式。
配置模式：
log4j.appender.appenderName.layout =className
log4j.appender.appenderName.layout.Option1 = value1

常使用的類以下：

org.apache.log4j.HTMLLayout（以HTML表格形式佈局）
LocationInfo=true：輸出java文件名稱和行號，默認值是false。
Title=My Logging： 默認值是Log4J Log Messages。

org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式）
ConversionPattern=%m%n：設定以怎樣的格式顯示消息。
格式化符號說明：
%p：輸出日誌信息的優先級，即DEBUG，INFO，WARN，ERROR，FATAL。
%d：輸出日誌時間點的日期或時間，默認格式爲ISO8601，也能夠在其後指定格式，如：%d{yyyy/MM/dd HH:mm:ss,SSS}。
%r：輸出自應用程序啓動到輸出該log信息耗費的毫秒數。
%t：輸出產生該日誌事件的線程名。
%l：輸出日誌事件的發生位置，至關於%c.%M(%F:%L)的組合，包括類全名、方法、文件名以及在代碼中的行數。
例如：test.TestLog4j.main(TestLog4j.java:10)。
%c：輸出日誌信息所屬的類目，一般就是所在類的全名。
%M：輸出產生日誌信息的方法名。
%F：輸出日誌消息產生時所在的文件名稱。
%L:：輸出代碼中的行號。
%m:：輸出代碼中指定的具體日誌信息。
%n：輸出一個回車換行符，Windows平臺爲"rn"，Unix平臺爲"n"。
%x：輸出和當前線程相關聯的NDC(嵌套診斷環境)，尤爲用到像java servlets這樣的多客戶多線程的應用中。
%%：輸出一個"%"字符。 另外，還能夠在%與格式字符之間加上修飾符來控制其最小長度、最大長度、和文本的對齊方式。如：
1)c：指定輸出category的名稱，最小的長度是20，若是category的名稱長度小於20的話，默認的狀況下右對齊。
2)%-20c："-"號表示左對齊。
3)%.30c：指定輸出category的名稱，最大的長度是30，若是category的名稱長度大於30的話，就會將左邊多出的字符截掉，但小於30的話也不會補空格。

org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串）
org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等信息）

所需的jar包：

總體配置說明以下：

#定義LOG輸出級別
log4j.rootLogger=INFO,Console,File

#定義日誌輸出目的地爲控制檯
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]-%m%n

#mybatis顯示SQL語句日誌配置     net.cxp.blog.dao是你的dao接口所在的包名  
#log4j.logger.org.mybatis=DEBUG
log4j.logger.com.lymn.it.mapper=DEBUG

#文件大小到達指定尺寸的時候產生一個新的文件
log4j.appender.File=org.apache.log4j.RollingFileAppender
#指定輸出目錄
log4j.appender.File.File=d:/logs/ssm.log
#定義文件最大大小
log4j.appender.File.MaxFileSize=10MB
#輸出全部日誌，若是換成DEBUG表示輸出DEBUG以上級別日誌
log4j.appender.File.Threshold=DEBUG
log4j.appender.File.layout=org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern=[%p][%d{yyyy-MM-dd HH\:mm|\:ss}][%c]%m%n

若是想要使日誌文件生效，在web.xml添加以下內容

<!-- 定義LOG4J監聽器 ,打印log放在前面防止出錯-->
    <listener>
        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
    </listener>
    <!-- log4jConfigLocation：log4j配置文件存放路徑 -->
    <context-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>classpath:config/log4j.properties</param-value>
    </context-param>