Spring Cloud 升级之路 - 2020.0.x - 3. Undertow 的 acces-低调大师

Spring Cloud 升级之路 - 2020.0.x - 3. Undertow 的 acces

2021-04-07 552

上一节我们讲述了如何使用 Undertow 作为我们的 Web 服务容器，本小节我们来分析使用 Undertow 的另一个问题，也就是如何配置 accesslog，以及 accesslog 的各种占位符。

# accesslog 相关配置

```

server:

undertow:

# access log相关配置

accesslog:

# 存放目录，默认为 logs

dir: ./log

# 是否开启

enabled: true

# 格式，各种占位符后面会详细说明

pattern: '{

"transportProtocol":"%{TRANSPORT_PROTOCOL}",

"scheme":"%{SCHEME}",

"protocol":"%{PROTOCOL}",

"method":"%{METHOD}",

"reqHeaderUserAgent":"%{i,User-Agent}",

"cookieUserId": "%{c,userId}",

"queryTest": "%{q,test}",

"queryString": "%q",

"relativePath": "%R, %{REQUEST_PATH}, %{RESOLVED_PATH}",

"requestLine": "%r",

"uri": "%U",

"thread": "%I",

"hostPort": "%{HOST_AND_PORT}",

"localIp": "%A",

"localPort": "%p",

"localServerName": "%v",

"remoteIp": "%a",

"remoteHost": "%h",

"bytesSent": "%b",

"time":"%{time,yyyy-MM-dd HH:mm:ss.S}",

"status":"%s",

"reason":"%{RESPONSE_REASON_PHRASE}",

"respHeaderUserSession":"%{o,userSession}",

"respCookieUserId":"%{resp-cookie,userId}",

"timeUsed":"%Dms, %Ts, %{RESPONSE_TIME}ms, %{RESPONSE_TIME_MICROS} us, %{RESPONSE_TIME_NANOS} ns",

}'

# 文件前缀，默认为 access_log

prefix: access.

# 文件后缀，默认为 log

suffix: log

# 是否另起日志文件写 access log，默认为 true

# 目前只能按照日期进行 rotate，一天一个日志文件

rotate: true

```

## 注意点 1：日志文件 rotate 目前只能按照日期

Undertow 的 accesslog 处理核心类抽象是 `io.undertow.server.handlers.accesslog.AccesslogReceiver`。由于目前 Undertow 的 `AccesslogReceiver` 只有一种实现在使用，也就是 `io.undertow.server.handlers.accesslog.DefaultAccessLogReceiver`。

查看 `DefaultAccessLogReceiver` 的 rotate 时机：

[`DefaultAccessLogReceiver`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/server/handlers/accesslog/DefaultAccessLogReceiver.java)

```

/**

* 计算 rotate 时间点

*/

private void calculateChangeOverPoint() {

Calendar calendar = Calendar.getInstance();

calendar.set(Calendar.SECOND, 0);

calendar.set(Calendar.MINUTE, 0);

calendar.set(Calendar.HOUR_OF_DAY, 0);

//当前时间日期 + 1，即下一天

calendar.add(Calendar.DATE, 1);

SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd", Locale.US);

currentDateString = df.format(new Date());

// if there is an existing default log file, use the date last modified instead of the current date

if (Files.exists(defaultLogFile)) {

try {

currentDateString = df.format(new Date(Files.getLastModifiedTime(defaultLogFile).toMillis()));

} catch(IOException e){

// ignore. use the current date if exception happens.

}

//rotate 时机是下一天的 0 点

changeOverPoint = calendar.getTimeInMillis();

}

```

# accesslog 占位符

其实 Undertow 中的 accesslog 占位符，就是之前我们提到的 Undertow Listener 解析请求后抽象的 HTTP server exchange 的属性。

[官网文档](https://undertow.io/undertow-docs/undertow-docs-2.1.0/#exchange-attributes)的表格并不是最全的，并且注意点并没有说明，例如某些占位符必须打开某些 Undertow 特性才能使用等等。这里我们列出下。

首先先提出一个注意点，参数占位符，例如 `%{i,你要看的header值}` 查看 header 的某个 key 的值。**逗号后面注意不要有空格，因为这个空格会算入 key 里面导致拿不到你想要的 key**。

## 请求相关属性

|------|-------|------|------|------|

| 请求传输协议，等价于**请求协议** | 无 | `%{TRANSPORT_PROTOCOL}` | 无 | [`TransportProtocolAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/TransportProtocolAttribute.java) |

| 请求模式，例如 http、https 等 | | `%{SCHEME}` | 无 | [`RequestSchemeAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestSchemeAttribute.java) |

| 请求协议，例如 `HTTP/1.1` 等 | `%H` | `%{PROTOCOL}` | 无 | [`RequestProtocolAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestProtocolAttribute.java) |

| 请求方法，例如 GET、POST 等 | `%m` | `%{METHOD}` | 无 | [`RequestMethodAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestMethodAttribute.java) |

| 请求 Header 的某一个值 | 无 | 无 | `%{i,你要看的header值}` | [`RequestHeaderAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestHeaderAttribute.java)|

| Cookie 的某一个值| 无 | 无 | `%{c,你要看的cookie值}` 或者 `%{req-cookie,你要看的cookie值}` | 分别对应 [`CookieAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/CookieAttribute.java) 和 [`RequestCookieAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestCookieAttribute.java) |

| 路径参数 PathVariable 由于并没有被 Undertow 的 Listener 或者 Handler 解析处理，所以拦截不到，无法确认是否是一个 PathVariable 还是就是 url 路径。所以，**PathVariable 的占位符是不会起作用的**。 | 无 | 无 | `%{p, 你想查看的路径参数 key }` | [`PathParameterAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/PathParameterAttribute.java) |

| 请求参数，即 url 的 ? 之后键值对，这里可以选择查看某个 key 的值。| 无 | 无 | `%{q, 你想查看的请求参数 key}` | [`QueryParameterAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/QueryParameterAttribute.java) |

| 请求参数字符串，即 url 的 ? 之后的所有字符} |`%q`(不包含 ?)|`%{QUERY_STRING}`(不包含 ?);`%{BARE_QUERY_STRING}`(包含 ?)| 无 | [`QueryStringAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/QueryStringAttribute.java) |

|请求相对路径（在 Spring Boot 环境下，大多数情况 RequestPath 和 RelativePath 还有 ResolvedPath 是等价的），即除去 host，port，请求参数字符串的路径 | `%R` | `%{RELATIVE_PATH}` 或者 `%{REQUEST_PATH}` 或者 `%{RESOLVED_PATH}` | 无 | 分别对应 [`RelativePathAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RelativePathAttribute.java) 和 [`RequestPathAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestPathAttribute.java) 和 [`ResolvedPathAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ResolvedPathAttribute.java)|

| 请求整体字符串，包括请求方法，请求相对路径，请求参数字符串，请求协议，例如 `Get /test?a=b HTTP/1.1` | `%r` | `%{REQUEST_LINE}` | 无 | [`RequestLineAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestLineAttribute.java) |

| 请求 URI，包括请求相对路径，请求参数字符串 | `%U` | `%{REQUEST_URL}` | 无 | [`RequestURLAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RequestURLAttribute.java) |

| 处理请求的线程 | `%I` | `%{THREAD_NAME}` | 无 | [`ThreadNameAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ThreadNameAttribute.java) |

注意：

1. 路径参数 PathVariable 由于并没有被 Undertow 的 Listener 或者 Handler 解析处理，所以拦截不到，无法确认是否是一个 PathVariable 还是就是 url 路径。所以，**PathVariable 的占位符是不会起作用的**。

## 请求地址相关

|------|-------|------|------|------|

|host 和 port，一般就是 HTTP 请求 Header 中的 Host 值，如果 Host 为空则获取本地地址和端口，如果没获取到端口则根据协议用默认端口（http:80,，https:443）| 无 | `%{HOST_AND_PORT}` | 无 | [`HostAndPortAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/HostAndPortAttribute.java) |

|请求本地地址 IP| `%A` | `%{LOCAL_IP}` | 无 | [`LocalIPAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/LocalIPAttribute.java)|

|请求本地端口 Port| `%p` | `%{LOCAL_PORT}` | 无 | [`LocalPortAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/LocalPortAttribute.java)|

|请求本地主机名，一般就是 HTTP 请求 Header 中的 Host 值，如果 Host 为空则获取本地地址 | `%v` | `%{LOCAL_SERVER_NAME}` | 无 | [`LocalServerNameAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/LocalServerNameAttribute.java)|

|请求远程主机名，通过连接获取远端的主机地址 | `%h` | `%{REMOTE_HOST}` | 无 | [`RemoteHostAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RemoteHostAttribute.java)|

|请求远程 IP，通过连接获取远端的 IP | `%a` | `%{REMOTE_IP}` | 无 | [`RemoteIPAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/RemoteIPAttribute.java)|

注意：

1. 请求的远程地址我们一般不从请求连接获取，而是通过 Http Header 里面的 `X-forwarded-for` 或者 `X-real-ip` 等获取，因为现在请求都是通过各种 ***，负载均衡器发上来的。

## 响应相关属性

|------|-------|------|------|------|

| 发送的字节数大小，除了 Http Header 以外 | `%b` (如果为空就是 -) 或者 `%B` (如果为空就是 0) | `%{BYTES_SENT}` (如果为空就是 0) | 无 | [`BytesSentAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/BytesSentAttribute.java)|

| accesslog 时间，这个不是收到请求的时间，而是响应的时间 | `%t` | `%{DATE_TIME}` | `%{time, 你自定义的 java 中 SimpleDateFormat 的格式}` | [`DateTimeAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/DateTimeAttribute.java)|

| HTTP 响应状态码 | `%s` | `%{RESPONSE_CODE}` | 无 | [`ResponseCodeAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ResponseCodeAttribute.java)|

| HTTP 响应原因 | 无 | `%{RESPONSE_REASON_PHRASE}` | 无 | [`ResponseReasonPhraseAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ResponseReasonPhraseAttribute.java)|

| 响应 Header 的某一个值 | 无 | 无 | `%{o,你要看的header值}` | [`ResponseHeaderAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ResponseHeaderAttribute.java)|

| 响应 Cookie 的某一个值 | 无 | 无 | `%{resp-cookie,你要看的cookie值}` | [`ResponseCookieAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ResponseCookieAttribute.java)|

| 响应时间，**默认 undertow 没有开启请求时间内统计，需要打开才能统计响应时间** | `%D`(毫秒，例如 56 代表 56ms) `%T`(秒，例如 5.067 代表 5.067 秒) | `%{RESPONSE_TIME}`(等价于 `%D`) `%{RESPONSE_TIME_MICROS}` （微秒） `%{RESPONSE_TIME_NANOS}`（纳秒） | 无 | [`ResponseTimeAttribute`](https://github.com/undertow-io/undertow/blob/2.2.7.Final/core/src/main/java/io/undertow/attribute/ResponseTimeAttribute.java)|

注意：**默认 undertow 没有开启请求时间内统计，需要打开才能统计响应时间**，如何开启呢？通过注册一个 `WebServerFactoryCustomizer` 到 Spring ApplicationContext 中即可。请看下面的代码（项目地址：[https://github.com/HashZhang/spring-cloud-scaffold/blob/master/spring-cloud-iiford/](https://github.com/HashZhang/spring-cloud-scaffold/blob/master/spring-cloud-iiford/)）：

[`spring.factories`（省略无关代码）](https://github.com/HashZhang/spring-cloud-scaffold/blob/master/spring-cloud-iiford/spring-cloud-iiford-service-common/src/main/resources/META-INF/spring.factories)

```

# AutoConfiguration

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\

com.github.hashjang.spring.cloud.iiford.service.common.auto.UndertowAutoConfiguration

```

[`UndertowAutoConfiguration`](https://github.com/HashZhang/spring-cloud-scaffold/blob/master/spring-cloud-iiford/spring-cloud-iiford-service-common/src/main/java/com/github/hashjang/spring/cloud/iiford/service/common/auto/UndertowAutoConfiguration.java)

```

//设置proxyBeanMethods=false，因为没有 @Bean 的方法互相调用需要每次返回同一个 Bean，没必要代理，关闭增加启动速度

@Configuration(proxyBeanMethods = false)

@Import(WebServerConfiguration.class)

public class UndertowAutoConfiguration {

}

```

[`WebServerConfiguration`](https://github.com/HashZhang/spring-cloud-scaffold/blob/master/spring-cloud-iiford/spring-cloud-iiford-service-common/src/main/java/com/github/hashjang/spring/cloud/iiford/service/common/undertow/WebServerConfiguration.java)

```

//设置proxyBeanMethods=false，因为没有 @Bean 的方法互相调用需要每次返回同一个 Bean，没必要代理，关闭增加启动速度

@Configuration(proxyBeanMethods = false)

public class WebServerConfiguration {

@Bean

public WebServerFactoryCustomizer<ConfigurableUndertowWebServerFactory> undertowWebServerAccessLogTimingEnabler(ServerProperties serverProperties) {

return new DefaultWebServerFactoryCustomizer(serverProperties);

}

```

[`DefaultWebServerFactoryCustomizer`](https://github.com/HashZhang/spring-cloud-scaffold/blob/master/spring-cloud-iiford/spring-cloud-iiford-service-common/src/main/java/com/github/hashjang/spring/cloud/iiford/service/common/undertow/DefaultWebServerFactoryCustomizer.java)

```

public class DefaultWebServerFactoryCustomizer implements WebServerFactoryCustomizer<ConfigurableUndertowWebServerFactory> {

private final ServerProperties serverProperties;

public DefaultWebServerFactoryCustomizer(ServerProperties serverProperties) {

this.serverProperties = serverProperties;

}

@Override

public void customize(ConfigurableUndertowWebServerFactory factory) {

String pattern = serverProperties.getUndertow().getAccesslog().getPattern();

// 如果 accesslog 配置中打印了响应时间，则打开记录请求开始时间配置

if (logRequestProcessingTiming(pattern)) {

factory.addBuilderCustomizers(builder -> builder.setServerOption(UndertowOptions.RECORD_REQUEST_START_TIME, true));

}

private boolean logRequestProcessingTiming(String pattern) {

if (StringUtils.isBlank(pattern)) {

return false;

}

//判断 accesslog 是否配置了查看响应时间

return pattern.contains(ResponseTimeAttribute.RESPONSE_TIME_MICROS)

|| pattern.contains(ResponseTimeAttribute.RESPONSE_TIME_MILLIS)

|| pattern.contains(ResponseTimeAttribute.RESPONSE_TIME_NANOS)

|| pattern.contains(ResponseTimeAttribute.RESPONSE_TIME_MILLIS_SHORT)

|| pattern.contains(ResponseTimeAttribute.RESPONSE_TIME_SECONDS_SHORT);

}

```

## 其他

还有安全相关的属性（SSL 相关，登录认证 Authentication 相关），微服务内部调用一般用不到，我们这里就不赘述了。

其它内置的属性，在 Spring Boot 环境下一般用不到，我们这里就不讨论了。

## 举例

我们最开始配置的 accesslog 的例子请求返回如下（ JSON 格式化之后的结果）：

```

{

"transportProtocol": "http/1.1",

"scheme": "http",

"protocol": "HTTP/1.1",

"method": "GET",

"reqHeaderUserAgent": "PostmanRuntime/7.26.10",

"cookieUserId": "testRequestCookieUserId",

"queryTest": "1",

"queryString": "?test=1&query=2",

"relativePath": "/test, /test, -",

"requestLine": "GET /test?test=1&query=2 HTTP/1.1",

"uri": "/test",

"thread": "XNIO-2 task-1",

"hostPort": "127.0.0.1:8102",

"localIp": "127.0.0.1",

"localPort": "8102",

"localServerName": "127.0.0.1",

"remoteIp": "127.0.0.1",

"remoteHost": "127.0.0.1",

"bytesSent": "26",

"time": "2021-04-08 00:07:50.410",

"status": "200",

"reason": "OK",

"respHeaderUserSession": "testResponseHeaderUserSession",

"respCookieUserId": "testResponseCookieUserId",

"timeUsed": "3683ms, 3.683s, 3683ms, 3683149 us, 3683149200 ns",

}

```

微信关注我们

原文链接：https://blog.51cto.com/u_11418075/2691159

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

【DB宝41】监控利器PMM的使用--监控MySQL、PG、MongoDB、ProxySQL等

目录一、PMM简介二、安装使用三、监控MySQL数据库 MySQL慢查询分析四、监控PG数据库五、监控MongoDB数据库六、监控ProxySQL中间件一、PMM简介之前发布过一篇Prometheus+Grafana的文章，连接为：【DB宝36】使用Docker分分钟搭建漂亮的prometheus+grafana监控，今天我们来介绍一下另一个监控工具：PMM。 PMM（Percona Monitoring and Management）是一个免费的开源平台，用于管理和监视数据库性能，在docker环境中即可运行。它可以主动管理和监控MySQL（AWS RDS MySQL、Aurora MySQL、用户自建MySQL实例）、MariaDB、MongoDB、PostgreSQL等数据库，也可以监控ProxySQL中间件，并提供了众多指标与多样告警方式。 Percona Monitoring and Management (PMM)是一款开源的用于管理和监控MySQL和MongoDB性能的开源平台，通过PMM客户端收集到的DB监控数据用第三方软件Grafana画图展示出来。 ...

2021-04-07

619

朴素贝叶斯（Naive Bayesian Mode，NBM）贝叶斯由来贝叶斯是由英国学者托马斯·贝叶斯提出的一种纳推理的理论，后来发展为一种系统的统计推断方法。被称为贝叶斯方法。朴素贝叶斯朴素贝叶斯法是基于贝叶斯定理与特征条件独立假设的分类方法。优点是在数据较少的情况下仍然有效，可以处理多类别的问题。缺点是对于输入数据的装备方式较为敏感。适用于标称型的数据。特征条件独立：假设 X 的 N 个特征在类确定的条件下都是条件独立的。这样大大简化了计算的复杂度，但是会牺牲一些准确性。标称型数据：只在有限目标集中取值，比如真与假。贝叶斯定理条件概率就是指在事件 B 发生的情况下事件 A 发生的概率，用 P(A|B) 表示，读作 "A 在 B 发生的条件下发生的概率"。根据文氏图，可以看出在事件 B 发生的情况下，事件 A 发生的概率为 P(A∩B) 除以P(B)。其中： P(A) 是 A 的先验概率或边缘概率，不考虑 B 的因素 P(A|B) 是已知 B 发生后 A 的条件概率，也称作 A 的后验概率。 P(B|A) 是已知 A 发生后 B 的条件概率，也称作 B 的后验概...

2021-04-08

645

资源下载

更多资源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。