对于最新的稳定版本，请使用 Spring Boot 3.4.0！spring-doc.cn

HTTP 交换（`httpexchanges`)

终端节点提供有关 HTTP 请求-响应交换的信息。httpexchangesspring-doc.cn

检索 HTTP 交换

要检索 HTTP 交换，请向发出请求，如以下基于 curl 的示例所示：GET/actuator/httpexchangesspring-doc.cn

$ curl 'http://localhost:8080/actuator/httpexchanges' -i -X GET

生成的响应类似于以下内容：spring-doc.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 511

{
  "exchanges" : [ {
    "timestamp" : "2022-12-22T13:43:41Z",
    "request" : {
      "uri" : "https://api.example.com",
      "method" : "GET",
      "headers" : {
        "Accept" : [ "application/json" ]
      }
    },
    "response" : {
      "status" : 200,
      "headers" : {
        "Content-Type" : [ "application/json" ]
      }
    },
    "principal" : {
      "name" : "alice"
    },
    "session" : {
      "id" : "594e5244-0bbf-47ed-a98d-bae08a4adcc9"
    },
    "timeTaken" : "PT0.023S"
  } ]
}

响应结构

响应包含跟踪的 HTTP 请求-响应交换的详细信息。下表描述了响应的结构：spring-doc.cn

路径类型描述

路径	类型	描述
`exchanges`spring-doc.cn	`Array`spring-doc.cn	HTTP 请求-响应交换的数组。spring-doc.cn
`exchanges.[].timestamp`spring-doc.cn	`String`spring-doc.cn	交换发生的时间戳。spring-doc.cn
`exchanges.[].principal`spring-doc.cn	`Object`spring-doc.cn	交易所的本金（如有）。spring-doc.cn
`exchanges.[].principal.name`spring-doc.cn	`String`spring-doc.cn	主体的名称。spring-doc.cn
`exchanges.[].request.method`spring-doc.cn	`String`spring-doc.cn	HTTP 方法。spring-doc.cn
`exchanges.[].request.remoteAddress`spring-doc.cn	`String`spring-doc.cn	从中接收请求的远程地址（如果已知）。spring-doc.cn
`exchanges.[].request.uri`spring-doc.cn	`String`spring-doc.cn	请求的 URI。spring-doc.cn
`exchanges.[].request.headers`spring-doc.cn	`Object`spring-doc.cn	请求的标头，以标头名称为键。spring-doc.cn
`exchanges.[].request.headers.*.[]`spring-doc.cn	`Array`spring-doc.cn	标头的值spring-doc.cn
`exchanges.[].response.status`spring-doc.cn	`Number`spring-doc.cn	响应的状态spring-doc.cn
`exchanges.[].response.headers`spring-doc.cn	`Object`spring-doc.cn	响应的标头，以标头名称为键。spring-doc.cn
`exchanges.[].response.headers.*.[]`spring-doc.cn	`Array`spring-doc.cn	标头的值spring-doc.cn
`exchanges.[].session`spring-doc.cn	`Object`spring-doc.cn	与交易所关联的会话（如果有）。spring-doc.cn
`exchanges.[].session.id`spring-doc.cn	`String`spring-doc.cn	会话的 ID。spring-doc.cn
`exchanges.[].timeTaken`spring-doc.cn	`String`spring-doc.cn	处理交换所花费的时间。spring-doc.cn

exchangesspring-doc.cn

Arrayspring-doc.cn

HTTP 请求-响应交换的数组。spring-doc.cn

exchanges.[].timestampspring-doc.cn

Stringspring-doc.cn

交换发生的时间戳。spring-doc.cn

exchanges.[].principalspring-doc.cn

Objectspring-doc.cn

交易所的本金（如有）。spring-doc.cn

exchanges.[].principal.namespring-doc.cn

Stringspring-doc.cn

主体的名称。spring-doc.cn