log4j是一个被广泛使用的Java日志记录框架,通过使用该框架,我们可以在自己的项目中根据自身需求灵活配置日志输出格式,从而获得期望格式的日志信息,用于后续分析、错误排查等。log4j2则是原有log4j的升级版本,该版本使用更加简洁方便。
log4j2使用步骤
注:小编我目前使用的 IDE 为 Intellij,自从写Android代码时使用了Android Studio后,就爱上了 Intellij 这一系列的产品了。
- 下载 log4j2 的JAR包:从http://logging.apache.org/log4j/2.x/download.html 官网下载最新版Apache Log4j 2 binary 压缩包,解压后会得到许多JAR包,只需要将其中的 log4j-core-2.7.jar 和 log4j-api-2.7.jar 添加到项目中即可;
- 在项目的 src 文件夹下添加 log4j2.xml 文件,该文件为 log4j2 的配置文件,默认文件内容为:
<?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>
- 在项目中使用 log4j2:
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
public class LogTest {
// 获取 Logger 实例
static Logger logger = LogManager.getLogger();
public static void main(String[] args) {
logger.trace("I am a trace message");
logger.warn("I am a warn message");
logger.error("I am a error message");
logger.info("I am a info message");
logger.fatal("I am a fatal message");
}
}
效果如下图所示:
日志效果图-1咦?上面明明定义了五条日志信息,怎么控制台就显示了两条呢?细致的读者maybe会有如此困惑。小小剧透一波:此玄机存在于 log4j 的配置文件中,若想一探究竟,就继续随我一起仔细探究吧!
log4j2 日志级别
log4j2 中默认的日志级别为:trace < debug < info < warn < error < fatal
当设置了日志输出级别时,当前级别及以上级别的日志会输出,而当前级别以下级别的日志则不会输出,系统默认输出级别为 error,也就是说默认设置下,只有 error 和 fatal这两级日志会输出,这也就解释了为什么上面只输出了两条日志信息
- trace:即追踪,程序每推进一步均可输出一条trace日志,主要用于展现程序运行轨迹
- debug:调试
- info:输出你感兴趣的信息,一般用于基本的、高层次的诊断信息。在长时间运行的代码段开始运行及结束运行时应该产生消息,以便知道现在系统在干什么。但是这样的信息不宜太过频繁
- warn:提示信息
- error:错误信息,显示一个错误,或一个通用的错误情况,但还不至于会将系统挂起。这种程度的错误一般会触发邮件的发送,将消息发送到alert list中,运维人员可以在文档中记录这个bug并提交
- fatal:会导致程序崩溃的重大错误,用在极端的情形中,即必须马上获得注意的情况
log4j2 日志组件
下图是Apache官网贴出的log4j的类图,通过该类图可以清晰地看出log4j的类层次结构。
log4j2类层次结构图由类图可以看出:log4j2中主要包含如下概念/组成部分:Loggerontext、Configuration、Filter、Logger、LoggerConfig、Appender、Layout等,后文会详细解释这些概念。
log4j2 由以下三个核心组件组成:
- Loggers:Logger负责捕捉事件并将其发送给合适的Appender;
- Appenders:负责对Logger传来的日志事件进行处理,如过滤、格式化等,然后将处理后的日志事件记录到指定位置;
- Layouts:负责对日志事件中的数据进行转换和格式化;Layouts决定了数据在一条日志记录中的最终形式。
当Logger记录一个事件时,它将事件转发给适当的Appender。然后Appender使用Layout来对日志记录进行格式化,并将其发送给控制台、文件或其它目标位置。另外,Filters可以让你进一步指定一个Appender是否可以应用在一条特定的日志记录上。在日志配置中,Filters并不是必需的,但可以让你更灵活地控制日志消息的流动。
log4j2核心概念
Loggerontext
LoggerContext在Logger系统中扮演着锚点的角色,一般来说,一个应用只会存在于一个LoggerContext中,但是也可以根据使用场景的差异和项目的具体需求,为一个项目配置多个不同的LoggerContext。在同一个LoggerContext下,log系统是可以互通的。
Configuration
Configuration顾名思义,即是当前LoggerContext中的所有Logger的配置环境,每一个LoggerContext均会拥有一个动态可配置的Configuration,该Configuration 包含了当前LoggerContext环境中所有的Loggers、Appenders、Filters、Layouts等配置信息。注意:在reConfiguration期间,新旧Configuration均会同时存在,然而一旦重配过程结束,旧的Configuration就会失效,配置信息会重定向至新的Configuration中。
Logger
Logger是一个通过给LoggerManager.getLogger()方法传递特定的Logger名称而获得的一个AbstractLogger实现类对象,该对象自身并不具体进行任何操作,而是通过关联一个LoggerConfig完成具体的Logger配置,并通过实现AbstractLogger的方法进行具体的操作。注意:通过同一个名称获得的Logger对象会指向同一个Logger引用。
LoggerConfig
LoggerConfig包含了一个Logger对象的具体配置信息,如该Logger关联的Appenders、Filters、过滤级别等。
Filter
过滤器,定义LogEvent的过滤规则。log4j中定义了三种过滤状态:Accept(接受)、Deny(拒绝)和Nertual(中立)。
Accept:该LogEvent将被执行而无需调用其它过滤器;
Deny:忽略当前LogEvent,并将该LogEvent的控制权移交给过滤器调用者;
Nertual:中立,也就是说,当前LogEvent应该传递给其它过滤器,如果没有别的过滤器可以传递了,那么就由现在这个过滤器来处理。
Appender
Appender意为输出目的地,负责将日志消息转发给期望的输出。它负责接收日志事件,使用Layout格式化事件,然后将其发送给对应的目标。对于一个日志事件,我们可以使用多个Appenders来将事件发送到不同的目标位置。例如,我们可以在控制台上显示一个简单的日志事件的同时,将其通过邮件的方式发送给指定的接收者。目前,Appender可以是console、文件、远程socket服务器、Apache Flume、JMS以及远程 UNIX 系统日志守护进程等。
注意:
在某一个Logger中被启用的log请求将被转发到该Logger相关联的的所有Appenders上,并且还会被转发到LoggerConfig的父级的Appenders上。由此可知,如果设置不当的话,会产生一系列的遗传反应。如:Logger A 继承自 Logger B,并且两者均是root的子节点,若LoggerConfig B 中定义了一个文件作为Appender的话,那么使用LoggerConfig A和LoggerConfig B的logger 的log请求都会在该文件中打印,文件中便会显示很多重复的日志信息,这会给日志分析带来不必要的麻烦。还好这是可以被避免的,通过设置 Appender 的 additivity属性为false即可。(默认情况下,additivity="true")
Layout:
Layout用于定义LogEvent的输出格式。
log4j2配置方式
log4j2 有如下四种配置方式,可以根据你的意愿、喜好等自行选择:
- 通过配置文件进行配置,配置文件可以是 XML、 JSON、 YAML 和 properties这四种类型中的任意一种;
- 在代码中创建 ConfigurationFactory 和 Configuration 累的实现类;
- 在代码中调用Configuration 接口的 API 在默认配置类上添加组件;
- 在代码中调用内部类 Logger 的方法实现自定义。
通过配置文件配置log4j
目前小编还只使用了文件的配置方式,所以本文着重于通过配置文件配置log4j,以后有机会再好好研究一波代码配置的方式,然后与看官分享 _。
文件配置优先级
对应于四类配置文件:XML、 JSON、 YAML 和 properties,Log4j 分别有与之相应的 ConfigurationFactory 实现类,不同的实现类可以加载不同扩展名的配置文件中的配置信息。当 Log4j 启动时会按照一定的优先级顺序在classpath(一般是项目的src文件夹下)查找项目中的配置文件,若找到一个配置文件,就调用与当前文件扩展名对应的ConfigurationFactory实现类加载该配置文件中的配置信息,否则继续查找下一优先级的配置文件,若未找到任何配置文件,就使用默认配置DefaultConfiguration。
不同配置文件的优先级如下图所示:
配置文件详解
如下是个比较完整详细的 XML 形式的配置文件,该文件通过注释的方式提供简要解释以便于理解。
<?xml version="1.0" encoding="UTF-8"?>
<!-- configuration 有多个属性,常用的有:name(配置名)
status(是否记录log4j2本身的event信息,默认是OFF,
可选值有: "trace", "debug", "info", "warn", "error" and "fatal")
dest(错误流输出位置,标准错误流、文件或远程邮件发送)
strict(是否使用strict xml形式,configuration支持concise(简约)和strict(严格)两种模式的xml。
简约模式下,使得文件编写起来更简洁) -->
<configuration status="OFF">
<!-- 定义如下几个引用名,用于后面配置文件中使用 -->
<Properties>
<property name="log_pattern">%d{yyyy-MM-dd HH:mm:ss z} %-5level %class{36}%L%M - %msg%xEx%n
</property><!-- 日志输出格式 -->
<property name="log-path">${web:rootDir}/logs</property><!-- ${web:rootDir}是项目根目录 -->
<property name="every_file_size">5M</property><!-- 日志切割的最小单位 -->
<property name="output_log_level">debug</property><!-- 日志输出级别 -->
</Properties>
<!-- 先定义所有的appender(日志输出位置) -->
<appenders>
<!-- 输出到控制台 name: 当前appender名 target: 目的位置-->
<Console name="Console" target="SYSTEM_OUT">
<!-- ThresholdFilter: 用于定义过滤机制 -->
<!-- level: 日志过滤级别 -->
<!-- onMatch="ACCEPT":保留level 及以上级别的日志 -->
<!-- onMismatch="DENY":丢掉level 以下级别的日志-->
<!-- onMatch 和 onMissmatch 可选值为:ACCEPT DENY NEUTRAL-->
<ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY" />
<!--这个都知道是输出日志的格式 -->
<PatternLayout pattern="${log_pattern}" />
</Console>
<!-- debug级别日志文件 -->
<!-- RollingFile:日志滚动输出 -->
<!--每次大小超过size,则这size大小的日志会自动进行压缩,作为存档 -->
<RollingFile name="app_debug" fileName="${log-path}/debug/debug.log"
filePattern="${log-path}/debug/debug-%d{yyyy-MM-dd}-%i.log.gz">
<Filters>
<ThresholdFilter level="info" onMatch="DENY" onMismatch="NEUTRAL" />
<ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="NEUTRAL" />
</Filters>
<PatternLayout pattern="${log_pattern}" />
<!-- SizeBasedTriggeringPolicy: 基于日志大小切分日志 -->
<SizeBasedTriggeringPolicy size="${every_file_size}"/>
</RollingFile>
<!-- info级别日志文件 -->
<RollingFile name="app_info" fileName="${log-path}/info/info.log"
filePattern="${log-path}/info/info-%d{yyyy-MM-dd}-%i.log.gz">
<Filters>
<ThresholdFilter level="warn" onMatch="DENY" onMismatch="NEUTRAL" />
<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
</Filters>
<PatternLayout pattern="${log_pattern}" />
<SizeBasedTriggeringPolicy size="${every_file_size}"/>
</RollingFile>
<!-- error级别日志文件 -->
<RollingFile name="app_error" fileName="${log-path}/error/error.log"
filePattern="${log-path}/error/error-%d{yyyy-MM-dd}-%i.log.gz">
<Filters>
<ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY" />
</Filters>
<PatternLayout pattern="${log_pattern}" />
<SizeBasedTriggeringPolicy size="${every_file_size}"/>
</RollingFile>
</appenders>
<!-- 定义logger,只有定义了logger并引入之前定义的appender,appender才会生效 -->
<loggers>
<!--建立一个默认的root的logger,需要在root的level中指定输出的级别, -->
<root level="${output_log_level}">
<appender-ref ref="Console" />
<appender-ref ref="app_debug"/>
<appender-ref ref="app_info"/>
<appender-ref ref="app_error"/>
</root>
</loggers>
</configuration>
log4j2 配置节点分析
configuration
configuration决定了当前上下文的loggers配置信息,是配置文件根节点,主要包含如下属性值:
- name:当前配置的名称
- dest:输出位置,标准错误流、文件或远程邮件发送
- status:是否记录 Log4j 自身的event信息,默认为 off,可选值有: "trace", "debug", "info", "warn", "error" and "fatal"
- strict:是否使用strict xml形式,configuration支持concise(简约)和strict(严格)两种模式的xml。简约模式下,使得文件编写起来更简洁
Appenders
Appenders用于定义当前LoggerContext中所需要使用到的Appender。目前log4j2提供了多种不同类型的appender可供配置。如下介绍几种常用的,如果想了解更全面的信息,可移步官网
Appender类型
ConsoleAppender:
ConsoleAppender是最常用的Appenders之一,它只是将日志消息显示到控制台上。log4j2的默认Appender即为ConsoleAppender。
ConsoleAppender参数如下:
- filter:用于决定是否需要使用该Appender来处理当前日志事件,通过使用CompositeFilter可以组合使用多个Filter;
- layout:用于决定如何对日志记录进行格式化,默认情况下使用“%m%n”,它会在每一行显示一条日志记录;
- follow:用于决定Appender是否需要了解输出(system.out或者system.err)的变化,默认情况是不需要跟踪这种变化;
- name:用于设置Appender的名字;
- ignoreExceptions:默认为true,用于决定是否需要记录在日志事件处理过程中出现的异常;
- target:用于指定输出目标位置,默认情况下使用SYSTEM_OUT,但也可以修改成SYSTEM_ERR
FileAppender:
FileAppenders将日志记录写入到文件中,它负责打开、关闭文件,向文件中追加日志记录,并对文件进行加锁,以免数据被破坏或者覆盖。
FileAppender参数如下:
- append:是否追加写入,默认为true,表示将日志事件追加在文件末尾,若设置为false,则每次都会先清空文件,然后将日志事件写入文件中;
- bufferedIO:默认为true,表示使用缓存,也就是说每次进行日志输出时会先将日志事件输出到缓存中,缓存满或者设置了immediateFlush 时,才将日志事件写入磁盘文件。注意:llocking属性不能与该属性同时使用;
- bufferSize:缓存大小,默认为8192字节;
- createOnDemand:当需要时才创建日志文件,即只有当有日志事件需要被输出到该文件中时才创建文件;
- filter:过滤器,含义与ConsoleAppender中相似;
- fileName:日志文件名;
- immediateFlush:表示每次写完日志后均进行flush,这可以保证每次日志均被写入磁盘中了;
- layout:格式化;
- locking:是否对该日志文件加锁,一般用于多主机场景中,默认为false,该属性对性能影响较大,需要谨慎使用;
- name:Appender名称;
- ignoreExceptions:用法同ConsoleAppender。
RollingFileAppender
滚动输出日志到文件中,RollingFileAppender 根据TriggeringPolicy 和RolloverPolicy滚动将日志事件输出到fileName指定的文件中。TriggeringPolicy用于决定是否触发RolloverPolicy所定义的日志滚动操作,若未设置RolloverPolicy ,则会使用默认设置 DefaultRolloverStrategy。
RollingFileAppender参数如下:
- append、bufferedIO、bufferSize、createOnDemand、filter、fileName、immediateFlush、layout、name、ignoreExceptions等属性与FileAppender类似,就不一一概述了;
- filePattern:存档日志文件的文件名模式,模式格式依赖于所采用的RolloverPolicy ;
- policy:TriggeringPolicy,触发策略;触发策略有如下几种:Composite Triggering Policy(组合策略)、CronTriggeringPolicy(定时触发)、OnStartupTriggeringPolicy(JVM虚拟机启动时触发)、SizeBasedTriggeringPolicy(基于日志文件大小触发)、TimeBasedTriggeringPolicy(基于时间触发)
- strategy:RolloverStrategy,决定存档文件名称、数量和位置的策略。
其它Appender:
SyslogAppenders将日志记录发送给本地或者远程系统的日志服务;SMTPAppender会将日志内容以邮件的形式发送出去;FailoverAppender设置在处理日志的过程中,如果一个或者多个Appender失败,自动切换到其他Appender上等,更多信息详见官网
Layout
log4j2中使用较多的Layout为PatternLayout,格式为:
<PatternLayout pattern = "%d{yyyy-MM-dd HH:mm:ss z} %-5level %class{36}%L%M - %msg%xEx%n" />
%d{HH:mm:ss:SSS}:日志输出时间,精确到毫秒
%t:当前线程名称
%-5level:日志级别,-5表示左对齐并固定输出5个字符,如果不足右边补零
%logger:logger名称
%msg:日志文本
%n:换行
%F:文件所在的类文件名
%L:行号
%M:所在方法名
%l:语句所在的行数,包括类名,方法名,文件名,行数
网友评论