Log4j配置(很詳細~)
【1】從零開始
a). 新建Java Project>>新建package>>新建java類;
b). import jar包(一個就夠),這裏我用的是log4j-1.2.14.jar,
c). 新建log4j.properties,置於project根目錄下;
### 設置###
log4j.rootLogger = debug,stdout,D,E
### 輸出信息到控制擡 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
### 輸出DEBUG 級別以上的日誌到=E://logs/error.log ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = E://logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
### 輸出ERROR 級別以上的日誌到=E://logs/error.log ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =E://logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
d). 在main()中,加載log4j:
PropertyConfigurator.configure("log4j.properties");
e). 寫個小程序測試下,好了,我們看下效果:
【神馬】找不到文件exception?
1). 用絕對路徑,真心不推薦啊,太不優雅了;
2). 將log4j文件置於bin/目錄下:
a). 代碼中,PropertyConfigurator.configure("bin/log4j.properties");
b). 代碼中,PropertyConfigurator.configure(ClassLoader.getSystemResource("log4j.properties"));
c). 注意,必須位於bin直接目錄下,不可位於bin更深層的目錄當中。可是這究竟是爲神馬捏?
可參考: http://blog.sina.com.cn/s/blog_3f4755c70100jco1.html
3) 必殺技:
private static void initLog4j() {
Properties prop = new Properties();
prop.setProperty("log4j.rootLogger", "DEBUG, CONSOLE");
prop.setProperty("log4j.appender.CONSOLE", "org.apache.log4j.ConsoleAppender");
prop.setProperty("log4j.appender.CONSOLE.layout", "org.apache.log4j.PatternLayout");
prop.setProperty("log4j.appender.CONSOLE.layout.ConversionPattern", "%d{HH:mm:ss,SSS} [%t] %-5p %C{1} : %m%n");
PropertyConfigurator.configure(prop);
}
【2】log4j 格式詳解
log4j.rootLogger=日誌級別,appender1, appender2, ….
- 日誌級別:ALL<DEBUG<INFO<WARN<ERROR<FATAL<OFF,不區分大小寫
- 注意,需在控制檯輸入,只需將其中一個appender定義爲stdout即可
- 注意,rootLogger默認是對整個工程生效
- 注意,如果只想對某些包操作,那麼:log4j.logger.com.hutu=info, stdout,表示該日誌對package com.hutu生效
- 注意,這樣做可以區分dev/線上,也可以減小性能影響:if(log.isDebugEnabled()){log.debug();}
log4j.appender.appender1=org.apache.log4j.日誌輸出到哪兒
- ConsoleAppender(控制檯)
- FileAppender(文件)
- DailyRollingFileAppender(每天產生一個日誌文件)
- RollingFileAppender(文件大小到達指定尺寸時產生一個新的文件)
- WriteAppender(將日誌信息以流格式發送到任意指定的地方)
- JDBCAppender(將日誌信息保存到數據庫中)
log4j.appender.appender1.File=文件目錄及文件
${user.home}/logs/...
log4j.appender.appender1.MaxFileSize=最大文件大小
log4j.appender.appender1.MaxBackupIndex=備份文件個數
- 其中,appender1是在第一行定義過的;
- 文件目錄及文件,例如,/home/admin/logs/hutudan.log
- 最大文件大小,例如,100KB
- 備份文件個數,例如,1
log4j.appender.ServerDailyRollingFile.DatePattern=日誌後綴格式
- 例如,'.'yyyy-MM-dd
log4j.appender.appender1.layout=org.apache.log4j.日誌佈局格式
- HTMLLayout(以HTML表格形式佈局)
- SimpleLayout(包含日誌信息的級別和信息字符串)
- TTCCLayout(包含日誌產生的時間,執行緒,類別等信息)
- PatternLayout(可以靈活的指定佈局格式,常用)
log4j.appender.appender1.layout.ConversionPattern=日誌輸出格式
- 例如,%d - %m%n或%d{yyyy-MM-dd HH:mm:ss} %p [%c] %m%n
- %c 輸出日誌信息所屬的類的全名
- %d 輸出日誌時間點的日期或時間,默認格式爲ISO8601,也可以在其後指定格式,比如:%d{yyy-M-dd HH:mm:ss },輸出類似:2002-10-18- 22:10:28
- %f 輸出日誌信息所屬的類的類名
- %l 輸出日誌事件的發生位置,即輸出日誌信息的語句處於它所在的類的第幾行
- %m 輸出代碼中指定的信息,如log(message)中的message
- %n 輸出一個回車換行符,Windows平臺爲“rn”,Unix平臺爲“n”
- %p 輸出優先級,即DEBUG,INFO,WARN,ERROR,FATAL。如果是調用debug()輸出的,則爲DEBUG,依此類推
- %r 輸出自應用啓動到輸出該日誌信息所耗費的毫秒數
- %t 輸出產生該日誌事件的線程名
- 可參考:http://blog.sina.com.cn/s/blog_4e4dd5570100qowy.html
log4j.appender.ServerDailyRollingFile.Append=true
- 例如,不解釋,追加往後寫便是
三、Web項目中使用Log4j實例
上面代碼描述了Log4j的簡單應用,其實使用Log4j也就是這樣簡單方便。當然除了上面的配置方法,還有其它,比如做一個J2EE應用,在J2EE應用使用Log4j,必須先在啓動服務時加載Log4j的配置文件進行初始化,可以在web.xml中進行。
1、web應用的log4j使用基本上都採用:新建一個servlet,這個servlet在init函數中爲log4j執行配置。一般就是讀入配置文件。所以需要在web.xml中爲這個servlet配置,同時設定load-on-startup爲1。
2、這個servlet配置log4j就是讀出配置文件,然後調用configure函數。這裏有兩個問題:一、需要知道文件在哪裏;二、需要正確的文件類型
3、配置文件位置在web.xml中配置一個param即可,路徑一般是相對於web的root目錄
4、文件類型一般有兩種,一個是Java的property文件,另一種是xml文件
配置文件的大致內容:log4j可以指定輸出的log級別的最低等級,以及log的輸出配置格式,每個log可以指定多個輸出方式
(1)創建Web工程,整個工程最後目錄如下
(2)web.xml配置如下:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
<display-name>LogLearning</display-name>
<servlet>
<servlet-name>Log4JTestServlet</servlet-name>
<servlet-class>com.mucfc.Log4JTestServlet</servlet-class>
</servlet>
<!--用來啓動 log4jConfigLocation的servlet -->
<servlet>
<servlet-name>Log4JInitServlet</servlet-name>
<servlet-class>com.mucfc.Log4JInitServlet</servlet-class>
<init-param>
<param-name>log4j-properties-location</param-name>
<param-value>/WEB-INF/classes/log4j.properties</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Log4JTestServlet</servlet-name>
<url-pattern>/test</url-pattern>
</servlet-mapping>
</web-app>
(3)配置文件log4j.properties
### set log levels ###
log4j.rootLogger = debug,stdout,D,E
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = F://logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =F://logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
總結一下:
- Logger類:完成日誌記錄,設置日誌信息級別
- Appender類:決定日誌去向,終端、DB、硬盤
- Layout類:決定日誌輸出的樣式,例如包含當前線程、行號、時間