logback 实战

1. 基于maven的pom.xml文件包中引入依赖的jar包.

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-core</artifactId>
    <version>1.2.3</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.3</version>
</dependency>

2. resources目录增加logback.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
 
  <!-- 控制台打印的内容输出格式 -->
  <property name="LINE_LOG_PATTERN"
    value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n"/>
  <!-- 文件存储的默认路径 -->
  <property name="LOG_PATH" value="E:/opt/logs/"/>
  <!-- 每个单独文件的大小默认为50M -->
  <property name="MAX_FILE_SIZE" value="50MB"/>
  <!-- 文件最多保存时间默认为60天 -->
  <property name="MAX_HISTORY" value="60"/>
  <!-- 文件总大小默认为20G -->
  <property name="TOTAL_SIZE_CAP" value="20GB"/>
  <!-- 默认日志级别 -->
  <property name="LOG_LEVEL" value="DEBUG"/>
  <!-- 加载资源文件(可以在此文件中自定义以上属性) -->
  <property resource="logback.properties"/>
 
 
  <!--
    将INFO级别的日志输出到控制台
   -->
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>INFO</level>
    </filter>
    <encoder>
      <pattern>${LINE_LOG_PATTERN}</pattern>
    </encoder>
  </appender>
 
  <!-- DEBUG级别以上的信息写入到log文件中 -->
  <appender name="D_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_PATH}/mes-log.log</file>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>DEBUG</level>
    </filter>
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
      <!-- rollover daily -->
      <fileNamePattern>${LOG_PATH}/%d{yyyy-MM-dd,aux}/logs/mes-log-%d{yyyy-MM-dd}.%i.log
      </fileNamePattern>
      <!-- each file should be at most 100MB, keep 60 days worth of history, but at most 20GB -->
      <maxFileSize>${MAX_FILE_SIZE}</maxFileSize>
      <maxHistory>${MAX_HISTORY}</maxHistory>
      <totalSizeCap>${TOTAL_SIZE_CAP}</totalSizeCap>
    </rollingPolicy>
    <encoder>
      <pattern>${LINE_LOG_PATTERN}</pattern>
    </encoder>
  </appender>
 
  <!-- ERROR信息写入到一个单独的ERROR文件中去 -->
  <appender name="E_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_PATH}/mes-error.log</file>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>ERROR</level>
    </filter>
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
      <!-- rollover daily -->
      <fileNamePattern>${LOG_PATH}/%d{yyyy-MM-dd,aux}/error/mes-error-%d{yyyy-MM-dd}.%i.log
      </fileNamePattern>
      <!-- each file should be at most 100MB, keep 60 days worth of history, but at most 20GB -->
      <maxFileSize>${MAX_FILE_SIZE}</maxFileSize>
      <maxHistory>${MAX_HISTORY}</maxHistory>
      <totalSizeCap>${TOTAL_SIZE_CAP}</totalSizeCap>
    </rollingPolicy>
    <encoder>
      <pattern>${LINE_LOG_PATTERN}</pattern>
    </encoder>
  </appender>
 
  <root level="${LOG_LEVEL}">
    <!-- 输出到控制台 -->
    <appender-ref ref="CONSOLE"/>
    <!-- DEBUG级别日志 -->
    <appender-ref ref="D_FILE"/>
    <!-- ERROR级别日志 -->
    <appender-ref ref="E_FILE"/>
  </root>
</configuration>

说明: 日志文件分为三种方式打印,  

a. CONSOLE: 将INFO级别的日志打印到控制台; 

b.  D_FILE:  将DEBUG级别的日志输出到指定的文件mes-log.log中; 每个文件会按天存储, 默认单个文件的大小maxFileSize为50M, 默认文件存储时间MAX_HISTORY为60天

                  默认日志文件totalSizeCap总大小为20GB;

c.  E_FILE:  将ERROR级别的日志输出到指定的文件mes-error.log中; 每个文件会按天存储, 默认单个文件的大小maxFileSize为50M, 默认文件存储时间MAX_HISTORY为60天

                  默认日志文件totalSizeCap总大小为20GB;

备注: 日志文件大小如果超过100MB,会自动在当前日期的文件夹中生成累加的文件例如:  ../../logs/2020-04-20/logs/mes-log-2020-04-20.149.log  或者 ../../logs/2020-04-20/error/mes-error-2020-04-20.47.log

LOG_PATH ,MAX_FILE_SIZE,MAX_HISTORY,TOTAL_SIZE_CAP;这四个变量可在使用hk-core的工程下自定义配置.

3. 自定义日志参数配置

在resources目录下创建logback.properties文件,可以在文件中针对一下属性进行自定义配置: 

    # 文件存储路径; 默认存储在E:/opt/logs下

    LOG_PATH=${catalina.home}/logs/

    # 单个日志文件的大小 默认是50MB

    MAX_FILE_SIZE=5MB

   # 文件存储的最大时长,默认为60天

   MAX_HISTORY=60

   # 日志文件总大小,默认为20GB

   TOTAL_SIZE_CAP=20GB

   # 日志的监控级别,默认为DEBUG  

    LOG_LEVEL=DEBUG