Spring Boot 3.日志

日志

日志框架、日志配置
代码地址
ssh git@gitee.com:Ding_DangMao/learn-spring-bot.git

1. 日志框架

• 小故事
  小张，开发一个大型系统；
  1. System.out.pringln('') 将关键数据打印在控制台；去掉？下载一个文件？
  2. 框架来记录系统的一些运行时信息；日志框架；zhangloging.jar
  3. 高大上的功能？异步模式？自动归档？xxxzhanglogging-good.jar
  4. 将以前框架卸载下来？换上新的框架，重新修改之前的api；zhanglogging-prefect.jar
  5. jdbc--数据库驱动；
  写了一个统一的接口层；日志门面（日志的一个抽象层）；logging-abstract.jar;
  给项目中导入具体的日志实现就可以了，我们之前的日志框架都是实现的抽象层
• 市面上的日志框架
  lul，jcl，jboss-logging，logback，jog4j，log4j2，slf4j。。。
  
  左边选一个门面（抽象层），右边来选一个实现
  日志门面：slf4j
  日志实现：logback
• spring boot：底层时 spring框架，spring框架默认使用的时 jcl
  spring boot选用 slf4j和 logback

2. slf4j 使用

1. 如何在系统中使用 slf4j

• 以后开发的时候，日志记录方法的调用，不应该来直接调用日志的实现类，而是调用日志抽象里面的方法。
• 官方地址 http://www.slf4j.org/manual.html
  给系统里面导入 slf4j 的jar 和logback的实现 jar

  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  
  public class HelloWorld {
    public static void main(String[] args) {
  	Logger logger = LoggerFactory.getLogger(HelloWorld.class);
  	logger.info("Hello World");
    }
  }
  

  
  每一个日志的实现框架都有自己的配置文件。使用slf4j以后，配置文件还是做成日志实现框架字节本身的配置文件。

2. 遗留问题

• a（slf4j+logback）：spring(commons-logging)，hibernate(jboos-logging)，mybatis，xx
  统一日志记录，即使是别的框架和我一起统一使用 slf4j进行输出？
  

如何让系统中所有的日志统一到 slf4j

1. 将系统中其他日志框架先排除出去
2. 用中间包来替换原有的日志狂降。
3. 我们导入 slf4j其他的实现

3. spring boot日志关系

• starter 每一个启动器【场景】都要依赖的

  	<dependency>
  		<groupId>org.springframework.boot</groupId>
  		<artifactId>spring-boot-starter</artifactId>
  	</dependency>
  

  spring boot使用它来做日志功能

  starter里面依赖的
  	<dependency>
  		<groupId>org.springframework.boot</groupId>
  		<artifactId>spring-boot-starter-logging</artifactId>
  	</dependency>
  

  
  底层依赖关系：总结：
  1. spring boot底层也是 slf4j+logback的方式进行日志记录
  2. spring boot也把其他的日志都替换成了 slf4j
  3. 中间替换包
     
     
  4. 如果我们要引入其他框架？一定要把这个框架的默认日志依赖移除掉。
     spring 框架用的是 commons-logging；
     
• spring boot能自动适配所有的日志，而且底层使用 slf4j+logback的方式记录日志，引入其他框架的时候，只需要把这个框架依赖的日志排除掉。

4. 日志使用

1. 默认配置

• spring boot默认帮我们配置好了日志

  @RunWith(SpringRunner.class)
  @org.springframework.boot.test.context.SpringBootTest
  public class SpringBootTest {
  	//记录器，记录日志
  	Logger logger = LoggerFactory.getLogger(getClass());
  
  	@Test
  	public void test1() {
  		//日志的级别，由低到高 trance<debug<info<warn<error
  		//可以调整 输出的日志级别。
  		logger.trace("这是 trace日志");
  		logger.debug("这是 debug日志");
  		//spring boot默认给我们使用的是 info级别的【输出 info即一下的内容】
  		//没有指定级别的就用spring boot默认规定的级别【root级别】
  		logger.info("这是 info日志");
  		logger.warn("这是 warn日志");
  		logger.error("这是 error日志");
  	}
  }
  

• 配置 日志级别，在 application.properties中设置

  #调整日志级别  trance
  logging.level.com.cainiao=trance
  
  # file 和 path两者二选一
  #不指定路径，当前项目下生成 springboot.log日志
  #可指定完整的路径
  #logging.file=springboot.log
  #在当前磁盘的根路径下创建 spring文件夹和里面的 log文件夹，使用 spring.log 作为默认文件
  logging.path=/spring/log
  # 在控制台输出的日志格式
  logging.pattern.console=%d{yyyy-MM-dd} [%thread] %-5leve %logger{50} - %msg%n
  # 指定文件中日志输出的格式
  logging.pattern.file=%d{yyyy-MM-dd} === [%thread] %-5leve === %logger{50} === %msg%n
  

  两者二选一

  logging.file	logging.path	Example	Description
  (none)	(none)		只在控制台输出
  指定文件名	(none)	my.log	输出日志到 my.log文件
  (none)	指定目录	/var/log	输出到指定目录的 spring.log文件中

• 日志输出格式
  %d 表示日期时间
  %thread 表示线程名
  %-51leve: 级别从左显示5个字符宽度
  %loger{50} 表示logger名字最长 50个字符，否则按照句点分隔。
  %msg 日志消息
  $n 是换行

2. 指定配置

• 给类路径下放上每个日志框架字节的配置文件即可；spring boot就不使用他默认的了。
• 每个日志框架使用文件名不一样
  
  logback.xml：直接就被日志框架识别了。
  logback-spring.xml：日记之框架就不直接加载日志的配置项，由spring boot解析日志配置，可以使用 spring boot的高级功能。

  <springProfile name="staging">
  	<!-- configuration to be enable when the "staging" profile is active -->
  	可以指定某段配置只在某个环境下生效
  </springProfile>
  

  否则no applicable action for [springProfile]

<appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
    <springProfile name="dev">
		<!--如果是开发环境就这样输出-->
        <pattern>%d{yyyy‐MM‐dd HH:mm:ss.SSS} ‐‐‐‐> [%thread] ‐‐‐> %‐5level
            %logger{50} ‐ %msg%n
        </pattern>
    </springProfile>
    <springProfile name="!dev">
	<!-- 不是开发环境-->
        <pattern>%d{yyyy‐MM‐dd HH:mm:ss.SSS} ==== [%thread] ==== %‐5level
            %logger{50} ‐ %msg%n
        </pattern>
    </springProfile>
</layout>
</appender>

两种方式设置开发环境，在 application.properties 或者在命令行上 --spring.profiles.active=dev

5. 切换日志框架[不推荐这样做]

• 可以按照slf4j的日志适配图，进行相关的切换；
• slf4j+log4j的方式；

  <dependency>
  	<groupId>org.springframework.boot</groupId>
  	<artifactId>spring‐boot‐starter‐web</artifactId>
  	<exclusions>
  		<exclusion>
  			<artifactId>logback‐classic</artifactId>
  			<groupId>ch.qos.logback</groupId>
  		</exclusion>
  		<exclusion>
  			<artifactId>log4j‐over‐slf4j</artifactId>
  			<groupId>org.slf4j</groupId>
  		</exclusion>
  	</exclusions>
  </dependency>
  <dependency>
  	<groupId>org.slf4j</groupId>
  	<artifactId>slf4j‐log4j12</artifactId>
  </dependency>
  

• 切换为log4j2

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