Log4j用于日志記錄禽翼,有兩個版本捍壤,一個是老版本Log4j 1.x
续誉,這里寫的是新版本Apache Log4j 2
的使用
使用
- Gradle 內(nèi)添加依賴
dependencies {
compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.11.0'
compile group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.11.0'
}
編寫配置文件
應(yīng)用程序中使用
static Logger log =LogManager.getLogger();//默認(rèn)以所在類名稱作為logger名稱哲银,可以在配置文件中指定特定名稱的日志屬性
log.debug(Object);
org.apache.logging.log4j.Level
用來表明消息的優(yōu)先級扛吞,ALL輸出全部log,OFF不輸出
ALL < Trace < Debug < Info < Warn < Error < Fatal < OFF
框架中有兩種類型的對象:
Core Objects
Logger:捕獲日志信息
Layout:設(shè)定格式
Appender:指定日志信息的輸出位置(console,files,sockets等)
Support Objects
Level:設(shè)定等級OFF, FATAL, ERROR, WARN,INFO,DEBUG, ALL
Filter:分析過濾日志
ObjectRenderer:把對象作為日志時荆责,輸出字符串的方式
LogManger:管理日志框架滥比,讀取初始化配置信息
配置
可以通過文件配置,也可以通過程序配置做院,通常使用配置文件
如果沒有配置盲泛,會使用默認(rèn)配置,由DefaultConfiguration
類提供键耕,等價于下下配置文件
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Root level="error">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
使用配置文件時寺滚,Log4j的ConfigurationFactory
支持property,JSON屈雄,YAML和XML文件配置村视,它會在classpath下查找文件對應(yīng)的文件名稱,例如log4j2.properties
酒奶,log4j2.xml
蚁孔,通常將配置文件放在scr/resouces
目錄下
Log4j property文件配置
log4j.rootLogger=info, stdout
### stdout appender 設(shè)定 ###
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=%d{ABSOLUTE} %5p - %m%n
### 設(shè)置特定package的日志輸出級別和appender###
log4j.logger.org.springframework=info
log4j.logger.org.apache.catalina=info
log4j.logger.org.apache.commons.digester.Digester=info
log4j.logger.org.apache.catalina.startup.TldConfig=info
log4j.logger.chb.test=debug
配置根Logger
定義log4j支持的日志級別及輸出目的地
log4j.rootLogger = [ level ] , appenderName, appenderName, …
level 是日志記錄的優(yōu)先級
appenderName指定日志信息輸出的目的地,可以定義多個
配置輸出目的地 Appender
輸出到文件
# 定義文件路徑
log = /usr/home/log4j
log4j.rootLogger = DEBUG, FILE
#定義appender
log4j.appender.FILE=org.apache.log4j.FileAppender
#設(shè)定文件名稱
log4j.appender.FILE.File=${log}/log.out
#設(shè)定布局
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n
log4j.appender.FILE.ImmediateFlush=true
log4j.appender.FILE.Threshold=debug
log4j.appender.FILE.Append=false
輸出到控制臺
...appender名稱為stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out //或者System.err
log4j.appender.stdout.Threshold=WARN //日志消息的輸出門限惋嚎,低于則不輸出
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout //設(shè)定格式
log4j.appender.stdout.layout.ConversionPattern=%d{HH:mm:ss.SSS} %-5p %c{1}:%L - %m%n
布局 Layout
指定輸出格式杠氢,例如PatternLayout
,XmlLayout
另伍,JsonLayout
等
PatternLayout 格式
轉(zhuǎn)換字符 | 含義 |
---|---|
%c | 輸出日志事件所在的目錄(類名)鼻百,全名為"a.b.c" %c{2}輸出類名 "b.c" |
%d | 用于輸出時間 %d{HH:mm:ss,SSS} 或者 %d{dd MMM yyyy HH:mm:ss,SSS} |
%L | 請求輸出日志的代碼行號 |
%m | 輸出代碼中指定的消息 |
%n | 輸出一個平臺相關(guān)的換行符 |
%p | 輸出日志信息優(yōu)先級 |
%t | 線程名 |
%-5p | 左對齊,最小寬度為5摆尝,輸出日志等級 |
Log4j2 property配置文件
根據(jù)屬性層級温艇,逐級配置即可,具體屬性Configuration說明
最外層的可以是status
结榄,name
,appender
中贝,filter
,loger
等臼朗,示例如下:
status = error
dest = err
name = PropertiesConfig
property.filename = target/rolling/rollingtest.log
filter.threshold.type = ThresholdFilter
filter.threshold.level = debug
appender.console.type = Console
appender.console.name = STDOUT
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = %m%n
appender.console.filter.threshold.type = ThresholdFilter
appender.console.filter.threshold.level = error
appender.rolling.type = RollingFile
appender.rolling.name = RollingFile
appender.rolling.fileName = ${filename}
appender.rolling.filePattern = target/rolling2/test1-%d{MM-dd-yy-HH-mm-ss}-%i.log.gz
appender.rolling.layout.type = PatternLayout
appender.rolling.layout.pattern = %d %p %C{1.} [%t] %m%n
appender.rolling.policies.type = Policies
appender.rolling.policies.time.type = TimeBasedTriggeringPolicy
appender.rolling.policies.time.interval = 2
appender.rolling.policies.time.modulate = true
appender.rolling.policies.size.type = SizeBasedTriggeringPolicy
appender.rolling.policies.size.size=100MB
appender.rolling.strategy.type = DefaultRolloverStrategy
appender.rolling.strategy.max = 5
logger.rolling.name = com.example.my.app
logger.rolling.level = debug
logger.rolling.additivity = false
logger.rolling.appenderRef.rolling.ref = RollingFile
rootLogger.level = info
# 對應(yīng)appender.console
rootLogger.appenderRef.stdout.ref = STDOUT
SLF4j
SLF4J(Simple logging Facade for Java)是各種日志框架(例如java.util.logging邻寿,logback蝎土,log4j)的簡單抽象,最終在部署時插入所需的日志框架
簡單使用:
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class HelloWorld {
public static void main(String[] args) {
String name = "abc"
Logger logger = LoggerFactory.getLogger(HelloWorld.class);
logger.info("Hello World, {}", name);
}
}
使用{}
作為占位符绣否,左右花括號之間沒有其他字符
- 避免不輸出時誊涯,構(gòu)造參數(shù)引發(fā)計算,例如
logger.debug("Entry number: " + i + " is " + String.valueOf(entry[i]));
- 本質(zhì)上是使用兩次判斷l(xiāng)ogger是否開啟
if(logger.isDebugEnabled()) {
logger.debug("Entry number: " + i + " is " + String.valueOf(entry[i]));
}
如果使用SLF4J綁定log4j蒜撮,使用三個庫暴构,slf4j本身,slf4j到log4j的適配器段磨,log4j本身
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.16</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.16</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
如果綁定到log4j2取逾,log4j-slf4j-impl
內(nèi)部包含所有需要的依賴
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<version>2.11.0</version>
</dependency>