Java     Spring     SpringBoot     log    

Spring Boot学习3——日志管理

223 次访问
Sherlock
Scroll Down

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

默认情况下，SpringBoot使用Logback作为日志框架。

日志打印出内存地址解决

使用logback/log4j等原生的日志框架，在日志输出的时候可能会遇到一个问题：
如果被打印参数未重写 toString 方法，则打印出来的都是 XXX@xx。

一般简单的解决办法是，可以通过 JSON 把对象转成 String，如：

log.info("obj = {}", JSON.toJSONString(obj));

这种方式显然不够优雅，而且笨拙，有一个好办法：
借助logback(log4j也有类似的功能)的MessageConverter。无侵入性的解决这个问题

1、自定义一个Layout

/**
 * 参数JSON格式化类
 *
 * @author Hollis
 */
public class ArgumentJsonFormatLayout extends MessageConverter {

    @Override
    public String convert(ILoggingEvent event) {
        try {
            return MessageFormatter.arrayFormat(event.getMessage(), Stream.of(event.getArgumentArray())
                .map(JSON::toJSONString).toArray()).getMessage();
        } catch (Exception e) {
            return event.getMessage();
        }
    }
}

2、在logback中配置上这个Layout

<configuration>
    <conversionRule conversionWord="m" converterClass="com.xx.ArgumentJsonFormatLayout"/>
</configuration>

然后，就可以直接使用log.info("obj = {}",obj)这样的形式记录日志了。

格式化日志

默认的日志输出如下：

2017-05-08 08:23:50.120  INFO 37397 --- [           main] org.hibernate.Version                    : HHH000412: Hibernate Core {4.3.11.Final}

输出内容元素具体如下：

  • 时间日期 — 精确到毫秒
  • 日志级别 — ERROR, WARN, INFO, DEBUG or TRACE
  • 进程ID
  • 分隔符 — --- 标识实际日志的开始
  • 线程名 — 方括号括起来（可能会截断控制台输出）
  • Logger名 — 通常使用源代码的类名
  • 日志内容

控制台输出

在 Spring Boot 中默认配置了 ERROR、WARN 和 INFO 级别的日志输出到控制台。
我们可以通过两种方式切换至 DEBUG 级别：

在运行命令后加入 --debug 标志，如：java -jar myapp.jar --debug 在 application.properties 中配置 debug=true，该属性置为 true 的时候，核心 Logger（包含嵌入式容器、hibernate、spring）会输出更多内容，但是你自己应用的日志并不会输出为 DEBUG 级别。 #多彩输出 如果你的终端支持 ANSI，设置彩色输出会让日志更具可读性。通过在 application.properties 中设置 spring.output.ansi.enabled 参数来支持。

  • NEVER：禁用ANSI-colored输出（默认项）
  • DETECT：会检查终端是否支持ANSI，是的话就采用彩色输出（==推荐项==）
  • ALWAYS：总是使用ANSI-colored格式输出，若终端不支持的时候，会有很多干扰信息，不推荐使用 #文件输出 Spring Boot 默认配置只会输出到控制台，并不会记录到文件中，但是我们通常生产环境使用时都需要以文件方式记录。

若要增加文件输出，需要在 application.properties 中配置 logging.file 或 logging.path 属性。

  • logging.file，设置文件，可以是绝对路径，也可以是相对路径。如：logging.file=my.log
  • logging.path，设置目录，会在该目录下创建spring.log文件，并写入日志内容，如：logging.path=/var/log

日志文件会在10Mb大小的时候被截断，产生新的日志文件，默认级别为：ERROR、WARN、INFO

#级别控制 在Spring Boot中只需要在 application.properties 中进行配置完成日志记录的级别控制。

配置格式：logging.level.*=LEVEL

  • logging.level：日志级别控制前缀，* 为包名或Logger名
  • LEVEL：选项TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF

举例：

  • logging.level.com.didispace=DEBUG：则com.didispace 包下所有class以DEBUG级别输出
  • logging.level.root=WARN：root日志以WARN级别输出 #自定义日志配置 由于日志服务一般都在 ApplicationContext 创建前就初始化了，它并不是必须通过 Spring 的配置文件控制。因此通过系统属性和传统的 Spring Boot 外部配置文件依然可以很好的支持日志控制和管理。

根据不同的日志系统，你可以按如下规则组织配置文件名，就能被正确加载：

  • Logback：logback-spring.xm, logback-spring.groovy, logback.xml, logback.groovy
  • Log4j：log4j-spring.properties, log4j-spring.xml, log4j.properties, og4j.xml
  • Log4j2：log4j2-spring.xml, log4j2.xml
  • JDK (Java Util Logging)：logging.properties Spring Boot官方推荐优先使用带有 -spring 的文件名作为你的日志配置（如使用 logback-spring.xml，而不是 logback.xml）

#自定义输出格式

在 Spring Boot 中可以通过在 application.properties 配置如下参数控制输出格式：

  • logging.pattern.console：定义输出到控制台的样式（不支持JDK Logger）
  • logging.pattern.file：定义输出到文件的样式（不支持JDK Logger）

使用 logback 出现LOG_PATH_IS_UNDEFINED的问题解决

  • 1、将logback.xml改成logback-spring.xml。
  • 2、在application.xxx配置文件中增加：logging.path或logging.file日志文件路径配置。
  • 3、修改logback-spring.xml文件，将logPath的value中改成${LOG_PATH:-.}，例如：
<property name="logPath" value="${LOG_PATH:-.}"></property>

这样 logback 会读取到 springboot application 配置文件中指定的日志目录位置。

贴一个目前使用的logback-spring.xml

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <!-- 日志地址 -->
    <property name="logPath" value="${LOG_PATH:-.}"></property>
    <!--配置console打印的log-->
    <appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
        </layout>
    </appender>
    <!--自定义配置-->
    <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>INFO</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
            <!--日志内容格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <!--<pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] %logger{50} - %msg%n</pattern>-->
            <pattern>[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!--滚动策略，按天输出日志-->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--设置文件保存路径，timeBasedFileNamingAndTriggeringPolicy标签时，这里的%i要加上，不然会导致运行报错-->
            <fileNamePattern>${logPath}/info.%d-%i.log</fileNamePattern>
            <!-- 配置日志文件不能超过2M，若超过2M，日志文件会以索引0开始，命名日志文件，例如info.2018-12-21-0.log -->
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>10MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <!--日志文件保留天数-->
            <maxHistory>5</maxHistory>
        </rollingPolicy>
    </appender>
    <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <encoder>
            <pattern>[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!--滚动策略 按天生成日志-->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--路径-->
            <fileNamePattern>${logPath}/error.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>
    <root level="info">
        <appender-ref ref="consoleLog" />
        <appender-ref ref="fileInfoLog" />
        <appender-ref ref="fileErrorLog" />
    </root>

    <!--日志指定包路径-->
    <logger name="com.sherlocky" level = "INFO">
        <appender-ref ref="consoleLog" />
        <appender-ref ref="fileInfoLog" />
        <appender-ref ref="fileErrorLog" />
    </logger>
</configuration>

改良版

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 读取系统环境属性 -->
    <property name="log_path" value="${LOG_PATH:-./logs}"></property>
    <!-- 读取当前应用Environment中的属性 -->
    <!--
    <springProperty scope="context" name="log_path" source="logging.path" defaultValue="./demo-logs"/>
    -->
    <springProperty scope="context" name="app_name" source="spring.application.name" defaultValue="demo"/>
    <!-- 日志文件保留天数 -->
    <springProperty scope="context" name="logger_max_history" source="logging.file.max-history" defaultValue="7"/>
    <!-- 日志文件大小：默认50MB -->
    <springProperty scope="context" name="max_file_size" source="logging.file.max-size" defaultValue="10MB"/>
    <contextName>${app_name}</contextName>

    <!-- Log Appender Begin -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--日志内容格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <!--<pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] %logger{50} - %msg%n</pattern>-->
            <pattern>#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <springProfile name="prod">
        <!--输出到文件-->
        <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
                <maxFileSize>${max_file_size}</maxFileSize>
                <maxHistory>${logger_max_history}</maxHistory>
                <totalSizeCap>1GB</totalSizeCap>
            </rollingPolicy>
            <encoder>
                <pattern>#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
                <charset>UTF-8</charset>
            </encoder>
        </appender>
    </springProfile>

    <springProfile name="test">
        <!--输出到文件-->
        <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
                <maxFileSize>${max_file_size}</maxFileSize>
                <maxHistory>${logger_max_history}</maxHistory>
                <totalSizeCap>1GB</totalSizeCap>
            </rollingPolicy>
            <encoder>
                <pattern>#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
                <charset>UTF-8</charset>
            </encoder>
        </appender>
    </springProfile>


    <springProfile name="prod">
        <root level="INFO">
            <appender-ref ref="FILE"/>
        </root>
    </springProfile>

    <springProfile name="test">
        <root level="DEBUG">
            <appender-ref ref="FILE"/>
        </root>
    </springProfile>

    <springProfile name="dev">
        <root level="DEBUG">
            <appender-ref ref="STDOUT"/>
        </root>
    </springProfile>

</configuration>

彩色日志版

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 读取系统环境属性 -->
    <property name="log_path" value="${LOG_PATH:-./logs}"></property>
    <!-- 读取当前应用Environment中的属性 -->
    <!--
    <springProperty scope="context" name="log_path" source="logging.path" defaultValue="./demo-logs"/>
    -->
    <springProperty scope="context" name="app_name" source="spring.application.name" defaultValue="demo"/>
    <!-- 日志文件保留天数 -->
    <springProperty scope="context" name="logger_max_history" source="logging.file.max-history" defaultValue="7"/>
    <!-- 日志文件大小：默认50MB -->
    <springProperty scope="context" name="max_file_size" source="logging.file.max-size" defaultValue="10MB"/>
    <contextName>${app_name}</contextName>

    <property name="log_pattern_old" value="#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n"/>
    <!-- 可参考：spring-boot.jar!/org/springframework/boot/logging/logback/defaults.xml -->
	<!-- https://logback.qos.ch/manual/layouts.html#coloring 彩色日志另一种写法，举个例子
	<pattern>%yellow(%date{yyyy-MM-dd HH:mm:ss}) |%highlight(%-5level)  |%green(%logger:%line) |%black(%msg%n)</pattern>		
	-->
    <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
    <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
    <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
    <property name="log_pattern" value="#${app_name}# %clr([%d{yyyy-MM-dd HH:mm:ss.SSS}]){faint} [%thread] %clr([%-5level]) %clr([%-60.60logger{60}:%-3line]){cyan} --%mdc{client} %msg%n%wEx"/>

    <!-- Log Appender Begin -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--日志内容格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <!--<pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] %logger{50} - %msg%n</pattern>-->
            <pattern>${log_pattern}</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <springProfile name="prod">
        <!--输出到文件-->
        <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
                <maxFileSize>${max_file_size}</maxFileSize>
                <maxHistory>${logger_max_history}</maxHistory>
                <totalSizeCap>1GB</totalSizeCap>
            </rollingPolicy>
            <encoder>
                <pattern>${log_pattern}</pattern>
                <charset>UTF-8</charset>
            </encoder>
        </appender>
    </springProfile>

    <springProfile name="test">
        <!--输出到文件-->
        <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
                <maxFileSize>${max_file_size}</maxFileSize>
                <maxHistory>${logger_max_history}</maxHistory>
                <totalSizeCap>1GB</totalSizeCap>
            </rollingPolicy>
            <encoder>
                <pattern>${log_pattern}</pattern>
                <charset>UTF-8</charset>
            </encoder>
        </appender>
    </springProfile>


    <springProfile name="prod">
        <root level="INFO">
            <appender-ref ref="FILE"/>
        </root>
    </springProfile>

    <springProfile name="test">
        <root level="DEBUG">
            <appender-ref ref="FILE"/>
        </root>
    </springProfile>

    <springProfile name="dev">
        <root level="DEBUG">
            <appender-ref ref="STDOUT"/>
        </root>
    </springProfile>

</configuration>

application.properties 样例：

spring.application.name=qiniu-sync-nas

# 日志配置
logging.path=D:/vfsroot/logs
logging.file.max-history=7
logging.file.max-size=10MB

# 会检查终端是否支持ANSI，是的话就采用彩色输出
spring.output.ansi.enabled=detect

旧 web 项目使用 logback 配置可参考旧 web 项目使用 logback

日志规范可参考：惊讶！我定的日志规范被CTO在全公司推广了

本文由 Sherlock 创作，如果您觉得本文不错，请随意赞赏
采用 知识共享署名4.0 国际许可协议进行许可
本站文章除注明转载/出处外，均为本站原创或翻译，转载前请务必署名
原文链接：https://halo.sherlocky.com/archives/spring-bootxue-xi-3-ri-zhi-guan-li
最后更新于：2019-12-31 09:20:32

最新文章
CentOS7 Nginx 服务化、开机自启动

直接上命令：vi/usr/lib/systemd/system/nginx.service编辑文件内容为：[Unit]Description=nginxAfter=network.target[Service]Type=forkingExecStart=/usr/local/nginx/sbin/n
群晖 NAS Let's Encrypt 泛域名证书自动更新

我们都知道可以使用Let’sEncrypt免费申请HTTPS证书。而且现在acme协议版本更新了，开始支持泛域名(wildcard)了，这样可以只申请一个类似*.xxx.com的证书，而不需要单独为每个子域名申请证书了。很爽~大神已经对acme脚本做了群晖NAS的适配——syno-acme，我们就是
使用七牛云 API 上传 letsencrypt SSL 证书并绑定到 CDN

certbot 生成的 letsencrypt 证书，可惜只有3个月有效期，好在可以无限续命，nginx 配置在上文中已经实现了自动刷新证书。 另外笔者使用了七牛云的 CDN，同样需要SSL证书，但是每次更新后都需要手动上传。今日下班后闲着无聊研究了一下七牛的API，简单实现了证书上传脚本。
CentOS 安装 Jenkins 及 国内下载加速

yum下安装jenkins Jenkins 国内环境 插件下载加速
MySQL 使用 utf8mb4 编码

在 MySQL8 以下版本，测试发现，如果只需要对某一列支持utf8mb4，此时不需要改数据库和表的编码，只修改那一列的编码为utf8mb4就可以，最主要的还是修改``my.cnf``文件。
分类
生活 life
杂记 zaji
娱乐 yule
标签
postgresql postgresql
css css
mybatis mybatis
博客 1576560981808
微服务 1575621302506
SSL ssl
yum yum
https https
leetcode leetcode
JDBC jdbc
pdf pdf
itext itext
python python
MySQL8 mysql8
CTE cte
windows windows
ss ss
缓存 huan-cun
dubbo dubbo
死锁 si-suo
TCP tcp
茶 cha
Exception exception
Restful restful
Elasticsearch elasticsearch
语录 yu-lu
IO io
儿童 er-tong
教育 jiao-yu
算法 suan-fa
历史 li-shi
书法 shu-fa
管理 guan-li
James james
邮件 you-jian
Gradle gradle
Tomcat tomcat
Android android
玩 wan
笔记 bi-ji
多线程 duo-xian-cheng
transaction transaction
ffmpeg ffmpeg
NAS nas
Node.js nodejs
rss rss-tag
json json
websocket websocket
car car
book book
frp frp
MQ mq
Google google
Apache apache
httpd httpd
CentOS7 centos7
诗歌 shi-ge
美文 mei-wen
svn svn
Docker docker
EPEL epel
文件 wen-jian
分布式 fen-bu-shi
log log
上传 shang-chuan
断点续传 duan-dian-xu-chuan
learning learning
ip ip
SpringBoot springboot
Ubuntu ubuntu
加密 jia-mi
Bcrypt bcrypt
sftp sftp
极客 ji-ke
路由 lu-you
刷机 shua-ji
IDEA idea
开源 kai-yuan
许可证 xu-ke-zheng
findbugs findbugs
php php
webstorm webstorm
内存 nei-cun
GPU gpu
Spring spring
MVC mvc
并发 bing-fa
CentOS centos
面试 mian-shi
硬件 ying-jian
cpu cpu
percona-toolkit percona-toolkit
Maven maven
eclipse eclipse
重构 zhong-gou
Lua lua
恢复 hui-fu
数据迁移 shu-ju-qian-yi
tag tag
命令 ming-ling
scp scp
复制 fu-zhi
备份 bei-fen
定时任务 ding-shi-ren-wu
cron cron
Linux linux
服务器 fu-wu-qi
性能 xing-neng
iptables iptables
vps vps
MySQL mysql
markdown markdown
Git git
Github github
reading reading
Redis redis
cache cache
Java java
octopress octopress
JVM jvm
Nginx nginx
web web
CDN cdn
forever forever
Ghost ghost-tag