log4j - Logger VS Appender

 

loggers 和 appenders 是两个不同的概念

一定要搞清楚两者的作用,不要搞反了。

Log4J makes a distinction between

  • loggers, which are responsible for generating log messages. logger负责产生log信息
  • appenders, which are responsible for sending those messages somewhere (a file, the console, a database, etc.) appender负责把log写到哪里

 

loggers 的继承结构

Loggers有继承结构。如果一个logger命名为“admin”, 那么它是名为“admin.component1” logger的父亲。

Loggers form a hierarchy, the root logger is the parent of the logger named admin, which is the parent of admin.component1, etc., and you can attach appenders to any logger in the hierarchy.

 

对于xml格式的配置文件,默认的父logger就是,其他自定义的是子logger。

例如:


    
        
    


.......

    
        
        
    

    
        
        
        
    

  

  

结构图如下:

log4j - Logger VS Appender_第1张图片

 

如何调用父logger,子logger

1.通过logger的名字来决定调用哪个的logger

2.如果找不到指定名字的logger,那就默认调用root logger.

 

假设项目中有如下的logger,共有三个logger:

  1. MonikerLogger
  2. com.XXX.unity.risk.engineutils.HeartBeat
  3. root (by default, when not found specific name)
 
 
    
        
        
    
	
	
        
    

    
        
        
        
    

  

Case 1

private final static Logger loggerMoniker = Logger.getLogger("MonikerLogger");

直接点名调用logger的名称,“MonikerLogger”

 

Case 2

private final static Logger logger = Logger.getLogger(Test.class);

Test.class 是指Test类的类全名,这里假设是com.XXX.unity.risk.engineutils.Test

可以看到没有匹配一个特定的logger,所以会选择root

 

Case 3

Logger log = Logger.getLogger(HeartBeat.class);

HeartBeat.class 是指Test类的类全名,这里假设是com.XXX.unity.risk.engineutils.HeartBeat

可以看到匹配到特定的 com.XXX.unity.risk.engineutils.HeartBeat  logger,所以会选择 com.XXX.unity.risk.engineutils.HeartBeat

 

 

loggers 能把消息发给哪些appenders

  • 默认情况下,logger会把消息发送给所有和它直接相连的appenders
  • 再者,当未在logger中设置additivity="false"时,还会发送给它的父亲logger的appenders.

这也是为什么,在命名logger时,会采用类似java类的结构。例如 “com.example” logger是 “com.example.Class1” 和 “com.example.subpkg.AnotherClass” 的父亲logger。

By default a logger will send messages to all appenders that are attached directly to it, or to any of its ancestors in the hierarchy (this is why loggers are conventionally named like Java classes, e.g. you can control logging for com.example.Class1 and com.example.subpkg.AnotherClass by configuring the com.example logger).

 

 

案例分析

问题描述

This might be a very easy question for some, but personally I find Log4j config to be nightmarishly difficult and that learning to perform brain surgery might be less challenging.

I am trying to lave multiple loggers logging into different files. Here is what I have in my log4j.properties file:

# Root logger option
log4j.rootLogger=INFO, file, admin # Direct log messages to a log file log4j.appender.file=org.apache.log4j.RollingFileAppender log4j.appender.file.File=/home/nick/logging/file.log log4j.appender.file.MaxFileSize=1MB log4j.appender.file.MaxBackupIndex=1 log4j.appender.file.layout=org.apache.log4j.PatternLayout log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1} - %m%n log4j.appender.admin=org.apache.log4j.RollingFileAppender log4j.appender.admin.File=/home/nick/logging/admin.log log4j.appender.admin.MaxFileSize=1MB log4j.appender.admin.MaxBackupIndex=1 log4j.appender.admin.layout=org.apache.log4j.PatternLayout log4j.appender.admin.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1} - %m%n

And here is my (very simple) Java app used to test the config:

public static void main(String[] args) throws Exception { Properties resource = new Properties(); InputStream in = new FileInputStream("/home/nick/logging/log4j.properties"); resource.load(in); PropertyConfigurator.configure(resource); Logger admin = Logger.getLogger("admin"); Logger file = Logger.getLogger("file"); admin.info("hello admin"); file.info("hello file"); }

The 2nd problem is that both messages are written to both logs. Here is the actual result:

File admin:log:

2014-04-27 11:55:30 INFO admin - hello admin 2014-04-27 11:55:30 INFO file - hello file

File file.log:

2014-04-27 11:55:30 INFO admin - hello admin 2014-04-27 11:55:30 INFO file - hello file

Here is the required result:

File admin:log:

2014-04-27 11:55:30 INFO admin - hello admin

File file.log:

2014-04-27 11:55:30 INFO file - hello file

错误原因

The configuration you have given in the question defines one logger (the root logger) which sends all the messages it generates to two separate appenders, one for each of the two files. Your code then requests two different loggers and generates one log message with each logger. Both these loggers inherit the appender configuration from the root logger, so they both send their messages to both of the configured appenders.

解决方案

Instead of attaching the two appenders to the root logger, you should attach the file appender to the file logger and the admin appender to the admin logger:

log4j.rootLogger=INFO log4j.logger.file=INFO, file log4j.logger.admin=INFO, admin

This way the file logger will send messages only to file.log, the admin logger only to admin.log, and all messages from other loggers will be silently discarded, as there are no appenders attached to the root.


The additivity flag is the exception to this rule - setting a logger's additivity to false essentially disconnects the arrow from a logger up to its parent, so messages generated by that logger (or flowing into it from one of its children) will not go any further up the tree, they will only go to appenders attached directly to the logger in question.

log4j - Logger VS Appender_第2张图片

 

 

英文原版答案

Ref: https://stackoverflow.com/questions/23322602/log4j-config-different-logs-to-different-files

Log4J makes a distinction between loggers, which are responsible for generating log messages, and appenders, which are responsible for sending those messages somewhere (a file, the console, a database, etc.). Loggers form a hierarchy, the root logger is the parent of the logger named admin, which is the parent of admin.component1, etc., and you can attach appenders to any logger in the hierarchy. By default a logger will send messages to all appenders that are attached directly to it, or to any of its ancestors in the hierarchy (this is why loggers are conventionally named like Java classes, e.g. you can control logging for com.example.Class1 and com.example.subpkg.AnotherClass by configuring the com.example logger).

Loggers and appenders form separate namespaces and this is the source of your confusion - the logger named admin and the appender named admin are two separate entities.

The configuration you have given in the question defines one logger (the root logger) which sends all the messages it generates to two separate appenders, one for each of the two files. Your code then requests two different loggers and generates one log message with each logger. Both these loggers inherit the appender configuration from the root logger, so they both send their messages to both of the configured appenders.

Instead of attaching the two appenders to the root logger, you should attach the file appender to the file logger and the admin appender to the admin logger:

log4j.rootLogger=INFO log4j.logger.file=INFO, file log4j.logger.admin=INFO, admin

This way the file logger will send messages only to file.log, the admin logger only to admin.log, and all messages from other loggers will be silently discarded, as there are no appenders attached to the root.


The additivity flag is the exception to this rule - setting a logger's additivity to false essentially disconnects the arrow from a logger up to its parent, so messages generated by that logger (or flowing into it from one of its children) will not go any further up the tree, they will only go to appenders attached directly to the logger in question.

 

你可能感兴趣的:(log4j - Logger VS Appender)