首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >SpringBoot 各种 Web 容器服开启 AccessLog 日志

SpringBoot 各种 Web 容器服开启 AccessLog 日志

作者头像
BUG弄潮儿
发布2022-12-05 20:33:33
6920
发布2022-12-05 20:33:33
举报
文章被收录于专栏:JAVA乐园JAVA乐园

SpringBoot 内置支持的 Web 容器有 Tomcat、Undertow、Jetty 和 Netty。默认情况下,这些 Web 服务的 AccessLog 日志是不开启的,而 AccessLog 日志对于做接口统计尤为重要。如果要开启这些日志,需要进行如下配置。

1. Tomcat容器日志配置

SpringBoot 2.x 默认支持的是 Tomcat Web 容器,如果要开启 AccessLog 日志,只需要添加若干配置文件即可:

server: 
  tomcat: 
    basedir: /var/tmp
    background-processor-delay: 30
    port-header: X-Forwarded-Port
    protocol-header: X-Forwarded-Proto
    protocol-header-https-value: https
    redirect-context-root: true
    remote-ip-header: X-Forwarded-For
    uri-encoding: UTF-8
    accesslog: 
      enabled: true
      buffered: true
      directory: ./log
      file-date-format: .yyyy-MM-dd
      pattern: '%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i" %D ms'
      prefix: access_log
      rename-on-rotate: false
      request-attributes-enabled: false
      rotate: true
      suffix: .log

其中

server: 
  tomcat: 
    basedir: /var/tmp

属性是必须要配置的,如果不配置该属性,日志也是不会输出的。配置完毕,AccessLog 日志就会在 /var/tmp/log 目录下生成,名称是 access_log.yyyy-MM-dd.log

2. Undertow容器日志配置

引入 Undertow 依赖包后,在配置文件添加如下配置。另外,注意需要排除 Tomcat 依赖包

server: 
  undertow: 
    max-http-post-size: 10MB
    buffer-size: 1024KB
    io-threads: 8
    worker-threads: 64
    direct-buffers: true
    eager-filter-init: true
    accesslog: 
      enabled: true
      pattern: common
      prefix: access_log.
      suffix: log
      dir: /var/undertow/logs
      rotate: true

配置完毕,AccessLog 日志会生成在 /var/undertow/logs 目录下。

3. Jetty容器日志配置引入 Jetty 依赖包后,在配置文件添加如下配置。另外,注意需要排除 Tomcat 依赖包

server: 
  jetty: 
    max-http-post-size: 4MB
    acceptors: 32
    selectors: 32
    accesslog: 
      enabled: true
      filename: /var/jetty/logs/access_log.yyyy_MM_dd.log
      file-date-format: yyyy-MM-dd
      retention-period: 20
      append: true
      extended-format: true
      date-format: 'dd/MMM/yyyy:HH:mm:ss Z'
      locale: zh
      timeZone: GMT+8
      log-cookies: false
      log-server: true
      log-latency: true

配置完成后,AccessLog 日志文件会生成在 /var/jetty/logs 目录下。

4. Netty容器日志配置

这个容器比较特殊,说其是容器,倒不如说是一种协议。启用这个作为“容器”的话,需要引入reactor-netty.jar。这个版本管理也比较乱,注意与 netty 版本匹配!并且在reactor-netty早期版本(低于0.7.8版本)是不支持 AccessLog 日志的!(这里用的是0.7.13版本,当然也可以用更高版本,但是注意与netty版本要保持兼容!)首先加入reactor-netty依赖:

<dependency>
    <groupId>io.projectreactor.ipc</groupId>
    <artifactId>reactor-netty</artifactId>
    <version>0.7.13.RELEASE</version>
</dependency>

其次,需要开启netty日志支持,需要添加系统属性reactor.netty.http.server.accessLogEnabled=true。注意,这个属性不能通过SpringBoot配置添加,但可以使用下面方法:

public static void main(String[] args) throws Exception {
    System.setProperty("reactor.netty.http.server.accessLogEnabled", "true");
    configureApplication(new SpringApplicationBuilder()).run(args);
}

最后,需要借助系统日志实现该日志的输出(这里用的是 logback),参照配置如下:

<!-- [Netty Appender] Access日志 -->
<appender name="ACCESS-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>/var/netty/log/access_log.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>/var/netty/log/access/access_log.log.%d{yyyyMMdd}</fileNamePattern>
        <maxHistory>20</maxHistory>
    </rollingPolicy>
    <encoder charset="UTF-8">
        <pattern>%msg%n</pattern>
    </encoder>
</appender>
<appender name="ASYNC-APPENDER" class="ch.qos.logback.classic.AsyncAppender">
    <appender-ref ref="ACCESS-APPENDER" />
</appender>
<!-- ===== [Access Logger] ===== -->
<logger name="reactor.netty.http.server.AccessLog" additivity="false">
    <level value="INFO"/>
    <appender-ref ref="ASYNC-APPENDER"/>
</logger>

这里要注意几点:

  • logger名称必须用reactor.netty.http.server.AccessLog
  • encoder的pattern无需自己定义,使用系统定义即可(%msg%n);
  • 生成日志存放路径/var/netty/log;

目前系统内置的支持的这几种 Web 容器的 AccessLog 日志配置就是这些,如果想使用自定义Web容器,那可以参照

org.springframework.boot.autoconfigure.web.embedded.EmbeddedWebServerFactoryCustomizerAutoConfiguration

该文件来配置自定义 Web 容器和其AccessLog 日志。

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2022-07-12,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 BUG弄潮儿 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
相关产品与服务
容器服务
腾讯云容器服务(Tencent Kubernetes Engine, TKE)基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务,覆盖 Serverless、边缘计算、分布式云等多种业务部署场景,业内首创单个集群兼容多种计算节点的容器资源管理模式。同时产品作为云原生 Finops 领先布道者,主导开源项目Crane,全面助力客户实现资源优化、成本控制。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档