springboot+logback实现系统日志记录

前言

       最近在搞springboot项目，想给项目中加入日志。之前一直在使用log4j，首先想到怎么集成log4j，但查阅相关文档之后发现springboot默认日志框架为logback，而且logback比log4j更好用，于是果断抛弃log4j。

正文

        Spring Boot在所有内部日志中使用Commons Logging，但是默认配置也提供了对常用日志的支持，如：Java Util Logging，Log4J, Log4J2和Logback。每种Logger都可以通过配置使用控制台或者文件输出日志内容。

默认日志Logback

        默认情况下，Spring Boot会用Logback来记录日志，并用INFO级别输出到控制台。在运行应用程序和其他例子时，你应该已经看到很多INFO级别的日志了。

具体实现

如上图所示：

        

设置上下文名称<contextName>

        每个logger都关联到logger上下文，默认上下文名称为“default”。但可以使用<contextName>设置成其他名字，用于区分不同应用程序的记录。一旦设置，不能修改,可以通过%contextName来打印日志上下文名称。

<contextName>dico-fast-cms</contextName>

设置变量<property>

        用来定义变量值的标签，<property> 有两个属性，name和value；其中name的值是变量的名称，value的值时变量定义的值。通过<property>定义的值会被插入到logger上下文中。定义变量后，可以使“${}”来使用变量。

<property name="log_path" value="F:/soft/nginx-1.14.0/logs/" />

子节点<appender>

        appender用来格式化日志输出节点，有俩个属性name和class，class用来指定哪种输出策略，常用就是控制台输出策略和文件输出策略。

控制台输出ConsoleAppender：

<encoder>表示对日志进行编码：

• %d{HH: mm:ss.SSS}——日志输出时间
• %thread——输出日志的进程名字，这在Web应用以及异步任务处理中很有用
• %-5level——日志级别，并且使用5个字符靠左对齐
• %logger{36}——日志输出者的名字
• %msg——日志消息
• %n——平台的换行符

输出到文件RollingFileAppender

        将日志输出到文件，随着应用的运行时间越来越长，日志内容也会增多，将他们输出到同一个文件并非一个好办法。RollingFileAppender用于切分文件日志：

        上例中 <FileNamePattern>${log_path}/logback.%d{yyyy-MM-dd}.log</FileNamePattern> 定义了日志的切分方式——把每一天的日志归档到一个文件中，<maxHistory>30</maxHistory>表示只保留最近30天的日志，以防止日志填满整个磁盘空间。同理，可以使用%d{yyyy-MM-dd_HH-mm}来定义精确到分的日志切分方式。<MaxFileSize>10MB</MaxFileSize>用来指定日志文件的上限大小，例如设置为10MB的话，那么到了这个值，就会重新创建日志文件。

子节点<root>

root节点是必选节点，用来指定最基础的日志输出级别，只有一个level属性。

• level:用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，不能设置为INHERITED或者同义词NULL，默认是DEBUG。

<root>可以包含多个<appender-ref>元素，如图：

        上图中可以将file和console放入一个root节点中，但考虑到使用INFO会使得日志文件非常臃肿，便只将ERROR级别的日志保存到文件中，控制台用于调试所以打印INFO级别的日志。也可以使用多环境日志输出，使用方式如下：

多环境日志输出

        据不同环境（prod:生产环境，test:测试环境，dev:开发环境）来定义不同的日志输出，在 logback-spring.xml中使用 springProfile 节点来定义，方法如下：文件名称不是logback.xml，想使用spring扩展profile支持，要以logback-spring.xml命名

logger的配置

        name 控制cn.dico包下所有类的日志打印，level 控制打印日志级别，additivity属性为false，表示此loger的打印信息不再向上级传递，appender-ref指定打印方式为控制台打印或者日志打印。

        这时候执行cn.dico包下任意类的方法时，将在控制台和文件中打出日志，不再向上级root传递打印信息。

总结

到此为止终于介绍完日志框架了，平时使用的时候推荐用自定义logback-spring.xml来命名配置文件，如果你想使用spring扩展profile支持的话。