HTTP Exchanges (httpexchanges)

httpexchanges 端点提供有关 HTTP 请求-响应交换的信息。

获取 HTTP 交换信息

要获取 HTTP 交换信息，向 /actuator/httpexchanges 发送 GET 请求，如下面的基于 curl 的示例所示：

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

响应结果类似于以下内容：

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" : "f0a2ad73-296c-4732-9bc1-4cbdee7d38ee"
    },
    "timeTaken" : "PT0.023S"
  } ]
}

响应结构

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

Path Type Description

exchanges

Array

An array of HTTP request-response exchanges.

exchanges.[].timestamp

String

Timestamp of when the exchange occurred.

exchanges.[].principal

Object

Principal of the exchange, if any.

exchanges.[].principal.name

String

Name of the principal.

exchanges.[].request.method

String

HTTP method of the request.

exchanges.[].request.remoteAddress

String

Remote address from which the request was received, if known.

exchanges.[].request.uri

String

URI of the request.

exchanges.[].request.headers

Object

Headers of the request, keyed by header name.

exchanges.[].request.headers.*.[]

Array

Values of the header

exchanges.[].response.status

Number

Status of the response

exchanges.[].response.headers

Object

Headers of the response, keyed by header name.

exchanges.[].response.headers.*.[]

Array

Values of the header

exchanges.[].session

Object

Session associated with the exchange, if any.

exchanges.[].session.id

String

ID of the session.

exchanges.[].timeTaken

String

Time taken to handle the exchange.