Log4j2 ThreadContext使用详解_日志跟踪id实现

位置:首页>文章>详情   分类: 教程分享 > Java教程   阅读(2052)   2023-03-28 11:29:14

概述

       Log4j2 ThreadContext允许您使用多个唯一的标签标记日志语句,以分析日志,同时在运行时诊断问题-主要是在多线程应用程序中,其中应用程序会在短时间内生成大量日志。 例如。 您可能要扫描所有日志以查找特定的用户事务或完成会话。 此过程也称为鱼标记(即,在每个log语句中添加一些额外的上下文信息)。 鱼标签可以帮助使用自动工具来记录日志,例如Splunk。

让我们看看如何使用ThreadContext类在log4j2中进行捕获标记。

在ThreadContext中添加容器信息

为了唯一标记每个请求,ThreadContext提供了put(String key,String value)方法,该方法接受一个键及其值。 您可以根据需要添加任意数量的标签以捕获整个上下文信息。 请注意,ThreadContext类的所有方法都是静态的。
import java.util.UUID;
 
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.ThreadContext;
 
public class Log4j2HelloWorldExample 
{
    private static final Logger LOGGER = LogManager.getLogger(Log4j2HelloWorldExample.class.getName());
     
    public static void main(String[] args) 
    {
        //Add context information
        ThreadContext.put("id", UUID.randomUUID().toString());
        ThreadContext.put("ipAddress", "192.168.21.9");
         
        LOGGER.debug("Debug Message Logged !!");
        LOGGER.info("Info Message Logged !!");
        LOGGER.debug("Another Debug Message !!");
         
        //Clear the map
        ThreadContext.clearMap();
         
        LOGGER.debug("Thread Context Cleaned up !!");
        LOGGER.debug("Log message with no context information !!");
    }
}
或者,您可以将ThreadContext的堆栈实现与ThreadContext.push(String value)一起使用,如下所示:
//Add context information
ThreadContext.push(UUID.randomUUID().toString());
ThreadContext.push("192.168.21.9");
 
LOGGER.debug("Debug Message Logged !!");
LOGGER.info("Info Message Logged !!");
LOGGER.debug("Another Debug Message !!");
 
//Clear the map
ThreadContext.clearStack();
 
LOGGER.debug("Thread Context Cleaned up !!");
LOGGER.debug("Log message with no context information !!");
事务结束或不再需要上下文信息之后,可以使用ThreadContext.clearMap()方法清空信息。

ThreadContext的Stack和Map是按线程管理的,默认情况下基于ThreadLocal。 通过将系统属性isThreadContextMapInheritable设置为true,上下文映射的内容将传递给子线程。

修改log4j2.xml中的pattern格式

现在要在日志语句中打印以上标记,您需要在log4j2配置文件中修改转换模式。
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
    <Appenders>
        <Console name="console" target="SYSTEM_OUT">
            <PatternLayout
                pattern="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] [%X{id}] [%X{ipAddress}] %c{1} - %msg%n" />
        </Console>
    </Appenders>
    <Loggers>
        <Root level="debug" additivity="false">
            <AppenderRef ref="console" />
        </Root>
    </Loggers>
</Configuration>
  • 单独使用%X可以包含地图的全部内容。
  • 使用%X {key}来包含指定的密钥。
  • 使用%x包含堆栈的全部内容。
现在,当您运行上面的代码时–您将获得以下输出:
[DEBUG] 2016-06-21 13:09:56.485 [main] [7cdd4cf0-2c26-4b81-b374-1adce3781499] [192.168.21.9] Log4j2HelloWorldExample - Debug Message Logged !!
[INFO ] 2016-06-21 13:09:56.487 [main] [7cdd4cf0-2c26-4b81-b374-1adce3781499] [192.168.21.9] Log4j2HelloWorldExample - Info Message Logged !!
[DEBUG] 2016-06-21 13:09:56.487 [main] [7cdd4cf0-2c26-4b81-b374-1adce3781499] [192.168.21.9] Log4j2HelloWorldExample - Another Debug Message !!
[DEBUG] 2016-06-21 13:09:56.487 [main] [] [] Log4j2HelloWorldExample - Thread Context Cleaned up !!
[DEBUG] 2016-06-21 13:09:56.487 [main] [] [] Log4j2HelloWorldExample - Log message with no context information !!
如您所见,前三个日志语句添加了上下文信息-其他两个语句没有此类信息。
地址:https://www.leftso.com/article/807.html

相关阅读

概述       Log4j2 ThreadContext允许您使用多个唯一的标签标记日志语句,以分析日志,同时在运行时诊断问题-主要是在多线程应用程序中,其中应用程序会在短时间内生成大量日志
log4j使用,log4j框架在java编程中还是比较常见的,这里将会讲解通过log4j2的LevelRangeFilter将不同级别log存放不同文件中。
这个Log4j2示例将帮助您使用HTMLLayout配置log4j2.xml文件
简介       Apache Log4j2是对Log4j 1.x的升级,在性能上进行了重大改进,改进了配置文件的自动重装,Java 8 lambda支持和自定义日志级别,从而对Log4j 1....
Log4j 2 简介       Apache Log4j 2是对Log4j 1.x的升级,相对于其先前版本进行了重大改进,例如性能改进,自动重新加载已修改的配置文件,java 8 lambda...
概述       学习配置log4j2.properties文件以将日志语句输出到控制台,滚动文件等
概述下面的log4j2转换模式仅供参考,这样您和我就不会在每次创建/编辑log4j配置文件时浪费时间来构建这些模式
ConsoleAppender概述       Log4j2 ConsoleAppender将应用程序生成的日志事件附加到System.out或System.err中
概述       Log4j2 RollingFileAppender是一个OutputStreamAppender,它遵循有关何时应进行滚动(备份)的已配置触发策略,将日志消息写入文件
概述给定log4j2.xml是配置configure multiple appenders(例如控制台附加程序和文件附加程序)的参考