Log4J的配置详解及输出文件的级别限制

Log4J的配置详解及输出文件的级别限制

1、Log4j的配置详解

1.1、Log4j的架构

Log4j系统的三大板块：日志写入器、日志输出终端、日志布局模式

Logger类是日志包的核心，Logger的名称是大小写敏感的，并且名称之间有继承关系。子名由父名做前缀，用点号“.”分隔，如x.y是x.y.z 的父亲Logger。Logger系统中有个根logger，是所有logger的祖先，它总是存在的，并且不可以通过名字获取，可以通过 Logger.getRootLogger()来获取。获取Logger对象的方法很多，可以参考API文档，在某对象中，用该对象所属的类作为参数，调 用Logger.getLogger(Class clazz)以获取logger对象被认为是目前所知最理智的命名logger方法。

1.2、Log4j的级别

每个logger都有一个日志级别，用来控制日志的输出。未分配级别的logger将自动继承它最近的父logger的日志级别。Logger的由低到高级别如下：

ALL<DEBUG<INFO<WARN<ERROR<FATAL<OFF

1.3、Log4j的输出终端（Appender接口）

org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天都产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小达到指定尺寸时产生一个新的日志文件，文件名称上会自动添加数字序号。)
org.apache.log4j.WriterAppender(将日志信息以流的格式发送到任意指定的地方)

默认情况下，子logger将继承父logger的所有appenders。

1.4、Log4j的输出布局模式（Layout接口）

org.apache.log4j.HTMLLayout（以HTML表格形式布局）
org.apache.log4j.PatternLayout（可以灵活地指定布局模式）
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等信息）

日志输出格式，所用到的参数说明如下，按需添加

%p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL
%d: 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921
%r: 输出自应用启动到输出该log信息耗费的毫秒数
%c: 输出日志信息所属的类目，通常就是所在类的全名
%t: 输出产生该日志事件的线程名
%l: 输出日志事件的发生位置，相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:20)
%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中
%%: 输出一个”%”字符
%F: 输出日志消息产生时所在的文件名称
%L: 输出代码中的行号
%m: 输出代码中指定的消息,产生的日志具体信息
%n: 输出一个回车换行符，Windows平台为”\r\n”，Unix平台为”\n”输出日志信息换行

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：
1)%20c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。
2)%-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，”-”号指定左对齐。
3)%.30c:指定输出category的名称，最大的宽度是30，如果category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。
4)%20.30c:如果category的名称小于20就补空格，并且右对齐，如果其名称长于30字符，就从左边交远销出的字符截掉。

1.5、Log4j的配置

### 设置级别和目的地(这里多个目的地) ###
log4j.rootLogger = info, Console, Debug, Info, Warn, Error
#log4j.additivity.org.apache=true

### 输出到控制台 ###
log4j.appender.Console = org.apache.log4j.ConsoleAppender
log4j.appender.Console.Target = System.out
log4j.appender.Console.layout = org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 输出debug以上级别到日志文件 ###
log4j.appender.Debug = org.apache.log4j.DailyRollingFileAppender
log4j.appender.Debug.File = /logs/debug.log
log4j.appender.Debug.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.Debug.Append = true
log4j.appender.Debug.Threshold = DEBUG
log4j.appender.Debug.layout = org.apache.log4j.PatternLayout
log4j.appender.Debug.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n
log4j.appender.Debug.Encoding=UTF-8

### 输出INFO以上级别到日志文件 ###
log4j.appender.Info = org.apache.log4j.DailyRollingFileAppender
log4j.appender.Info.File = /logs/info.log
log4j.appender.Info.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.Info.Append = true
log4j.appender.Info.Threshold = INFO
log4j.appender.Info.layout = org.apache.log4j.PatternLayout
log4j.appender.Info.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n
log4j.appender.Info.Encoding=UTF-8

### 输出Warn以上级别到日志文件 ###
log4j.appender.Warn = org.apache.log4j.DailyRollingFileAppender
log4j.appender.Warn.File = /logs/warn.log
log4j.appender.Warn.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.Warn.Append = true
log4j.appender.Warn.Threshold = WARN
log4j.appender.Warn.layout = org.apache.log4j.PatternLayout
log4j.appender.Warn.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n
log4j.appender.Warn.Encoding=UTF-8

### 输出Error以上级别到日志文件 ###
log4j.appender.Error = org.apache.log4j.DailyRollingFileAppender
log4j.appender.Error.File = /logs/error.log
log4j.appender.Error.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.Error.Append = true
log4j.appender.Error.Threshold = ERROR
log4j.appender.Error.layout = org.apache.log4j.PatternLayout
log4j.appender.Error.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n
log4j.appender.Error.Encoding=UTF-8

注意点，只导出相应级别到相应文件中，可自定义类型，如下所示
上述配置文件中，导出某某级别日志到指定文件的关键配置是：log4j.appender.Debug.Threshold = DEBUG
只想筛选出与Threshold配置一致的级别到日志文件，可以自定义类，继承DailyRollingFileAppender类

public class MyDailyRollingFileAppender extends DailyRollingFileAppender {
    @Override
    public boolean isAsSevereAsThreshold(Priority priority) {
        //只判断是否相等，而不判断优先级
        return this.getThreshold().equals(priority);
    }
}

然后把类替换下即可。

2、测试调用

public static Logger logger = Logger.getLogger(Log4jTest.class);
public static void main(String[] args) {
    logger.trace("我是logger，trace");
    logger.debug("我是logger，debug");
    logger.info("我是logger，info");
    logger.warn("我是logger，warn");
    logger.error("我是logger，error");
    logger.fatal("我是logger，fatal");
}

3、log4j将日志输出到文本文件，并且，每一小时生成一个文件，每天一个文件，每半天一个文件

需要使用org.apache.log4j.DailyRollingFileAppender类，并使用log4j.appender.XXX.DatePattern配置生成文件方式类型

DatePattern=’.’yyyy-ww:每周滚动一次文件，即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下：
1)’.’yyyy-MM: 每月
2)’.’yyyy-ww: 每周
3)’.’yyyy-MM-dd: 每天
4)’.’yyyy-MM-dd-a: 每天两次
5)’.’yyyy-MM-dd-HH: 每小时
6)’.’yyyy-MM-dd-HH-mm: 每分钟

4、log4j将日志输出到文本文件，并且，超过一定大小，新建一个文件

使用org.apache.log4j.RollingFileAppender类，并设置log4j.appender.XXX.MaxFileSize的值，若MaxFileSize=2KB，则在文本文件超过2KB时，即新建一个文件。

原文转载：https://blog.csdn.net/qq_27615455/article/details/79801782
原文转载：https://blog.csdn.net/misswwg/article/details/79165220