日志框架（一）JUL

青旅半醒 2023-01-05 05:02 120阅读 0赞

## 一、日志的概念 ##

### 1. 日志文件 ###

**日志文件是用于记录系统操作事件的文件集合**，可分为事件日志和消息日志。具有处理历史数据、诊断问题的追踪以及理解系统的活动等重要作用。

在计算机中，日志文件是记录在操作系统或其他软件运行中发生的事件或在通信软件的不同用户之间的消息的文件。记录是保持日志的行为。在最简单的情况下，消息被写入单个日志文件。

许多操作系统，软件框架和程序包括日志系统。广泛使用的日志记录标准是在因特网工程任务组（IETF）RFC5424中定义的syslog。syslog标准使专用的标准化子系统能够生成，过滤，记录和分析日志消息

#### 1.1 调试日志 ####

软件开发中，我们经常需要去调试程序，做一些信息，状态的输出便于我们查询程序的运行状况。为了让我们能够更加灵活和方便的控制这些调试的信息，所有我们需要专业的日志技术。java中寻找bug会需要重现。调试也就是debug 可以在程序运行中暂停程序运行，可以查看程序在运行中的情况。日志主要是为了更方便的去重现问题。

#### 1.2 系统日志 ####

系统日志是记录系统中硬件、软件和系统问题的信息，同时还可以监视系统中发生的事件。用户可以通过它来检查错误发生的原因，或者寻找受到攻击时攻击者留下的痕迹。系统日志包括系统日志、应用程序日志和安全日志。

**系统日志的价值**

系统日志策略可以在故障刚刚发生时就向你发送警告信息，系统日志帮助你在最短的时间内发现问题。系统日志是一种非常关键的组件，因为系统日志可以让你充分了解自己的环境。这种系统日志信息对于决定故障的根本原因或者缩小系统攻击范围来说是非常关键的，因为系统日志可以让你了解故障或者袭击发生之前的所有事件。为虚拟化环境制定一套良好的系统日志策略也是至关重要的，因为系统日志需要和许多不同的外部组件进行关联。良好的系统日志可以防止你从错误的角度分析问题，避免浪费宝贵的排错时间。另外一种原因是借助于系统日志，管理员很有可能会发现一些之前从未意识到的问题，在几乎所有刚刚部署系统日志的环境当中。

### 2. JAVA日志框架 ###

#### 2.1 为什么要使用日志框架 ####

因为软件系统发展到今天已经很复杂了，特别是服务器端软件，涉及到的知识，内容，问题太多。在某些方面使用别人成熟的框架，就相当于让别人帮你完成一些基础工作，你只需要集中精力完成系统的业务逻辑设计。而且框架一般是成熟，稳健的，他可以处理系统很多细节问题，比如，事务处理，安全性，数据流控制等问题。还有框架一般都经过很多人使用，所以结构很好，所以扩展性也很好，而且它是不断升级的，你可以直接享受别人升级代码带来的好处。

#### 2.2 现有的日志框架 ####

JUL（java util logging）、logback、log4j、log4j2

JCL（Jakarta Commons Logging）、slf4j（ Simple Logging Facade for Java）

**日志门面**

JCL、slf4j

**日志实现**

JUL、logback、log4j、log4j2

### 3. JUL学习 ###

JUL全称Java util Logging是java原生的日志框架，使用时不需要另外引用第三方类库，相对其他日志框

架使用方便，学习简单，能够在小型应用中灵活使用。

#### 3.1 JUL入门 ####

##### 3.1.1 架构介绍 #####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo_size_16_color_FFFFFF_t_70_pic_center]

*  Loggers：被称为记录器，应用程序通过获取Logger对象，调用其API来来发布日志信息。Logger
    
    通常时应用程序访问日志系统的入口程序。
 *  Appenders：也被称为Handlers，每个Logger都会关联一组Handlers，Logger会将日志交给关联
 *  Handlers处理，由Handlers负责将日志做记录。Handlers在此是一个抽象，其具体的实现决定了日志记录的位置可以是控制台、文件、网络上的其他日志服务或操作系统日志等。
 *  Layouts：也被称为Formatters，它负责对日志事件中的数据进行转换和格式化。Layouts决定了数据在一条日志记录中的最终形式。
 *  Level：每条日志消息都有一个关联的日志级别。该级别粗略指导了日志消息的重要性和紧迫，我可以将Level和Loggers，Appenders做关联以便于我们过滤消息。
 *  Filters：过滤器，根据需要定制哪些信息会被记录，哪些信息会被放过。

**总结一下就是：**

用户使用Logger来进行日志记录，Logger持有若干个Handler，日志的输出操作是由Handler完成的。

在Handler在输出日志前，会经过Filter的过滤，判断哪些日志级别过滤放行哪些拦截，Handler会将日

志内容输出到指定位置（日志文件、控制台等）。Handler在输出日志时会使用Layout，将输出内容进

行排版。

##### 3.1.2 入门案例 #####

public class JULTest { 
    
        /** * jul快速入门 */
        @Test
        public void test() { 
            //1 先获取日志记录器对象
            Logger logger = Logger.getLogger("com.tzh.JULTest");
            //2 日志记录输出
            logger.info("hello jul");
    
            //通用方法进行日志记录
            logger.log(Level.INFO, "ingo msg");
    
            //通过占位符方式输出变量值
            String name = "张三";
            int age = 18;
            logger.log(Level.INFO, "用户信息：{0},{1}", new Object[]{ name, age});
        }
    }

#### 3.2 日志的级别 ####

*  java.util.logging.Level中定义了日志的级别：
    
     *  SEVERE（最高值）
     *  WARNING
     *  INFO （默认级别）
     *  CONFIG
     *  FINE
     *  FINER
     *  FINEST（最低值）
 *  还有两个特殊的级别：
    
     *  OFF，可用来关闭日志记录。
     *  ALL，启用所有消息的日志记录。

虽然我们测试了7个日志级别但是默认只实现info以上的级别

/** * 日志级别 */
    @Test
    public void test1() { 
        //1 获取日志记录器
        Logger logger = Logger.getLogger("com.tzh.JULTest");
        //2 日志记录输出
        logger.severe("severe");
        logger.warning("warning");
        logger.info("info");
        logger.config("config");
        logger.fine("fine");
        logger.finer("finer");
        logger.finest("finest");
        //默认输出级别为info
    }

**自定义日志级别配置**

/** * 自定义日志级别 */
        @Test
        public void test2() throws IOException { 
            //1 获取日志记录器
            Logger logger = Logger.getLogger("com.tzh.JULTest");
            //一、自定义日志级别
            //a.关闭系统默认配置 默认输出级别为info
            logger.setUseParentHandlers(false);
            //b.创建consoleHandler 控制台输出
            ConsoleHandler consoleHandler = new ConsoleHandler();
            //c.创建格式转换器
            SimpleFormatter simpleFormatter = new SimpleFormatter();
            //d.进行关联
            consoleHandler.setFormatter(simpleFormatter);
            logger.addHandler(consoleHandler);
            //e.配置日志具体级别
            logger.setLevel(Level.ALL);
            consoleHandler.setLevel(Level.ALL);
    
            //创建fileHandler 文件输出
            FileHandler fileHandler = new FileHandler("/jul.log");
            fileHandler.setFormatter(simpleFormatter);
    
            logger.addHandler(fileHandler);
            fileHandler.setLevel(Level.FINER);
            //2 日志记录输出
            logger.severe("severe");
            logger.warning("warning");
            logger.info("info");
            logger.config("config");
            logger.fine("fine");
            logger.finer("finer");
            logger.finest("finest");
        }

#### 3.3 Logger之间的父子关系 ####

JUL中Logger之间存在父子关系，这种父子关系通过树状结构存储，JUL在初始化时会创建一个顶层RootLogger作为所有Logger父Logger，存储上作为树状结构的根节点。并父子关系通过路径来关联。

/** * logger的父子关系 */
        @Test
        public void test3() throws Exception { 
            //1 获取日志记录器
            Logger logger = Logger.getLogger("com.tzh");
            Logger logger1 = Logger.getLogger("com");
            System.out.println(logger.getParent() == logger1);
            //RootLogger
            System.out.println(logger1.getParent());
    
            logger1.setUseParentHandlers(false);
    
            //创建consoleHandler 控制台输出
            ConsoleHandler consoleHandler = new ConsoleHandler();
            //创建格式转换器
            SimpleFormatter simpleFormatter = new SimpleFormatter();
            //进行关联
            consoleHandler.setFormatter(simpleFormatter);
            logger1.addHandler(consoleHandler);
            //配置日志具体级别
            logger1.setLevel(Level.ALL);
            consoleHandler.setLevel(Level.ALL);
    
            //2 日志记录输出
            logger.severe("severe");
            logger.warning("warning");
            logger.info("info");
            logger.config("config");
            logger.fine("fine");
            logger.finer("finer");
            logger.finest("finest");
        }

#### 3.4 日志的配置文件 ####

默认配置文件路径$JAVAHOME\\jre\\lib\\logging.properties

/** * 加载配置文件 入门 */
        @Test
        public void test4() throws Exception { 
    		// 读取自定义配置文件
            InputStream ins = JULTest.class.getClassLoader().getResourceAsStream("logging.properties");
    		// 获取日志管理器对象
            LogManager logManager = LogManager.getLogManager();
            // 通过日志管理器加载配置文件
            logManager.readConfiguration(ins);
    
            //1 获取日志记录器
            Logger logger = Logger.getLogger("com.tzh");
    
            //2 日志记录输出
            logger.severe("severe");
            logger.warning("warning");
            logger.info("info");
            logger.config("config");
            logger.fine("fine");
            logger.finer("finer");
            logger.finest("finest");
        }

配置文件：

# RootLogger 顶级父元素指定的默认处理器为：ConsoleHandler
    handlers=java.util.logging.ConsoleHandler
    # RootLogger 顶级父元素默认的日志级别为 ALL
    .level=ALL
    # 向日志文件输出的 handler 对象
    # 指定日志文件路径 /logs/java0.log
    java.util.logging.FileHandler.pattern=/logs/java%u.log
    # 指定日志文件的内容大小
    java.util.logging.FileHandler.limit=50000
    # 指定日志文件数量
    java.util.logging.FileHandler.count=1
    # 指定 handler 对象日志消息格式对象
    java.util.logging.FileHandler.formatter=java.util.logging.XMLFormatter
    # 指定以追加方式添加日志内容
    java.util.logging.FileHandler.append=true
    #想控制台输出的 handler 对象
    # 指定 handler 对象的日志级别
    java.util.logging.ConsoleHandler.level=ALL
    # 指定 handler 对象的日志消息格式对象
    java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
    # 指定 handler对象的字符集
    java.util.logging.ConsoleHandler.encoding=UTF-8
    com.xyz.foo.level=SEVERE
    # 自定义Logger使用
    com.tzh.handlers=java.util.logging.ConsoleHandler
    com.tzh.level=CONFIG
    #关闭默认配置
    com.tzh.useParentHandlers=false

#### 3.5 日志的原理解析 ####

1.  初始化LogManager
    
    1.  LogManager加载logging.properties配置
    2.  添加Logger到LogManager
2.  从单例LogManager获取Logger
3.  设置级别Level，并指定日志记录LogRecord
4.  Filter提供了日志级别之外更细粒度的控制
5.  Handler是用来处理日志输出位置
6.  Formatter是用来格式化LogRecord的

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo_size_16_color_FFFFFF_t_70_pic_center 1]  
\--------------最后感谢大家的阅读，愿大家技术越来越流弊！--------------

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo_size_16_color_FFFFFF_t_70]

\--------------也希望大家给我点支持，谢谢各位大佬了！！！--------------

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo_size_16_color_FFFFFF_t_70_pic_center]: /images/20221119/d633fab0bce042e687c4909c80d08659.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221119/f96739b079834a2caeb63b2117500acd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200721144257696.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1phY2tfdHpo,size_16,color_FFFFFF,t_70