log4j 日志文件
要将日志信息写入文件,我们必须使用 org.apache.logging.log4j.FileAppender
。
FileAppender 配置
FileAppender
具有以下可配置参数:
属性 | 描述 |
---|---|
immediateFlush | 此标志默认设置为 true,这意味着文件的输出流被每次追加操作刷新。 |
encoding | 可以使用任何字符编码。 默认情况下,它是特定于平台的编码方案。 |
threshold | 此附加程序的阈值级别。 |
Filename | 日志文件的名称。 |
fileAppend | 默认情况下设置为 true,这意味着日志信息将附加到同一文件的末尾。 |
bufferedIO | 此标志指示我们是否需要启用缓冲写入。 默认情况下,它设置为 false。 |
bufferSize | 如果启用缓冲 I/O,则表示缓冲区大小。 默认情况下,它设置为 8kb。 |
以下是 FileAppender
的示例配置文件 log4j2.properties
property.filename = /workspace/java/log4j
#
appender.infoFile.type = FILE
appender.infoFile.name = infoLogFile
#
appender.infoFile.fileName=${filename}/log.out
appender.infoFile.layout.type = PatternLayout
appender.infoFile.ImmediateFlush=true
appender.infoFile.Threshold=debug
appender.infoFile.Append=false
appender.infoFile.layout.pattern=[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c{1} [%t] - %m%n
rootLogger.level = warn
rootLogger.appenderRef.infoFile.ref = infoLogFile
rootLogger.appenderRef.infoFile.level = warn
我们可以尝试使用上述配置的 log4j 示例程序
多个日志文件
出于某些原因,我们可能希望将日志消息写入多个文件,例如,如果文件大小达到某个阈值。
要将日志信息写入多个文件,我们必须使用扩展 FileAppender
类并继承其所有属性的 org.apache.logging.log4j.RollingFileAppender
类。
除了上面提到的 FileAppender
之外,我们还有以下可配置的参数
属性 | 描述 |
---|---|
maxFileSize | 这是文件将滚动到的文件的临界大小。 默认值为 10 MB。 |
maxBackupIndex | 该属性表示要创建的备份文件的数量。 默认值为 1。 |
以下是 RollingFileAppender
的示例配置文件** log4j2.properties** 。
property.filename = /workspace/java/log4j
#
appender.infoFile.type = FILE
appender.infoFile.name = infoLogFile
#
appender.infoFile.fileName=${filename}/log.out
appender.infoFile.layout.type = PatternLayout
appender.infoFile.ImmediateFlush=true
appender.infoFile.Threshold=debug
appender.infoFile.Append=true
appender.infoFile.layout.pattern=[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c{1} [%t] - %m%n
appender.infoFile.MaxFileSize=5MB
appender.infoFile.MaxBackupIndex=2
rootLogger.level = warn
rootLogger.appenderRef.infoFile.ref = infoLogFile
rootLogger.appenderRef.infoFile.level = warn
此示例配置演示每个日志文件的最大允许大小为 5 MB。 超过最大大小后,将创建一个新的日志文件。 由于 maxBackupIndex 定义为 2,一旦第二个日志文件达到最大大小,第一个日志文件将被擦除,此后所有日志信息将回滚到第一个日志文件。
我们可以尝试使用上述配置的 log4j 示例程序。
Daily 日志文件生成
可能需要每天生成日志文件,以保持日志信息的干净记录。
要每天将日志信息写入文件,我们必须使用扩展 FileAppender
类并继承其所有属性的 org.apache.logging.log4j.DailyRollingFileAppender
类。
除了上面提到的 FileAppender 之外,只有一个重要的可配置参数:
属性 | 描述 |
---|---|
DatePattern | 这指示何时滚动文件以及要遵循的命名约定。 默认情况下,滚动在每天午夜执行。 |
DatePattern 使用以下模式之一控制滚动计划:
DatePattern | 描述 |
---|---|
'.' yyyy-MM | 在每个月底和下个月的月初刷新。 |
'.' yyyy-MM-dd | 每天午夜刷新。 这是默认值。 |
'.' yyyy-MM-dd-a | 在每天的中午和午夜刷新。 |
'.' yyyy-MM-dd-HH | 每小时结束时刷新。 |
'.' yyyy-MM-dd-HH-mm | 每分钟刷新一次 |
'.' yyyy-ww | 根据地区,在每周的第一天刷新。 |
以下是一个示例配置文件 log4j2.properties
,用于在每天的中午和午夜生成刷新的日志文件。
property.filename = /workspace/java/log4j
#
appender.infoFile.type = FILE
appender.infoFile.name = infoLogFile
#
appender.infoFile.fileName=${filename}/log.out
appender.infoFile.layout.type = PatternLayout
appender.infoFile.ImmediateFlush=true
appender.infoFile.Threshold=debug
appender.infoFile.Append=true
appender.infoFile.layout.pattern=[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c{1} [%t] - %m%n
appender.infoFile.MaxFileSize=5MB
appender.infoFile.MaxBackupIndex=2
# 设置 DatePattern
log4j.appender.FILE.DatePattern='.' yyyy-MM-dd-a
rootLogger.level = warn
rootLogger.appenderRef.infoFile.ref = infoLogFile
rootLogger.appenderRef.infoFile.level = warn
我们可以尝试使用上述配置的 log4j 示例程序 。