springboot 日志2

 

SpringBoot关于日志的官方文档php

一、简述

SpringBoot官方文档关于日志的总体说明


本博客基于SpringBoot_1.3.6
你们请先简单看下这篇英文的官方文档,文中有说 SpringBoot 内部日志系统使用的是 Commons Logging 而且 SpringBoot 给 JDKLogging , Log4j2(Log4j也是支持的) , Logback 都提供了默认配置,而且若是使用了 Starters ,那么默认使用 Logback 。
那么什么是这个这个 Starters 呢?你们请看个人pom文件:html

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.lunqi</groupId> <artifactId>springbootstart</artifactId> <version>0.0.1-SNAPSHOT</version> <name>boot</name> <description>SpringBootDemo</description> <parent> <groupId>org.springframework.boot</groupId> <!-- Spring Boot应用启动器Starter-parent: 官方推荐 其中集成了: 一、使用java6编译级别 二、使用utf-8编码 三、实现了通用的测试框架 (JUnit, Hamcrest, Mockito). 四、智能资源过滤 五、智能的插件配置(exec plugin, surefire, Git commit ID, shade). --> <artifactId>spring-boot-starter-parent</artifactId> <version>1.3.6.RELEASE</version> <relativePath /> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.7</java.version> </properties> <dependencies> <dependency> <!-- Spring Boot应用启动器Starter-web: 支持全栈式Web开发,包括Tomcat和spring-webmvc --> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> </project>

简单的说,只要你的 pom 文件中使用了 spring-boot-starter 就表明着你使用了 SpringBoot 的 Starters 。相信各位玩 SpringBoot 的朋友确定是看到了本身的 pom 文件中有这个了,由于,Starters(启动器)是 SpringBoot 最核心的部件之一,没有了启动器, SpringBoot 就几乎废掉了。java

二、使用

SpringBoot 招人喜欢的一大特色就是配置方便,配置日志的相关参数也只须要写在 application.properties 中就能够了,固然,这仅仅是基本的配置,若是须要高级的配置,仍是须要添加依赖所选择日志系统的配置文件。web


SpringBoot官方文档关于配置Log级别的说明

官方文档中有提到, SpringBoot 的 Logging 配置的级别有7个:
TRACE , DEBUG , INFO , WARN , ERROR , FATAL , OFFspring

配置格式:
logging.level.*=LEVELapache

举例:springboot

#root日志以WARN级别输出
logging.level.root=WARN #springframework.web日志以DEBUG级别输出 logging.level.org.springframework.web=DEBUG #hibernate日志以ERROR级别输出 logging.level.org.hibernate=ERROR

在进行了这样的配置后,就能够在控制台打印Log信息了!mvc

可是颇有人又会问了,在生产环境中,日志每每要以文件形式存放到本地,那么 SpringBoot 的默认配置文件可以实现吗?答案是能够的,咱们继续看官方文档:app

文档中对 SpringBoot 日志的文件输出有明确的说明,上面说到:
在默认状况下,SpringBoot 是仅仅在控制台打印log信息的,若是咱们须要将log信息记录到文件,那么就须要在 application.properties 中配置 logging.file 或者 logging.path (注意啊,是或者,不是而且!)
并且官方文档有明确说明,配置 logging.file 的话是能够定位到自定义的文件的,使用 logging.path 的话,日志文件将使用 spring.log 来命名。
并且日志文件会在10Mb大小的时候被截断,产生新的日志文件,默认级别为:ERROR、WARN、INFO框架

这时候又会有不少同窗问了,那若是我要自定义输出格式怎么办呢?其实在 application.properties 也是能够办到的。继续看官方文档:


SpringBoot官方文档关于日志配置的说明


可是要注意:这两个配置项是只对默认的日志系统Logback起做用的

举例(application.properties):

logging.level.root=WARN
logging.level.org.springframework.web=DEBUG
logging.file=/log/log/my.log logging.pattern.console=%d{yyyy/MM/dd-HH:mm:ss} [%thread] %-5level %logger- %msg%n logging.pattern.file=%d{yyyy/MM/dd-HH:mm} [%thread] %-5level %logger- %msg%n

结果(Console部分):

2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'systemEnvironment': no URL paths identified 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'org.springframework.context.annotation.ConfigurationClassPostProcessor.importRegistry': no URL paths identified 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'messageSource': no URL paths identified 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'servletContext': no URL paths identified 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'contextParameters': no URL paths identified 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'contextAttributes': no URL paths identified 2016/09/22-17:36:06 [main] INFO org.springframework.web.servlet.handler.SimpleUrlHandlerMapping- Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016/09/22-17:36:06 [main] INFO org.springframework.web.servlet.handler.SimpleUrlHandlerMapping- Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver- Looking for exception mappings: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@15ef3ab: startup date [Thu Sep 22 17:36:04 GMT+08:00 2016]; root of context hierarchy 2016/09/22-17:36:06 [main] INFO org.springframework.web.servlet.handler.SimpleUrlHandlerMapping- Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.resource.ResourceUrlProvider- Looking for resource handler mappings 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.resource.ResourceUrlProvider- Found resource handler mapping: URL pattern="/**/favicon.ico", locations=[ServletContext resource [/], class path resource [META-INF/resources/], class path resource [resources/], class path resource [static/], class path resource [public/], class path resource []], resolvers=[org.springframework.web.servlet.resource.PathResourceResolver@b1df4d] 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.resource.ResourceUrlProvider- Found resource handler mapping: URL pattern="/webjars/**", locations=[class path resource [META-INF/resources/webjars/]], resolvers=[org.springframework.web.servlet.resource.PathResourceResolver@164e13b] 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.servlet.resource.ResourceUrlProvider- Found resource handler mapping: URL pattern="/**", locations=[ServletContext resource [/], class path resource [META-INF/resources/], class path resource [resources/], class path resource [static/], class path resource [public/]], resolvers=[org.springframework.web.servlet.resource.PathResourceResolver@1fefcb1] 2016/09/22-17:36:06 [main] DEBUG org.springframework.web.context.support.StandardServletEnvironment- Adding [server.ports] PropertySource with highest search precedence

结果(File部分):

2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'org.springframework.context.annotation.ConfigurationClassPostProcessor.importRegistry': no URL paths identified 2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'messageSource': no URL paths identified 2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'servletContext': no URL paths identified 2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'contextParameters': no URL paths identified 2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping- Rejected bean name 'contextAttributes': no URL paths identified 2016/09/22-17:36 [main] INFO org.springframework.web.servlet.handler.SimpleUrlHandlerMapping- Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016/09/22-17:36 [main] INFO org.springframework.web.servlet.handler.SimpleUrlHandlerMapping- Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver- Looking for exception mappings: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@15ef3ab: startup date [Thu Sep 22 17:36:04 GMT+08:00 2016]; root of context hierarchy 2016/09/22-17:36 [main] INFO org.springframework.web.servlet.handler.SimpleUrlHandlerMapping- Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016/09/22-17:36 [main] DEBUG org.springframework.web.servlet.resource.ResourceUrlProvider- Looking for resource handler mappings

好了,这时候你们已经对 application.properties 中配置Log有了了解,可是这时候又会发现一个问题, application.properties 中的配置有的时候不能知足咱们的要求,或者咱们要使用其余的集成进SpringBoot的日志系统,该怎么办呢?官方文档又给了咱们答案:


SpringBoot官方文档关于使用指定日志配置的说明


咱们能从中知道:
1.经过将适当的库添加到classpath,能够激活各类日志系统。而后在 classpath 的根目录 (root) 或经过 Spring Environment( application.properties)的 logging.config 属性指定的位置提供一个合适的配置文件来达到进一步的定制(注意因为日志是在ApplicationContext被建立以前初始化的,因此不可能在Spring的@Configuration文件中,经过@PropertySources控制日志。系统属性和日常的Spring Boot外部配置文件能正常工做)。
2.若是咱们使用指定日志系统的配置文件, application.properties 中相关的日志配置是能够不要的。
3.支持的三种日志系统( Logback , Log4j2 ( Log4j 也是支持的), JDKLogging )所识别的配置文件名。

好了,接下来咱们就要学习如何在 SpringBoot 中玩这些指定的日志系统了。

三、扩展
#3.1使用Logback的指定配置文件实现更高级的日志配置:

若是咱们的确要使用 Logback 的指定配置文件的话,那么说明 application.properties 中的配置功能已经不知足咱们需求了,因此 application.properties 中关于日志记录的能够不要了,由于咱们启用了 Logback 本身的配置文件,启用的方式很简单,在 classpath 的 resources 下新建 logback.xml 文件。这样就能够了。
具体配置和说明这里有个简单的介绍:

<?xml version="1.0" encoding="UTF-8"?> <configuration> <!-- 控制台打印日志的相关配置 --> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <!-- 日志格式 --> <encoder> <pattern>%d{yyyy-MM-dd HH:mm:ss} [%level] - %m%n</pattern> </encoder> <!-- 日志级别过滤器 --> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <!-- 过滤的级别 --> <level>WARN</level> <!-- 匹配时的操做:接收(记录) --> <onMatch>ACCEPT</onMatch> <!-- 不匹配时的操做:拒绝(不记录) --> <onMismatch>DENY</onMismatch> </filter> </appender> <!-- 文件保存日志的相关配置 --> <appender name="ERROR-OUT" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!-- 保存日志文件的路径 --> <file>/logs/error.log</file> <!-- 日志格式 --> <encoder> <pattern>%d{yyyy-MM-dd HH:mm:ss} [%class:%line] - %m%n</pattern> </encoder> <!-- 日志级别过滤器 --> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <!-- 过滤的级别 --> <level>ERROR</level> <!-- 匹配时的操做:接收(记录) --> <onMatch>ACCEPT</onMatch> <!-- 不匹配时的操做:拒绝(不记录) --> <onMismatch>DENY</onMismatch> </filter> <!-- 循环政策:基于时间建立日志文件 --> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!-- 日志文件名格式 --> <fileNamePattern>error.%d{yyyy-MM-dd}.log</fileNamePattern> <!-- 最大保存时间:30天--> <maxHistory>30</maxHistory> </rollingPolicy> </appender> <!-- 基于dubug处理日志:具体控制台或者文件对日志级别的处理还要看所在appender配置的filter,若是没有配置filter,则使用root配置 --> <root level="debug"> <appender-ref ref="STDOUT" /> <appender-ref ref="ERROR-OUT" /> </root> </configuration>
#3.2使用Log4j的指定配置文件实现更高级的日志配置:

1.更改pom文件:
在建立 SpringBoot 工程时,咱们引入了 spring-boot-starter,其中包含了 spring-boot-starter-logging ,该依赖内容就是 SpringBoot 默认的日志框架 Logback ,因此咱们在引入 log4j 以前,须要先排除该包的依赖,再引入 log4j 的依赖。

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-log4j</artifactId> </dependency>

以后咱们可使用 application.properties,其中的配置项以前有说,一样也是适用 Log4J 的。
若是须要更高级的配置选择,必需要添加 Log4j 的配置文件了。咱们在 classpath 的 resources下新建 log4j.properties 文件,这里简单示例一下:

# 日志级别,日志追加程序列表... log4j.rootLogger=DEBUG,ServerDailyRollingFile,stdout #文件保存日志 log4j.appender.ServerDailyRollingFile=org.apache.log4j.DailyRollingFileAppender #文件保存日志日期格式 log4j.appender.ServerDailyRollingFile.DatePattern='.'yyyy-MM-dd_HH #文件保存日志文件路径 log4j.appender.ServerDailyRollingFile.File=/mnt/lunqi/demo/log4j.log #文件保存日志布局程序 log4j.appender.ServerDailyRollingFile.layout=org.apache.log4j.PatternLayout #文件保存日志布局格式 log4j.appender.ServerDailyRollingFile.layout.ConversionPattern=%d - %m%n #文件保存日志须要向后追加(false是测试的时候日志文件就清空,true的话就是在以前基础上日后写) log4j.appender.ServerDailyRollingFile.Append=false #控制台日志 log4j.appender.stdout=org.apache.log4j.ConsoleAppender #控制台日志布局程序 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout #控制台日志布局格式 log4j.appender.stdout.layout.ConversionPattern=%d yyyy-MM-dd HH:mm:ss %p [%c] %m%n
#3.3使用Log4j2的指定配置文件实现更高级的日志配置:

1.更改pom文件:
跟引入Log4j同样,咱们也须要排除 spring-boot-starter-logging ,再引入Log4j2的依赖:

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-log4j2</artifactId> </dependency>

2.跟Log4j同样,咱们可使用 application.properties ,若是须要更高级的配置选择,必需要添加 Log4j2 的配置文件了。咱们在 classpath 的 resources下新建 log4j2.xml 文件:

<?xml version="1.0" encoding="UTF-8"?> <configuration> <appenders> <Console name="Console" target="SYSTEM_OUT"> <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY" /> <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n" /> </Console> <File name="log" fileName="log/test.log" append="false"> <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n" /> </File> <RollingFile name="RollingFile" fileName="logs/spring.log" filePattern="log/$${date:yyyy-MM}/app-%d{MM-dd-yyyy}-%i.log"> <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n" /> <SizeBasedTriggeringPolicy size="50MB" /> </RollingFile> </appenders> <loggers> <root level="trace"> <appender-ref ref="RollingFile" /> <appender-ref ref="Console" /> </root> </loggers> </configuration>原文连接 https://www.cnblogs.com/zhangzhen894095789/p/6640808.html
相关文章
相关标签/搜索