Log4j日志体系结构

转自:https://my.oschina.net/andylucc/blog/794867

摘要

我们在写日志的时候首先要获取logger,在每一个使用log4j的项目都有很多个地方要获取logger,这些logger是真实的被实例化的Logger对象,他们有可能被分散在无数不同的类中,日志体系结构讲的是这些logger对象是如何组织的,他们之间又有什么样的关系。

体系结构

我们举个具体的实例来看看,假设我的项目包结构如下:

项目结构

说明一下:com.flu.jdk包下面有两个类分别是LogTest1和LogTest2,然后在包com.flu包下面有一个LogTest3类,很显然,com.flu.jdk包是com.flu包的子包。假设我们在这三个类中分别通过LogManager.getLogger(xxx.class)获取三个logger实例,他们分别是logger1、logger2和logger3,我们将要讨论这三个logger的关系。

值得注意的是log4j的日志体系中,有一个特殊的日志对象叫做root(根),他是始终存在的,假设我们首先获取logger实例,log4j将构造下面这样一个图形(我不能把它叫做树):

当只有logger1的时候

当我们获取logger2实例的时候,这个图将变成:

当加入logger2日志实例时结构图

当我们获取logger3实例的时候,这个图又变了一个样,如下:

当加入logger3日志实例之后

仅仅才三个日志实例,图就搞的略复杂,可想log4j应用中,将会有无数的日志实例按照这个规律组成纷繁复杂的有向图结构,虽然看起来杂乱,但是又规律。那么问题来了,这样的结构有什么用呢?下一节我们将会看到这种结构对于日志配置继承的影响。

配置继承

log4j日志级别定义

在往下面看之前我们先来看看log4j对日志级别的定义:

public final static int OFF_INT = Integer.MAX_VALUE;
public final static int FATAL_INT = 50000;
public final static int ERROR_INT = 40000;
public final static int WARN_INT  = 30000;
public final static int INFO_INT  = 20000;
public final static int DEBUG_INT = 10000;
  //public final static int FINE_INT = DEBUG_INT;
public final static int ALL_INT = Integer.MIN_VALUE;

很显然,log4j的日志级别有下面的关系:

OFF > FATAL > ERROR > WARN > INFO > DEBUG > ALL

log4j在写日志的时候只有当当前写日志的级别大于等于当前日志实例的配置级别的时候,日志写操作才生效,比如当前日志实例的配置级别为INFO,那么log.info会写成功,而log.debug则不会写。

日志写源码剖析

我们来看看一句简单的log.info("this is log message")的背后,先来看看一段源代码:

public void info(Object message) {
  if(repository.isDisabled(Level.INFO_INT))
    return;
  if(Level.INFO.isGreaterOrEqual(this.getEffectiveLevel()))
    forcedLog(FQCN, Level.INFO, message, null);
}
public boolean isDisabled(int level) {
  return thresholdInt > level;
}

首先看看当前写的日志级别是否被禁止的,默认的情况下thresholdInt为ALL,因此INFO的级别显然比ALL大,因此下面会继续看看INFO的级别是否大于等于当前日志实例生效的级别,this.getEffectiveLevel()获取的实例是什么呢?我们继续看看代码:

public Level getEffectiveLevel() {
   for(Category c = this; c != null; c=c.parent) {
     if(c.level != null)
		return c.level;
   }
   return null; // If reached will cause an NullPointerException.
 }

当前日志生效的级别逻辑为首先看看当前日志实例是否有配置级别,如果没有,那么就继续找当前日志实例的parent节点,按照上一节中所表述的,如果当前日志的日志级别没有配置,当找到root的日志级别,并根据root的日志级别来断定是否继续进行日志写。这里体现了日志级别的继承关系,其实不仅仅是日志级别,日志其他相关的配置也会基于这种继承的特性,比如appender组件等。

项目应用

了解Log4j的日志体系结构以及日志级别配置的继承特性之后,我们现在应该比较清楚项目中应该如何配置了。以Log4j.xml配置文件为例子,满足基本需求我们只需要配置root这个日志实例的日志级别即可,如下:

<root>
    <level value="INFO" />
    <appender-ref ref="CONSOLE" />
</root>

上面配置了root日志实例的日志级别为INFO,如果获取按照一定规范(当前类的权限定名作为日志实例名),那么我们可以保证所有的日志实例将继承root所配置的日志级别。

配置隔离

上面的配置略粗糙,假如我们想为不同的模块给予不同的配置怎么办呢?最常见的是业务日志与中间件日志,比如我们的业务业务包名为com.dianping.biz,而我们的rpc组件的包名字为com.dianping.pigeon,则我们可以使用下面方法给予不同的模块不同的配置:

<!--业务日志配置-->
<category name="com.dianping.biz">
    <level value="INFO" />
    <appender-ref ref="CONSOLE" />
</category>

<!--pigeon组件日志配置-->
<category name="com.dianping.pigeon">
    <level value="DEBUG" />
    <appender-ref ref="CONSOLE" />
</category>

通过上面的配置,我们可以指定com.dianping.biz包下面所有类获取的logger都继承name为com.dianping.biz的日志配置,而com.dianping.pigeon包下面的所有类获取的logger都继承name为com.dianping.pigeon的日志篇日志。不过通常设计良好的中间件都定制了日志配置以确保中间件日志与业务日志隔离。

总结

昨天有个同事对log4j进行了一些分享,会上听的意犹未尽因此课下忍不住扒一扒log4j的内裤,日志作为java应用的一项重要内容,其不仅仅包括日志如何写、以什么格式写、以及日志写到哪里的问题,还包括性能、扩展性、分布式、日志实时分析等方面问题,本文在介绍log4j日志体系的基础之上稍微聊一下项目应用于配置隔离相关内容,如果读者有兴趣可以深入研究,必定收货满满。

当前日志生效的级别逻辑为首先看看当前日志实例是否有配置级别,如果没有,那么就继续找当前日志实例的parent节点,按照上一节中所表述的,如果当前日志的日志级别没有配置,当找到root的日志级别,并根据root的日志级别来断定是否继续进行日志写。这里体现了日志级别的继承关系,其实不仅仅是日志级别,日志其他相关的配置也会基于这种继承的特性,比如appender组件等。
这段话总结很好啊,不过这种继承关系也是有开关的,例如可以配置additivity=false,取消子log往父log的输出!

时间: 2024-08-01 20:21:36

Log4j日志体系结构的相关文章

转:Log4j 日志体系结构

转自:https://my.oschina.net/andylucc/blog/794867 我们在写日志的时候首先要获取logger,在每一个使用log4j的项目都有很多个地方要获取logger,这些logger是真实的被实例化的Logger对象,他们有可能被分散在无数不同的类中,日志体系结构讲的是这些logger对象是如何组织的,他们之间又有什么样的关系. 体系结构 我们举个具体的实例来看看,假设我的项目包结构如下: 项目结构 说明一下:com.flu.jdk包下面有两个类分别是LogTes

log4j日志基本配置

Log4j有三个主要的组件:Loggers(记录器),Appenders (输出源)和Layouts(布局).这里可简单理解为日志类别,日志要输出的地方和日志以何种形式输出.综合使用这三个组件可以轻松地记录信息的类型和级别,并可以在运行时控制日志输出的样式和位置. 1.Loggers Loggers组件在此系统中被分为五个级别:DEBUG.INFO.WARN.ERROR和FATAL.这五个级别是有顺序的,DEBUG < INFO < WARN < ERROR < FATAL,分别用

Log4J日志配置详解

一.Log4j简介 Log4j有三个主要的组件:Loggers(记录器),Appenders (输出源)和Layouts(布局).这里可简单理解为日志类别,日志要输出的地方和日志以何种形式输出.综合使用这三个组件可以轻松地记录信息的类型和级别,并可以在运行时控制日志输出的样式和位置. 1.Loggers Loggers组件在此系统中被分为五个级别:DEBUG.INFO.WARN.ERROR和FATAL.这五个级别是有顺序的,DEBUG < INFO < WARN < ERROR <

Spring集成Log4j日志框架

1.日志系统介绍 slf4j,即简单日志门面(Simple Logging Facade for Java),不是具体的日志解决方案,它只服务于各种各样的日志系统.简答的讲就是slf4j是一系列的日志接口,而log4j是具体实现了的日志框架. slf4j与常用日志框架绑定关系,图片来源 2.Maven导入slf4j和log4j,编辑pom.xml <!-- 导入slf4j-log4j12,依赖slf4j-api和log4j,自动导入 --> <dependency> <gro

ELK菜鸟手记 (四) - 利用filebeat和不同端口把不同服务器上的log4j日志传输到同一台ELK服务器

1. 问题描述  我们需要将不同服务器(如Web Server)上的log4j日志传输到同一台ELK服务器,介于公司服务器资源紧张(^_^) 2. 我们需要用到filebeat 什么是filebeat? filebeat被用来ship events,即把一台服务器上的文件日志通过socket的方式,传输到远程的ELK. 可以传输到logstash,也可以直接传输到elasticsearch. 3. 我们这里讲解如何传输到远程的logstash,然后再由elasticsearch讲数据传输到kib

JAVA log4j日志文件使用

//1.导入jar包,log4j-1.2.17.jar//2.src下创建log4j.properties文件//3.配置properties文件/*log4j.rootLogger(默认是对整个工程生效)=DEBUG,stdout(控制台),a, b, -日志级别(ALL<DEBUG<INFO<WARN<ERROR<FATAL<OFF)log4j.logger.com.hutu=info, stdout,表示该日志只对package com.hutu生效 log4j.

log4j日志输出到web项目指定文件夹

感谢 eric2500 的这篇文章:http://www.cxyclub.cn/n/27860/ 摘要:尝试将log4j的文件日志输出到web工程制定目录,遇到了很多问题,最终在eric2500的指导下搞定,下面是记录. 其原理在于log4j的配置文件支持服务器的vm的环境变量,如${oss.log4j.path},在log4j加载配置文件之前,先用 System.setProperty("","")设置好日志文件路径,这一操作通过一个初始的servlet来实现.

Hibernate4.3.5搭建Log4j日志环境

本文记录Hibernate4.3.5搭建Log4j日志环境的过程 1.搞清楚Hibernate4.3.5的日志环境依赖 方法:查看帮助文档 3.5. Logging Important Completely out of date. Hibernate uses JBoss Logging starting in 4.0. This will get documented as we migrate this content to the Developer Guide. Hibernate u

解决IntelliJ IDEA控制台乱码问题[包含程序运行时的log4j日志以及tomcat日志乱码]

这里使用的IntelliJ IDEA版本为[IntelliJ IDEA 14.1.4]: 一.控制台打印的程序运行时的log4j日志中包含中文乱码 在IDEA安装目录的bin目录下找到名为"idea.exe.vmoptions"的文件: 使用文本编译软件(Notepad++等)打开此文件,在文件内容从末尾追加一行设置(-Dfile.encoding=UTF-8),表示指定编码为UTF-8: 重启IDEA,再次测试,log4j日志不再乱码: 但是发现tomcat启动日志乱码了(修改IDE