1.缺省默认配置文件
<?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>
2. 配置文件节点说明
2.1 根节点Configuration 参数
-
status:指定log4j本身打印日志的级别
-
monitorinterval:用于指定log4j自动重新分配的检测间隔时间,最小间隔5s
2.2 子节点Appenders :输出源,用于定义日志输出的地方
log4j2支持的输出源有很多,有控制台Console、文件File、RollingRandomAccessFile、MongoDB、Flume 等
常见子节点:Console、RollingFile、File
2.2.1 Console:用于定义输出到控制台的Appender
-
name:指定Appender名字
-
target:SYSTEM_OUT 或 SYSTEM_ERR,一般只设置默认:SYSTEM_OUT
-
PatternLayout:输出格式,不设置默认为%m%n
2.2.2 File: 用于定义输出到指定位置的文件的Appender
-
name: 指定Appender名字
-
fileName: 指定输出日志的目的文件带全路径的文件名
-
PatternLayout:输出格式,不设置默认为%m%n
2.2.3 RollingFile: 定义指定方式触发新的Appender
-
name:指定Appender名字
-
fileName: 输出日志文件的名字,带全路径
-
filePattern:归档日志文件的文件名模式
-
PatternLayout:输出格式,不设置默认为%m%n
-
Policies: 指定滚动日志的策略
-
TimeBasedTriggeringPolicy:Policies 子节点,基于时间的滚动策略。interval 属性根据日期模式中最具体的时间单位进行翻转的频率,默认为1。
-
SizeBasedTriggeringPolicy:Policies 子节点,基于文件大小的滚动策略。size属性用来定义每个日志文件的大小。大小可以以字节为单位指定,后缀为KB,MB或GB,例如20MB。
-
DefaultRolloverStrategy:用来指定同一文件夹最多有几个日志文件时开始删除最旧的,创建新的(通过max属性)。
2.3 子节点Loggers:日志器
常见子节点:Root和Logger
2.3.1 Root: 指定项目的根日志,如果没有单独制定Logger,默认使用该Root日志输出
-
level:日志的输出级别,共8个级别,按照从低到高为 All < Trace < Debug < Info < Warn < Error < Fatal < OFF。
-
AppenderRef:Root的子节点,指定该日志输出到哪个Appender。
2.3.2 Logger: 用来单独指定日志的形式
- level: 日志的输出级别,和Root的一致
- name: 用来指定该Logger所适用的类或者类所在的包全路径,继承自Root节点
- AppenderRef:Logger的子节点,用来指定该日志输出到哪个Appender,如果没有指定,就默认继承自Root.若指定了。那么会在指定的这个Appender和Root的Appnder中都输出,此时我们可以设置Logger的additivity="false"只在自定义的Appender中进行输出。
3.配置模板
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<!--全局参数-->
<Properties>
<Property name="pattern">%d{yyyy-MM-dd HH:mm:ss,SSS} %5p %c{1}:%L - %m%n</Property>
<Property name="logDir">/data/logs/dust-server</Property>
</Properties>
<Loggers>
<Root level="INFO">
<AppenderRef ref="console"/>
<AppenderRef ref="rolling_file"/>
</Root>
</Loggers>
<Appenders>
<!-- 定义输出到控制台 -->
<Console name="console" target="SYSTEM_OUT" follow="true">
<!--控制台只输出level及以上级别的信息-->
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
<PatternLayout>
<Pattern>${pattern}</Pattern>
</PatternLayout>
</Console>
<!-- 同一来源的Appender可以定义多个RollingFile,定义按天存储日志 -->
<RollingFile name="rolling_file"
fileName="${logDir}/dust-server.log"
filePattern="${logDir}/dust-server_%d{yyyy-MM-dd}.log">
<ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
<PatternLayout>
<Pattern>${pattern}</Pattern>
</PatternLayout>
<Policies>
<TimeBasedTriggeringPolicy interval="1"/>
</Policies>
<!-- 日志保留策略,配置只保留七天 -->
<DefaultRolloverStrategy>
<Delete basePath="${logDir}/" maxDepth="1">
<IfFileName glob="dust-server_*.log" />
<IfLastModified age="7d" />
</Delete>
</DefaultRolloverStrategy>
</RollingFile>
</Appenders>
</Configuration>
<?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{50} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Root level="debug">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>