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

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: SpringBoot 各种 Web 容器服开启 AccessLog 日志

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 日志。

相关实践学习
日志服务之数据清洗与入湖
本教程介绍如何使用日志服务接入NGINX模拟数据,通过数据加工对数据进行清洗并归档至OSS中进行存储。
相关文章
|
3天前
|
前端开发 Java 应用服务中间件
Spring Boot 2.x 嵌入式 Servlet 容器
Spring Boot使用内嵌Tomcat,默认端口8080,可通过`application.properties`配置端口、上下文路径等。配置方式有两种:1) 直接在配置文件中添加`server.port`和`server.servlet.context-path`;2) 创建`WebServerFactoryCustomizer` Bean来自定义配置,如设置端口`factory.setPort(8083)`,这种方式优先级更高。
|
7天前
|
Java Spring 容器
深入理解Spring Boot中的容器与依赖注入
深入理解Spring Boot中的容器与依赖注入
|
11天前
|
存储 JavaScript 容器
TS,添加注释,//,ctrl + /,shift + alt + a,输出语句,console.log(“Hello Ts‘),变量和数据类型导读,变量就是用来存储数据的容器,变量的使用,TS
TS,添加注释,//,ctrl + /,shift + alt + a,输出语句,console.log(“Hello Ts‘),变量和数据类型导读,变量就是用来存储数据的容器,变量的使用,TS
|
17天前
|
Java API Docker
使用Spring Boot和Docker进行容器化部署
使用Spring Boot和Docker进行容器化部署
|
19天前
|
Java 应用服务中间件 Maven
SpringBoot(六)之内嵌容器
需要用哪个容器,就把其他两个容器注释掉。(
14 0
|
19天前
|
Java 应用服务中间件 容器
手写SpringBoot(二)之动态切换Servlet容器
我们在切换serlvet容器的时候,会将SpringBoot默认的tomcat jar包给排除掉,换上我们需要的jar包,比如jetty。
16 0
|
20天前
|
Java Docker 容器
springboot项目容器化
springboot项目容器化
12 0
|
26天前
|
前端开发 安全 数据库
Web架构&前后端分离站&Docker容器站&集成软件站&建站分配
Web架构&前后端分离站&Docker容器站&集成软件站&建站分配
|
9天前
|
边缘计算 物联网 开发者
什么是容器Docker?
什么是容器?容器,也叫Docker,是一个开源的容器化平台,用于开发、测试和部署应用程序。通过将软件打包为标准化的单元(容器),使得应用程序可以在任何地方一致地运行,不论是在开发者的本地机器上,还是在云计算平台上。Docker容器包含了应用程序运行所需的一切,包括代码、运行时、系统工具、系统库等,从而解决了“在我这里可以正常工作,但在服务器上不行”的问题。
33 1
|
13天前
|
安全 关系型数据库 开发者
Docker Compose凭借其简单易用的特性,已经成为开发者在构建和管理多容器应用时不可或缺的工具。
Docker Compose是容器编排利器,简化多容器应用管理。通过YAML文件定义服务、网络和卷,一键启动应用环境。核心概念包括服务(组件集合)、网络(灵活通信)、卷(数据持久化)。实战中,编写docker-compose.yml,如设置Nginx和Postgres服务,用`docker-compose up -d`启动。高级特性涉及依赖、环境变量、健康检查和数据持久化。最佳实践涵盖环境隔离、CI/CD、资源管理和安全措施。案例分析展示如何构建微服务应用栈,实现一键部署。Docker Compose助力开发者高效驾驭复杂容器场景。
30 1