logback 变量

定义变量

• 在 logback.xml 中定义
• 在命令行定义
• 引入 properties 文件

在 logback.xml 中定义变量

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <property name="logBase" value="/logs"/>
...
</configuration>

在命令行定义变量

在命令行通过大 D 参数来定义

java -DHOME="/home/logstore" xxx.jar

引入 properties 文件

在 properties 文件定义变量。logback 引入 properties 文件后，获得变量。

通过文件路径引入 properties 文件：

<configuration>
  <property file="/AppPath/logbackVars.properties" />
...
</configuration>

通过 classpath 引入 properties 文件:

<configuration>
  <property resource="logbackVars.properties" />
...
</configuration>

properties 文件的格式是 key-value 型:

HOME=/logs

变量的作用域

变量有三个作用域：

• local 作用域在配置文件内有效
• context 作用域的有效范围延伸至 logger context
• system 作用域的范围最广，整个 JVM 内都有效

logback 在替换变量时，首先搜索 local 变量，然后搜索 context，然后搜索 system。

如何为变量指定 scope ?

<configuration>
  <property scope="context" name="home" value="/logs" />
  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>/${home}/myApp.log</file>
...
  </appender>
...
</configuration>

变量的默认值

在引用一个变量时，如果该变量未定义，需要为其指定默认值，写法是：

${变量名:-默认值}

示例：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <property name="logBase" value="${HOME:-/logs}"/>

    <appender name="file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <FileNamePattern>${logBase}/log.%d{yyyy-MM-dd}.log</FileNamePattern>
            <MaxHistory>60</MaxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yy/MM/dd HH:mm:ss.SSS} %-5level %line %logger{15} - %msg %n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>
...
</configuration>

变量使用

使用方式：

${变量名} 

示例：参见前面示例中用法。

[spring boot] 自定义 log 配置文件名_springapplication run 执行前动态修改 log 文件名 - CSDN 博客

默认情况下，spring boot 按照下表查找 log 的配置文件。

Logging System	Customization
Logback	logback-spring.xml, logback-spring.groovy, logback.xml, or logback.groovy
Log4j2	log4j2-spring.xml or log4j2.xml
JDK (Java Util Logging)	logging.properties

在某些情况下，希望使用其它的配置文件，比如：名为 logback-spring-dev.xml 的配置文件。此时，需要在 application.properties 文件中使用属性 logging.config 指定配置文件。如下：

   logging.config=classpath:logback-spring-dev.xml