Java 日志

一、摘要

不管是使用何种编程语言,何种框架,日志输出几乎无处不再,也是任何商业软件中必不可少的一部分。
总结起来,日志的用途大致可以归纳成以下三种:

  • 问题追踪:通过日志不仅仅包括程序的一些bug,也可以在安装配置时,通过日志可以发现问题。
  • 状态监控:通过实时分析日志,可以监控系统的运行状态,做到早发现问题、早处理问题。
  • 安全审计:审计主要体现在安全上,通过对日志进行分析,可以发现是否存在非授权的操作。

以 Java 编程语言为例,打印日志的方式有很多,例如通过System.out.print()方法将关键信息输出到控制台,也可以通过 JDK 自带的日志Logger类输出,虽然 JDK 从1.4开始支持日志输出,但是功能单一,无法更好的满足商业要求,于是诞生了很多第三方日志库,像熟悉的主流框架log4jlog4j2logback等,提供的 API 功能都远胜 JDK 提供的Logger

二、Log4j

2.1、介绍

Log4j 是一种非常流行的日志框架,由Ceki Gülcü首创,之后将其开源贡献给 Apache 软件基金会。
Log4j 有三个主要的组件:Loggers(记录器),Appenders (输出源)和Layouts(布局)。这里可简单理解为日志类别日志要输出的地方日志以何种形式输出
综合使用这三个组件可以轻松地记录信息的类型和级别,并可以在运行时控制日志输出的样式和位置。
Log4j 的架构大致如下:
Log配置教程及框架性能比较 - 图1
当使用 Log4j 输出一条日志时,Log4j 自动通过不同的Appender(输出源)把同一条日志输出到不同的目的地。例如:

  • console:输出到屏幕;
  • file:输出到文件;
  • socket:通过网络输出到远程计算机;
  • jdbc:输出到数据库

在输出日志的过程中,通过Filter来过滤哪些log需要被输出,哪些log不需要被输出。
Loggers(记录器)组件中,级别分五种:DEBUGINFOWARNERRORFATAL
这五个级别是有顺序的,DEBUG < INFO < WARN < ERROR < FATAL,分别用来指定这条日志信息的重要程度,明白这一点很重要,Log4j有一个规则:只输出级别不低于设定级别的日志信息
假设Loggers级别设定为INFO,则INFOWARNERRORFATAL级别的日志信息都会输出,而级别比INFO低的DEBUG则不会输出。
最后,通过Layout来格式化日志信息,例如,自动添加日期、时间、方法名称等信息。
具体输出样式配置,可以参考如下内容Log4j2 - Layouts布局介绍

2.2、项目应用

以 Java 项目为例,在 Maven 的pom.xml中添加如下依赖!

2.2.1、添加 maven 依赖

  1. <dependencies>
  2. <dependency>
  3. <groupId>org.slf4j</groupId>
  4. <artifactId>slf4j-api</artifactId>
  5. <version>1.6.6</version>
  6. </dependency>
  7. <dependency>
  8. <groupId>org.slf4j</groupId>
  9. <artifactId>slf4j-log4j12</artifactId>
  10. <version>1.6.6</version>
  11. </dependency>
  12. <dependency>
  13. <groupId>log4j</groupId>
  14. <artifactId>log4j</artifactId>
  15. <version>1.2.17</version>
  16. </dependency>
  17. </dependencies>

2.2.2、创建log4j配置

在实际应用中,要使Log4j在系统中运行须事先设定配置文件。
配置文件实际上也就是对LoggerAppenderLayout进行相应设定。
Log4j支持两种配置文件格式,一种是XML格式的文件,一种是properties属性文件,二选一。
创建一个log4j.xml或者log4j.properties,将其放入项目根目录下。

1、XML格式
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE log4j:configuration PUBLIC "-//APACHE//DTD LOG4J 1.2//EN" "log4j.dtd">
  3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
  4. <!-- 控制台输出配置 -->
  5. <appender name="console" class="org.apache.log4j.ConsoleAppender">
  6. <!-- 目标为控制台 -->
  7. <param name="Target" value="System.out" />
  8. <layout class="org.apache.log4j.PatternLayout">
  9. <!-- 输出格式 -->
  10. <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5p %l %m%n" />
  11. </layout>
  12. </appender>
  13. <!-- 文件输出配置 -->
  14. <appender name="log_file" class="org.apache.log4j.DailyRollingFileAppender">
  15. <!-- 目标为文件 -->
  16. <param name="File" value="/logs/log/file.log" />
  17. <!-- 向文件追加输出 -->
  18. <param name="Append" value="true" />
  19. <!-- 每个小时生成一个log -->
  20. <param name="DatePattern" value="'.'yyyy-MM-dd-HH" />
  21. <layout class="org.apache.log4j.PatternLayout">
  22. <!-- 输出格式 -->
  23. <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5p %l %m%n" />
  24. </layout>
  25. </appender>
  26. <!-- Application Loggers -->
  27. <logger name="org.example">
  28. <level value="info" />
  29. </logger>
  30. <!-- 根目录 -->
  31. <!-- Root Logger -->
  32. <root>
  33. <priority value="info" />
  34. <appender-ref ref="console" />
  35. <appender-ref ref="log_file" />
  36. </root>
  37. </log4j:configuration>

2、properties格式
  1. log4j.rootLogger=INFO,M,C,E
  2. log4j.additivity.monitorLogger=false
  3. # INFO级别文件输出配置
  4. log4j.appender.M=org.apache.log4j.DailyRollingFileAppender
  5. log4j.appender.M.File=/logs/info.log
  6. log4j.appender.M.ImmediateFlush=false
  7. log4j.appender.M.BufferedIO=true
  8. log4j.appender.M.BufferSize=16384
  9. log4j.appender.M.Append=true
  10. log4j.appender.M.Threshold=INFO
  11. log4j.appender.M.DatePattern='.'yyyy-MM-dd
  12. log4j.appender.M.layout=org.apache.log4j.PatternLayout
  13. log4j.appender.M.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} %p %l %m %n
  14. # ERROR级别文件输出配置
  15. log4j.appender.E=org.apache.log4j.DailyRollingFileAppender
  16. log4j.appender.E.File=/logs/error.log
  17. log4j.appender.E.ImmediateFlush=true
  18. log4j.appender.E.Append=true
  19. log4j.appender.E.Threshold=ERROR
  20. log4j.appender.E.DatePattern='.'yyyy-MM-dd
  21. log4j.appender.E.layout=org.apache.log4j.PatternLayout
  22. log4j.appender.E.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} %p %l %m %n
  23. # 控制台输出配置
  24. log4j.appender.C=org.apache.log4j.ConsoleAppender
  25. log4j.appender.C.Threshold=INFO
  26. log4j.appender.C.layout=org.apache.log4j.PatternLayout
  27. log4j.appender.C.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%t] %-5p %l %m %n

2.2.3、log4j使用

在需要打印日志的类中,引入Logger类,在需要的地方打印即可!

  1. package org.example.log4j.service;
  2. import org.slf4j.Logger;
  3. import org.slf4j.LoggerFactory;
  4. public class LogPrintUtil {
  5. /**log静态常量*/
  6. private static final Logger logger = LoggerFactory.getLogger(LogPrintUtil.class);
  7. public static void main(String[] args){
  8. logger.info("info信息");
  9. logger.warn("warn信息");
  10. logger.error("error信息");
  11. }
  12. }

当然还可以这样写

  1. if(logger.isInfoEnabled()) {
  2. logger.info("info信息");
  3. }
  4. if(logger.isWarnEnabled()) {
  5. logger.warn("warn信息");
  6. }

2.2.4、isInfoEnabled()的作用

简单来说,在某些场景下,用isInfoEnabled()方法判断下是能提升性能的!
例如打印这段内容logger.info("User:" + userId + appId),程序在打印这行代码时,先对内容("User:" + userId + appId)进行字符串拼接,然后再输出。
如果当前配置文件中日志输出级别是info,是直接输出的,当日志输出级别是error时,logger.info()的内容时不输出的,但是却进行了字符串拼接,如果加上if(logger.isInfoEnabled())进行一次判定,logger.info()就不会执行,从而更好的提升性能,这个尤其是在高并发和复杂log打印情况下提升非常显著。
另外,ERROR及其以上级别的log信息是一定会被输出的,所以只有logger.isDebugEnabledlogger.isInfoEnabledlogger.isWarnEnabled()方法,而没有logger.isErrorEnabled方法。

三、Log4j2

3.1、介绍

log4j2 是 log4j 1.x 的升级版,参考了 logback 的一些优秀的设计,并且修复了一些问题,因此带来了一些重大的提升,主要特点有:
Log配置教程及框架性能比较 - 图2

  • 异常处理:在logback中,Appender中的异常不会被应用感知到,但是在log4j2中,提供了一些异常处理机制。
  • 性能提升, log4j2相较于log4j 1和logback都具有很明显的性能提升,后面会有官方测试的数据。
  • 自动重载配置:参考了logback的设计,当然会提供自动刷新参数配置,最实用的就是在生产上可以动态的修改日志的级别而不需要重启应用——那对监控来说,是非常敏感的。
  • 无垃圾机制:log4j2在大部分情况下,都可以使用其设计的一套无垃圾机制,避免频繁的日志收集导致的jvm gc。

    3.2、项目应用

    3.2.1、添加 maven 依赖

    1. <dependencies>
    2. <!-- slf4j核心包 -->
    3. <dependency>
    4. <groupId>org.slf4j</groupId>
    5. <artifactId>slf4j-api</artifactId>
    6. <version>1.7.13</version>
    7. </dependency>
    8. <!--用于与common-log保持桥接 -->
    9. <dependency>
    10. <groupId>org.slf4j</groupId>
    11. <artifactId>jcl-over-slf4j</artifactId>
    12. <version>1.7.13</version>
    13. <scope>runtime</scope>
    14. </dependency>
    15. <!--核心log4j2jar包 -->
    16. <dependency>
    17. <groupId>org.apache.logging.log4j</groupId>
    18. <artifactId>log4j-api</artifactId>
    19. <version>2.4.1</version>
    20. </dependency>
    21. <dependency>
    22. <groupId>org.apache.logging.log4j</groupId>
    23. <artifactId>log4j-core</artifactId>
    24. <version>2.4.1</version>
    25. </dependency>
    26. <!--用于与slf4j保持桥接 -->
    27. <dependency>
    28. <groupId>org.apache.logging.log4j</groupId>
    29. <artifactId>log4j-slf4j-impl</artifactId>
    30. <version>2.4.1</version>
    31. </dependency>
    32. <!--需要使用log4j2的AsyncLogger需要包含disruptor -->
    33. <dependency>
    34. <groupId>com.lmax</groupId>
    35. <artifactId>disruptor</artifactId>
    36. <version>3.2.0</version>
    37. </dependency>
    38. </dependencies>

    3.2.2、创建log4j2配置

    在项目的根目录下创建一个log4j2.xml的文件,与log4j相比,log4j2的异步输出日志性能非常强劲,配置如下:

    1、同步输出日志
    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <!-- status : 这个用于设置log4j2自身内部的信息输出,可以不设置,当设置成trace时。
    3. 注:本配置文件的目标是将不同级别的日志输出到不同文件,最大1MB一个文件,
    4. 文件数据达到最大值时,旧数据会被压缩并放进指定文件夹 ,最多存放20个文件-->
    5. <Configuration status="error">
    6. <!-- 配置日志文件输出目录,此配置将日志输出到根目录下的指定文件夹 -->
    7. <Properties>
    8. <Property name="fileDir">/logs/log4j2</Property>
    9. <Property name="fileHistory">/logs/log4j2/history</Property>
    10. </Properties>
    11. <Appenders>
    12. <!-- 优先级从高到低分别是 OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL -->
    13. <!-- 单词解释:Match:匹配 DENY:拒绝 Mismatch:不匹配 ACCEPT:接受 -->
    14. <!-- DENY,日志将立即被抛弃不再经过其他过滤器;NEUTRAL,有序列表里的下个过滤器过接着处理日志;ACCEPT,日志会被立即处理,不再经过剩余过滤器。 -->
    15. <!--输出日志的格式
    16. %d{yyyy-MM-dd HH:mm:ss, SSS} : 日志生产时间
    17. %t 输出当前线程名称
    18. %-5level 输出日志级别,-5表示左对齐并且固定输出5个字符,如果不足在右边补0
    19. %logger 输出logger名称,因为Root Logger没有名称,所以没有输出
    20. %msg 日志文本
    21. %n 换行
    22. 其他常用的占位符有:
    23. %F 输出所在的类文件名,如Client.java
    24. %L 输出行号
    25. %M 输出所在方法名
    26. %l 输出语句所在的行数, 包括类名、方法名、文件名、行数
    27. -->
    28. <!--这个输出控制台的配置,这里输出all信息到System.out -->
    29. <console name="Console" target="SYSTEM_OUT">
    30. <!-- 输出日志的格式 -->
    31. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    32. </console>
    33. <!--这个输出文件的配置,这里输出info信息到junbao_info.log -->
    34. <RollingFile name="RollingFileInfo" fileName="${fileDir}/info.log" filePattern="${fileHistory}/info/%d{yyyy-MM-dd}-%i.log">
    35. <!-- 此Filter意思是,只输出info级别的数据 DENY,日志将立即被抛弃不再经过其他过滤器;NEUTRAL,有序列表里的下个过滤器过接着处理日志;
    36. ACCEPT,日志会被立即处理,不再经过剩余过滤器。 -->
    37. <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
    38. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    39. <Policies>
    40. <!-- 如果启用此配置,则日志会按文件名生成新文件, 即如果filePattern配置的日期格式为 %d{yyyy-MM-dd HH}
    41. ,则每小时生成一个压缩文件, 如果filePattern配置的日期格式为 %d{yyyy-MM-dd} ,则天生成一个压缩文件,默认为1 -->
    42. <TimeBasedTriggeringPolicy />
    43. <!-- 每个日志文件最大1MB,超过1MB生产新的文件 ; -->
    44. <SizeBasedTriggeringPolicy size="100MB" />
    45. </Policies>
    46. <!--文件夹下最多的文件个数-->
    47. <DefaultRolloverStrategy max="20" />
    48. </RollingFile>
    49. <RollingFile name="RollingFileWarn" fileName="${fileDir}/warn.log" filePattern="${fileHistory}/warn/%d{yyyy-MM-dd}-%i.log">
    50. <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY" />
    51. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    52. <Policies>
    53. <TimeBasedTriggeringPolicy />
    54. <SizeBasedTriggeringPolicy size="100MB" />
    55. </Policies>
    56. <DefaultRolloverStrategy max="20" />
    57. </RollingFile>
    58. <RollingFile name="RollingFileError" fileName="${fileDir}/error.log" filePattern="${fileHistory}/error/%d{yyyy-MM-dd}-%i.log">
    59. <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY" />
    60. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    61. <Policies>
    62. <TimeBasedTriggeringPolicy />
    63. <SizeBasedTriggeringPolicy size="100MB" />
    64. </Policies>
    65. <DefaultRolloverStrategy max="20" />
    66. </RollingFile>
    67. </Appenders>
    68. <!--然后定义logger,只有定义了logger并引入的appender,appender才会生效 -->
    69. <Loggers>
    70. <!--全异步输出info级以上的日志信息-->
    71. <!-- <asyncRoot level="info" includeLocation="true">
    72. <appender-ref ref="Console" />
    73. <appender-ref ref="RollingFileInfo" />
    74. </asyncRoot> -->
    75. <!--同步输出info级以上的日志信息-->
    76. <root level="info" includeLocation="true">
    77. <appender-ref ref="Console" />
    78. </root>
    79. </Loggers>
    80. </Configuration>

    2、异步输出日志
    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <!-- status : 这个用于设置log4j2自身内部的信息输出,可以不设置,当设置成trace时。
    3. 注:本配置文件的目标是将不同级别的日志输出到不同文件,最大1MB一个文件,
    4. 文件数据达到最大值时,旧数据会被压缩并放进指定文件夹 ,最多存放20个文件-->
    5. <Configuration status="error">
    6. <!-- 配置日志文件输出目录,此配置将日志输出到根目录下的指定文件夹 -->
    7. <Properties>
    8. <Property name="fileDir">/logs/log4j2</Property>
    9. <Property name="fileHistory">/logs/log4j2/history</Property>
    10. </Properties>
    11. <Appenders>
    12. <!-- 优先级从高到低分别是 OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL -->
    13. <!-- 单词解释:Match:匹配 DENY:拒绝 Mismatch:不匹配 ACCEPT:接受 -->
    14. <!-- DENY,日志将立即被抛弃不再经过其他过滤器;NEUTRAL,有序列表里的下个过滤器过接着处理日志;ACCEPT,日志会被立即处理,不再经过剩余过滤器。 -->
    15. <!--输出日志的格式
    16. %d{yyyy-MM-dd HH:mm:ss, SSS} : 日志生产时间
    17. %t 输出当前线程名称
    18. %-5level 输出日志级别,-5表示左对齐并且固定输出5个字符,如果不足在右边补0
    19. %logger 输出logger名称,因为Root Logger没有名称,所以没有输出
    20. %msg 日志文本
    21. %n 换行
    22. 其他常用的占位符有:
    23. %F 输出所在的类文件名,如Client.java
    24. %L 输出行号
    25. %M 输出所在方法名
    26. %l 输出语句所在的行数, 包括类名、方法名、文件名、行数
    27. -->
    28. <!--这个输出控制台的配置,这里输出all信息到System.out -->
    29. <console name="Console" target="SYSTEM_OUT">
    30. <!-- 输出日志的格式 -->
    31. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    32. </console>
    33. <!--这个输出文件的配置,这里输出info信息到junbao_info.log -->
    34. <RollingFile name="RollingFileInfo" fileName="${fileDir}/info.log" filePattern="${fileHistory}/info/%d{yyyy-MM-dd}-%i.log">
    35. <!-- 此Filter意思是,只输出info级别的数据 DENY,日志将立即被抛弃不再经过其他过滤器;NEUTRAL,有序列表里的下个过滤器过接着处理日志;
    36. ACCEPT,日志会被立即处理,不再经过剩余过滤器。 -->
    37. <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
    38. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    39. <Policies>
    40. <!-- 如果启用此配置,则日志会按文件名生成新文件, 即如果filePattern配置的日期格式为 %d{yyyy-MM-dd HH}
    41. ,则每小时生成一个压缩文件, 如果filePattern配置的日期格式为 %d{yyyy-MM-dd} ,则天生成一个压缩文件,默认为1 -->
    42. <TimeBasedTriggeringPolicy />
    43. <!-- 每个日志文件最大1MB,超过1MB生产新的文件 ; -->
    44. <SizeBasedTriggeringPolicy size="100MB" />
    45. </Policies>
    46. <!--文件夹下最多的文件个数-->
    47. <DefaultRolloverStrategy max="20" />
    48. </RollingFile>
    49. <RollingFile name="RollingFileWarn" fileName="${fileDir}/warn.log" filePattern="${fileHistory}/warn/%d{yyyy-MM-dd}-%i.log">
    50. <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY" />
    51. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    52. <Policies>
    53. <TimeBasedTriggeringPolicy />
    54. <SizeBasedTriggeringPolicy size="100MB" />
    55. </Policies>
    56. <DefaultRolloverStrategy max="20" />
    57. </RollingFile>
    58. <RollingFile name="RollingFileError" fileName="${fileDir}/error.log" filePattern="${fileHistory}/error/%d{yyyy-MM-dd}-%i.log">
    59. <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY" />
    60. <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %l %msg%n" />
    61. <Policies>
    62. <TimeBasedTriggeringPolicy />
    63. <SizeBasedTriggeringPolicy size="100MB" />
    64. </Policies>
    65. <DefaultRolloverStrategy max="20" />
    66. </RollingFile>
    67. </Appenders>
    68. <!--然后定义logger,只有定义了logger并引入的appender,appender才会生效 -->
    69. <Loggers>
    70. <!--全异步输出info级以上的日志信息-->
    71. <asyncRoot level="info" includeLocation="true">
    72. <appender-ref ref="Console" />
    73. <appender-ref ref="RollingFileInfo" />
    74. </asyncRoot>
    75. <!--同步输出info级以上的日志信息-->
    76. <!-- <root level="info" includeLocation="true">
    77. <appender-ref ref="Console" />
    78. </root> -->
    79. </Loggers>
    80. </Configuration>

    详细 API 可以参考官方网站!

    3.2.3、log4j2使用

    与 log4j 类似,直接在需要位置打印日志即可

    1. package org.example.log4j.service;
    2. import org.slf4j.Logger;
    3. import org.slf4j.LoggerFactory;
    4. public class LogPrintUtil {
    5. /**log静态常量*/
    6. private static final Logger logger = LoggerFactory.getLogger(LogPrintUtil.class);
    7. public static void main(String[] args){
    8. logger.info("info信息");
    9. logger.warn("warn信息");
    10. logger.error("error信息");
    11. }
    12. }

    四、Logback

    4.1、介绍

    Logback 也是用 java 编写一款非常热门的日志开源框架,由 log4j 创始人写的,性能比 log4j 要好!
    logback 主要分为3个模块:

  • logback-core:核心代码模块

  • logback-classic:log4j的一个改良版本,同时实现了slf4j的接口,这样如果之后要切换其他日志组件也是一件很容易的事
  • logback-access:访问模块与Servlet容器集成提供通过Http来访问日志的功能

    4.2、项目应用

    4.2.1、添加 maven 依赖

    1. <!--这个依赖直接包含了 logback-core 以及 slf4j-api的依赖-->
    2. <dependency>
    3. <groupId>ch.qos.logback</groupId>
    4. <artifactId>logback-classic</artifactId>
    5. <version>1.2.3</version>
    6. </dependency>
    7. <!-- 支持在xml中写判断标签 -->
    8. <dependency>
    9. <groupId>org.codehaus.janino</groupId>
    10. <artifactId>janino</artifactId>
    11. <version>2.7.8</version>
    12. </dependency>

    4.2.2、创建logback配置文件

    1、配置说明

    logback在启动的时候,会按照下面的顺序加载配置文件:

  • 如果java程序启动时指定了logback.configurationFile属性,就用该属性指定的配置文件。如java -Dlogback.configurationFile=/path/to/mylogback.xml Test,这样执行Test类的时候就会加载/path/to/mylogback.xml配置

  • classpath中查找logback.groovy文件
  • classpath中查找logback-test.xml文件
  • classpath中查找logback.xml文件
  • 如果是jdk6+,那么会调用ServiceLoader查找 com.qos.logback.classic.spi.Configurator接口的第一个实现类
  • 自动使用ch.qos.logback.classic.BasicConfigurator,在控制台输出日志

上面的顺序表示优先级,使用java -D配置的优先级最高,只要获取到配置后就不会再执行下面的流程。相关代码可以看ContextInitializer#autoConfig()方法。

2、同步输出日志
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- scan:当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。scanPeriod:设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。当scan为true时,此属性生效。默认的时间间隔为1分钟。
  3. debug:当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。 -->
  4. <configuration scan="true" scanPeriod="60 seconds" debug="false">
  5. <!-- 运行环境,dev:开发,test:测试,pre:预生产,pro:生产 -->
  6. <property name="system_host" value="dev" />
  7. <property file="system.properties" />
  8. <!-- 上下文变量设置,用来定义变量值,其中name的值是变量的名称,value的值时变量定义的值。 通过<property>定义的值会被插入到logger上下文中。定义变量后,可以使“${}”来使用变量。 -->
  9. <property name="CONTEXT_NAME" value="logback-test" />
  10. <!-- 日志文件存放路径设置,绝对路径 -->
  11. <property name="logs.dir" value="/opt/logs" />
  12. <!-- 日志文件存放路径设置,tomcat路径 -->
  13. <property name="logs.dir" value="${catalina.base}/logs" />
  14. <!-- 定义日志文件 相对输入位置 -->
  15. <property name="log_dir" value="log" />
  16. <!-- 日志输出格式设置 -->
  17. <!--
  18. %d{yyyy-MM-dd HH:mm:ss} [%level] - %msg%n
  19. Logger: %logger
  20. Class: %class
  21. File: %file
  22. Caller: %caller
  23. Line: %line
  24. Message: %m
  25. Method: %M
  26. Relative: %relative
  27. Thread: %thread
  28. Exception: %ex
  29. xException: %xEx
  30. nopException: %nopex
  31. rException: %rEx
  32. Marker: %marker
  33. newline:%n
  34. -->
  35. <property name="CUSTOM_LOG_PATTERN"
  36. value="%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{90} - %msg%n" />
  37. <!-- 上下文名称:<contextName>, 每个logger都关联到logger上下文, 默认上下文名称为“default”。但可以使用<contextName>设置成其他名字,用于区分不同应用程序的记录。
  38. 一旦设置,不能修改。 -->
  39. <contextName>${CONTEXT_NAME}</contextName>
  40. <!-- <appender>是<configuration>的子节点,是负责写日志的组件。 有两个必要属性name和class。name指定appender名称,
  41. class指定appender的实现类。 -->
  42. <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
  43. <!-- 对日志进行格式化。 -->
  44. <encoder>
  45. <pattern>${CUSTOM_LOG_PATTERN}</pattern>
  46. <charset>UTF-8</charset>
  47. </encoder>
  48. </appender>
  49. <appender name="file"
  50. class="ch.qos.logback.core.rolling.RollingFileAppender">
  51. <!-- 按天来回滚,如果需要按小时来回滚,则设置为{yyyy-MM-dd_HH} -->
  52. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  53. <fileNamePattern>log/testC.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  54. <!-- 如果按天来回滚,则最大保存时间为30天,30天之前的都将被清理掉 -->
  55. <maxHistory>30</maxHistory>
  56. <!-- 按时间回滚的同时,按文件大小来回滚 -->
  57. <timeBasedFileNamingAndTriggeringPolicy
  58. class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  59. <maxFileSize>100MB</maxFileSize>
  60. </timeBasedFileNamingAndTriggeringPolicy>
  61. </rollingPolicy>
  62. <!-- 过滤器,只记录WARN级别的日志 -->
  63. <!-- 果日志级别等于配置级别,过滤器会根据onMath 和 onMismatch接收或拒绝日志。 -->
  64. <filter class="ch.qos.logback.classic.filter.LevelFilter">
  65. <!-- 设置过滤级别 -->
  66. <level>WARN</level>
  67. <!-- 用于配置符合过滤条件的操作 -->
  68. <onMatch>ACCEPT</onMatch>
  69. <!-- 用于配置不符合过滤条件的操作 -->
  70. <onMismatch>DENY</onMismatch>
  71. </filter>
  72. <!-- 日志输出格式 -->
  73. <encoder>
  74. <pattern>${CUSTOM_LOG_PATTERN}</pattern>
  75. <charset>UTF-8</charset>
  76. </encoder>
  77. </appender>
  78. <appender name="log_file"
  79. class="ch.qos.logback.core.rolling.RollingFileAppender">
  80. <!-- 被写入的文件名,可以是相对目录,也可以是绝对目录,如果上级目录不存在会自动创建,没有默认值。 -->
  81. <file>${logs.dir}/logback-test.log</file>
  82. <!-- 按照固定窗口模式生成日志文件,当文件大于20MB时,生成新的日志文件。窗口大小是1到3,当保存了3个归档文件后,将覆盖最早的日志 -->
  83. <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
  84. <!-- 必须包含“%i”例如,假设最小值和最大值分别为1和2,命名模式为 mylog%i.log,会产生归档文件mylog1.log和mylog2.log。还可以指定文件压缩选项,例如,mylog%i.log.gz
  85. 或者 没有log%i.log.zip -->
  86. <FileNamePattern>${logs.dir}/logback-test.%i.log</FileNamePattern>
  87. <!-- 窗口索引最小值 -->
  88. <minIndex>1</minIndex>
  89. <!-- 窗口索引最大值 -->
  90. <maxIndex>3</maxIndex>
  91. </rollingPolicy>
  92. <!-- 日志级别过滤器 -->
  93. <filter class="ch.qos.logback.classic.filter.LevelFilter">
  94. <!-- 日志级别过滤器 -->
  95. <level>INFO</level>
  96. <!-- 符合要求的日志级别,过滤,ACCEPT:接受 -->
  97. <onMatch>ACCEPT</onMatch>
  98. <!-- 不符合要求的日志级别,过滤,DENY:拒绝 -->
  99. <onMismatch>DENY</onMismatch>
  100. </filter>
  101. <!-- 激活滚动的条件。 -->
  102. <triggeringPolicy
  103. class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
  104. <!-- 活动文件的大小,默认值是10MB -->
  105. <maxFileSize>30MB</maxFileSize>
  106. </triggeringPolicy>
  107. <!-- 对记录事件进行格式化。 -->
  108. <encoder>
  109. <pattern>${CUSTOM_LOG_PATTERN}</pattern>
  110. <charset>UTF-8</charset>
  111. </encoder>
  112. </appender>
  113. <!-- 异步输出 -->
  114. <appender name="ASYNC_logback" class="ch.qos.logback.classic.AsyncAppender">
  115. <!-- 不丢失日志.默认的,如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 -->
  116. <!-- <discardingThreshold>0</discardingThreshold> -->
  117. <!-- 更改默认的队列的深度,该值会影响性能.默认值为256 -->
  118. <!-- <queueSize>256</queueSize> -->
  119. <!-- 添加附加的appender,最多只能添加一个 -->
  120. <appender-ref ref="log_file" />
  121. </appender>
  122. <!-- 指定包输出路径 -->
  123. <!-- 用来设置某一个 包 或者具体的某一个 类 的日志打印级别、以及指定<appender>, name:用来指定受此logger约束的某一个包或者具体的某一个类。
  124. level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,还有一个特俗值INHERITED或者同义词NULL,代表强制执行上级的级别。如果未设置此属性,那么当前loger将会继承上级的级别。
  125. additivity:是否向上级logger传递打印信息。默认是true。(这个logger的上级就是上面的root) <logger>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个logger。 -->
  126. <logger name="org.logback.test" level="DEBUG" additivity="true">
  127. <appender-ref ref="stdout" />
  128. </logger>
  129. <!-- 特殊的<logger>元素,是根logger。只有一个level属性,应为已经被命名为"root". level:设置打印级别,大小写无关:TRACE,
  130. DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能设置为INHERITED或者同义词NULL。默认是DEBUG。 <root>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个loger。 -->
  131. <root>
  132. <level value="WARN" />
  133. <!-- if表达式,需要Janino jar -->
  134. <!-- Janino 2.6.0版本开始,除了janino.jar之外, commons-compiler.jar也需要在类路径中 -->
  135. <if condition='property("system_host").contains("dev")'>
  136. <then>
  137. <appender-ref ref="stdout" />
  138. </then>
  139. </if>
  140. <appender-ref ref="file" />
  141. </root>
  142. </configuration>

注意:logback如果配置要输出行号,性能会明显降低,如果不是必须,建议不要配置!

4.2.3、logback使用

  1. package org.example.logback.service;
  2. import org.slf4j.Logger;
  3. import org.slf4j.LoggerFactory;
  4. public class LogPrintUtil {
  5. /**log静态常量*/
  6. private static final Logger logger = LoggerFactory.getLogger(LogPrintUtil.class);
  7. public static void main(String[] args){
  8. logger.info("info信息");
  9. logger.warn("warn信息");
  10. logger.error("error信息");
  11. }
  12. }

五、SLF4J桥接

上面代码使用时,都使用的是private static final Logger logger = LoggerFactory.getLogger(LogPrintUtil.class)这个,其中都来自org.slf4j包,SLF4J是啥?有什么作用呢?
SLF4J本身并不输出日志,最大的特色是:它可以通过适配的方式挂接不同的日志系统,属于一个日志接口。
如果项目适配到log4j就使用log4j日志库进行输出;如果适配到logback就使用logback日志库进行输出;如果适配到log4j2就使用log4j2日志库进行输出。
这样最大的好处,就是想将项目从log4j换成log4j2的时候,只需要在项目pom.xml中进行桥接适配即可,不用修改具体需要打印日志的代码

六、三大主流日志框架性能比较

三个日志框架的日志输出性能比较,本文以10000条数据进行打印,比较log4jlog4j2logback日志的输出时间。
每个电脑的配置不一样,测试的结果也不一样,结果是真实的。

  • 同步输出

Log配置教程及框架性能比较 - 图3

  • 异步输出

Log配置教程及框架性能比较 - 图4
从测试结果上可以看出:

  • 不建议生产环境进行控制台输出;
  • 在纯文件输出的环境下,logback的输出优于log4j2,而log4j2要优于log4j,如果要进行生产环境的部署,建议采用logback,如果是使用log4j2,建议使用异步方式进行输出,输出结果基本是实时输出;

最后需要注意的地方是:log有风险,输出需谨慎!
由于输出log过程需要进行磁盘操作,且log4j为了保证log输出过程的线程安全性而使用同步锁,就使得输出log成为很耗时的操作,所以log信息一定要言简意赅,不要输出一些无用的log