Java在CentOS上如何进行日志配置

Java 在 CentOS 上的日志配置实操指南

一 前置准备与目录权限

• 确认应用使用的日志框架：常见为 Logback、Log4j 1.x/2.x、SLF4J（门面）、JUL（java.util.logging）。SLF4J 需要绑定具体实现（如 Logback 或 Log4j）。
• 规划日志目录（示例：/var/log/myapp），并创建与授权（假设应用以 javauser 运行）：
  • 创建目录：sudo mkdir -p /var/log/myapp
  • 授权目录：sudo chown -R javauser:javauser /var/log/myapp && sudo chmod 755 /var/log/myapp
• 配置文件放置位置：放在应用 classpath（如 Maven 工程的 src/main/resources），打包后随 JAR 生效。修改配置后需重启应用（如 systemctl restart tomcat）。

二 使用 Logback 输出到文件并滚动

• 依赖（Maven，示例版本）：
  • ch.qos.logback:logback-classic:1.2.11
  • org.slf4j:slf4j-api:1.7.25
• 示例 logback.xml（按天滚动、保留 30 天、输出到 /var/log/myapp/app.log）：

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>/var/log/myapp/app.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>/var/log/myapp/app.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="INFO">
    <appender-ref ref="FILE"/>
  </root>
</configuration>

• 要点：使用 RollingFileAppender + TimeBasedRollingPolicy 实现按时间切分；确保运行用户对 /var/log/myapp 具备写权限。

三 使用 Log4j 2 输出到文件并滚动

• 依赖（Maven，示例版本）：org.apache.logging.log4j:log4j-core:2.17.1
• 示例 log4j2.xml（按大小滚动：单文件 10MB、保留 10 个备份）：

<Configuration status="WARN">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
    </Console>
    <RollingFile name="RollingFile"
                 fileName="/var/log/myapp/app.log"
                 filePattern="/var/log/myapp/app.%i.log">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
      <Policies>
        <SizeBasedTriggeringPolicy size="10 MB"/>
      </Policies>
      <DefaultRolloverStrategy max="10"/>
    </RollingFile>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="Console"/>
      <AppenderRef ref="RollingFile"/>
    </Root>
  </Loggers>
</Configuration>

• 要点：使用 RollingFile + SizeBasedTriggeringPolicy 实现按大小切分；如需按时间切分，可改用 TimeBasedTriggeringPolicy 与相应 filePattern。

四 系统级日志与集中化采集

• 输出到 syslog（系统日志）：在日志框架中配置 SyslogAppender（Log4j/Log4j2 均支持），将日志发送到本地 rsyslog；适用于统一审计与集中采集。
• 使用 Logstash/Elasticsearch/Kibana 集中化：Java 侧用 Logback/Log4j 输出到文件，部署 Filebeat 采集日志并发送至 Logstash，再由 Elasticsearch 存储、Kibana 可视化展示。
• 系统级轮转（可选）：对落盘到 /var/log/ 的日志，可用 logrotate 管理（创建 /etc/logrotate.d/myapp 配置定时压缩、清理与保留策略）。

五 常见问题与排查

• 权限与路径：应用用户对日志目录（如 /var/log/myapp）需具备写权限；路径不存在会导致启动失败或无法写日志。
• 配置未生效：确认配置文件在 classpath 下、文件名与框架约定一致（如 logback.xml、log4j2.xml、log4j.properties），并重启应用。
• 依赖冲突与桥接：避免同时存在多套日志实现；使用 SLF4J 时确保仅保留一个实现，并正确排除冲突依赖；如需统一 JUL 日志，添加 jul-to-slf4j 桥接。
• 性能与级别：生产环境建议 INFO/WARN 为主，按需开启 DEBUG；避免过于频繁的日志导致 I/O 压力或磁盘占满。