基于log4j2.properties踩坑与填坑

log4j2.properties踩坑与填坑

日志配置

门面模式：slf4j

日志库：log4j2

引入依赖：compile('org.springframework.boot:spring-boot-starter-log4j2:2.0.4.release')

采坑

启动application时，出现multiple bindings were found on the class path的问题

• 坑点：没有排除对默认logback的依赖
• 填坑：在build.gradle中加入：

configurations {
    compile.exclude module: 'spring-boot-starter-logging'
}

启动后，没有按照配置好的格式输出

• 坑点：没有在application.[yml|properties]中声明配置文件的路径
• 填坑：在application.yml中加入

#指定log4j2配置文件的位置与名称
logging:
  config: classpath:log4j2.properties

格式化日志输出参数

• %m 输出代码中指定的消息
• %p 输出优先级，即debug，info，warn，error，fatal
• %r 输出自应用启动到输出该log信息耗费的毫秒数
• %c 输出所属的类目，通常就是所在类的全名
• %t 输出产生该日志事件的线程名
• %n 输出一个回车换行符，windows平台为“rn”，unix平台为“n”
• %d 输出日志时间点的日期或时间，默认格式为iso8601，也可以在其后指定格式，比如：%d{yyy mmm dd hh:mm:ss,sss}，输出类似：2002年10月18日 22：10：28，921
• %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：testlog4.main(testlog4.java:10)
• %f 输出日志消息产生时所在的文件名称
• %l 输出代码中的行号
• %x 输出和当前线程相关联的ndc(嵌套诊断环境),像java servlets多客户多线程的应用中
• %% 输出一个"%"字符

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：

• %5c: 输出category名称，最小宽度是5，category<5，默认的情况下右对齐
• %-5c:输出category名称，最小宽度是5，category<5，"-"号指定左对齐,会有空格
• %.5c:输出category名称，最大宽度是5，category>5，就会将左边多出的字符截掉，<5不会有空格
• %20.30c:category名称<20补空格，并且右对齐，>30字符，就从左边交远销出的字符截掉

记录一份自己的配置文件

实现控制台打印，以及基于时间和基于文件大小的本地保存策略。

name=propertiesconfig
# 定义变量。指定日志文件的位置和文件名称,以便记录多份日志时,直接引用
property.filename=qiyinzone
property.filedir=./logs
property.filepath=${filedir}/${filename}.log
appenders=console, rolling
 
# rootlogger, 根记录器，所有记录器的父辈
# 指定根日志的级别
rootlogger.level=info
# 指定输出的appender引用
rootlogger.appenderref.stdout.ref=stdout
rootlogger.appenderref.rolling.ref=inforollingfile
 
# console
# 指定输出源的类型与名称
appender.console.type=console
appender.console.name=stdout
appender.console.layout.type=patternlayout
# 输出模板
appender.console.layout.pattern=%highlight{%d{yyyy-mm-dd hh:mm:ss.sss} [%5p] [%t] [%l] - %m%n}{fatal=white, error=red, warn=blue, info=green, debug=yellow, trace=blue}
 
# rolling file
appender.rolling.type=rollingfile
appender.rolling.name=inforollingfile
appender.rolling.filename=${filepath}
# 指定当发生rolling时，文件的转移和重命名规则
appender.rolling.filepattern=${filedir}/${filename}_%d{yyyy-mm-dd}_%i.log
appender.rolling.layout.type=patternlayout
appender.rolling.layout.pattern=%highlight{%d{yyyy-mm-dd hh:mm:ss.sss} [%5p] [%t] [%l] - %m%n}{fatal=white, error=red, warn=blue, info=green, debug=yellow, trace=blue}
# 指定记录文件的封存策略，该策略主要是完成周期性的日志文件封存工作
appender.rolling.policies.type=policies
# 基于时间的触发策略
appender.rolling.policies.time.type=timebasedtriggeringpolicy
# 当前记录周期为每1h生成一个文件
appender.rolling.policies.time.interval=1
appender.rolling.policies.time.modulate=true
# 基于日志文件体积的触发策略
appender.rolling.policies.size.type=sizebasedtriggeringpolicy
# 当日志文件体积大于size指定的值时，触发rolling
appender.rolling.policies.size.size=20m
# 文件封存的覆盖策略
appender.rolling.strategy.type=defaultrolloverstrategy
# 生成分割（封存）文件的个数
appender.rolling.strategy.max=100

打印效果

打印时，对不同level的日志定义了不同的字体颜色，方便定位。

%highlight{%d{yyyy-mm-dd hh:mm:ss.sss} [%5p] [%t] [%l] - %m%n}{fatal=white, error=red, warn=blue, info=green, debug=yellow, trace=blue}

log4j2 properties配置文件

原工作组比较清闲，被临时借调到新的工作组。组长给了个任务是把log4j的xml配置文件改成properties，原因是xml格式的看着不舒服。哈，以上不算吐槽，只是交待一下，为什么我要这么费劲的使用properties做配置文件。

log4j2 一开始抛弃了properties配置文件格式，到2.4版本时，又开始支持properties配置文件格式。到2.6版本又有新的要求。我用的是写本文时的最近版本2.8

status = error
property.log_home=/output/logs
property.backup_home=backup
property.server_name=buddie-service
property.every_file_size=10m
property.output_log_level=info
property.file_max=10
appender.console.type = console
appender.console.name = stdout
appender.console.layout.type = patternlayout
appender.console.layout.pattern = %m%n
appender.rolling.type=rollingfile
appender.rolling.name=rollingfileall
appender.rolling.filter.threshold.level = trace
appender.rolling.filter.threshold.type = thresholdfilter
appender.rolling.filename=${log_home}/dev_${server_name}_all.log
appender.rolling.filepattern=${log_home}/dev_${backup_home}/dev_${server_name}_all.%d{yyyy-mm-dd-hh}.log
appender.rolling.layout.type=patternlayout
appender.rolling.layout.pattern=%d %p %c{1.} [%t] %m%n
appender.rolling.policies.type=policies
appender.rolling.policies.time.type=timebasedtriggeringpolicy
appender.rolling.policies.time.interval=2
appender.rolling.policies.time.modulate=true
appender.rolling.policies.size.type=sizebasedtriggeringpolicy
appender.rolling.policies.size.size=${every_file_size}
appender.rolling.strategy.type=defaultrolloverstrategy
appender.error.type=rollingfile
appender.error.name=rollingfileerror
appender.error.filter.threshold.level = error
appender.error.filter.threshold.type = thresholdfilter
appender.error.filename=${log_home}/dev_${server_name}_error.log
appender.error.filepattern=${log_home}/dev_${backup_home}/dev_${server_name}_error.%d{yyyy-mm-dd-hh}.log
appender.error.layout.type=patternlayout
appender.error.layout.pattern=%d %p %c{1.} [%t] %m%n
appender.error.policies.type=policies
appender.error.policies.time.type=timebasedtriggeringpolicy
appender.error.policies.time.interval=2
appender.error.policies.time.modulate=true
appender.error.policies.size.type=sizebasedtriggeringpolicy
appender.error.policies.size.size=${every_file_size}
appender.error.strategy.type=defaultrolloverstrategy
appender.charge.type=rollingfile
appender.charge.name=rollingfilecharge
appender.charge.filter.threshold.level = trace
appender.charge.filter.threshold.type = thresholdfilter
appender.charge.filename=${log_home}/dev_${server_name}_charge.log
appender.charge.filepattern=${log_home}/dev_${backup_home}/dev_${server_name}_charge.%d{yyyy-mm-dd-hh}.log
appender.charge.layout.type=patternlayout
appender.charge.layout.pattern=%d %p %c{1.} [%t] %m%n
appender.charge.policies.type=policies
appender.charge.policies.time.type=timebasedtriggeringpolicy
appender.charge.policies.time.interval=2
appender.charge.policies.time.modulate=true
appender.charge.policies.size.type=sizebasedtriggeringpolicy
appender.charge.policies.size.size=${every_file_size}
appender.charge.strategy.type=defaultrolloverstrategy
logger.activity.name = buddie.activity
logger.activity.level = debug
logger.activity.additivity = false
logger.activity.appenderref.all.ref = rollingfileall
logger.activity.appenderref.error.ref = rollingfileerror
logger.activity.appenderref.stdout.ref = stdout
logger.login.name = buddie.login
logger.login.level = debug
logger.login.additivity = false
logger.login.appenderref.all.ref = rollingfileall
logger.login.appenderref.error.ref = rollingfileerror
logger.login.appenderref.stdout.ref = stdout
logger.charge.name = buddie.charge
logger.charge.level = trace
logger.charge.additivity = false
logger.charge.appenderref.all.ref = rollingfileall
logger.charge.appenderref.error.ref = rollingfileerror
logger.charge.appenderref.charge.ref = rollingfilecharge
logger.charge.appenderref.stdout.ref = stdout
rootlogger.level = info
rootlogger.appenderref.stdout.ref = stdout
rootlogger.appenderref.all.ref = rollingfileall
rootlogger.appenderref.error.ref = rollingfileerror

以上为个人经验，希望能给大家一个参考，也希望大家多多支持。