如何在现代日志框架中使用Jenkins？

Question

Jenkins默认使用Java Utils日志记录。这是一个有点过时的日志框架，缺少Log4J或Logback等现代日志框架的许多功能。

如何使用Logback或Log4J在Tomcat上部署/配置Jenkins？

Answer 1

Jenkins主要使用Java Utils Logging (JUL)，一些依赖项和插件使用SLF4J。JUL不可替换，但在使用Logback (http://logback.qos.ch/manual/configuration.html#LevelChangePropagator)时，可以将记录器输出重定向到SLF4J (请参阅http://www.slf4j.org/legacy.html#jul-to-slf4j)，并将日志配置传播到JUL。

Jenkins捆绑了slf4j-jdk14JUL绑定(参见https://github.com/jenkinsci/jenkins/blob/jenkins-1.620/war/pom.xml#L144)。此绑定必须替换为logback。这可以通过修补jenkins-war pom或手动将WEB-INF/lib/slf4j-jdk14-1.7.7.jar替换为logback-classic-1.1.3.jar和logback-core-1.1.3.jar (Jenkins-1.620)来完成。

JUL桥可以通过在WEB-INF/classes/ containing中放置一个logging.properties文件(JULI配置，请参阅https://tomcat.apache.org/tomcat-7.0-doc/logging.html#Using_java.util.logging_%28default%29)来安装

handlers = org.slf4j.bridge.SLF4JBridgeHandler
.handlers = org.slf4j.bridge.SLF4JBridgeHandler

按照启用logback内部日志记录(debug="true")并激活LevelChangePropagator的示例Logback配置(放在WEB-INF/classes/logback.xml中)：

<configuration debug="true">
  <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator" />
  <appender name="WARN" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>/home/jenkins/work/log/warn-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
      <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
        <maxFileSize>10MB</maxFileSize>
      </timeBasedFileNamingAndTriggeringPolicy>
      <maxHistory>50</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>%date{HH:mm:ss.SSS} %-5level [%thread] %logger %msg%n</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>WARN</level>
    </filter>
  </appender>   
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%-4relative %-5level [%thread] %logger %msg %n</pattern>
    </encoder>
  </appender>
  <root level="debug">
    <appender-ref ref="WARN" />
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

Tomcat JULI日志记录是Tomcat特定的LogManager (http://docs.oracle.com/javase/7/docs/api/java/util/logging/LogManager.html)实现，它允许特定于ClassLoader的JUL配置。因此，上述配置的范围特定于Jenkins webapp。