无规矩不成方圆

  • 日志记录规范
  • 日志打印优化
  • 批量写入


最温暖的事不是他说爱你，而是他从不说很爱很爱你，而却一直都在

日志记录规范

日志是程序员们追踪错误信息的好帮手, 但是平常日志记录又没有什么规范, 我们日志应该什么时候打, 打印什么内容的日志

日志对于程序员来说是非常重要的工具，它可以帮助我们追踪错误信息、监控程序运行状态以及诊断问题。为了让日志更加有效，我们可以遵循一些基本的日志记录规范：

  1. 日志级别：为日志设置不同的级别，例如：DEBUG、INFO、WARNING、ERROR 和 CRITICAL。这样，在不同情况下，可以方便地过滤和查看相关的日志信息。
  2. 日志内容：日志应当包含足够的上下文信息，便于诊断问题。例如，记录请求参数、用户ID、操作类型、时间戳等。同时，也要注意保护敏感信息，避免泄露。
  3. 结构化日志：使用结构化的日志格式（如JSON），便于后期日志分析和处理。
  4. 日志记录时机：
  • DEBUG：用于开发阶段，记录详细的程序运行信息，有助于发现潜在问题。
  • INFO：记录程序运行的关键节点信息，如程序启动、关闭、配置文件加载、关键操作等。
  • WARNING：记录一些非致命性的问题，如临时性错误、资源不足等，可能需要关注但不会导致程序中断。
  • ERROR：记录程序运行中的错误，如异常、错误的输入参数等，可能会导致程序无法正常运行。
  • CRITICAL：记录严重的错误，如数据丢失、系统崩溃等，需要立即处理。
  1. 日志记录原则：
  • 保持日志简洁明了，避免冗余信息。
  • 适当地使用日志级别，以便快速定位问题。
  • 遵循团队或项目的日志规范，保持一致性。
  1. 日志轮转与归档：根据日志的大小、时间或其他条件，定期轮转和归档日志文件，避免单个日志文件过大，影响系统性能。

遵循这些基本规范，可以让我们更有效地利用日志，提高工作效率。

日志打印优化

除了开启异步, 记录到消息队列, 日志打印还有什么可以优化的吗?

在Spring Boot开发中，使用Log4j2进行日志记录时，除了开启异步记录和记录到消息队列之外，还有一些其他的优化方法：

  1. 使用异步Logger：
    Log4j2提供了异步Logger，相较于异步Appender，异步Logger的性能更高。在log4j2.xml配置文件中添加 <AsyncLogger> 或 <AsyncRoot> 标签，以启用异步Logger。
  2. 配置日志级别：
    合理配置日志级别，例如在生产环境中关闭DEBUG级别，可以避免输出过多不必要的日志信息，提高程序运行效率。
  3. 使用Logger的标准方法：
    避免使用字符串拼接等低效操作，使用占位符（例如：{}）进行日志参数传递。这样，只有在需要记录日志时才会进行字符串处理，从而提高性能。
  4. 使用批量写入：
    当需要写入大量日志时，可以考虑将日志信息先存储在内存中，然后批量写入到日志文件或消息队列中，以减少I/O操作的次数。
  5. 合理配置日志存储：
  • 选择适当的日志存储介质，例如使用SSD硬盘以提高写入速度。
  • 如果条件允许，可以将日志文件存储在不同的磁盘或文件系统中，以提高性能。
  1. 压缩日志文件：
    配置Log4j2的滚动策略（RollingFileAppender）时，可以启用日志文件压缩功能，以节省磁盘空间。
  2. 使用缓冲：
    在Appender配置中，可以启用缓冲功能（如使用bufferSize参数）。通过缓冲，可以将多个日志记录合并为一次I/O操作，从而提高性能。
  3. 对日志进行监控：
    定期检查并优化日志记录，发现潜在的性能问题，避免不必要的日志开销。

以上优化方法可以帮助提高Spring Boot应用程序在使用Log4j2时的日志记录性能。不过需要注意的是，针对具体项目进行优化时，要根据实际情况进行调整，以找到适合项目的最佳方案。

批量写入

在Spring Boot和Log4j2的组合中，批量写入日志的方式主要是通过配置异步日志来实现。异步日志的实现原理是在内存中缓存一定数量的日志记录，然后批量将这些日志写入到日志文件或其他输出目标中。这样做可以减少I/O操作次数，从而提高日志记录性能。

要在Spring Boot和Log4j2中启用异步日志，可以按照以下步骤操作：

  1. 添加Log4j2依赖：

在pom.xml中添加Log4j2的依赖，替换默认的日志框架。例如：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
  1. 创建或编辑Log4j2配置文件：

在src/main/resources目录下创建或编辑log4j2.xml或log4j2.yml文件，以配置Log4j2的日志记录设置。以下是一个简单的log4j2.xml配置文件示例，启用了异步日志功能：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" monitorInterval="30">
    <Appenders>
        <RollingFile name="File" fileName="logs/app.log" filePattern="logs/app-%d{yyyy-MM-dd}.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
            </Policies>
        </RollingFile>
    </Appenders>
    <Loggers>
        <AsyncRoot level="info">
            <AppenderRef ref="File"/>
        </AsyncRoot>
    </Loggers>
</Configuration>

其中，<AsyncRoot>标签表示启用异步日志。默认情况下，异步日志的缓冲队列大小是8192条，这意味着内存中最多可以缓存8192条日志记录。当队列达到此大小时，会批量写入到日志文件中。

  1. 自定义异步日志参数：

如果需要自定义异步日志的相关参数，如队列大小、线程数等，可以在log4j2.xml配置文件中进行设置。例如：

<Configuration>
    ...
    <AsyncLoggerConfig name="com.example" level="info" includeLocation="true">
        <AppenderRef ref="File"/>
    </AsyncLoggerConfig>
    <AsyncLoggerConfig name="org.springframework" level="info" includeLocation="true">
        <AppenderRef ref="File"/>
    </AsyncLoggerConfig>
    <AsyncRoot level="error" includeLocation="true">
        <AppenderRef ref="File"/>
    </AsyncRoot>
</Configuration>

在AsyncLoggerConfig标签中，可以通过queueSize属性设置队列大小，通过numThreads属性设置异步日志处理线程数。